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