JDBC Connection。如需這個類別的說明文件,請參閱
java.sql.Connection。
方法
內容詳盡的說明文件
clear Warnings()
如需這個方法的說明文件,請參閱
java.sql.Connection#clearWarnings()。
授權
使用這個方法的指令碼需要一或多個下列範圍的授權:
-
https://www.googleapis.com/auth/script.external_request
close()
釋放這個連線的資料庫和所有相關聯的資源。
const conn = Jdbc.getConnection( 'jdbc:mysql://<host>:<port>/<instance>', 'user', 'password', ); conn.close();
另請參閱
-
Connection.close()
commit()
將所有待處理的變更設為永久變更,並釋放這個 Jdbc 持有的資料庫鎖定。
const conn = Jdbc.getConnection( 'jdbc:mysql://<host>:<port>/<instance>', 'user', 'password', ); conn.setAutoCommit(false); const stmt = conn.prepareStatement( 'insert into person (lname,fname) values (?,?)', ); const start = new Date(); for (let i = 0; i < 5000; i++) { // Objects are accessed using 1-based indexing stmt.setObject(1, `firstName${i}`); stmt.setObject(2, `lastName${i}`); stmt.addBatch(); } const res = stmt.executeBatch(); conn.commit(); // When this returns, this is when changes are actually // committed conn.close();
授權
使用這個方法的指令碼需要一或多個下列範圍的授權:
-
https://www.googleapis.com/auth/script.external_request
另請參閱
-
Connection.commit()
create Array Of(typeName, elements)
如需這個方法的說明文件,請參閱
java.sql.Connection#createArrayOf(String, Object[])。
參數
| 名稱 | 類型 | 說明 |
|---|---|---|
type | String | 陣列元素類型的資料庫專屬 SQL 名稱。選項包括內建型別、使用者定義型別,或資料庫支援的標準 SQL 型別。 |
elements | Object[] | 要在傳回的物件中填入的元素。 |
回攻員
Jdbc:陣列,其中的元素會對應至指定的 SQL 類型。
create Blob()
建構 Jdbc 例項。另請參閱「
java.sql.Connection#createBlob()」。
最初傳回的物件不含任何資料。您可以使用 Jdbc 的 set 方法,設定應包含的資料。這裡使用的 Blob 與使用 Utilities.newBlob(data) 建立的 Blob 不同。如要在這兩種格式之間轉換,請使用已定義的 get 和 set 方法。此外,Jdbc 和 Jdbc 都提供 get 便利方法,可轉換為 Apps Script 可用的格式。
回攻員
Jdbc:空白 Blob 物件。
create Clob()
create NClob()
create SQLXML()
create Statement()
建立 Jdbc 物件,用於將 SQL 陳述式傳送至資料庫。另請參閱
java.sql.Connection#createStatement()。
// This sample code assumes authentication is off const conn = Jdbc.getConnection('jdbc:mysql://<host>:3306/<instance>'); const stmt = conn.createStatement(); stmt.setMaxRows(100); const rs = stmt.execute('select * from person'); while (rs.next()) { // Do something } rs.close(); stmt.close(); conn.close();
回攻員
Jdbc:用於執行查詢的陳述式例項。
create Statement(resultSetType, resultSetConcurrency)
建立 Jdbc 物件,用於將 SQL 陳述式傳送至資料庫。另請參閱
java.sql.Connection#createStatement(int, int)。
這個版本可覆寫結果集類型和並行。
// This sample code assumes authentication is off // For more information about this method, see documentation here: // http://docs.oracle.com/javase/6/docs/api/java/sql/Connection.html#createStatement(int, // int) const conn = Jdbc.getConnection('jdbc:mysql://<host>:3306/<instance>'); const stmt = conn.createStatement( Jdbc.ResultSet.TYPE_FORWARD_ONLY, Jdbc.ResultSet.CONCUR_READ_ONLY, ); stmt.setMaxRows(100); const rs = stmt.execute('select * from person'); while (rs.next()) { // Do something } rs.close(); stmt.close(); conn.close();
參數
| 名稱 | 類型 | 說明 |
|---|---|---|
result | Integer | 結果集類型,可以是 Jdbc.ResultSet.TYPE_FORWARD_ONLY、Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE 或 Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE。 |
result | Integer | 並行類型,可以是 Jdbc.ResultSet.CONCUR_READ_ONLY 或 Jdbc.ResultSet.CONCUR_UPDATABLE。 |
回攻員
Jdbc:用於執行查詢的陳述式例項。
create Statement(resultSetType, resultSetConcurrency, resultSetHoldability)
建立 Jdbc 物件,用於將 SQL 陳述式傳送至資料庫。另請參閱
java.sql.Connection#createStatement(int, int, int)。
這個版本可覆寫結果集類型、並行和可保留性。
// This sample code assumes authentication is off // For more information about this method, see documentation here: // http://docs.oracle.com/javase/6/docs/api/java/sql/Connection.html#createStatement(int, // int) const conn = Jdbc.getConnection('jdbc:mysql://<host>:3306/<instance>'); const stmt = conn.createStatement( Jdbc.ResultSet.TYPE_FORWARD_ONLY, Jdbc.ResultSet.CONCUR_READ_ONLY, Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT, ); stmt.setMaxRows(100); const rs = stmt.execute('select * from person'); while (rs.next()) { // Do something } rs.close(); stmt.close(); conn.close();
參數
| 名稱 | 類型 | 說明 |
|---|---|---|
result | Integer | 結果集類型,可以是 Jdbc.ResultSet.TYPE_FORWARD_ONLY、Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE 或 Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE。 |
result | Integer | 並行類型,可以是 Jdbc.ResultSet.CONCUR_READ_ONLY 或 Jdbc.ResultSet.CONCUR_UPDATABLE。 |
result | Integer | 可保留設定,可以是 Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT 或 Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT。 |
回攻員
Jdbc:用於執行查詢的陳述式例項。
create Struct(typeName, attributes)
如需這個方法的說明文件,請參閱
java.sql.Connection#createStruct(String, Object[])。
參數
| 名稱 | 類型 | 說明 |
|---|---|---|
type | String | 陣列元素類型的資料庫專屬 SQL 名稱。選項包括內建型別、使用者定義型別,或資料庫支援的標準 SQL 型別。 |
attributes | Object[] | 填入傳回物件的屬性。 |
回攻員
Jdbc:對應至指定 SQL 型別的結構物件,並填入指定屬性。
get Auto Commit()
如需這個方法的說明文件,請參閱
java.sql.Connection#getAutoCommit()。
回攻員
Boolean - true (如果已啟用連線的自動提交模式);false (否則)。
授權
使用這個方法的指令碼需要一或多個下列範圍的授權:
-
https://www.googleapis.com/auth/script.external_request
get Catalog()
或這個方法的說明文件,請參閱
java.sql.Connection#getCatalog()。
回攻員
String:目前的目錄名稱,或 null (如果尚未設定名稱)。
授權
使用這個方法的指令碼需要一或多個下列範圍的授權:
-
https://www.googleapis.com/auth/script.external_request
get Holdability()
如需這個方法的說明文件,請參閱
java.sql.Connection#getHoldability()。
回攻員
Integer:連線的保留設定,可以是 Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT 或 Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT。
get Meta Data()
如需這個方法的說明文件,請參閱
java.sql.Connection#getMetaData()。
回攻員
Jdbc:這個連線所連線的資料庫中繼資料。
授權
使用這個方法的指令碼需要一或多個下列範圍的授權:
-
https://www.googleapis.com/auth/script.external_request
get Transaction Isolation()
如需這個方法的說明文件,請參閱
java.sql.Connection#getTransactionIsolation()。
回攻員
Integer:目前的交易層級,可以是 Jdbc.Connection.TRANSACTION_READ_UNCOMMITTED、Jdbc.Connection.TRANSACTION_READ_COMMITTED、Jdbc.Connection.TRANSACTION_REPEATABLE_READ、Jdbc.Connection.TRANSACTION_SERIALIZABLE 或 Jdbc.Connection.TRANSACTION_NONE。
授權
使用這個方法的指令碼需要一或多個下列範圍的授權:
-
https://www.googleapis.com/auth/script.external_request
get Warnings()
如需這個方法的說明文件,請參閱
java.sql.Connection#getWarnings()。
回攻員
String[]:警告字串陣列。
授權
使用這個方法的指令碼需要一或多個下列範圍的授權:
-
https://www.googleapis.com/auth/script.external_request
is Closed()
如需這個方法的說明文件,請參閱
java.sql.Connection#isClosed()。
回攻員
Boolean - 如果連線已關閉,則為 true;否則為 false。
授權
使用這個方法的指令碼需要一或多個下列範圍的授權:
-
https://www.googleapis.com/auth/script.external_request
is Read Only()
如需這個方法的說明文件,請參閱
java.sql.Connection#isReadOnly()。
回攻員
Boolean - true (如果連線為唯讀);否則為 false。
授權
使用這個方法的指令碼需要一或多個下列範圍的授權:
-
https://www.googleapis.com/auth/script.external_request
is Valid(timeout)
如需這個方法的說明文件,請參閱
java.sql.Connection#isValid(int)。
參數
| 名稱 | 類型 | 說明 |
|---|---|---|
timeout | Integer | 等待驗證作業完成的時間 (以秒為單位)。如果值為 0,表示系統不會套用逾時設定。 |
回攻員
Boolean:如果連線有效,則為 true,否則為 false。如果作業在逾時期限內未完成,也會傳回 false。
授權
使用這個方法的指令碼需要一或多個下列範圍的授權:
-
https://www.googleapis.com/auth/script.external_request
native SQL(sql)
如需這個方法的說明文件,請參閱
java.sql.Connection#nativeSQL(String)。
參數
| 名稱 | 類型 | 說明 |
|---|---|---|
sql | String | SQL 陳述式,可能包含一或多個「?」預留位置。 |
回攻員
String - 所提供陳述式的原生形式。
授權
使用這個方法的指令碼需要一或多個下列範圍的授權:
-
https://www.googleapis.com/auth/script.external_request
prepare Call(sql)
如需這個方法的說明文件,請參閱
java.sql.Connection#prepareCall(String)。
參數
| 名稱 | 類型 | 說明 |
|---|---|---|
sql | String | SQL 陳述式,可能包含一或多個「?」預留位置,通常使用 JDBC 呼叫逸出語法提供。 |
回攻員
Jdbc:包含預先編譯 SQL 陳述式的可呼叫陳述式。
prepare Call(sql, resultSetType, resultSetConcurrency)
如需這個方法的說明文件,請參閱
java.sql.Connection#prepareCall(String, int, int)。
參數
| 名稱 | 類型 | 說明 |
|---|---|---|
sql | String | SQL 陳述式,可能包含一或多個「?」預留位置,通常使用 JDBC 呼叫逸出語法提供。 |
result | Integer | 結果集類型,可以是 Jdbc.ResultSet.TYPE_FORWARD_ONLY、Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE 或 Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE。 |
result | Integer | 並行類型,可以是 Jdbc.ResultSet.CONCUR_READ_ONLY 或 Jdbc.ResultSet.CONCUR_UPDATABLE。 |
回攻員
Jdbc:可呼叫的陳述式,內含預先編譯的 SQL 陳述式,可使用提供的型別和並行產生結果集。
prepare Call(sql, resultSetType, resultSetConcurrency, resultSetHoldability)
如需這個方法的說明文件,請參閱
java.sql.Connection#prepareCall(String, int, int, int)。
參數
| 名稱 | 類型 | 說明 |
|---|---|---|
sql | String | SQL 陳述式,可能包含一或多個「?」預留位置,通常使用 JDBC 呼叫逸出語法提供。 |
result | Integer | 結果集類型,可以是 Jdbc.ResultSet.TYPE_FORWARD_ONLY、Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE 或 Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE。 |
result | Integer | 並行類型,可以是 Jdbc.ResultSet.CONCUR_READ_ONLY 或 Jdbc.ResultSet.CONCUR_UPDATABLE。 |
result | Integer | 可保留設定,可以是 Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT 或 Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT。 |
回攻員
Jdbc:可呼叫的陳述式,內含預先編譯的 SQL 陳述式,可產生具有所提供型別的結果集,並發揮並行功能。
prepare Statement(sql)
如需這個方法的說明文件,請參閱
java.sql.Connection#prepareStatement(String)。
參數
| 名稱 | 類型 | 說明 |
|---|---|---|
sql | String | SQL 陳述式,可能包含一或多個「?」IN 參數預留位置。 |
回攻員
Jdbc:包含預先編譯 SQL 陳述式的預先處理陳述式。
prepare Statement(sql, autoGeneratedKeys)
如需這個方法的說明文件,請參閱
java.sql.Connection#prepareStatement(String, int)。
參數
| 名稱 | 類型 | 說明 |
|---|---|---|
sql | String | SQL 陳述式,可能包含一或多個「?」IN 參數預留位置。 |
auto | Integer | 這個旗標表示是否傳回自動產生的金鑰;可以是 Jdbc.Statement.RETURN_GENERATED_KEYS 或 Jdbc.Statement.NO_GENERATED_KEYS。 |
回攻員
Jdbc:包含預先編譯的 SQL 陳述式,可能能夠傳回自動產生的鍵。
prepare Statement(sql, resultSetType, resultSetConcurrency)
如需這個方法的說明文件,請參閱
java.sql.Connection#prepareStatement(String, int, int)。
參數
| 名稱 | 類型 | 說明 |
|---|---|---|
sql | String | SQL 陳述式,可能包含一或多個「?」IN 參數預留位置。 |
result | Integer | 結果集類型,可以是 Jdbc.ResultSet.TYPE_FORWARD_ONLY、Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE 或 Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE。 |
result | Integer | 並行類型,可以是 Jdbc.ResultSet.CONCUR_READ_ONLY 或 Jdbc.ResultSet.CONCUR_UPDATABLE。 |
回攻員
Jdbc:包含預先編譯的 SQL 陳述式,可使用提供的型別和並行產生結果集。
prepare Statement(sql, resultSetType, resultSetConcurrency, resultSetHoldability)
如需這個方法的說明文件,請參閱
java.sql.Connection#prepareStatement(String, int, int, int)。
參數
| 名稱 | 類型 | 說明 |
|---|---|---|
sql | String | SQL 陳述式,可能包含一或多個「?」IN 參數預留位置。 |
result | Integer | 結果集類型,可以是 Jdbc.ResultSet.TYPE_FORWARD_ONLY、Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE 或 Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE。 |
result | Integer | 並行類型,可以是 Jdbc.ResultSet.CONCUR_READ_ONLY 或 Jdbc.ResultSet.CONCUR_UPDATABLE。 |
result | Integer | 可保留設定,可以是 Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT 或 Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT。 |
回攻員
Jdbc:包含預先編譯的 SQL 陳述式,可產生具有所提供型別、並行和可保留性的結果集。
prepare Statement By Index(sql, indices)
如需這個方法的說明文件,請參閱
java.sql.Connection#prepareStatement(String, int[])。
參數
| 名稱 | 類型 | 說明 |
|---|---|---|
sql | String | SQL 陳述式,可能包含一或多個「?」IN 參數預留位置。 |
indices | Integer[] | 要從插入的列傳回的欄的欄索引。 |
回攻員
Jdbc:包含預先編譯的 SQL 陳述式的預先處理陳述式,能夠傳回提供的資料欄索引所指定的自動產生鍵。
prepare Statement By Name(sql, columnNames)
如需這個方法的說明文件,請參閱
java.sql.Connection#prepareStatement(String, String[])。
參數
| 名稱 | 類型 | 說明 |
|---|---|---|
sql | String | SQL 陳述式,可能包含一或多個「?」IN 參數預留位置。 |
column | String[] | 資料欄名稱,用於指定方法應從插入的資料列傳回哪些資料欄。 |
回攻員
Jdbc:包含預先編譯的 SQL 陳述式的預先處理陳述式,能夠傳回提供的資料欄名稱指定的自動產生鍵。
release Savepoint(savepoint)
如需這個方法的說明文件,請參閱
java.sql.Connection#releaseSavepoint(Savepoint)。
參數
| 名稱 | 類型 | 說明 |
|---|---|---|
savepoint | Jdbc | 要移除的儲存點。 |
授權
使用這個方法的指令碼需要一或多個下列範圍的授權:
-
https://www.googleapis.com/auth/script.external_request
rollback()
如需這個方法的說明文件,請參閱
java.sql.Connection#rollback()。
授權
使用這個方法的指令碼需要一或多個下列範圍的授權:
-
https://www.googleapis.com/auth/script.external_request
rollback(savepoint)
如需這個方法的說明文件,請參閱
java.sql.Connection#rollback(Savepoint)。
參數
| 名稱 | 類型 | 說明 |
|---|---|---|
savepoint | Jdbc | 要回溯到的儲存點。 |
授權
使用這個方法的指令碼需要一或多個下列範圍的授權:
-
https://www.googleapis.com/auth/script.external_request
set Auto Commit(autoCommit)
如需這個方法的說明文件,請參閱
java.sql.Connection#setAutoCommit(boolean)。
參數
| 名稱 | 類型 | 說明 |
|---|---|---|
auto | Boolean | 如果為 true,則啟用自動提交模式;false 則為停用。 |
授權
使用這個方法的指令碼需要一或多個下列範圍的授權:
-
https://www.googleapis.com/auth/script.external_request
set Catalog(catalog)
如需這個方法的說明文件,請參閱
java.sql.Connection#setCatalog(String)。
參數
| 名稱 | 類型 | 說明 |
|---|---|---|
catalog | String | 要使用的目錄名稱 (連線資料庫中的子空間)。 |
授權
使用這個方法的指令碼需要一或多個下列範圍的授權:
-
https://www.googleapis.com/auth/script.external_request
set Holdability(holdability)
如需這個方法的說明文件,請參閱
java.sql.Connection#setHoldability(int)。
參數
| 名稱 | 類型 | 說明 |
|---|---|---|
holdability | Integer | 使用這個連線建立的 Jdbc 物件預設可保留性;可以是 Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT 或 Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT。 |
set Read Only(readOnly)
如需這個方法的說明文件,請參閱
java.sql.Connection#setReadOnly(boolean)。
參數
| 名稱 | 類型 | 說明 |
|---|---|---|
read | Boolean | 如果是 true,則啟用唯讀模式;false 則會停用。 |
授權
使用這個方法的指令碼需要一或多個下列範圍的授權:
-
https://www.googleapis.com/auth/script.external_request
set Savepoint()
如需這個方法的說明文件,請參閱
java.sql.Connection#setSavepoint()。
回攻員
Jdbc:新的未命名儲存點。
授權
使用這個方法的指令碼需要一或多個下列範圍的授權:
-
https://www.googleapis.com/auth/script.external_request
set Savepoint(name)
如需這個方法的說明文件,請參閱
java.sql.Connection#setSavepoint(String)。
參數
| 名稱 | 類型 | 說明 |
|---|---|---|
name | String | 建立的儲存點名稱。 |
回攻員
Jdbc:新的具名儲存點。
授權
使用這個方法的指令碼需要一或多個下列範圍的授權:
-
https://www.googleapis.com/auth/script.external_request
set Transaction Isolation(level)
如需這個方法的說明文件,請參閱
java.sql.Connection#setTransactionIsolation(int)。
參數
| 名稱 | 類型 | 說明 |
|---|---|---|
level | Integer | 要設定的交易層級,可以是 Jdbc.Connection.TRANSACTION_READ_UNCOMMITTED、Jdbc.Connection.TRANSACTION_READ_COMMITTED、Jdbc.Connection.TRANSACTION_REPEATABLE_READ、Jdbc.Connection.TRANSACTION_SERIALIZABLE 或 Jdbc.Connection.TRANSACTION_NONE。 |
授權
使用這個方法的指令碼需要一或多個下列範圍的授權:
-
https://www.googleapis.com/auth/script.external_request