Class JdbcConnection

如需查看此方法的文档，请参阅 java.sql.Connection#clearWarnings()。

授权

使用此方法的脚本需要通过以下一个或多个范围进行授权：

• https://www.googleapis.com/auth/script.external_request

释放此连接的数据库以及所有关联的资源。

var conn = Jdbc.getConnection("jdbc:mysql://<host>:<port>/<instance>", "user", "password");
conn.close();

另请参阅

• Connection.close()

将所有待处理的更改设为永久性，并释放此 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();

授权

使用此方法的脚本需要通过以下一个或多个范围进行授权：

• https://www.googleapis.com/auth/script.external_request

另请参阅

• Connection.commit()

如需查看此方法的文档，请参阅 java.sql.Connection#createArrayOf(String, Object[])。

参数

返回

JdbcArray - 其元素映射到指定 SQL 类型的数组。

构建 JdbcBlob 实例。另请参阅 java.sql.Connection#createBlob()。

最初返回的对象不包含任何数据。您可以使用 JdbcBlob 的 setBytes 方法来设置它应包含的数据。此处使用的 blob 与使用 Utilities.newBlob(data) 创建的 blob 不同。如需在这两种格式之间进行转换，请使用定义的 getBytes() 和 setBytes() 方法。或者，JdbcBlob 和 JdbcClob 都提供了 getAppsScriptBlob() 简便方法，用于转换为 Apps 脚本可以使用的格式。

返回

JdbcBlob - 空 blob 对象。

如需查看此方法的文档，请参阅 java.sql.Connection#createClob()。

返回

JdbcClob - 空的 clob 对象。

如需查看此方法的文档，请参阅 java.sql.Connection#createNClob()。

返回

JdbcClob - 空的 nclob 对象。

如需查看此方法的文档，请参阅 java.sql.Connection#createSQLXML()。

返回

JdbcSQLXML - 空 SQLXML 对象。

创建一个 JdbcStatement 对象，用于将 SQL 语句发送到数据库。另请参阅 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 - 执行查询的语句实例。

创建一个 JdbcStatement 对象，用于将 SQL 语句发送到数据库。另请参阅 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();

参数

返回

JdbcStatement - 执行查询的语句实例。

创建一个 JdbcStatement 对象，用于将 SQL 语句发送到数据库。另请参阅 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();

参数

返回

JdbcStatement - 执行查询的语句实例。

如需查看此方法的文档，请参阅 java.sql.Connection#createStruct(String, Object[])。

参数

返回

JdbcStruct - 与给定 SQL 类型相对应并填充了给定属性的结构对象。

如需查看此方法的文档，请参阅 java.sql.Connection#getAutoCommit()。

返回

Boolean - 如果连接启用了自动提交模式，则为 true；否则为 false。

授权

使用此方法的脚本需要通过以下一个或多个范围进行授权：

• https://www.googleapis.com/auth/script.external_request

或参阅此方法的文档，请参阅 java.sql.Connection#getCatalog()。

返回

String - 当前清单名称或 null（如果未设置名称）。

授权

使用此方法的脚本需要通过以下一个或多个范围进行授权：

• https://www.googleapis.com/auth/script.external_request

如需查看此方法的文档，请参阅 java.sql.Connection#getHoldability()。

返回

Integer - 连接的可保持性设置；值为 Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT 或 Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT。

如需查看此方法的文档，请参阅 java.sql.Connection#getMetaData()。

返回

JdbcDatabaseMetaData - 此连接所连接的数据库的元数据。

授权

使用此方法的脚本需要通过以下一个或多个范围进行授权：

• https://www.googleapis.com/auth/script.external_request

如需查看此方法的文档，请参阅 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。

授权

使用此方法的脚本需要通过以下一个或多个范围进行授权：

• https://www.googleapis.com/auth/script.external_request

如需查看此方法的文档，请参阅 java.sql.Connection#getWarnings()。

返回

String[] - 警告字符串数组。

授权

使用此方法的脚本需要通过以下一个或多个范围进行授权：

• https://www.googleapis.com/auth/script.external_request

如需查看此方法的文档，请参阅 java.sql.Connection#isClosed()。

返回

Boolean - 如果连接关闭，则返回 true；否则，返回 false。

授权

使用此方法的脚本需要通过以下一个或多个范围进行授权：

• https://www.googleapis.com/auth/script.external_request

如需查看此方法的文档，请参阅 java.sql.Connection#isReadOnly()。

返回

Boolean - 如果连接处于只读模式，则为 true；否则为 false。

授权

使用此方法的脚本需要通过以下一个或多个范围进行授权：

• https://www.googleapis.com/auth/script.external_request

如需查看此方法的文档，请参阅 java.sql.Connection#isValid(int)。

参数

返回

Boolean - 如果连接有效，则为 true；否则为 false。如果超时期限在操作完成之前到期，也会返回 false。

授权

使用此方法的脚本需要通过以下一个或多个范围进行授权：

• https://www.googleapis.com/auth/script.external_request

如需查看此方法的文档，请参阅 java.sql.Connection#nativeSQL(String)。

参数

返回

String - 所提供语句的原生形式。

授权

使用此方法的脚本需要通过以下一个或多个范围进行授权：

• https://www.googleapis.com/auth/script.external_request

如需查看此方法的文档，请参阅 java.sql.Connection#prepareCall(String)。

参数

返回

JdbcCallableStatement - 包含预编译 SQL 语句的 Callable 语句。

如需查看此方法的文档，请参阅 java.sql.Connection#prepareCall(String, int, int)。

参数

返回

JdbcCallableStatement - 包含预编译 SQL 语句的 Callable 语句，该语句会生成具有提供的类型和并发的结果集。

如需查看此方法的文档，请参阅 java.sql.Connection#prepareCall(String, int, int, int)。

参数

返回

JdbcCallableStatement - 包含预编译 SQL 语句的 Callable 语句，该语句会生成具有所提供的类型、并发的结果集。

如需查看此方法的文档，请参阅 java.sql.Connection#prepareStatement(String)。

参数

返回

JdbcPreparedStatement - 准备好的语句，包含预编译的 SQL 语句。

如需查看此方法的文档，请参阅 java.sql.Connection#prepareStatement(String, int)。

参数

返回

JdbcPreparedStatement - 包含预编译 SQL 语句的准备好的语句，可能能够返回自动生成的键。

如需查看此方法的文档，请参阅 java.sql.Connection#prepareStatement(String, int, int)。

参数

返回

JdbcPreparedStatement - 包含预编译 SQL 语句的准备好的语句，可生成具有提供的类型和并发的结果集。

如需查看此方法的文档，请参阅 java.sql.Connection#prepareStatement(String, int, int, int)。

参数

返回

JdbcPreparedStatement - 一个预制语句，包含预编译的 SQL 语句，该语句会生成具有所提供的类型、并发和可存储性的结果集。

如需查看此方法的文档，请参阅 java.sql.Connection#prepareStatement(String, int[])。

参数

返回

JdbcPreparedStatement - 准备好的语句，包含预编译的 SQL 语句，能够返回由提供的列索引指定的自动生成的键。

如需查看此方法的文档，请参阅 java.sql.Connection#prepareStatement(String, String[])。

参数

返回

JdbcPreparedStatement - 包含预编译 SQL 语句的准备好的语句，能够返回通过提供的列名称指定的自动生成的键。

如需查看此方法的文档，请参阅 java.sql.Connection#releaseSavepoint(Savepoint)。

参数

授权

使用此方法的脚本需要通过以下一个或多个范围进行授权：

• https://www.googleapis.com/auth/script.external_request

如需查看此方法的文档，请参阅 java.sql.Connection#rollback()。

授权

使用此方法的脚本需要通过以下一个或多个范围进行授权：

• https://www.googleapis.com/auth/script.external_request

如需查看此方法的文档，请参阅 java.sql.Connection#rollback(Savepoint)。

参数

授权

使用此方法的脚本需要通过以下一个或多个范围进行授权：

• https://www.googleapis.com/auth/script.external_request

如需查看此方法的文档，请参阅 java.sql.Connection#setAutoCommit(boolean)。

参数

授权

使用此方法的脚本需要通过以下一个或多个范围进行授权：

• https://www.googleapis.com/auth/script.external_request

如需查看此方法的文档，请参阅 java.sql.Connection#setCatalog(String)。

参数

授权

使用此方法的脚本需要通过以下一个或多个范围进行授权：

• https://www.googleapis.com/auth/script.external_request

如需查看此方法的文档，请参阅 java.sql.Connection#setHoldability(int)。

参数

如需查看此方法的文档，请参阅 java.sql.Connection#setReadOnly(boolean)。

参数

授权

使用此方法的脚本需要通过以下一个或多个范围进行授权：

• https://www.googleapis.com/auth/script.external_request

如需查看此方法的文档，请参阅 java.sql.Connection#setSavepoint()。

返回

JdbcSavepoint - 未命名的新保存点。

授权

使用此方法的脚本需要通过以下一个或多个范围进行授权：

• https://www.googleapis.com/auth/script.external_request

如需查看此方法的文档，请参阅 java.sql.Connection#setSavepoint(String)。

参数

返回

JdbcSavepoint - 新的已命名保存点。

授权

使用此方法的脚本需要通过以下一个或多个范围进行授权：

• https://www.googleapis.com/auth/script.external_request

如需查看此方法的文档，请参阅 java.sql.Connection#setTransactionIsolation(int)。

参数

授权

使用此方法的脚本需要通过以下一个或多个范围进行授权：

• https://www.googleapis.com/auth/script.external_request