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)

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

const 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)

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

const 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)

尝试使用用户名和密码建立与给定数据库的连接。

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