JDBC Connection
。如需查看此类的文档,请参阅
java.sql.Connection
。
方法
详细文档
clearWarnings()
如需查看此方法的文档,请参阅 java.sql.Connection#clearWarnings()
。
授权
使用此方法的脚本需要通过以下一个或多个范围进行授权:
-
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();
授权
使用此方法的脚本需要通过以下一个或多个范围进行授权:
-
https://www.googleapis.com/auth/script.external_request
另请参阅
-
Connection.commit()
createArrayOf(typeName, elements)
如需查看此方法的文档,请参阅 java.sql.Connection#createArrayOf(String, Object[])
。
参数
名称 | 类型 | 说明 |
---|---|---|
typeName | String | 数组 elemnents' 类型的数据库特定 SQL 名称。选项包括内置类型、用户定义的类型或数据库支持的标准 SQL 类型。 |
elements | Object[] | 要在返回的对象中填充的元素。 |
返回
JdbcArray
- 其元素映射到指定 SQL 类型的数组。
createBlob()
构建 JdbcBlob
实例。另请参阅
java.sql.Connection#createBlob()
。
最初返回的对象不包含任何数据。您可以使用 JdbcBlob
的 setBytes
方法来设置它应包含的数据。此处使用的 blob 与使用 Utilities.newBlob(data)
创建的 blob 不同。如需在这两种格式之间进行转换,请使用定义的 getBytes()
和 setBytes()
方法。或者,JdbcBlob
和 JdbcClob
都提供了 getAppsScriptBlob()
简便方法,用于转换为 Apps 脚本可以使用的格式。
返回
JdbcBlob
- 空 blob 对象。
createClob()
createNClob()
createSQLXML()
createStatement()
创建一个 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
- 执行查询的语句实例。
createStatement(resultSetType, resultSetConcurrency)
创建一个 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();
参数
名称 | 类型 | 说明 |
---|---|---|
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)
创建一个 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();
参数
名称 | 类型 | 说明 |
---|---|---|
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 | 数组 elemnents' 类型的数据库特定 SQL 名称。选项包括内置类型、用户定义的类型或数据库支持的标准 SQL 类型。 |
attributes | Object[] | 填充所返回对象的属性。 |
返回
JdbcStruct
- 与给定 SQL 类型相对应并填充了给定属性的结构对象。
getAutoCommit()
如需查看此方法的文档,请参阅 java.sql.Connection#getAutoCommit()
。
返回
Boolean
- 如果连接启用了自动提交模式,则为 true
;否则为 false
。
授权
使用此方法的脚本需要通过以下一个或多个范围进行授权:
-
https://www.googleapis.com/auth/script.external_request
getCatalog()
或参阅此方法的文档,请参阅
java.sql.Connection#getCatalog()
。
返回
String
- 当前清单名称或 null
(如果未设置名称)。
授权
使用此方法的脚本需要通过以下一个或多个范围进行授权:
-
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
- 此连接所连接的数据库的元数据。
授权
使用此方法的脚本需要通过以下一个或多个范围进行授权:
-
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
。
授权
使用此方法的脚本需要通过以下一个或多个范围进行授权:
-
https://www.googleapis.com/auth/script.external_request
getWarnings()
如需查看此方法的文档,请参阅
java.sql.Connection#getWarnings()
。
返回
String[]
- 警告字符串数组。
授权
使用此方法的脚本需要通过以下一个或多个范围进行授权:
-
https://www.googleapis.com/auth/script.external_request
isClosed()
如需查看此方法的文档,请参阅
java.sql.Connection#isClosed()
。
返回
Boolean
- 如果连接关闭,则返回 true
;否则,返回 false
。
授权
使用此方法的脚本需要通过以下一个或多个范围进行授权:
-
https://www.googleapis.com/auth/script.external_request
isReadOnly()
如需查看此方法的文档,请参阅
java.sql.Connection#isReadOnly()
。
返回
Boolean
- 如果连接处于只读模式,则为 true
;否则为 false
。
授权
使用此方法的脚本需要通过以下一个或多个范围进行授权:
-
https://www.googleapis.com/auth/script.external_request
isValid(timeout)
如需查看此方法的文档,请参阅
java.sql.Connection#isValid(int)
。
参数
名称 | 类型 | 说明 |
---|---|---|
timeout | Integer | 等待验证操作完成的时间(以秒为单位)。值 0 表示未应用超时。 |
返回
Boolean
- 如果连接有效,则为 true
;否则为 false
。如果超时期限在操作完成之前到期,也会返回 false
。
授权
使用此方法的脚本需要通过以下一个或多个范围进行授权:
-
https://www.googleapis.com/auth/script.external_request
nativeSQL(sql)
如需查看此方法的文档,请参阅 java.sql.Connection#nativeSQL(String)
。
参数
名称 | 类型 | 说明 |
---|---|---|
sql | String | 可能包含一个或多个占位符的 SQL 语句。 |
返回
String
- 所提供语句的原生形式。
授权
使用此方法的脚本需要通过以下一个或多个范围进行授权:
-
https://www.googleapis.com/auth/script.external_request
prepareCall(sql)
如需查看此方法的文档,请参阅 java.sql.Connection#prepareCall(String)
。
参数
名称 | 类型 | 说明 |
---|---|---|
sql | String | 一个 SQL 语句可能包含一个或多个 '?' 占位符,通常使用 JDBC 调用转义语法提供。 |
返回
JdbcCallableStatement
- 包含预编译 SQL 语句的 Callable 语句。
prepareCall(sql, resultSetType, resultSetConcurrency)
如需查看此方法的文档,请参阅 java.sql.Connection#prepareCall(String, int, int)
。
参数
名称 | 类型 | 说明 |
---|---|---|
sql | String | 一个 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 语句的 Callable 语句,该语句会生成具有提供的类型和并发的结果集。
prepareCall(sql, resultSetType, resultSetConcurrency, resultSetHoldability)
如需查看此方法的文档,请参阅 java.sql.Connection#prepareCall(String, int, int, int)
。
参数
名称 | 类型 | 说明 |
---|---|---|
sql | String | 一个 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 语句的 Callable 语句,该语句会生成具有所提供的类型、并发的结果集。
prepareStatement(sql)
如需查看此方法的文档,请参阅 java.sql.Connection#prepareStatement(String)
。
参数
名称 | 类型 | 说明 |
---|---|---|
sql | String | 一个 SQL 语句,可以包含一个或多个 '?' IN 参数占位符。 |
返回
JdbcPreparedStatement
- 准备好的语句,包含预编译的 SQL 语句。
prepareStatement(sql, autoGeneratedKeys)
如需查看此方法的文档,请参阅 java.sql.Connection#prepareStatement(String, int)
。
参数
名称 | 类型 | 说明 |
---|---|---|
sql | String | 一个 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 | 一个 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 | 一个 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 | 一个 SQL 语句,可以包含一个或多个 '?' IN 参数占位符。 |
indices | Integer[] | 从插入的一行或多行返回的列索引。 |
返回
JdbcPreparedStatement
- 准备好的语句,包含预编译的 SQL 语句,能够返回由提供的列索引指定的自动生成的键。
prepareStatementByName(sql, columnNames)
如需查看此方法的文档,请参阅 java.sql.Connection#prepareStatement(String, String[])
。
参数
名称 | 类型 | 说明 |
---|---|---|
sql | String | 一个 SQL 语句,可以包含一个或多个 '?' IN 参数占位符。 |
columnNames | String[] | 列名称,用于指定方法应从插入的一行或多行返回哪些列。 |
返回
JdbcPreparedStatement
- 包含预编译 SQL 语句的准备好的语句,能够返回通过提供的列名称指定的自动生成的键。
releaseSavepoint(savepoint)
如需查看此方法的文档,请参阅 java.sql.Connection#releaseSavepoint(Savepoint)
。
参数
名称 | 类型 | 说明 |
---|---|---|
savepoint | JdbcSavepoint | 要移除的保存点。 |
授权
使用此方法的脚本需要通过以下一个或多个范围进行授权:
-
https://www.googleapis.com/auth/script.external_request
rollback()
如需查看此方法的文档,请参阅
java.sql.Connection#rollback()
。
授权
使用此方法的脚本需要通过以下一个或多个范围进行授权:
-
https://www.googleapis.com/auth/script.external_request
rollback(savepoint)
如需查看此方法的文档,请参阅 java.sql.Connection#rollback(Savepoint)
。
参数
名称 | 类型 | 说明 |
---|---|---|
savepoint | JdbcSavepoint | 要回滚到的保存点。 |
授权
使用此方法的脚本需要通过以下一个或多个范围进行授权:
-
https://www.googleapis.com/auth/script.external_request
setAutoCommit(autoCommit)
如需查看此方法的文档,请参阅 java.sql.Connection#setAutoCommit(boolean)
。
参数
名称 | 类型 | 说明 |
---|---|---|
autoCommit | Boolean | 如果为 true ,则表示启用自动提交模式;false 表示停用。 |
授权
使用此方法的脚本需要通过以下一个或多个范围进行授权:
-
https://www.googleapis.com/auth/script.external_request
setCatalog(catalog)
如需查看此方法的文档,请参阅 java.sql.Connection#setCatalog(String)
。
参数
名称 | 类型 | 说明 |
---|---|---|
catalog | String | 要在其中使用的目录(连接数据库中的子空间)的名称。 |
授权
使用此方法的脚本需要通过以下一个或多个范围进行授权:
-
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 表示停用。 |
授权
使用此方法的脚本需要通过以下一个或多个范围进行授权:
-
https://www.googleapis.com/auth/script.external_request
setSavepoint()
如需查看此方法的文档,请参阅
java.sql.Connection#setSavepoint()
。
返回
JdbcSavepoint
- 未命名的新保存点。
授权
使用此方法的脚本需要通过以下一个或多个范围进行授权:
-
https://www.googleapis.com/auth/script.external_request
setSavepoint(name)
如需查看此方法的文档,请参阅 java.sql.Connection#setSavepoint(String)
。
参数
名称 | 类型 | 说明 |
---|---|---|
name | String | 创建的保存点的名称。 |
返回
JdbcSavepoint
- 新的已命名保存点。
授权
使用此方法的脚本需要通过以下一个或多个范围进行授权:
-
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 。 |
授权
使用此方法的脚本需要通过以下一个或多个范围进行授权:
-
https://www.googleapis.com/auth/script.external_request