Class Jdbc

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