JDBC Connection
。このクラスのドキュメントについては、
java.sql.Connection
をご覧ください。
Methods
詳細なドキュメント
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()
もご覧ください。
最初に返されたオブジェクトにはデータが含まれていません。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 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 つ以上の「?」IN パラメータのプレースホルダを含む可能性のある SQL ステートメント。 |
リターン
JdbcPreparedStatement
- プリコンパイルされた SQL ステートメントを含む準備済みステートメント。
prepareStatement(sql, autoGeneratedKeys)
このメソッドのドキュメントについては、
java.sql.Connection#prepareStatement(String, int)
をご覧ください。
パラメータ
名前 | 型 | 説明 |
---|---|---|
sql | String | 1 つ以上の「?」IN パラメータのプレースホルダを含む可能性のある SQL ステートメント。 |
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 つ以上の「?」IN パラメータのプレースホルダを含む可能性のある SQL ステートメント。 |
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 つ以上の「?」IN パラメータのプレースホルダを含む可能性のある SQL ステートメント。 |
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 つ以上の「?」IN パラメータのプレースホルダを含む可能性のある SQL ステートメント。 |
indices | Integer[] | 挿入された行から返される列の列インデックス。 |
リターン
JdbcPreparedStatement
- コンパイル済みの SQL ステートメントを含む準備済みのステートメント。指定された列インデックスで指定された自動生成キーを返すことができます。
prepareStatementByName(sql, columnNames)
このメソッドのドキュメントについては、
java.sql.Connection#prepareStatement(String, String[])
をご覧ください。
パラメータ
名前 | 型 | 説明 |
---|---|---|
sql | String | 1 つ以上の「?」IN パラメータのプレースホルダを含む可能性のある SQL ステートメント。 |
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