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