JDBC Connection
。如需這個類別的說明文件,請參閱
java.sql.Connection
。
方法
內容詳盡的說明文件
clearWarnings()
如需這個方法的說明文件,請參閱
java.sql.Connection#clearWarnings()
。
授權
使用這個方法的指令碼必須取得以下一或多個範圍的授權:
-
https://www.googleapis.com/auth/script.external_request
close()
釋出此連線的資料庫和所有相關聯的資源。
var conn = Jdbc.getConnection("jdbc:mysql://<host>:<port>/<instance>", "user", "password"); conn.close();
另請參閱
-
Connection.close()
commit()
這會將所有待處理的變更都還原,並釋出這個 JdbcConnection
保留的資料庫鎖定。
var conn = Jdbc.getConnection("jdbc:mysql://<host>:<port>/<instance>", "user", "password"); conn.setAutoCommit(false); var stmt = conn.prepareStatement("insert into person (lname,fname) values (?,?)"); var start = new Date(); for (var i = 0; i < 5000; i++) { // Objects are accessed using 1-based indexing stmt.setObject(1, 'firstName' + i); stmt.setObject(2, 'lastName' + i); stmt.addBatch(); } var 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()
createArrayOf(typeName, elements)
如需這個方法的說明文件,請參閱
java.sql.Connection#createArrayOf(String, Object[])
。
參數
名稱 | 類型 | 說明 |
---|---|---|
typeName | String | 資料庫特殊 SQL 名稱的陣列海拔高度類型。選項包括內建類型、使用者定義類型,或資料庫支援的標準 SQL 類型。 |
elements | Object[] | 要在傳回物件中填入的元素。 |
回攻員
JdbcArray
:所含元素對應至指定 SQL 類型的陣列。
createBlob()
建構一個 JdbcBlob
執行個體。另請參閱
java.sql.Connection#createBlob()
。
最初傳回的物件不含任何資料。您可以使用 JdbcBlob
的 setBytes
方法,設定其應包含的資料。這裡使用的 blob 與使用 Utilities.newBlob(data)
建立的 blob 不同。如要在這兩種格式之間轉換,請使用定義的 getBytes()
和 setBytes()
方法。或者,JdbcBlob
和 JdbcClob
都提供 getAppsScriptBlob()
便利的方法,用於轉換為 Apps Script 可以使用的格式。
回攻員
JdbcBlob
:空白 blob 物件。
createClob()
createNClob()
createSQLXML()
createStatement()
建立 JdbcStatement
物件,將 SQL 陳述式傳送至資料庫。另請參閱
java.sql.Connection#createStatement()
。
// This sample code assumes authentication is off var conn = Jdbc.getConnection("jdbc:mysql://<host>:3306/<instance>") var stmt = conn.createStatement(); stmt.setMaxRows(100); var rs = stmt.execute("select * from person"); while(rs.next()) { // Do something } rs.close(); stmt.close(); conn.close();
回攻員
JdbcStatement
:用於執行查詢的陳述式執行個體。
createStatement(resultSetType, resultSetConcurrency)
建立 JdbcStatement
物件,將 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) var conn = Jdbc.getConnection("jdbc:mysql://<host>:3306/<instance>") var stmt = conn.createStatement(Jdbc.ResultSet.TYPE_FORWARD_ONLY, Jdbc.ResultSet.CONCUR_READ_ONLY); stmt.setMaxRows(100); var rs = stmt.execute("select * from person"); while(rs.next()) { // Do something } rs.close(); stmt.close(); conn.close();
參數
名稱 | 類型 | 說明 |
---|---|---|
resultSetType | Integer | 結果集類型,可以是 Jdbc.ResultSet.TYPE_FORWARD_ONLY 、Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE 或 Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE 。 |
resultSetConcurrency | Integer | 並行類型,可以是 Jdbc.ResultSet.CONCUR_READ_ONLY 或 Jdbc.ResultSet.CONCUR_UPDATABLE 。 |
回攻員
JdbcStatement
:用於執行查詢的陳述式執行個體。
createStatement(resultSetType, resultSetConcurrency, resultSetHoldability)
建立 JdbcStatement
物件,將 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) var conn = Jdbc.getConnection("jdbc:mysql://<host>:3306/<instance>") var stmt = conn.createStatement(Jdbc.ResultSet.TYPE_FORWARD_ONLY, Jdbc.ResultSet.CONCUR_READ_ONLY, Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT); stmt.setMaxRows(100); var rs = stmt.execute("select * from person"); while(rs.next()) { // Do something } rs.close(); stmt.close(); conn.close();
參數
名稱 | 類型 | 說明 |
---|---|---|
resultSetType | Integer | 結果集類型,可以是 Jdbc.ResultSet.TYPE_FORWARD_ONLY 、Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE 或 Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE 。 |
resultSetConcurrency | Integer | 並行類型,可以是 Jdbc.ResultSet.CONCUR_READ_ONLY 或 Jdbc.ResultSet.CONCUR_UPDATABLE 。 |
resultSetHoldability | Integer | 保留設定;Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT 或 Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT 。 |
回攻員
JdbcStatement
:用於執行查詢的陳述式執行個體。
createStruct(typeName, attributes)
如需這個方法的說明文件,請參閱
java.sql.Connection#createStruct(String, Object[])
。
參數
名稱 | 類型 | 說明 |
---|---|---|
typeName | String | 資料庫特殊 SQL 名稱的陣列海拔高度類型。選項包括內建類型、使用者定義類型,或資料庫支援的標準 SQL 類型。 |
attributes | Object[] | 填入傳回物件的屬性。 |
回攻員
JdbcStruct
:對應至指定 SQL 類型並填入指定屬性的結構物件。
getAutoCommit()
如需這個方法的說明文件,請參閱
java.sql.Connection#getAutoCommit()
。
回攻員
Boolean
— 如果連線的自動修訂模式已啟用,則為 true
;否則為 false
。
授權
使用這個方法的指令碼必須取得以下一或多個範圍的授權:
-
https://www.googleapis.com/auth/script.external_request
getCatalog()
或此方法的說明文件,詳情請參閱
java.sql.Connection#getCatalog()
。
回攻員
String
:目前的目錄名稱或 null
(如果尚未設定名稱)。
授權
使用這個方法的指令碼必須取得以下一或多個範圍的授權:
-
https://www.googleapis.com/auth/script.external_request
getHoldability()
如需這個方法的說明文件,請參閱
java.sql.Connection#getHoldability()
。
回攻員
Integer
:連線的保留設定,可為 Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT
或 Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT
。
getMetaData()
如需這個方法的說明文件,請參閱
java.sql.Connection#getMetaData()
。
回攻員
JdbcDatabaseMetaData
:這個連線所連線的資料庫中繼資料。
授權
使用這個方法的指令碼必須取得以下一或多個範圍的授權:
-
https://www.googleapis.com/auth/script.external_request
getTransactionIsolation()
如需這個方法的說明文件,請參閱
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
getWarnings()
如需這個方法的說明文件,請參閱
java.sql.Connection#getWarnings()
。
回攻員
String[]
:警告字串陣列。
授權
使用這個方法的指令碼必須取得以下一或多個範圍的授權:
-
https://www.googleapis.com/auth/script.external_request
isClosed()
如需這個方法的說明文件,請參閱
java.sql.Connection#isClosed()
。
回攻員
Boolean
- 如果連線已關閉,則為 true
,否則為 false
。
授權
使用這個方法的指令碼必須取得以下一或多個範圍的授權:
-
https://www.googleapis.com/auth/script.external_request
isReadOnly()
如需這個方法的說明文件,請參閱
java.sql.Connection#isReadOnly()
。
回攻員
Boolean
— true
表示連線處於唯讀狀態,否則設為 false
。
授權
使用這個方法的指令碼必須取得以下一或多個範圍的授權:
-
https://www.googleapis.com/auth/script.external_request
isValid(timeout)
如需這個方法的說明文件,請參閱
java.sql.Connection#isValid(int)
。
參數
名稱 | 類型 | 說明 |
---|---|---|
timeout | Integer | 等待驗證作業完成的時間 (以秒為單位)。如果值為 0,表示未套用逾時。 |
回攻員
Boolean
:如果連線有效,則為 true
,否則為 false
。如果逾時期間在作業完成前到期,系統也會傳回 false
。
授權
使用這個方法的指令碼必須取得以下一或多個範圍的授權:
-
https://www.googleapis.com/auth/script.external_request
nativeSQL(sql)
如需這個方法的說明文件,請參閱
java.sql.Connection#nativeSQL(String)
。
參數
名稱 | 類型 | 說明 |
---|---|---|
sql | String | SQL 陳述式可包含一或多個「?」預留位置。 |
回攻員
String
:所提供陳述式的原生格式。
授權
使用這個方法的指令碼必須取得以下一或多個範圍的授權:
-
https://www.googleapis.com/auth/script.external_request
prepareCall(sql)
如需這個方法的說明文件,請參閱
java.sql.Connection#prepareCall(String)
。
參數
名稱 | 類型 | 說明 |
---|---|---|
sql | String | SQL 陳述式可能包含多個「?」預留位置,通常透過 JDBC 呼叫逸出語法提供。 |
回攻員
JdbcCallableStatement
:包含預先編譯 SQL 陳述式的可呼叫陳述式。
prepareCall(sql, resultSetType, resultSetConcurrency)
如需這個方法的說明文件,請參閱
java.sql.Connection#prepareCall(String, int, int)
。
參數
名稱 | 類型 | 說明 |
---|---|---|
sql | String | SQL 陳述式可能包含多個「?」預留位置,通常透過 JDBC 呼叫逸出語法提供。 |
resultSetType | Integer | 結果集類型,可以是 Jdbc.ResultSet.TYPE_FORWARD_ONLY 、Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE 或 Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE 。 |
resultSetConcurrency | Integer | 並行類型,可以是 Jdbc.ResultSet.CONCUR_READ_ONLY 或 Jdbc.ResultSet.CONCUR_UPDATABLE 。 |
回攻員
JdbcCallableStatement
:包含預先編譯 SQL 陳述式的可呼叫陳述式,會產生具有指定類型和並行的結果集。
prepareCall(sql, resultSetType, resultSetConcurrency, resultSetHoldability)
如需這個方法的說明文件,請參閱
java.sql.Connection#prepareCall(String, int, int, int)
。
參數
名稱 | 類型 | 說明 |
---|---|---|
sql | String | SQL 陳述式可能包含多個「?」預留位置,通常透過 JDBC 呼叫逸出語法提供。 |
resultSetType | Integer | 結果集類型,可以是 Jdbc.ResultSet.TYPE_FORWARD_ONLY 、Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE 或 Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE 。 |
resultSetConcurrency | Integer | 並行類型,可以是 Jdbc.ResultSet.CONCUR_READ_ONLY 或 Jdbc.ResultSet.CONCUR_UPDATABLE 。 |
resultSetHoldability | Integer | 保留設定;Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT 或 Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT 。 |
回攻員
JdbcCallableStatement
:可呼叫的陳述式,包含預先編譯的 SQL 陳述式,可產生具有指定類型 (並行) 的結果集。
prepareStatement(sql)
如需這個方法的說明文件,請參閱
java.sql.Connection#prepareStatement(String)
。
參數
名稱 | 類型 | 說明 |
---|---|---|
sql | String | SQL 陳述式可包含一或多個 IN 參數預留位置。 |
回攻員
JdbcPreparedStatement
:包含預先編譯 SQL 陳述式的準備陳述式。
prepareStatement(sql, autoGeneratedKeys)
如需這個方法的說明文件,請參閱
java.sql.Connection#prepareStatement(String, int)
。
參數
名稱 | 類型 | 說明 |
---|---|---|
sql | String | SQL 陳述式可包含一或多個 IN 參數預留位置。 |
autoGeneratedKeys | Integer | 指出是否傳回自動產生的金鑰的旗標,可以是 Jdbc.Statement.RETURN_GENERATED_KEYS 或 Jdbc.Statement.NO_GENERATED_KEYS 。 |
回攻員
JdbcPreparedStatement
:包含預先編譯 SQL 陳述式的準備陳述式,可能可以傳回自動產生的金鑰。
prepareStatement(sql, resultSetType, resultSetConcurrency)
如需這個方法的說明文件,請參閱
java.sql.Connection#prepareStatement(String, int, int)
。
參數
名稱 | 類型 | 說明 |
---|---|---|
sql | String | SQL 陳述式可包含一或多個 IN 參數預留位置。 |
resultSetType | Integer | 結果集類型,可以是 Jdbc.ResultSet.TYPE_FORWARD_ONLY 、Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE 或 Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE 。 |
resultSetConcurrency | Integer | 並行類型,可以是 Jdbc.ResultSet.CONCUR_READ_ONLY 或 Jdbc.ResultSet.CONCUR_UPDATABLE 。 |
回攻員
JdbcPreparedStatement
:包含預先編譯 SQL 陳述式的準備陳述式,會產生具有指定類型和並行的結果集。
prepareStatement(sql, resultSetType, resultSetConcurrency, resultSetHoldability)
如需這個方法的說明文件,請參閱
java.sql.Connection#prepareStatement(String, int, int, int)
。
參數
名稱 | 類型 | 說明 |
---|---|---|
sql | String | SQL 陳述式可包含一或多個 IN 參數預留位置。 |
resultSetType | Integer | 結果集類型,可以是 Jdbc.ResultSet.TYPE_FORWARD_ONLY 、Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE 或 Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE 。 |
resultSetConcurrency | Integer | 並行類型,可以是 Jdbc.ResultSet.CONCUR_READ_ONLY 或 Jdbc.ResultSet.CONCUR_UPDATABLE 。 |
resultSetHoldability | Integer | 保留設定;Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT 或 Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT 。 |
回攻員
JdbcPreparedStatement
:包含預先編譯 SQL 陳述式的準備陳述式,會產生具有指定類型、並行和可保留性的結果集。
prepareStatementByIndex(sql, indices)
如需這個方法的說明文件,請參閱
java.sql.Connection#prepareStatement(String, int[])
。
參數
名稱 | 類型 | 說明 |
---|---|---|
sql | String | SQL 陳述式可包含一或多個 IN 參數預留位置。 |
indices | Integer[] | 從插入的資料列或資料列傳回的資料欄索引。 |
回攻員
JdbcPreparedStatement
:包含預先編譯 SQL 陳述式的準備陳述式,可傳回由提供的資料欄索引指定自動產生的索引鍵。
prepareStatementByName(sql, columnNames)
如需這個方法的說明文件,請參閱
java.sql.Connection#prepareStatement(String, String[])
。
參數
名稱 | 類型 | 說明 |
---|---|---|
sql | String | SQL 陳述式可包含一或多個 IN 參數預留位置。 |
columnNames | String[] | 資料欄名稱,用於指定方法應從插入的資料列或資料列傳回哪些資料欄。 |
回攻員
JdbcPreparedStatement
:包含預先編譯 SQL 陳述式的準備陳述式,可傳回由提供的資料欄名稱指定自動產生的索引鍵。
releaseSavepoint(savepoint)
如需這個方法的說明文件,請參閱
java.sql.Connection#releaseSavepoint(Savepoint)
。
參數
名稱 | 類型 | 說明 |
---|---|---|
savepoint | JdbcSavepoint | 要移除的儲存點。 |
授權
使用這個方法的指令碼必須取得以下一或多個範圍的授權:
-
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 | JdbcSavepoint | 復原的目標儲存點。 |
授權
使用這個方法的指令碼必須取得以下一或多個範圍的授權:
-
https://www.googleapis.com/auth/script.external_request
setAutoCommit(autoCommit)
如需這個方法的說明文件,請參閱
java.sql.Connection#setAutoCommit(boolean)
。
參數
名稱 | 類型 | 說明 |
---|---|---|
autoCommit | Boolean | 如果為 true ,則會啟用自動修訂模式;false 會停用。 |
授權
使用這個方法的指令碼必須取得以下一或多個範圍的授權:
-
https://www.googleapis.com/auth/script.external_request
setCatalog(catalog)
如需這個方法的說明文件,請參閱
java.sql.Connection#setCatalog(String)
。
參數
名稱 | 類型 | 說明 |
---|---|---|
catalog | String | 運作中的目錄名稱 (連線資料庫中的子空間)。 |
授權
使用這個方法的指令碼必須取得以下一或多個範圍的授權:
-
https://www.googleapis.com/auth/script.external_request
setHoldability(holdability)
如需這個方法的說明文件,請參閱
java.sql.Connection#setHoldability(int)
。
參數
名稱 | 類型 | 說明 |
---|---|---|
holdability | Integer | 透過這個連線建立的 JdbcResultSet 物件會預設為保留狀態,可為 Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT 或 Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT 。 |
setReadOnly(readOnly)
如需這個方法的說明文件,請參閱
java.sql.Connection#setReadOnly(boolean)
。
參數
名稱 | 類型 | 說明 |
---|---|---|
readOnly | Boolean | 如果為 true ,系統會啟用唯讀模式;false 會停用。 |
授權
使用這個方法的指令碼必須取得以下一或多個範圍的授權:
-
https://www.googleapis.com/auth/script.external_request
setSavepoint()
如需這個方法的說明文件,請參閱
java.sql.Connection#setSavepoint()
。
回攻員
JdbcSavepoint
:新的未命名的儲存點。
授權
使用這個方法的指令碼必須取得以下一或多個範圍的授權:
-
https://www.googleapis.com/auth/script.external_request
setSavepoint(name)
如需這個方法的說明文件,請參閱
java.sql.Connection#setSavepoint(String)
。
參數
名稱 | 類型 | 說明 |
---|---|---|
name | String | 建立的儲存點名稱。 |
回攻員
JdbcSavepoint
:新的已命名儲存點。
授權
使用這個方法的指令碼必須取得以下一或多個範圍的授權:
-
https://www.googleapis.com/auth/script.external_request
setTransactionIsolation(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