JDBC Connection
。このクラスのドキュメントについては、
java.sql.Connection
をご覧ください。
メソッド
詳細なドキュメント
clearWarnings()
このメソッドのドキュメントについては、
java.sql.Connection#clearWarnings()
。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。
-
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();
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。
-
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()
SQL ステートメントをデータベースに送信するための JdbcStatement
オブジェクトを作成します。関連項目
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)
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) 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)
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) 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
- 接続の自動 commit モードが有効になっている場合は 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 呼び出しエスケープ構文を使用します。 |
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 | 1 つ以上の「?」を含むことができる 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 | 1 つ以上の「?」を含むことができる SQL ステートメントIN パラメータのプレースホルダ。 |
戻る
JdbcPreparedStatement
- プリコンパイルされた SQL ステートメントを含む準備済みのステートメント。
prepareStatement(sql, autoGeneratedKeys)
このメソッドのドキュメントについては、
java.sql.Connection#prepareStatement(String, int)
。
パラメータ
名前 | 型 | 説明 |
---|---|---|
sql | String | 1 つ以上の「?」を含むことができる 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 | 1 つ以上の「?」を含むことができる 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 | 1 つ以上の「?」を含むことができる 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 | 1 つ以上の「?」を含むことができる SQL ステートメントIN パラメータのプレースホルダ。 |
indices | Integer[] | 挿入された行から返される列の列インデックス。 |
戻る
JdbcPreparedStatement
- プリコンパイルされた SQL ステートメントを含む準備済みのステートメント。
指定された列インデックスで指定された自動生成キー。
prepareStatementByName(sql, columnNames)
このメソッドのドキュメントについては、
java.sql.Connection#prepareStatement(String, String[])
。
パラメータ
名前 | 型 | 説明 |
---|---|---|
sql | String | 1 つ以上の「?」を含むことができる SQL ステートメントIN パラメータのプレースホルダ。 |
columnNames | String[] | メソッドが返す列を指定する列名 表します。 |
戻る
JdbcPreparedStatement
- プリコンパイルされた SQL ステートメントを含む準備済みのステートメント。
自動生成されたキーの文字列が自動生成されます。
releaseSavepoint(savepoint)
このメソッドのドキュメントについては、
java.sql.Connection#releaseSavepoint(Savepoint)
。
パラメータ
名前 | 型 | 説明 |
---|---|---|
savepoint | JdbcSavepoint | 削除するセーブポイント。 |
承認
このメソッドを使用するスクリプトには、次のスコープの 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 | JdbcSavepoint | ロールバック先のセーブポイント。 |
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上を使用した承認が必要です。
-
https://www.googleapis.com/auth/script.external_request
setAutoCommit(autoCommit)
このメソッドのドキュメントについては、
java.sql.Connection#setAutoCommit(boolean)
。
パラメータ
名前 | 型 | 説明 |
---|---|---|
autoCommit | Boolean | true の場合、自動 commit モードが有効になります。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 | このメソッドで作成された JdbcResultSet オブジェクトのデフォルトの保持可能性は、
接続Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT または Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT 。 |
setReadOnly(readOnly)
このメソッドのドキュメントについては、
java.sql.Connection#setReadOnly(boolean)
。
パラメータ
名前 | 型 | 説明 |
---|---|---|
readOnly | 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