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
чтобы установить данные, которые он должен содержать. Используемый здесь большой двоичный объект отличается от большого двоичного объекта, созданного с помощью Utilities.newBlob(data)
. Для преобразования между двумя форматами используйте определенные методы get Bytes()
и set Bytes()
. Альтернативно, как Jdbc Blob
, так и Jdbc Clob
предоставляют удобный метод get Apps Script Blob()
для преобразования в формат, который может использоваться Apps Script.
Возвращаться
Jdbc 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, который может содержать еще один '?' заполнители, обычно предоставляемые с использованием синтаксиса escape-вызовов JDBC. |
Возвращаться
Jdbc Callable Statement
— вызываемый оператор, содержащий предварительно скомпилированный оператор SQL.
prepare Call(sql, resultSetType, resultSetConcurrency)
Документацию по этому методу см. в java.sql.Connection#prepareCall(String, int, int)
.
Параметры
Имя | Тип | Описание |
---|---|---|
sql | String | Оператор SQL, который может содержать еще один '?' заполнители, обычно предоставляемые с использованием синтаксиса escape-вызовов 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, который может содержать еще один '?' заполнители, обычно предоставляемые с использованием синтаксиса escape-вызовов 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, который может содержать еще один '?' Заполнители параметров IN. |
Возвращаться
Jdbc Prepared Statement
— подготовленный оператор, содержащий предварительно скомпилированный оператор SQL.
prepare Statement(sql, autoGeneratedKeys)
Документацию по этому методу см. в java.sql.Connection#prepareStatement(String, int)
.
Параметры
Имя | Тип | Описание |
---|---|---|
sql | String | Оператор SQL, который может содержать еще один '?' Заполнители параметров IN. |
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, который может содержать еще один '?' Заполнители параметров IN. |
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, который может содержать еще один '?' Заполнители параметров IN. |
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, который может содержать еще один '?' Заполнители параметров IN. |
indices | Integer[] | Индексы столбцов, возвращаемых из вставленной строки или строк. |
Возвращаться
Jdbc Prepared Statement
— подготовленный оператор, содержащий предварительно скомпилированный оператор SQL, способный возвращать автоматически сгенерированные ключи, указанные в предоставленных индексах столбцов.
prepare Statement By Name(sql, columnNames)
Документацию по этому методу см. в java.sql.Connection#prepareStatement(String, String[])
.
Параметры
Имя | Тип | Описание |
---|---|---|
sql | String | Оператор SQL, который может содержать еще один '?' Заполнители параметров IN. |
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