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

参数

名称	类型	说明
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)

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

参数

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

返回

JdbcDate - 一个 JdbcDate 对象。

---

newTime(milliseconds)

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

参数

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

返回

JdbcTime - 一个 JdbcTime 对象。

---

newTimestamp(milliseconds)

创建时间戳（自纪元以来的毫秒数）。

参数

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

返回

JdbcTimestamp - 一个 JdbcTimestamp 对象。

---

parseDate(date)

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

参数

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

返回

JdbcDate - 一个 JdbcDate 对象。

---

parseTime(time)

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

参数

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

返回

JdbcTime - 一个 JdbcTime 对象。

---

parseTimestamp(timestamp)

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

参数

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

返回

JdbcTimestamp - 一个 JdbcTimestamp 对象。