JDBC- Connection
. Документацию по этому классу см. в java.sql.Connection
.
Методы
Подробная документация
clear Warnings()
Документацию по этому методу см. в java.sql.Connection#clearWarnings()
.
Авторизация
Скрипты, использующие этот метод, требуют авторизации в одной или нескольких из следующих областей :
-
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 Connection
.
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();
Авторизация
Скрипты, использующие этот метод, требуют авторизации в одной или нескольких из следующих областей :
-
https://www.googleapis.com/auth/script.external_request
Смотрите также
-
Connection.commit()
create Array Of(typeName, elements)
Документацию по этому методу см. в java.sql.Connection#createArrayOf(String, Object[])
.
Параметры
Имя | Тип | Описание |
---|---|---|
type Name | String | Имя SQL, специфичное для базы данных, для типа элементов массива. Возможные варианты: встроенные типы, пользовательские типы или стандартные типы SQL, поддерживаемые базой данных. |
elements | Object[] | Элементы для заполнения возвращаемого объекта. |
Возвращаться
Jdbc Array
— массив, элементы которого соответствуют указанному типу SQL.
create Blob()
Создаёт экземпляр Jdbc Blob
. См. также java.sql.Connection#createBlob()
.
Возвращаемый объект изначально не содержит данных. Вы можете использовать методы set Bytes
объекта Jdbc Blob
чтобы задать данные, которые он должен содержать. Используемый здесь объект blob отличается от объекта, созданного с помощью Utilities.newBlob(data)
. Для преобразования между двумя форматами используйте определённые методы get Bytes()
и set Bytes()
. Кроме того, как Jdbc Blob
, так и Jdbc Clob
предоставляют удобный метод get Apps Script Blob()
для преобразования в формат, который может использоваться Apps Script.
Возвращаться
Jdbc Blob
— пустой объект blob.
create Clob()
Документацию по этому методу см. в java.sql.Connection#createClob()
.
Возвращаться
Jdbc Clob
— пустой объект clob.
create NClob()
Документацию по этому методу см. в java.sql.Connection#createNClob()
.
Возвращаться
Jdbc Clob
— пустой объект nclob.
create SQLXML()
Документацию по этому методу см. java.sql.Connection#createSQLXML()
.
Возвращаться
Jdbc SQLXML
— пустой объект SQLXML.
create Statement()
Создаёт объект Jdbc Statement
для отправки SQL-запросов в базу данных. См. также 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 Statement
— экземпляр оператора для выполнения запросов.
create Statement(resultSetType, resultSetConcurrency)
Создаёт объект Jdbc Statement
для отправки 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) 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 Set Type | Integer | Тип набора результатов; один из Jdbc.ResultSet.TYPE_FORWARD_ONLY , Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE или Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE . |
result Set Concurrency | Integer | Тип параллелизма: Jdbc.ResultSet.CONCUR_READ_ONLY или Jdbc.ResultSet.CONCUR_UPDATABLE . |
Возвращаться
Jdbc Statement
— экземпляр оператора для выполнения запросов.
create Statement(resultSetType, resultSetConcurrency, resultSetHoldability)
Создаёт объект Jdbc Statement
для отправки 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) 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 Set Type | Integer | Тип набора результатов; один из Jdbc.ResultSet.TYPE_FORWARD_ONLY , Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE или Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE . |
result Set Concurrency | Integer | Тип параллелизма: Jdbc.ResultSet.CONCUR_READ_ONLY или Jdbc.ResultSet.CONCUR_UPDATABLE . |
result Set Holdability | Integer | Настройка удержания: Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT или Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT . |
Возвращаться
Jdbc Statement
— экземпляр оператора для выполнения запросов.
create Struct(typeName, attributes)
Документацию по этому методу см. в java.sql.Connection#createStruct(String, Object[])
.
Параметры
Имя | Тип | Описание |
---|---|---|
type Name | String | Имя SQL, специфичное для базы данных, для типа элементов массива. Возможные варианты: встроенные типы, пользовательские типы или стандартные типы SQL, поддерживаемые базой данных. |
attributes | Object[] | Атрибуты, заполняющие возвращаемый объект. |
Возвращаться
Jdbc Struct
— объект структуры, который сопоставляется с заданным типом SQL и заполняется заданными атрибутами.
get Auto Commit()
Документацию по этому методу см. java.sql.Connection#getAutoCommit()
.
Возвращаться
Boolean
— true
если режим автоматического подтверждения соединения включен; в противном случае false
.
Авторизация
Скрипты, использующие этот метод, требуют авторизации в одной или нескольких из следующих областей :
-
https://www.googleapis.com/auth/script.external_request
get Catalog()
или документацию по этому методу см. java.sql.Connection#getCatalog()
.
Возвращаться
String
— текущее имя каталога или null
, если имя не задано.
Авторизация
Скрипты, использующие этот метод, требуют авторизации в одной или нескольких из следующих областей :
-
https://www.googleapis.com/auth/script.external_request
get Holdability()
Документацию по этому методу см. в java.sql.Connection#getHoldability()
.
Возвращаться
Integer
— настройка удерживаемости соединения: Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT
или Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT
.
get Meta Data()
Документацию по этому методу см. java.sql.Connection#getMetaData()
.
Возвращаться
Jdbc Database Meta Data
— метаданные базы данных, к которой подключается это соединение.
Авторизация
Скрипты, использующие этот метод, требуют авторизации в одной или нескольких из следующих областей :
-
https://www.googleapis.com/auth/script.external_request
get Transaction Isolation()
Документацию по этому методу см. 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
get Warnings()
Документацию по этому методу см. в java.sql.Connection#getWarnings()
.
Возвращаться
String[]
— Массив строк предупреждений.
Авторизация
Скрипты, использующие этот метод, требуют авторизации в одной или нескольких из следующих областей :
-
https://www.googleapis.com/auth/script.external_request
is Closed()
Документацию по этому методу см. в java.sql.Connection#isClosed()
.
Возвращаться
Boolean
— true
, если соединение закрыто; в противном случае false
.
Авторизация
Скрипты, использующие этот метод, требуют авторизации в одной или нескольких из следующих областей :
-
https://www.googleapis.com/auth/script.external_request
is Read Only()
Документацию по этому методу см. в java.sql.Connection#isReadOnly()
.
Возвращаться
Boolean
— true
если соединение доступно только для чтения; в противном случае false
.
Авторизация
Скрипты, использующие этот метод, требуют авторизации в одной или нескольких из следующих областей :
-
https://www.googleapis.com/auth/script.external_request
is Valid(timeout)
Документацию по этому методу см. в java.sql.Connection#isValid(int)
.
Параметры
Имя | Тип | Описание |
---|---|---|
timeout | Integer | Время ожидания завершения операции проверки (в секундах). Значение 0 указывает на отсутствие тайм-аута. |
Возвращаться
Boolean
— true
, если соединение установлено; false
в противном случае. Также возвращает false
если время ожидания истекает до завершения операции.
Авторизация
Скрипты, использующие этот метод, требуют авторизации в одной или нескольких из следующих областей :
-
https://www.googleapis.com/auth/script.external_request
native SQL(sql)
Документацию по этому методу см. в java.sql.Connection#nativeSQL(String)
.
Параметры
Имя | Тип | Описание |
---|---|---|
sql | String | Оператор SQL, который может содержать еще один заполнитель «?». |
Возвращаться
String
— Собственная форма предоставленного оператора.
Авторизация
Скрипты, использующие этот метод, требуют авторизации в одной или нескольких из следующих областей :
-
https://www.googleapis.com/auth/script.external_request
prepare Call(sql)
Документацию по этому методу см. в java.sql.Connection#prepareCall(String)
.
Параметры
Имя | Тип | Описание |
---|---|---|
sql | String | Оператор SQL, который может содержать еще один заполнитель «?», обычно предоставляемый с использованием синтаксиса экранирования вызовов JDBC. |
Возвращаться
Jdbc Callable Statement
— вызываемый оператор, содержащий предварительно скомпилированный оператор SQL.
prepare Call(sql, resultSetType, resultSetConcurrency)
Документацию по этому методу см. в java.sql.Connection#prepareCall(String, int, int)
.
Параметры
Имя | Тип | Описание |
---|---|---|
sql | String | Оператор SQL, который может содержать еще один заполнитель «?», обычно предоставляемый с использованием синтаксиса экранирования вызовов JDBC. |
result Set Type | Integer | Тип набора результатов; один из Jdbc.ResultSet.TYPE_FORWARD_ONLY , Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE или Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE . |
result Set Concurrency | Integer | Тип параллелизма: Jdbc.ResultSet.CONCUR_READ_ONLY или Jdbc.ResultSet.CONCUR_UPDATABLE . |
Возвращаться
Jdbc Callable Statement
— вызываемый оператор, содержащий предварительно скомпилированный оператор SQL, который создает наборы результатов с заданным типом и параллелизмом.
prepare Call(sql, resultSetType, resultSetConcurrency, resultSetHoldability)
Документацию по этому методу см. в java.sql.Connection#prepareCall(String, int, int, int)
.
Параметры
Имя | Тип | Описание |
---|---|---|
sql | String | Оператор SQL, который может содержать еще один заполнитель «?», обычно предоставляемый с использованием синтаксиса экранирования вызовов JDBC. |
result Set Type | Integer | Тип набора результатов; один из Jdbc.ResultSet.TYPE_FORWARD_ONLY , Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE или Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE . |
result Set Concurrency | Integer | Тип параллелизма: Jdbc.ResultSet.CONCUR_READ_ONLY или Jdbc.ResultSet.CONCUR_UPDATABLE . |
result Set Holdability | Integer | Настройка удержания: Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT или Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT . |
Возвращаться
Jdbc Callable Statement
— вызываемый оператор, содержащий предварительно скомпилированный оператор SQL, который создает наборы результатов с предоставленным типом параллелизма.
prepare Statement(sql)
Документацию по этому методу см. в java.sql.Connection#prepareStatement(String)
.
Параметры
Имя | Тип | Описание |
---|---|---|
sql | String | Оператор SQL, который может содержать еще один параметр-заполнитель «?». |
Возвращаться
Jdbc Prepared Statement
— подготовленный оператор, содержащий предварительно скомпилированный оператор SQL.
prepare Statement(sql, autoGeneratedKeys)
Документацию по этому методу см. в java.sql.Connection#prepareStatement(String, int)
.
Параметры
Имя | Тип | Описание |
---|---|---|
sql | String | Оператор SQL, который может содержать еще один параметр-заполнитель «?». |
auto Generated Keys | Integer | Флаг, указывающий, возвращаются ли автоматически сгенерированные ключи: Jdbc.Statement.RETURN_GENERATED_KEYS или Jdbc.Statement.NO_GENERATED_KEYS . |
Возвращаться
Jdbc Prepared Statement
— подготовленный оператор, содержащий предварительно скомпилированный оператор SQL, возможно, способный возвращать автоматически сгенерированные ключи.
prepare Statement(sql, resultSetType, resultSetConcurrency)
Документацию по этому методу см. в java.sql.Connection#prepareStatement(String, int, int)
.
Параметры
Имя | Тип | Описание |
---|---|---|
sql | String | Оператор SQL, который может содержать еще один параметр-заполнитель «?». |
result Set Type | Integer | Тип набора результатов; один из Jdbc.ResultSet.TYPE_FORWARD_ONLY , Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE или Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE . |
result Set Concurrency | Integer | Тип параллелизма: Jdbc.ResultSet.CONCUR_READ_ONLY или Jdbc.ResultSet.CONCUR_UPDATABLE . |
Возвращаться
Jdbc Prepared Statement
— подготовленный оператор, содержащий предварительно скомпилированный оператор SQL, который создает наборы результатов с заданным типом и параллелизмом.
prepare Statement(sql, resultSetType, resultSetConcurrency, resultSetHoldability)
Документацию по этому методу см. в java.sql.Connection#prepareStatement(String, int, int, int)
.
Параметры
Имя | Тип | Описание |
---|---|---|
sql | String | Оператор SQL, который может содержать еще один параметр-заполнитель «?». |
result Set Type | Integer | Тип набора результатов; один из Jdbc.ResultSet.TYPE_FORWARD_ONLY , Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE или Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE . |
result Set Concurrency | Integer | Тип параллелизма: Jdbc.ResultSet.CONCUR_READ_ONLY или Jdbc.ResultSet.CONCUR_UPDATABLE . |
result Set Holdability | Integer | Настройка удержания: Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT или Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT . |
Возвращаться
Jdbc Prepared Statement
— подготовленный оператор, содержащий предварительно скомпилированный оператор SQL, который создает наборы результатов с заданным типом, параллелизмом и возможностью удержания.
prepare Statement By Index(sql, indices)
Документацию по этому методу см. в java.sql.Connection#prepareStatement(String, int[])
.
Параметры
Имя | Тип | Описание |
---|---|---|
sql | String | Оператор SQL, который может содержать еще один параметр-заполнитель «?». |
indices | Integer[] | Индексы столбцов, возвращаемых из вставленной строки или строк. |
Возвращаться
Jdbc Prepared Statement
— подготовленный оператор, содержащий предварительно скомпилированный оператор SQL, способный возвращать автоматически сгенерированные ключи, заданные предоставленными индексами столбцов.
prepare Statement By Name(sql, columnNames)
Документацию по этому методу см. в java.sql.Connection#prepareStatement(String, String[])
.
Параметры
Имя | Тип | Описание |
---|---|---|
sql | String | Оператор SQL, который может содержать еще один параметр-заполнитель «?». |
column Names | String[] | Имена столбцов, которые указывают, какие столбцы метод должен вернуть из вставленной строки или строк. |
Возвращаться
Jdbc Prepared Statement
— подготовленный оператор, содержащий предварительно скомпилированный оператор SQL, способный возвращать автоматически сгенерированные ключи, заданные предоставленными именами столбцов.
release Savepoint(savepoint)
Документацию по этому методу см. в java.sql.Connection#releaseSavepoint(Savepoint)
.
Параметры
Имя | Тип | Описание |
---|---|---|
savepoint | Jdbc Savepoint | Точка сохранения, которую необходимо удалить. |
Авторизация
Скрипты, использующие этот метод, требуют авторизации в одной или нескольких из следующих областей :
-
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 | Jdbc Savepoint | Точка сохранения, к которой необходимо откатиться. |
Авторизация
Скрипты, использующие этот метод, требуют авторизации в одной или нескольких из следующих областей :
-
https://www.googleapis.com/auth/script.external_request
set Auto Commit(autoCommit)
Документацию по этому методу см. в java.sql.Connection#setAutoCommit(boolean)
.
Параметры
Имя | Тип | Описание |
---|---|---|
auto Commit | Boolean | Если true , режим автоматической фиксации включен; false отключён. |
Авторизация
Скрипты, использующие этот метод, требуют авторизации в одной или нескольких из следующих областей :
-
https://www.googleapis.com/auth/script.external_request
set Catalog(catalog)
Документацию по этому методу см. в java.sql.Connection#setCatalog(String)
.
Параметры
Имя | Тип | Описание |
---|---|---|
catalog | String | Имя каталога (подпространства в базе данных соединения), в котором следует работать. |
Авторизация
Скрипты, использующие этот метод, требуют авторизации в одной или нескольких из следующих областей :
-
https://www.googleapis.com/auth/script.external_request
set Holdability(holdability)
Документацию по этому методу см. в java.sql.Connection#setHoldability(int)
.
Параметры
Имя | Тип | Описание |
---|---|---|
holdability | Integer | Удерживание по умолчанию объектов Jdbc Result Set созданных с помощью этого соединения: Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT или Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT . |
set Read Only(readOnly)
Документацию по этому методу см. в java.sql.Connection#setReadOnly(boolean)
.
Параметры
Имя | Тип | Описание |
---|---|---|
read Only | Boolean | Если true , режим только для чтения включен; false отключает. |
Авторизация
Скрипты, использующие этот метод, требуют авторизации в одной или нескольких из следующих областей :
-
https://www.googleapis.com/auth/script.external_request
set Savepoint()
Документацию по этому методу см. в java.sql.Connection#setSavepoint()
.
Возвращаться
Jdbc Savepoint
— новая безымянная точка сохранения.
Авторизация
Скрипты, использующие этот метод, требуют авторизации в одной или нескольких из следующих областей :
-
https://www.googleapis.com/auth/script.external_request
set Savepoint(name)
Документацию по этому методу см. в java.sql.Connection#setSavepoint(String)
.
Параметры
Имя | Тип | Описание |
---|---|---|
name | String | Имя созданной точки сохранения. |
Возвращаться
Jdbc Savepoint
— новая именованная точка сохранения.
Авторизация
Скрипты, использующие этот метод, требуют авторизации в одной или нескольких из следующих областей :
-
https://www.googleapis.com/auth/script.external_request
set Transaction Isolation(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