JDBC Connection。このクラスのドキュメントについては、
java.sql.Connection をご覧ください。
メソッド
詳細なドキュメント
clearWarnings()
このメソッドのドキュメントについては、
java.sql.Connection#clearWarnings() をご覧ください。
承認
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
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();
承認
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/script.external_request
関連情報
-
Connection.commit()
createArrayOf(typeName, elements)
このメソッドのドキュメントについては、
java.sql.Connection#createArrayOf(String, Object[]) をご覧ください。
パラメータ
| 名前 | タイプ | 説明 |
|---|---|---|
type | String | 配列要素の型のデータベース固有の SQL 名。オプションには、組み込み型、ユーザー定義型、データベースでサポートされている標準 SQL 型などがあります。 |
elements | Object[] | 返されるオブジェクトに設定する要素。 |
戻る
JdbcArray - 要素が指定された SQL 型にマッピングされる配列。
createBlob()
JdbcBlob インスタンスを構築します。
java.sql.Connection#createBlob() もご覧ください。
最初に返されるオブジェクトにはデータが含まれていません。JdbcBlob の setBytes メソッドを使用して、含めるべきデータを設定できます。ここで使用される BLOB は、Utilities.newBlob(data) で作成された BLOB とは異なります。2 つの形式を変換するには、定義された getBytes() メソッドと setBytes() メソッドを使用します。また、JdbcBlob と JdbcClob の両方で、Apps Script で使用できる形式に変換するための getAppsScriptBlob() 便利なメソッドが提供されています。
戻る
JdbcBlob - 空の BLOB オブジェクト。
createClob()
createNClob()
createSQLXML()
createStatement()
データベースに SQL ステートメントを送信するための JdbcStatement オブジェクトを作成します。
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)
データベースに SQL ステートメントを送信するための JdbcStatement オブジェクトを作成します。
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)。 |
戻る
JdbcStatement - クエリを実行するステートメント インスタンス。
createStatement(resultSetType, resultSetConcurrency, resultSetHoldability)
データベースに SQL ステートメントを送信するための JdbcStatement オブジェクトを作成します。
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)。 |
戻る
JdbcStatement - クエリを実行するステートメント インスタンス。
createStruct(typeName, attributes)
このメソッドのドキュメントについては、
java.sql.Connection#createStruct(String, Object[]) をご覧ください。
パラメータ
| 名前 | タイプ | 説明 |
|---|---|---|
type | String | 配列要素の型のデータベース固有の SQL 名。オプションには、組み込み型、ユーザー定義型、データベースでサポートされている標準 SQL 型などがあります。 |
attributes | Object[] | 返されるオブジェクトにデータを入力する属性。 |
戻る
JdbcStruct - 指定された SQL 型にマッピングされ、指定された属性が設定された構造体オブジェクト。
getAutoCommit()
このメソッドのドキュメントについては、
java.sql.Connection#getAutoCommit() をご覧ください。
戻る
Boolean - 接続の自動コミット モードが有効な場合は true、それ以外の場合は false。
承認
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/script.external_request
getCatalog()
またはこのメソッドのドキュメントについては、
java.sql.Connection#getCatalog() をご覧ください。
戻る
String - 現在のカタログ名。名前が設定されていない場合は null。
承認
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
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 - この接続が接続するデータベースのメタデータ。
承認
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
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 のいずれかです。
承認
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/script.external_request
getWarnings()
このメソッドのドキュメントについては、
java.sql.Connection#getWarnings() をご覧ください。
戻る
String[] - 警告文字列の配列。
承認
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/script.external_request
isClosed()
このメソッドのドキュメントについては、
java.sql.Connection#isClosed() をご覧ください。
戻る
Boolean - 接続が閉じられた場合は true、それ以外の場合は false。
承認
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/script.external_request
isReadOnly()
このメソッドのドキュメントについては、
java.sql.Connection#isReadOnly() をご覧ください。
戻る
Boolean - 接続が読み取り専用の場合は true、それ以外の場合は false。
承認
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/script.external_request
isValid(timeout)
このメソッドのドキュメントについては、
java.sql.Connection#isValid(int) をご覧ください。
パラメータ
| 名前 | タイプ | 説明 |
|---|---|---|
timeout | Integer | 検証オペレーションが完了するまで待機する時間(秒単位)。値 0 は、タイムアウトが適用されないことを示します。 |
戻る
Boolean - 接続が有効な場合は true、それ以外の場合は false。オペレーションが完了する前にタイムアウト期間が経過した場合も、false を返します。
承認
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/script.external_request
nativeSQL(sql)
このメソッドのドキュメントについては、
java.sql.Connection#nativeSQL(String) をご覧ください。
パラメータ
| 名前 | タイプ | 説明 |
|---|---|---|
sql | String | 1 つ以上の「?」プレースホルダを含む SQL ステートメント。 |
戻る
String - 提供されたステートメントのネイティブ形式。
承認
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/script.external_request
prepareCall(sql)
このメソッドのドキュメントについては、
java.sql.Connection#prepareCall(String) をご覧ください。
パラメータ
| 名前 | タイプ | 説明 |
|---|---|---|
sql | String | 1 つ以上の「?」プレースホルダを含む可能性のある SQL ステートメント。通常は JDBC 呼び出しエスケープ構文を使用して指定されます。 |
戻る
JdbcCallableStatement - 事前コンパイルされた SQL ステートメントを含む呼び出し可能なステートメント。
prepareCall(sql, resultSetType, resultSetConcurrency)
このメソッドのドキュメントについては、
java.sql.Connection#prepareCall(String, int, int) をご覧ください。
パラメータ
| 名前 | タイプ | 説明 |
|---|---|---|
sql | String | 1 つ以上の「?」プレースホルダを含む可能性のある 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)。 |
戻る
JdbcCallableStatement - 指定された型と同時実行で結果セットを生成する、事前コンパイルされた SQL ステートメントを含む呼び出し可能なステートメント。
prepareCall(sql, resultSetType, resultSetConcurrency, resultSetHoldability)
このメソッドのドキュメントについては、
java.sql.Connection#prepareCall(String, int, int, int) をご覧ください。
パラメータ
| 名前 | タイプ | 説明 |
|---|---|---|
sql | String | 1 つ以上の「?」プレースホルダを含む可能性のある 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)。 |
戻る
JdbcCallableStatement - 指定された型と同時実行性で結果セットを生成する、事前コンパイルされた SQL ステートメントを含む呼び出し可能なステートメント。
prepareStatement(sql)
このメソッドのドキュメントについては、
java.sql.Connection#prepareStatement(String) をご覧ください。
パラメータ
| 名前 | タイプ | 説明 |
|---|---|---|
sql | String | 1 つ以上の「?」IN パラメータ プレースホルダを含む SQL ステートメント。 |
戻る
JdbcPreparedStatement - 事前コンパイルされた SQL ステートメントを含む準備済みステートメント。
prepareStatement(sql, autoGeneratedKeys)
このメソッドのドキュメントについては、
java.sql.Connection#prepareStatement(String, int) をご覧ください。
パラメータ
| 名前 | タイプ | 説明 |
|---|---|---|
sql | String | 1 つ以上の「?」IN パラメータ プレースホルダを含む SQL ステートメント。 |
auto | 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 | 1 つ以上の「?」IN パラメータ プレースホルダを含む SQL ステートメント。 |
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)。 |
戻る
JdbcPreparedStatement - 指定された型と同時実行で結果セットを生成する、事前にコンパイルされた SQL ステートメントを含む準備済みステートメント。
prepareStatement(sql, resultSetType, resultSetConcurrency, resultSetHoldability)
このメソッドのドキュメントについては、
java.sql.Connection#prepareStatement(String, int, int, int) をご覧ください。
パラメータ
| 名前 | タイプ | 説明 |
|---|---|---|
sql | String | 1 つ以上の「?」IN パラメータ プレースホルダを含む SQL ステートメント。 |
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)。 |
戻る
JdbcPreparedStatement - 指定された型、同時実行、保持可能性で結果セットを生成する、事前にコンパイルされた SQL ステートメントを含む準備済みステートメント。
prepareStatementByIndex(sql, indices)
このメソッドのドキュメントについては、
java.sql.Connection#prepareStatement(String, int[]) をご覧ください。
パラメータ
| 名前 | タイプ | 説明 |
|---|---|---|
sql | String | 1 つ以上の「?」IN パラメータ プレースホルダを含む SQL ステートメント。 |
indices | Integer[] | 挿入された行から返される列の列インデックス。 |
戻る
JdbcPreparedStatement - 事前コンパイルされた SQL ステートメントを含む準備済みステートメント。指定された列インデックスで指定された自動生成キーを返すことができます。
prepareStatementByName(sql, columnNames)
このメソッドのドキュメントについては、
java.sql.Connection#prepareStatement(String, String[]) をご覧ください。
パラメータ
| 名前 | タイプ | 説明 |
|---|---|---|
sql | String | 1 つ以上の「?」IN パラメータ プレースホルダを含む SQL ステートメント。 |
column | String[] | 挿入された 1 つまたは複数の行からメソッドが返す列を指定する列名。 |
戻る
JdbcPreparedStatement - 事前コンパイルされた SQL ステートメントを含む準備済みステートメント。指定された列名で自動生成されたキーを返すことができます。
releaseSavepoint(savepoint)
このメソッドのドキュメントについては、
java.sql.Connection#releaseSavepoint(Savepoint) をご覧ください。
パラメータ
| 名前 | タイプ | 説明 |
|---|---|---|
savepoint | Jdbc | 削除する保存ポイント。 |
承認
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/script.external_request
rollback()
このメソッドのドキュメントについては、
java.sql.Connection#rollback() をご覧ください。
承認
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/script.external_request
rollback(savepoint)
このメソッドのドキュメントについては、
java.sql.Connection#rollback(Savepoint) をご覧ください。
パラメータ
| 名前 | タイプ | 説明 |
|---|---|---|
savepoint | Jdbc | ロールバックするセーブポイント。 |
承認
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/script.external_request
setAutoCommit(autoCommit)
このメソッドのドキュメントについては、
java.sql.Connection#setAutoCommit(boolean) をご覧ください。
パラメータ
| 名前 | タイプ | 説明 |
|---|---|---|
auto | Boolean | true の場合、自動コミット モードが有効になります。false の場合、無効になります。 |
承認
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/script.external_request
setCatalog(catalog)
このメソッドのドキュメントについては、
java.sql.Connection#setCatalog(String) をご覧ください。
パラメータ
| 名前 | タイプ | 説明 |
|---|---|---|
catalog | String | 作業するカタログ(接続のデータベース内のサブスペース)の名前。 |
承認
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/script.external_request
setHoldability(holdability)
このメソッドのドキュメントについては、
java.sql.Connection#setHoldability(int) をご覧ください。
パラメータ
| 名前 | タイプ | 説明 |
|---|---|---|
holdability | Integer | この接続で作成された Jdbc オブジェクトのデフォルトの保持可能性。Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT または Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT のいずれか。 |
setReadOnly(readOnly)
このメソッドのドキュメントについては、
java.sql.Connection#setReadOnly(boolean) をご覧ください。
パラメータ
| 名前 | タイプ | 説明 |
|---|---|---|
read | Boolean | true の場合、読み取り専用モードが有効になります。false の場合、無効になります。 |
承認
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/script.external_request
setSavepoint()
このメソッドのドキュメントについては、
java.sql.Connection#setSavepoint() をご覧ください。
戻る
JdbcSavepoint - 新しい名前のない保存ポイント。
承認
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/script.external_request
setSavepoint(name)
このメソッドのドキュメントについては、
java.sql.Connection#setSavepoint(String) をご覧ください。
パラメータ
| 名前 | タイプ | 説明 |
|---|---|---|
name | String | 作成された保存ポイントの名前。 |
戻る
JdbcSavepoint - 新しい名前付き保存ポイント。
承認
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
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 のいずれかです。 |
承認
このメソッドを使用するスクリプトには、次の 1 つ以上のスコープによる承認が必要です。
-
https://www.googleapis.com/auth/script.external_request