JDBC Connection . Документацию по этому классу см. в разделе java.sql.Connection .
Методы
Подробная документация
clearWarnings()
Для получения документации по этому методу см. 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()
Делает все ожидающие изменения постоянными и снимает блокировки базы данных, удерживаемые этим JdbcConnection .
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()
createArrayOf(typeName, elements)
Для получения документации по этому методу см. java.sql.Connection#createArrayOf(String, Object[]) .
Параметры
| Имя | Тип | Описание |
|---|---|---|
type Name | String | SQL-имя типа элементов массива, специфичное для данной базы данных. Возможны варианты: встроенные типы, определяемые пользователем типы или стандартные SQL-типы, поддерживаемые базой данных. |
elements | Object[] | Элементы, которые необходимо заполнить в возвращаемом объекте. |
Возвращаться
JdbcArray — массив, элементы которого соответствуют указанному типу SQL.
createBlob()
Создает экземпляр JdbcBlob . См. также java.sql.Connection#createBlob() .
Возвращаемый объект изначально не содержит данных. Вы можете использовать методы setBytes класса JdbcBlob для установки данных, которые он должен содержать. Используемый здесь blob не совпадает с blob, созданным с помощью Utilities.newBlob(data) . Для преобразования между двумя форматами используйте определенные методы getBytes() и setBytes() . В качестве альтернативы, как JdbcBlob , так и JdbcClob предоставляют удобный метод getAppsScriptBlob() для преобразования в формат, который может использоваться Apps Script.
Возвращаться
JdbcBlob — пустой объект типа blob.
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 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();
Возвращаться
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) 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 . |
Возвращаться
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) 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 . |
Возвращаться
JdbcStatement — Экземпляр оператора для выполнения запросов.
createStruct(typeName, attributes)
Для получения документации по этому методу см. java.sql.Connection#createStruct(String, Object[]) .
Параметры
| Имя | Тип | Описание |
|---|---|---|
type Name | 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-запрос, который может содержать один или несколько символов-заполнителей '?', обычно предоставляемых с помощью синтаксиса экранирования вызовов JDBC. |
Возвращаться
JdbcCallableStatement — вызываемый оператор, содержащий предварительно скомпилированный SQL-запрос.
prepareCall(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 . |
Возвращаться
JdbcCallableStatement — вызываемый оператор, содержащий предварительно скомпилированный SQL-запрос, который формирует наборы результатов с указанным типом и уровнем параллельного выполнения.
prepareCall(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 . |
Возвращаться
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. |
auto Generated Keys | 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. |
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 . |
Возвращаться
JdbcPreparedStatement — Подготовленный запрос, содержащий предварительно скомпилированный SQL-запрос, который формирует наборы результатов с указанным типом и уровнем параллельного выполнения.
prepareStatement(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 . |
Возвращаться
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. |
column Names | String[] | Названия столбцов, указывающие, какие столбцы метод должен возвращать из вставленной строки или строк. |
Возвращаться
JdbcPreparedStatement — Подготовленный запрос, содержащий предварительно скомпилированный SQL-запрос, способный возвращать автоматически сгенерированные ключи, заданные предоставленными именами столбцов.
releaseSavepoint(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
setAutoCommit(autoCommit)
Для получения документации по этому методу см. java.sql.Connection#setAutoCommit(boolean) .
Параметры
| Имя | Тип | Описание |
|---|---|---|
auto Commit | 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 | По умолчанию объект Jdbc Result Set , созданный с помощью этого соединения, может быть заблокирован либо по умолчанию по адресу Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT , либо по Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT . |
setReadOnly(readOnly)
Для получения документации по этому методу см. java.sql.Connection#setReadOnly(boolean) .
Параметры
| Имя | Тип | Описание |
|---|---|---|
read Only | 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