Class Jdbc

Jdbc

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 网址建立连接。

参数

名称类型说明
urlString数据库网址,格式为 jdbc:google:mysql://subname

返回

JdbcConnection - 一个 JdbcConnection 对象。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权:

  • https://www.googleapis.com/auth/sqlservice

getCloudSqlConnection(url, info)

尝试与给定 Google Cloud SQL 网址建立连接。

参数

名称类型说明
urlString数据库网址,格式为 jdbc:google:mysql://subname
infoObject用于指定高级参数(如下文中所定义)的可选 JavaScript 对象。

高级参数

名称类型说明
connectTimeoutSecondsInteger连接超时(以秒为单位)
databaseString要连接的数据库
instanceStringGoogle SQL 服务实例的名称
passwordString用户的密码
queryTimeoutSecondsInteger查询超时(以秒为单位)
userString要传递给数据库的用户名

返回

JdbcConnection - 一个 JdbcConnection 对象。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权:

  • https://www.googleapis.com/auth/sqlservice

getCloudSqlConnection(url, userName, password)

尝试与给定 Google Cloud SQL 网址建立连接。

参数

名称类型说明
urlString数据库网址,格式为 jdbc:google:mysql://subname
userNameString要传递给数据库的用户名。
passwordString用户的密码。

返回

JdbcConnection - 一个 JdbcConnection 对象。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权:

  • https://www.googleapis.com/auth/sqlservice

getConnection(url)

尝试与给定数据库网址建立连接。

var conn = Jdbc.getConnection('jdbc:mysql://yoursqlserver.example.com:3306/database_name');

参数

名称类型说明
urlString数据库网址,格式为 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'});

参数

名称类型说明
urlString数据库网址,格式为 jdbc:subprotocol:subname
infoObject用于指定高级参数(如下文中所定义)的可选 JavaScript 对象。

高级参数

名称类型说明
databaseNameString要连接的数据库
passwordString用户的密码
useJDBCCompliantTimeZoneShiftBoolean连接是否 转换时区时遵守 JDBC 规则。默认值为 false
userString要传递给数据库的用户名
_serverSslCertificateString服务器的 SSL 证书
_clientSslCertificateString客户端的 SSL 证书
_clientSslKeyString客户端的 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');

参数

名称类型说明
urlString数据库网址,格式为 jdbc:subprotocol:subname
userNameString要传递给数据库的用户名。
passwordString用户的密码。

返回

JdbcConnection - 一个 JdbcConnection 对象。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权:

  • https://www.googleapis.com/auth/script.external_request

newDate(milliseconds)

以自纪元以来的毫秒数创建日期。

参数

名称类型说明
millisecondsInteger从公元纪年开始计算的毫秒数。

返回

JdbcDate - 一个 JdbcDate 对象。


newTime(milliseconds)

创建时间,以自纪元以来的毫秒数表示。

参数

名称类型说明
millisecondsInteger从公元纪年开始计算的毫秒数。

返回

JdbcTime - 一个 JdbcTime 对象。


newTimestamp(milliseconds)

创建时间戳(自纪元以来的毫秒数)。

参数

名称类型说明
millisecondsInteger从公元纪年开始计算的毫秒数。

返回

JdbcTimestamp - 一个 JdbcTimestamp 对象。


parseDate(date)

通过解析 SQL 日期字符串创建日期。

参数

名称类型说明
dateString包含 SQL 日期字符串的字符串。

返回

JdbcDate - 一个 JdbcDate 对象。


parseTime(time)

通过解析 SQL 时间字符串创建时间。

参数

名称类型说明
timeString包含 SQL 时间字符串的字符串。

返回

JdbcTime - 一个 JdbcTime 对象。


parseTimestamp(timestamp)

通过解析 SQL 时间戳字符串创建时间戳。

参数

名称类型说明
timestampString包含 SQL 时间戳字符串的字符串。

返回

JdbcTimestamp - 一个 JdbcTimestamp 对象。