本頁面由 Cloud Translation API 翻譯而成。

Class Jdbc

JDBC 服務可讓指令碼連線至 Google Cloud SQL、MySQL、Microsoft SQL Server 和 Oracle 資料庫。詳情請參閱 JDBC 指南。

方法

方法	傳回類型	簡短說明
`getCloudSqlConnection(url)`	`JdbcConnection`	嘗試連線至指定的 Google Cloud SQL URL。
`getCloudSqlConnection(url, info)`	`JdbcConnection`	嘗試連線至指定的 Google Cloud SQL URL。
`getCloudSqlConnection(url, userName, password)`	`JdbcConnection`	嘗試連線至指定的 Google Cloud SQL URL。
`getConnection(url)`	`JdbcConnection`	嘗試與指定資料庫網址建立連線。
`getConnection(url, info)`	`JdbcConnection`	嘗試與指定資料庫網址建立連線。
`getConnection(url, userName, password)`	`JdbcConnection`	嘗試使用使用者名稱和密碼，建立與指定資料庫的連線。
`newDate(milliseconds)`	`JdbcDate`	根據自 Epoch 紀元時間起算的毫秒數建立日期。
`newTime(milliseconds)`	`JdbcTime`	以 Epoch 紀元時間起算的毫秒數建立時間。
`newTimestamp(milliseconds)`	`JdbcTimestamp`	以 Epoch 紀元時間起算的毫秒數建立時間戳記。
`parseDate(date)`	`JdbcDate`	剖析 SQL 日期字串，建立日期。
`parseTime(time)`	`JdbcTime`	剖析 SQL 時間字串，建立時間。
`parseTimestamp(timestamp)`	`JdbcTimestamp`	剖析 SQL 時間戳記字串，建立時間戳記。

內容詳盡的說明文件

`getCloudSqlConnection(url)`

嘗試連線至指定的 Google Cloud SQL URL。

參數

名稱	類型	說明
`url`	`String`	資料庫網址，格式為 `jdbc:google:mysql://subname`。

回攻員

JdbcConnection：JdbcConnection 物件。

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

`getCloudSqlConnection(url, info)`

嘗試連線至指定的 Google Cloud SQL URL。

參數

名稱	類型	說明
`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。

參數

名稱	類型	說明
`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)`

根據自 Epoch 紀元時間起算的毫秒數建立日期。

參數

名稱	類型	說明
`milliseconds`	`Integer`	自 Epoch 起算的毫秒數。

回攻員

JdbcDate：JdbcDate 物件。

`newTime(milliseconds)`

以 Epoch 紀元時間起算的毫秒數建立時間。

參數

名稱	類型	說明
`milliseconds`	`Integer`	自 Epoch 起算的毫秒數。

回攻員

JdbcTime：JdbcTime 物件。

`newTimestamp(milliseconds)`

以 Epoch 紀元時間起算的毫秒數建立時間戳記。

參數

名稱	類型	說明
`milliseconds`	`Integer`	自 Epoch 起算的毫秒數。

回攻員

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 物件。