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 | SQL-имя типа элемента массива, зависящее от базы данных. Опции включают встроенные типы, определяемые пользователем типы или стандартные типы SQL, поддерживаемые базой данных. |
elements | Object[] | Элементы, которые необходимо заполнить в возвращаемом объекте. |
Возвращаться
JdbcArray — Массив, элементы которого соответствуют указанному типу SQL.
createBlob()
Создает экземпляр JdbcBlob . См. также java.sql.Connection#createBlob() .
Первоначально возвращенный объект не содержит данных. Вы можете использовать методы setBytes из JdbcBlob чтобы установить данные, которые он должен содержать. Используемый здесь большой двоичный объект отличается от большого двоичного объекта, созданного с помощью Utilities.newBlob(data) . Для преобразования между двумя форматами используйте определенные методы getBytes() и setBytes() . Альтернативно, как JdbcBlob , так и JdbcClob предоставляют удобный метод getAppsScriptBlob() для преобразования в формат, который может использоваться Apps Script.
Возвращаться
JdbcBlob — Пустой объект большого двоичного объекта.
createClob()
Документацию по этому методу см. в java.sql.Connection#createClob() .
Возвращаться
JdbcClob — Пустой объект clob.
createNClob()
Документацию по этому методу см. в java.sql.Connection#createNClob() .
Возвращаться
JdbcClob — Пустой объект nclob.
createSQLXML()
Документацию по этому методу см. в java.sql.Connection#createSQLXML() .
Возвращаться
JdbcSQLXML — пустой объект SQLXML.
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 | 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, который может содержать еще один '?' заполнители, обычно предоставляемые с использованием синтаксиса escape-вызовов JDBC. |
Возвращаться
JdbcCallableStatement — вызываемый оператор, содержащий предварительно скомпилированный оператор SQL.
prepareCall(sql, resultSetType, resultSetConcurrency)
Документацию по этому методу см. в java.sql.Connection#prepareCall(String, int, int) .
Параметры
| Имя | Тип | Описание |
|---|---|---|
sql | String | Оператор SQL, который может содержать еще один '?' заполнители, обычно предоставляемые с использованием синтаксиса escape-вызовов 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 | Оператор SQL, который может содержать еще один '?' заполнители, обычно предоставляемые с использованием синтаксиса escape-вызовов 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 | Оператор 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