JDBC Connection。如需此類別的說明文件,請參閱
java.sql.Connection。
方法
內容詳盡的說明文件
clearWarnings()
如需此方法的說明文件,請參閱
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()
讓所有待處理的變更永久生效,發布資料庫鎖定為此 JdbcConnection 的鎖定。
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()
createArrayOf(typeName, elements)
如需此方法的說明文件,請參閱
java.sql.Connection#createArrayOf(String, Object[])。
參數
| 名稱 | 類型 | 說明 |
|---|---|---|
typeName | String | 陣列參與者的資料庫專屬 SQL 名稱類型。選項包括 內建類型、使用者定義類型,或資料庫支援的標準 SQL 類型。 |
elements | Object[] | 要填入傳回物件中的元素。 |
回攻員
JdbcArray:元素會對應至指定 SQL 類型的陣列。
createBlob()
建構 JdbcBlob 例項。另請參閱
java.sql.Connection#createBlob()。
一開始傳回的物件不含任何資料。您可以使用setBytes
JdbcBlob 用來設定其中應包含的資料。這裡使用的 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 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();
回攻員
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) 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();
參數
| 名稱 | 類型 | 說明 |
|---|---|---|
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) 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();
參數
| 名稱 | 類型 | 說明 |
|---|---|---|
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