JDBC 服务允许脚本连接到 Google Cloud SQL、MySQL、Microsoft SQL Server 和 Oracle 数据库。如需了解详情,请参阅 JDBC 指南。
方法
方法 | 返回类型 | 简介 |
---|---|---|
getCloudSqlConnection(url) | JdbcConnection | 尝试与给定的 Google Cloud SQL 网址建立连接。 |
getCloudSqlConnection(url, info) | JdbcConnection | 尝试与给定的 Google Cloud SQL 网址建立连接。 |
getCloudSqlConnection(url, userName, password) | JdbcConnection | 尝试与给定的 Google Cloud SQL 网址建立连接。 |
getConnection(url) | JdbcConnection | 尝试与给定数据库网址建立连接。 |
getConnection(url, info) | JdbcConnection | 尝试与给定数据库网址建立连接。 |
getConnection(url, userName, password) | JdbcConnection | 尝试使用用户名和密码与给定数据库建立连接。 |
newDate(milliseconds) | JdbcDate | 创建自纪元开始的日期(以毫秒为单位)。 |
newTime(milliseconds) | JdbcTime | 创建自纪元开始的时间(以毫秒为单位)。 |
newTimestamp(milliseconds) | JdbcTimestamp | 根据自纪元以来的毫秒数创建时间戳。 |
parseDate(date) | JdbcDate | 通过解析 SQL 日期字符串来创建日期。 |
parseTime(time) | JdbcTime | 通过解析 SQL 时间字符串来创建时间。 |
parseTimestamp(timestamp) | JdbcTimestamp | 通过解析 SQL 时间戳字符串来创建时间戳。 |
详细文档
getCloudSqlConnection(url)
尝试与给定的 Google Cloud SQL 网址建立连接。
参数
名称 | 类型 | 说明 |
---|---|---|
url | String | 数据库网址的形式为 jdbc:google:mysql://subname 。 |
返回
JdbcConnection
- JdbcConnection 对象。
授权
使用此方法的脚本需要通过以下一个或多个范围进行授权:
-
https://www.googleapis.com/auth/sqlservice
getCloudSqlConnection(url, info)
尝试与给定的 Google Cloud SQL 网址建立连接。
参数
名称 | 类型 | 说明 |
---|---|---|
url | String | 数据库网址的形式为 jdbc:google:mysql://subname 。 |
info | Object | 用于指定高级参数的可选 JavaScript 对象,定义如下。 |
高级参数
名称 | 类型 | 说明 |
---|---|---|
connectTimeoutSeconds | Integer | 连接超时(秒) |
database | String | 要连接的数据库 |
instance | String | Google SQL 服务实例的名称 |
password | String | 用户的密码 |
queryTimeoutSeconds | Integer | 查询超时(秒) |
user | String | 要传递给数据库的用户名 |
返回
JdbcConnection
- JdbcConnection 对象。
授权
使用此方法的脚本需要通过以下一个或多个范围进行授权:
-
https://www.googleapis.com/auth/sqlservice
getCloudSqlConnection(url, userName, password)
尝试与给定的 Google Cloud SQL 网址建立连接。
参数
名称 | 类型 | 说明 |
---|---|---|
url | String | 数据库网址的形式为 jdbc:google:mysql://subname 。 |
userName | String | 要传递给数据库的用户名。 |
password | String | 用户的密码。 |
返回
JdbcConnection
- JdbcConnection 对象。
授权
使用此方法的脚本需要通过以下一个或多个范围进行授权:
-
https://www.googleapis.com/auth/sqlservice
getConnection(url)
尝试与指定的数据库网址建立连接。
var conn = Jdbc.getConnection('jdbc:mysql://yoursqlserver.example.com:3306/database_name');
参数
名称 | 类型 | 说明 |
---|---|---|
url | String | 数据库网址的形式为 jdbc:subprotocol:subname 。 |
返回
JdbcConnection
- JdbcConnection 对象。
授权
使用此方法的脚本需要通过以下一个或多个范围进行授权:
-
https://www.googleapis.com/auth/script.external_request
getConnection(url, info)
尝试与指定的数据库网址建立连接。
var conn = Jdbc.getConnection('jdbc:mysql://yoursqlserver.example.com:3306/database_name', {user: 'username', password: 'password'});
参数
名称 | 类型 | 说明 |
---|---|---|
url | String | 数据库网址的形式为 jdbc:subprotocol:subname 。 |
info | Object | 用于指定高级参数的可选 JavaScript 对象,定义如下。 |
高级参数
名称 | 类型 | 说明 |
---|---|---|
databaseName | String | 要连接的数据库 |
password | String | 用户的密码 |
useJDBCCompliantTimeZoneShift | Boolean | 转换时区时,连接是否符合 JDBC 规则。默认值为 false 。 |
user | String | 要传递给数据库的用户名 |
_serverSslCertificate | String | 服务器的 SSL 证书 |
_clientSslCertificate | String | 客户端的 SSL 证书 |
_clientSslKey | String | 客户端的 SSL 密钥 |
返回
JdbcConnection
- JdbcConnection 对象。
授权
使用此方法的脚本需要通过以下一个或多个范围进行授权:
-
https://www.googleapis.com/auth/script.external_request
getConnection(url, userName, password)
尝试使用用户名和密码与指定数据库建立连接。
var conn = Jdbc.getConnection('jdbc:mysql://yoursqlserver.example.com:3306/database_name', 'username', 'password');
参数
名称 | 类型 | 说明 |
---|---|---|
url | String | 数据库网址的形式为 jdbc:subprotocol:subname 。 |
userName | String | 要传递给数据库的用户名。 |
password | String | 用户的密码。 |
返回
JdbcConnection
- JdbcConnection 对象。
授权
使用此方法的脚本需要通过以下一个或多个范围进行授权:
-
https://www.googleapis.com/auth/script.external_request
newDate(milliseconds)
newTime(milliseconds)
newTimestamp(milliseconds)
parseDate(date)
parseTime(time)
parseTimestamp(timestamp)
通过解析 SQL 时间戳字符串来创建时间戳。
参数
名称 | 类型 | 说明 |
---|---|---|
timestamp | String | 包含 SQL 时间戳字符串的字符串。 |
返回
JdbcTimestamp
- JdbcTimestamp 对象。