Class JdbcConnection

如需此方法的說明文件，請參閱 java.sql.Connection#clearWarnings()。

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

釋放這個連線的資料庫和所有相關資源。

const conn = Jdbc.getConnection(
    'jdbc:mysql://<host>:<port>/<instance>',
    'user',
    'password',
);
conn.close();

另請參閱

• Connection.close()

將所有待處理的變更設為永久，並釋放此 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()

如需此方法的說明文件，請參閱 java.sql.Connection#createArrayOf(String, Object[])。

參數

回攻員

JdbcArray：陣列元素會對應至指定的 SQL 類型。

建構 JdbcBlob 例項。另請參閱 java.sql.Connection#createBlob()。

最初傳回的物件不含任何資料。您可以使用 JdbcBlob 的 setBytes 方法，設定應包含的資料。此處使用的 Blob 與使用 Utilities.newBlob(data) 建立的 Blob 不同。如要轉換這兩種格式，請使用定義的 getBytes() 和 setBytes() 方法。另外，JdbcBlob 和 JdbcClob 都提供 getAppsScriptBlob() 方便方法，可轉換為 Apps Script 可用的格式。

回攻員

JdbcBlob：空 Blob 物件。

如需此方法的說明文件，請參閱 java.sql.Connection#createClob()。

回攻員

JdbcClob - 空白的 clob 物件。

如需此方法的說明文件，請參閱 java.sql.Connection#createNClob()。

回攻員

JdbcClob：空白的 nclob 物件。

如需此方法的說明文件，請參閱 java.sql.Connection#createSQLXML()。

回攻員

JdbcSQLXML：空白的 SQLXML 物件。

建立 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：用於執行查詢的陳述式例項。

建立 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();

參數

回攻員

JdbcStatement：用於執行查詢的陳述式例項。

建立 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();

參數

回攻員

JdbcStatement：用於執行查詢的陳述式例項。

如需此方法的說明文件，請參閱 java.sql.Connection#createStruct(String, Object[])。

參數

回攻員

JdbcStruct：結構體物件，會對應至指定的 SQL 類型，並填入指定的屬性。

如需此方法的說明文件，請參閱 java.sql.Connection#getAutoCommit()。

回攻員

Boolean - 如果已啟用連線的自動提交模式，則為 true；否則為 false。

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

或說明文件，請參閱 java.sql.Connection#getCatalog()。

回攻員

String：目前的目錄名稱，如果未設定名稱，則為 null。

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

如需此方法的說明文件，請參閱 java.sql.Connection#getHoldability()。

回攻員

Integer：連線的保留設定，可為 Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT 或 Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT。

如需此方法的說明文件，請參閱 java.sql.Connection#getMetaData()。

回攻員

JdbcDatabaseMetaData：這個連線所連結的資料庫中繼資料。

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

如需此方法的說明文件，請參閱 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

如需此方法的說明文件，請參閱 java.sql.Connection#getWarnings()。

回攻員

String[]：警告字串陣列。

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

如需此方法的說明文件，請參閱 java.sql.Connection#isClosed()。

回攻員

Boolean：如果連線已關閉，則為 true；否則為 false。

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

如需此方法的說明文件，請參閱 java.sql.Connection#isReadOnly()。

回攻員

Boolean：如果連線為唯讀，則為 true；否則為 false。

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

如需此方法的說明文件，請參閱 java.sql.Connection#isValid(int)。

參數

回攻員

Boolean：如果連線有效，則為 true；否則為 false。如果在作業完成前逾時，也會傳回 false。

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

如需此方法的說明文件，請參閱 java.sql.Connection#nativeSQL(String)。

參數

回攻員

String：提供的陳述式原生形式。

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

如需此方法的說明文件，請參閱 java.sql.Connection#prepareCall(String)。

參數

回攻員

JdbcCallableStatement：可呼叫的陳述式，其中包含預先編譯的 SQL 陳述式。

如需此方法的說明文件，請參閱 java.sql.Connection#prepareCall(String, int, int)。

參數

回攻員

JdbcCallableStatement：可呼叫的陳述式，其中包含預先編譯的 SQL 陳述式，可產生具有提供類型和並行作業的結果集。

如需此方法的說明文件，請參閱 java.sql.Connection#prepareCall(String, int, int, int)。

參數

回攻員

JdbcCallableStatement：可呼叫的陳述式，其中包含預先編譯的 SQL 陳述式，可使用提供的類型 (並行處理) 產生結果集。

如需此方法的說明文件，請參閱 java.sql.Connection#prepareStatement(String)。

參數

回攻員

JdbcPreparedStatement：包含預先編譯 SQL 陳述式的預備陳述式。

如需此方法的說明文件，請參閱 java.sql.Connection#prepareStatement(String, int)。

參數

回攻員

JdbcPreparedStatement：包含預先編譯 SQL 陳述式的預備陳述式，可能能夠傳回自動產生的鍵。

如需此方法的說明文件，請參閱 java.sql.Connection#prepareStatement(String, int, int)。

參數

回攻員

JdbcPreparedStatement：預備陳述式，其中包含預先編譯的 SQL 陳述式，可根據提供的類型和並行作業產生結果集。

如需此方法的說明文件，請參閱 java.sql.Connection#prepareStatement(String, int, int, int)。

參數

回攻員

JdbcPreparedStatement：已準備好的陳述式，其中包含預先編譯的 SQL 陳述式，可使用提供的類型、並行作業和可保留性產生結果集。

如需此方法的說明文件，請參閱 java.sql.Connection#prepareStatement(String, int[])。

參數

回攻員

JdbcPreparedStatement：包含預先編譯 SQL 陳述式的預備陳述式，可傳回由提供的資料欄索引指定的自動產生鍵。

如需此方法的說明文件，請參閱 java.sql.Connection#prepareStatement(String, String[])。

參數

回攻員

JdbcPreparedStatement：包含預先編譯 SQL 陳述式的預備陳述式，可傳回由提供的資料欄名稱指定的自動產生鍵。

如需此方法的說明文件，請參閱 java.sql.Connection#releaseSavepoint(Savepoint)。

參數

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

如需此方法的說明文件，請參閱 java.sql.Connection#rollback()。

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

如需此方法的說明文件，請參閱 java.sql.Connection#rollback(Savepoint)。

參數

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

如需此方法的說明文件，請參閱 java.sql.Connection#setAutoCommit(boolean)。

參數

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

如需此方法的說明文件，請參閱 java.sql.Connection#setCatalog(String)。

參數

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

如需此方法的說明文件，請參閱 java.sql.Connection#setHoldability(int)。

參數

如需此方法的說明文件，請參閱 java.sql.Connection#setReadOnly(boolean)。

參數

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

如需此方法的說明文件，請參閱 java.sql.Connection#setSavepoint()。

回攻員

JdbcSavepoint：新的未命名儲存點。

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

如需此方法的說明文件，請參閱 java.sql.Connection#setSavepoint(String)。

參數

回攻員

JdbcSavepoint：新的命名儲存點。

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

如需此方法的說明文件，請參閱 java.sql.Connection#setTransactionIsolation(int)。

參數

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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