JDBC Connection
。このクラスのドキュメントについては、
java.sql.Connection
をご覧ください。
メソッド
詳細なドキュメント
clear Warnings()
このメソッドのドキュメントについては、
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()
保留中のすべての変更を永続的にし、この Jdbc
によって保持されているデータベースのロックを解除します。
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()
create Array Of(typeName, elements)
このメソッドのドキュメントについては、
java.sql.Connection#createArrayOf(String, Object[])
をご覧ください。
パラメータ
名前 | 型 | 説明 |
---|---|---|
type | String | 配列要素の型のデータベース固有の SQL 名。オプションには、組み込み型、ユーザー定義型、データベースでサポートされている標準 SQL 型があります。 |
elements | Object[] | 返されるオブジェクトに入力する要素。 |
戻る
Jdbc
- 要素が指定された SQL 型にマッピングされる配列。
create Blob()
Jdbc
インスタンスを作成します。
java.sql.Connection#createBlob()
もご覧ください。
最初に返されるオブジェクトにはデータが含まれません。Jdbc
の set
メソッドを使用して、含まれるデータを設定できます。ここで使用される blob は、Utilities.newBlob(data)
で作成された blob とは異なります。2 つの形式を変換するには、定義された get
メソッドと set
メソッドを使用します。または、Jdbc
と Jdbc
の両方に、Apps Script で使用できる形式に変換するための get
コンビニエンス メソッドが用意されています。
戻る
Jdbc
- 空の blob オブジェクト。
create Clob()
create NClob()
create SQLXML()
create Statement()
SQL ステートメントをデータベースに送信する Jdbc
オブジェクトを作成します。
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();
戻る
Jdbc
- クエリを実行するステートメント インスタンス。
create Statement(resultSetType, resultSetConcurrency)
SQL ステートメントをデータベースに送信する Jdbc
オブジェクトを作成します。
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 )。 |
戻る
Jdbc
- クエリを実行するステートメント インスタンス。
create Statement(resultSetType, resultSetConcurrency, resultSetHoldability)
SQL ステートメントをデータベースに送信する Jdbc
オブジェクトを作成します。
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 )。 |
戻る
Jdbc
- クエリを実行するステートメント インスタンス。
create Struct(typeName, attributes)
このメソッドのドキュメントについては、
java.sql.Connection#createStruct(String, Object[])
をご覧ください。
パラメータ
名前 | 型 | 説明 |
---|---|---|
type | String | 配列要素の型のデータベース固有の SQL 名。オプションには、組み込み型、ユーザー定義型、データベースでサポートされている標準 SQL 型があります。 |
attributes | Object[] | 返されるオブジェクトに入力される属性。 |
戻る
Jdbc
- 指定された SQL 型にマッピングされ、指定された属性が設定された構造体オブジェクト。
get Auto Commit()
このメソッドのドキュメントについては、
java.sql.Connection#getAutoCommit()
をご覧ください。
戻る
Boolean
- 接続の autocommit モードが有効になっている場合は true
、それ以外の場合は false
を指定します。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/script.external_request
get Catalog()
またはこのメソッドのドキュメントについては、
java.sql.Connection#getCatalog()
をご覧ください。
戻る
String
- 現在のカタログ名。名前が設定されていない場合は null
です。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/script.external_request
get Holdability()
このメソッドのドキュメントについては、
java.sql.Connection#getHoldability()
をご覧ください。
戻る
Integer
- 接続の保持設定(Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT
または Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT
)。
get Meta Data()
このメソッドのドキュメントについては、
java.sql.Connection#getMetaData()
をご覧ください。
戻る
Jdbc
- この接続が接続するデータベースのメタデータ。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/script.external_request
get Transaction Isolation()
このメソッドのドキュメントについては、
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
get Warnings()
このメソッドのドキュメントについては、
java.sql.Connection#getWarnings()
をご覧ください。
戻る
String[]
- 警告文字列の配列。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/script.external_request
is Closed()
このメソッドのドキュメントについては、
java.sql.Connection#isClosed()
をご覧ください。
戻る
Boolean
- 接続が閉じられている場合は true
、そうでない場合は false
。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/script.external_request
is Read Only()
このメソッドのドキュメントについては、
java.sql.Connection#isReadOnly()
をご覧ください。
戻る
Boolean
- 接続が読み取り専用の場合は true
、それ以外の場合は false
。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/script.external_request
is Valid(timeout)
このメソッドのドキュメントについては、
java.sql.Connection#isValid(int)
をご覧ください。
パラメータ
名前 | 型 | 説明 |
---|---|---|
timeout | Integer | 検証オペレーションが完了するまで待機する時間(秒)。値 0 は、タイムアウトが適用されないことを示します。 |
戻る
Boolean
- 接続が有効な場合は true
、それ以外の場合は false
。オペレーションが完了する前にタイムアウト期間が切れた場合も、false
を返します。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/script.external_request
native SQL(sql)
このメソッドのドキュメントについては、
java.sql.Connection#nativeSQL(String)
をご覧ください。
パラメータ
名前 | 型 | 説明 |
---|---|---|
sql | String | 1 つ以上の「?」プレースホルダを含む SQL ステートメント。 |
戻る
String
- 指定されたステートメントのネイティブ形式。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/script.external_request
prepare Call(sql)
このメソッドのドキュメントについては、
java.sql.Connection#prepareCall(String)
をご覧ください。
パラメータ
名前 | 型 | 説明 |
---|---|---|
sql | String | 1 つ以上の「?」プレースホルダを含む SQL ステートメント。通常は JDBC 呼び出しエスケープ構文を使用して指定します。 |
戻る
Jdbc
- 事前コンパイルされた SQL ステートメントを含む呼び出し可能なステートメント。
prepare Call(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 )。 |
戻る
Jdbc
- 指定された型と同時実行で結果セットを生成する事前コンパイルされた SQL ステートメントを含む呼び出し可能なステートメント。
prepare Call(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 )。 |
戻る
Jdbc
- 指定されたタイプ(同時実行)の結果セットを生成する事前コンパイル済み SQL ステートメントを含む呼び出し可能なステートメント。
prepare Statement(sql)
このメソッドのドキュメントについては、
java.sql.Connection#prepareStatement(String)
をご覧ください。
パラメータ
名前 | 型 | 説明 |
---|---|---|
sql | String | 1 つ以上の「?」IN パラメータ プレースホルダを含む SQL ステートメント。 |
戻る
Jdbc
- 事前コンパイルされた SQL ステートメントを含む準備済みステートメント。
prepare Statement(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 )。 |
戻る
Jdbc
- 事前コンパイルされた SQL ステートメントを含む準備済みステートメント。自動生成されたキーを返すことができます。
prepare Statement(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 )。 |
戻る
Jdbc
- 指定された型と同時実行で結果セットを生成する事前コンパイルされた SQL ステートメントを含む準備済みステートメント。
prepare Statement(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 )。 |
戻る
Jdbc
- 指定された型、同時実行、保持可能性を持つ結果セットを生成する事前コンパイルされた SQL ステートメントを含む準備済みステートメント。
prepare Statement By Index(sql, indices)
このメソッドのドキュメントについては、
java.sql.Connection#prepareStatement(String, int[])
をご覧ください。
パラメータ
名前 | 型 | 説明 |
---|---|---|
sql | String | 1 つ以上の「?」IN パラメータ プレースホルダを含む SQL ステートメント。 |
indices | Integer[] | 挿入された行から返される列の列番号。 |
戻る
Jdbc
- 事前コンパイルされた SQL ステートメントを含む準備済みステートメント。指定された列番号で指定された自動生成キーを返すことができます。
prepare Statement By Name(sql, columnNames)
このメソッドのドキュメントについては、
java.sql.Connection#prepareStatement(String, String[])
をご覧ください。
パラメータ
名前 | 型 | 説明 |
---|---|---|
sql | String | 1 つ以上の「?」IN パラメータ プレースホルダを含む SQL ステートメント。 |
column | String[] | 挿入された行からメソッドが返す列を指定する列名。 |
戻る
Jdbc
- 事前コンパイルされた SQL ステートメントを含む準備済みステートメント。指定された列名で指定された自動生成キーを返すことができます。
release Savepoint(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
set Auto Commit(autoCommit)
このメソッドのドキュメントについては、
java.sql.Connection#setAutoCommit(boolean)
をご覧ください。
パラメータ
名前 | 型 | 説明 |
---|---|---|
auto | Boolean | true の場合、自動 commit モードが有効になります。false の場合、無効になります。 |
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/script.external_request
set Catalog(catalog)
このメソッドのドキュメントについては、
java.sql.Connection#setCatalog(String)
をご覧ください。
パラメータ
名前 | 型 | 説明 |
---|---|---|
catalog | String | 作業するカタログ(接続のデータベース内のサブスペース)の名前。 |
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/script.external_request
set Holdability(holdability)
このメソッドのドキュメントについては、
java.sql.Connection#setHoldability(int)
をご覧ください。
パラメータ
名前 | 型 | 説明 |
---|---|---|
holdability | Integer | この接続で作成された Jdbc オブジェクトのデフォルトの保持可能性(Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT または Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT )。 |
set Read Only(readOnly)
このメソッドのドキュメントについては、
java.sql.Connection#setReadOnly(boolean)
をご覧ください。
パラメータ
名前 | 型 | 説明 |
---|---|---|
read | Boolean | true の場合、読み取り専用モードが有効になります。false の場合、無効になります。 |
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/script.external_request
set Savepoint()
このメソッドのドキュメントについては、
java.sql.Connection#setSavepoint()
をご覧ください。
戻る
Jdbc
- 名前のない新しいセーブポイント。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/script.external_request
set Savepoint(name)
このメソッドのドキュメントについては、
java.sql.Connection#setSavepoint(String)
をご覧ください。
パラメータ
名前 | 型 | 説明 |
---|---|---|
name | String | 作成されたセーブポイントの名前。 |
戻る
Jdbc
- 新しい名前付きセーブポイント。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/script.external_request
set Transaction Isolation(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