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 对象。