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 建立連線。

參數

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

回攻員

JdbcConnection - JdbcConnection 物件。

授權

使用這個方法的指令碼需要一或多個下列範圍的授權：

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

getCloudSqlConnection(url, info)

嘗試與指定的 Google Cloud SQL URL 建立連線。

參數

名稱類型說明
urlString資料庫網址，格式為 jdbc:google:mysql://subname。
infoObject選用 JavaScript 物件，用於指定進階參數 (定義如下)。

進階參數

名稱類型說明
connectTimeoutSecondsInteger連線逾時時間 (單位為秒)
databaseString要連線的資料庫
instanceStringGoogle SQL 服務執行個體的名稱
passwordString使用者的密碼
queryTimeoutSecondsInteger查詢逾時時間 (以秒為單位)
userString要傳遞至資料庫的使用者名稱

回攻員

JdbcConnection - JdbcConnection 物件。

授權

使用這個方法的指令碼需要一或多個下列範圍的授權：

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

getCloudSqlConnection(url, userName, password)

嘗試與指定的 Google Cloud SQL URL 建立連線。

參數

名稱類型說明
urlString資料庫網址，格式為 jdbc:google:mysql://subname。
userNameString要傳遞至資料庫的使用者名稱。
passwordString使用者的密碼。

回攻員

JdbcConnection - JdbcConnection 物件。

授權

使用這個方法的指令碼需要一或多個下列範圍的授權：

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

getConnection(url)

嘗試與指定的資料庫網址建立連線。 

const conn = Jdbc.getConnection(
    'jdbc:mysql://yoursqlserver.example.com:3306/database_name',
);

參數

名稱類型說明
urlString資料庫網址，格式為 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'},
);

參數

名稱類型說明
urlString資料庫網址，格式為 jdbc:subprotocol:subname。
infoObject選用 JavaScript 物件，用於指定進階參數 (定義如下)。

進階參數

名稱類型說明
databaseNameString要連線的資料庫
passwordString使用者的密碼
useJDBCCompliantTimeZoneShiftBoolean轉換時區時，連線是否應遵守 JDBC 規則。預設為 false。
userString要傳遞至資料庫的使用者名稱
_serverSslCertificateString伺服器的 SSL 憑證
_clientSslCertificateString用戶端的 SSL 憑證
_clientSslKeyString用戶端的 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',
);

參數

名稱類型說明
urlString資料庫網址，格式為 jdbc:subprotocol:subname。
userNameString要傳遞至資料庫的使用者名稱。
passwordString使用者的密碼。

回攻員

JdbcConnection - JdbcConnection 物件。

授權

使用這個方法的指令碼需要一或多個下列範圍的授權：

  • https://www.googleapis.com/auth/script.external_request

newDate(milliseconds)

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

參數

名稱類型說明
millisecondsInteger自 Epoch 起算的毫秒數。

回攻員

JdbcDate - JdbcDate 物件。

newTime(milliseconds)

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

參數

名稱類型說明
millisecondsInteger自 Epoch 起算的毫秒數。

回攻員

JdbcTime - JdbcTime 物件。

newTimestamp(milliseconds)

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

參數

名稱類型說明
millisecondsInteger自 Epoch 起算的毫秒數。

回攻員

JdbcTimestamp - JdbcTimestamp 物件。

parseDate(date)

剖析 SQL 日期字串，建立日期。

參數

名稱類型說明
dateString包含 SQL 日期字串的字串。

回攻員

JdbcDate - JdbcDate 物件。

parseTime(time)

剖析 SQL 時間字串，建立時間。

參數

名稱類型說明
timeString包含 SQL 時間字串的字串。

回攻員

JdbcTime - JdbcTime 物件。

parseTimestamp(timestamp)

剖析 SQL 時間戳記字串，建立時間戳記。

參數

名稱類型說明
timestampString包含 SQL 時間戳記字串的字串。

回攻員

JdbcTimestamp - JdbcTimestamp 物件。