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()
保留中のすべての変更を永続的にし、この 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()
createArrayOf(typeName, elements)
このメソッドのドキュメントについては、
java.sql.Connection#createArrayOf(String, Object[])
をご覧ください。
パラメータ
名前 | 型 | 説明 |
---|---|---|
type | String | 配列要素の型のデータベース固有の SQL 名。オプションには、組み込み型、ユーザー定義型、データベースでサポートされている標準 SQL 型があります。 |
elements | Object[] | 返されるオブジェクトに入力する要素。 |
戻る
Jdbc
- 要素が指定された SQL 型にマッピングされる配列。
createBlob()
Jdbc
インスタンスを作成します。
java.sql.Connection#createBlob()
もご覧ください。
最初に返されるオブジェクトにはデータが含まれません。Jdbc
の set
メソッドを使用して、含まれるデータを設定できます。ここで使用される blob は、Utilities.newBlob(data)
で作成された blob とは異なります。2 つの形式を変換するには、定義された get
メソッドと set
メソッドを使用します。または、Jdbc
と Jdbc
の両方に、Apps Script で使用できる形式に変換するための get
コンビニエンス メソッドが用意されています。
戻る
Jdbc
- 空の blob オブジェクト。
createClob()
createNClob()
createSQLXML()
createStatement()
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
- クエリを実行するステートメント インスタンス。
createStatement(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
- クエリを実行するステートメント インスタンス。
createStatement(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
- クエリを実行するステートメント インスタンス。
createStruct(typeName, attributes)
このメソッドのドキュメントについては、
java.sql.Connection#createStruct(String, Object[])
をご覧ください。
パラメータ
名前 | 型 | 説明 |
---|---|---|
type | String | 配列要素の型のデータベース固有の SQL 名。オプションには、組み込み型、ユーザー定義型、データベースでサポートされている標準 SQL 型があります。 |
attributes | Object[] | 返されるオブジェクトに入力される属性。 |
戻る
Jdbc
- 指定された SQL 型にマッピングされ、指定された属性が設定された構造体オブジェクト。
getAutoCommit()
このメソッドのドキュメントについては、
java.sql.Connection#getAutoCommit()
をご覧ください。
戻る
Boolean
- 接続の autocommit モードが有効になっている場合は 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()
をご覧ください。
戻る
Jdbc
- この接続が接続するデータベースのメタデータ。
承認
このメソッドを使用するスクリプトには、次のスコープの 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 呼び出しエスケープ構文を使用して指定します。 |
戻る
Jdbc
- 事前コンパイルされた 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 )。 |
戻る
Jdbc
- 指定された型と同時実行で結果セットを生成する事前コンパイルされた 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 )。 |
戻る
Jdbc
- 指定されたタイプ(同時実行)の結果セットを生成する事前コンパイル済み SQL ステートメントを含む呼び出し可能なステートメント。
prepareStatement(sql)
このメソッドのドキュメントについては、
java.sql.Connection#prepareStatement(String)
をご覧ください。
パラメータ
名前 | 型 | 説明 |
---|---|---|
sql | String | 1 つ以上の「?」IN パラメータ プレースホルダを含む SQL ステートメント。 |
戻る
Jdbc
- 事前コンパイルされた 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 )。 |
戻る
Jdbc
- 事前コンパイルされた 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 )。 |
戻る
Jdbc
- 指定された型と同時実行で結果セットを生成する事前コンパイルされた 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 )。 |
戻る
Jdbc
- 指定された型、同時実行、保持可能性を持つ結果セットを生成する事前コンパイルされた SQL ステートメントを含む準備済みステートメント。
prepareStatementByIndex(sql, indices)
このメソッドのドキュメントについては、
java.sql.Connection#prepareStatement(String, int[])
をご覧ください。
パラメータ
名前 | 型 | 説明 |
---|---|---|
sql | String | 1 つ以上の「?」IN パラメータ プレースホルダを含む SQL ステートメント。 |
indices | Integer[] | 挿入された行から返される列の列番号。 |
戻る
Jdbc
- 事前コンパイルされた SQL ステートメントを含む準備済みステートメント。指定された列番号で指定された自動生成キーを返すことができます。
prepareStatementByName(sql, columnNames)
このメソッドのドキュメントについては、
java.sql.Connection#prepareStatement(String, String[])
をご覧ください。
パラメータ
名前 | 型 | 説明 |
---|---|---|
sql | String | 1 つ以上の「?」IN パラメータ プレースホルダを含む SQL ステートメント。 |
column | String[] | 挿入された行からメソッドが返す列を指定する列名。 |
戻る
Jdbc
- 事前コンパイルされた 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 の場合、自動 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 | この接続で作成された 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()
をご覧ください。
戻る
Jdbc
- 名前のない新しいセーブポイント。
承認
このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。
-
https://www.googleapis.com/auth/script.external_request
setSavepoint(name)
このメソッドのドキュメントについては、
java.sql.Connection#setSavepoint(String)
をご覧ください。
パラメータ
名前 | 型 | 説明 |
---|---|---|
name | String | 作成されたセーブポイントの名前。 |
戻る
Jdbc
- 新しい名前付きセーブポイント。
承認
このメソッドを使用するスクリプトには、次のスコープの 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