Un objeto Connection
de JDBC. Para obtener documentación sobre esta clase, consulta
java.sql.Connection
.
Métodos
Documentación detallada
clear Warnings()
Para obtener documentación sobre este método, consulta
java.sql.Connection#clearWarnings()
.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/script.external_request
close()
Libera la base de datos de esta conexión y todos los recursos asociados.
const conn = Jdbc.getConnection( 'jdbc:mysql://<host>:<port>/<instance>', 'user', 'password', ); conn.close();
Consulta también
-
Connection.close()
commit()
Hace que todos los cambios pendientes sean permanentes y libera los bloqueos de la base de datos que mantiene este Jdbc
.
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();
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/script.external_request
Consulta también
-
Connection.commit()
create Array Of(typeName, elements)
Para obtener documentación sobre este método, consulta
java.sql.Connection#createArrayOf(String, Object[])
.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
type | String | Nombre SQL específico de la base de datos del tipo de los elementos del array. Las opciones incluyen tipos integrados, tipos definidos por el usuario o tipos de SQL estándar admitidos por la base de datos. |
elements | Object[] | Elementos que se propagarán en el objeto devuelto. |
Volver
Jdbc
: Es un array cuyos elementos se asignan al tipo de SQL especificado.
create Blob()
Construye una instancia de Jdbc
. Consulta también
java.sql.Connection#createBlob()
.
El objeto que se devuelve inicialmente no contiene datos. Puedes usar los métodos set
de Jdbc
para establecer los datos que debe contener. El BLOB que se usa aquí no es el mismo que el que se creó con Utilities.newBlob(data)
. Para convertir entre los dos formatos, usa los métodos get
y set
definidos.
Como alternativa, Jdbc
y Jdbc
proporcionan un método de conveniencia get
para convertir a un formato que se puede usar con Apps Script.
Volver
Jdbc
: Es un objeto blob vacío.
create Clob()
Para obtener documentación sobre este método, consulta
java.sql.Connection#createClob()
.
Volver
Jdbc
: Es un objeto CLOB vacío.
create NClob()
Para obtener documentación sobre este método, consulta
java.sql.Connection#createNClob()
.
Volver
Jdbc
: Es un objeto nclob vacío.
create SQLXML()
Para obtener documentación sobre este método, consulta
java.sql.Connection#createSQLXML()
.
Volver
Jdbc
: Es un objeto SQLXML vacío.
create Statement()
Crea un objeto Jdbc
para enviar instrucciones SQL a la base de datos. Consulta también
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();
Volver
Jdbc
: Es una instancia de instrucción para ejecutar consultas.
create Statement(resultSetType, resultSetConcurrency)
Crea un objeto Jdbc
para enviar instrucciones SQL a la base de datos. Consulta también
java.sql.Connection#createStatement(int, int)
.
Esta versión permite anular el tipo de conjunto de resultados y la simultaneidad.
// 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();
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
result | Integer | Es un tipo de conjunto de resultados; puede ser Jdbc.ResultSet.TYPE_FORWARD_ONLY , Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE o Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE . |
result | Integer | Es un tipo de simultaneidad, ya sea Jdbc.ResultSet.CONCUR_READ_ONLY o Jdbc.ResultSet.CONCUR_UPDATABLE . |
Volver
Jdbc
: Es una instancia de instrucción para ejecutar consultas.
create Statement(resultSetType, resultSetConcurrency, resultSetHoldability)
Crea un objeto Jdbc
para enviar instrucciones SQL a la base de datos. Consulta también
java.sql.Connection#createStatement(int, int, int)
.
Esta versión permite anular el tipo de conjunto de resultados, la simultaneidad y la capacidad de retención.
// 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();
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
result | Integer | Es un tipo de conjunto de resultados; puede ser Jdbc.ResultSet.TYPE_FORWARD_ONLY , Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE o Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE . |
result | Integer | Es un tipo de simultaneidad, ya sea Jdbc.ResultSet.CONCUR_READ_ONLY o Jdbc.ResultSet.CONCUR_UPDATABLE . |
result | Integer | Es un parámetro de configuración de retención, ya sea Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT o Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT . |
Volver
Jdbc
: Es una instancia de instrucción para ejecutar consultas.
create Struct(typeName, attributes)
Para obtener documentación sobre este método, consulta
java.sql.Connection#createStruct(String, Object[])
.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
type | String | Nombre SQL específico de la base de datos del tipo de los elementos del array. Las opciones incluyen tipos integrados, tipos definidos por el usuario o tipos de SQL estándar admitidos por la base de datos. |
attributes | Object[] | Son los atributos que completan el objeto devuelto. |
Volver
Jdbc
: Es un objeto de estructura que se asigna al tipo de SQL determinado y se propaga con los atributos determinados.
get Auto Commit()
Para obtener documentación sobre este método, consulta
java.sql.Connection#getAutoCommit()
.
Volver
Boolean
: true
si el modo de confirmación automática de la conexión está habilitado; de lo contrario, false
.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/script.external_request
get Catalog()
o la documentación de este método, consulta
java.sql.Connection#getCatalog()
.
Volver
String
: Es el nombre del catálogo actual o null
si no se configuró ningún nombre.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/script.external_request
get Holdability()
Para obtener documentación sobre este método, consulta
java.sql.Connection#getHoldability()
.
Volver
Integer
: Es el parámetro de configuración de la capacidad de retención de la conexión, que puede ser Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT
o Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT
.
get Meta Data()
Para obtener documentación sobre este método, consulta
java.sql.Connection#getMetaData()
.
Volver
Jdbc
: Son los metadatos de la base de datos a la que se conecta esta conexión.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/script.external_request
get Transaction Isolation()
Para obtener documentación sobre este método, consulta
java.sql.Connection#getTransactionIsolation()
.
Volver
Integer
: Es el nivel de transacción actual, que puede ser uno de los siguientes: Jdbc.Connection.TRANSACTION_READ_UNCOMMITTED
, Jdbc.Connection.TRANSACTION_READ_COMMITTED
, Jdbc.Connection.TRANSACTION_REPEATABLE_READ
, Jdbc.Connection.TRANSACTION_SERIALIZABLE
o Jdbc.Connection.TRANSACTION_NONE
.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/script.external_request
get Warnings()
Para obtener documentación sobre este método, consulta
java.sql.Connection#getWarnings()
.
Volver
String[]
: Es un array de cadenas de advertencia.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/script.external_request
is Closed()
Para obtener documentación sobre este método, consulta
java.sql.Connection#isClosed()
.
Volver
Boolean
: true
si la conexión está cerrada; false
en caso contrario.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/script.external_request
is Read Only()
Para obtener documentación sobre este método, consulta
java.sql.Connection#isReadOnly()
.
Volver
Boolean
: true
si la conexión es de solo lectura; de lo contrario, false
.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/script.external_request
is Valid(timeout)
Para obtener documentación sobre este método, consulta
java.sql.Connection#isValid(int)
.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
timeout | Integer | Es el tiempo en segundos que se espera a que se complete la operación de validación. Un valor de 0 indica que no se aplica ningún tiempo de espera. |
Volver
Boolean
: true
si la conexión es válida; de lo contrario, false
. También devuelve false
si vence el período de tiempo de espera antes de que se complete la operación.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/script.external_request
native SQL(sql)
Para obtener documentación sobre este método, consulta
java.sql.Connection#nativeSQL(String)
.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
sql | String | Es una instrucción de SQL que puede contener uno o más marcadores de posición "?". |
Volver
String
: Es la forma nativa de la declaración proporcionada.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/script.external_request
prepare Call(sql)
Para obtener documentación sobre este método, consulta
java.sql.Connection#prepareCall(String)
.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
sql | String | Es una instrucción SQL que puede contener uno o más marcadores de posición "?", que se suelen proporcionar con la sintaxis de escape de llamadas JDBC. |
Volver
Jdbc
: Es una instrucción invocable que contiene la instrucción de SQL precompilada.
prepare Call(sql, resultSetType, resultSetConcurrency)
Para obtener documentación sobre este método, consulta
java.sql.Connection#prepareCall(String, int, int)
.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
sql | String | Es una instrucción SQL que puede contener uno o más marcadores de posición "?", que se suelen proporcionar con la sintaxis de escape de llamadas JDBC. |
result | Integer | Es un tipo de conjunto de resultados; puede ser Jdbc.ResultSet.TYPE_FORWARD_ONLY , Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE o Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE . |
result | Integer | Es un tipo de simultaneidad, ya sea Jdbc.ResultSet.CONCUR_READ_ONLY o Jdbc.ResultSet.CONCUR_UPDATABLE . |
Volver
Jdbc
: Es una instrucción invocable que contiene la instrucción de SQL precompilada que produce conjuntos de resultados con el tipo y la simultaneidad proporcionados.
prepare Call(sql, resultSetType, resultSetConcurrency, resultSetHoldability)
Para obtener documentación sobre este método, consulta
java.sql.Connection#prepareCall(String, int, int, int)
.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
sql | String | Es una instrucción SQL que puede contener uno o más marcadores de posición "?", que se suelen proporcionar con la sintaxis de escape de llamadas JDBC. |
result | Integer | Es un tipo de conjunto de resultados; puede ser Jdbc.ResultSet.TYPE_FORWARD_ONLY , Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE o Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE . |
result | Integer | Es un tipo de simultaneidad, ya sea Jdbc.ResultSet.CONCUR_READ_ONLY o Jdbc.ResultSet.CONCUR_UPDATABLE . |
result | Integer | Es un parámetro de configuración de retención, ya sea Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT o Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT . |
Volver
Jdbc
: Es una instrucción invocable que contiene la instrucción de SQL precompilada que produce conjuntos de resultados con el tipo y la simultaneidad proporcionados.
prepare Statement(sql)
Para obtener documentación sobre este método, consulta
java.sql.Connection#prepareStatement(String)
.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
sql | String | Es una instrucción SQL que puede contener uno o más marcadores de posición de parámetros IN "?". |
Volver
Jdbc
: Es una sentencia preparada que contiene la sentencia de SQL precompilada.
prepare Statement(sql, autoGeneratedKeys)
Para obtener documentación sobre este método, consulta
java.sql.Connection#prepareStatement(String, int)
.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
sql | String | Es una instrucción SQL que puede contener uno o más marcadores de posición de parámetros IN "?". |
auto | Integer | Es una marca que indica si se devuelven claves generadas automáticamente; puede ser Jdbc.Statement.RETURN_GENERATED_KEYS o Jdbc.Statement.NO_GENERATED_KEYS . |
Volver
Jdbc
: Es una instrucción preparada que contiene la instrucción de SQL precompilada, posiblemente capaz de devolver claves generadas automáticamente.
prepare Statement(sql, resultSetType, resultSetConcurrency)
Para obtener documentación sobre este método, consulta
java.sql.Connection#prepareStatement(String, int, int)
.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
sql | String | Es una instrucción SQL que puede contener uno o más marcadores de posición de parámetros IN "?". |
result | Integer | Es un tipo de conjunto de resultados; puede ser Jdbc.ResultSet.TYPE_FORWARD_ONLY , Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE o Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE . |
result | Integer | Es un tipo de simultaneidad, ya sea Jdbc.ResultSet.CONCUR_READ_ONLY o Jdbc.ResultSet.CONCUR_UPDATABLE . |
Volver
Jdbc
: Es una instrucción preparada que contiene la instrucción de SQL precompilada que produce conjuntos de resultados con el tipo y la simultaneidad proporcionados.
prepare Statement(sql, resultSetType, resultSetConcurrency, resultSetHoldability)
Para obtener documentación sobre este método, consulta
java.sql.Connection#prepareStatement(String, int, int, int)
.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
sql | String | Es una instrucción SQL que puede contener uno o más marcadores de posición de parámetros IN "?". |
result | Integer | Es un tipo de conjunto de resultados; puede ser Jdbc.ResultSet.TYPE_FORWARD_ONLY , Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE o Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE . |
result | Integer | Es un tipo de simultaneidad, ya sea Jdbc.ResultSet.CONCUR_READ_ONLY o Jdbc.ResultSet.CONCUR_UPDATABLE . |
result | Integer | Es un parámetro de configuración de retención, ya sea Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT o Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT . |
Volver
Jdbc
: Es una instrucción preparada que contiene la instrucción de SQL precompilada que produce conjuntos de resultados con el tipo, la simultaneidad y la capacidad de retención proporcionados.
prepare Statement By Index(sql, indices)
Para obtener documentación sobre este método, consulta
java.sql.Connection#prepareStatement(String, int[])
.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
sql | String | Es una instrucción SQL que puede contener uno o más marcadores de posición de parámetros IN "?". |
indices | Integer[] | Son los índices de las columnas que se devuelven de las filas insertadas. |
Volver
Jdbc
: Es una instrucción preparada que contiene la instrucción SQL precompilada, capaz de devolver claves generadas automáticamente especificadas por los índices de columna proporcionados.
prepare Statement By Name(sql, columnNames)
Para obtener documentación sobre este método, consulta
java.sql.Connection#prepareStatement(String, String[])
.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
sql | String | Es una instrucción SQL que puede contener uno o más marcadores de posición de parámetros IN "?". |
column | String[] | Son los nombres de las columnas que especifican qué columnas debe devolver el método de las filas insertadas. |
Volver
Jdbc
: Es una instrucción preparada que contiene la instrucción de SQL precompilada, capaz de devolver claves generadas automáticamente especificadas por los nombres de columna proporcionados.
release Savepoint(savepoint)
Para obtener documentación sobre este método, consulta
java.sql.Connection#releaseSavepoint(Savepoint)
.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
savepoint | Jdbc | Es el punto de guardado que se quitará. |
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/script.external_request
rollback()
Para obtener documentación sobre este método, consulta
java.sql.Connection#rollback()
.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/script.external_request
rollback(savepoint)
Para obtener documentación sobre este método, consulta
java.sql.Connection#rollback(Savepoint)
.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
savepoint | Jdbc | Es el punto de guardado al que se revertirá. |
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/script.external_request
set Auto Commit(autoCommit)
Para obtener documentación sobre este método, consulta
java.sql.Connection#setAutoCommit(boolean)
.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
auto | Boolean | Si es true , se habilita el modo de confirmación automática; false inhabilita. |
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/script.external_request
set Catalog(catalog)
Para obtener documentación sobre este método, consulta
java.sql.Connection#setCatalog(String)
.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
catalog | String | Nombre de un catálogo (el subespacio en la base de datos de la conexión) en el que se trabajará. |
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/script.external_request
set Holdability(holdability)
Para obtener documentación sobre este método, consulta
java.sql.Connection#setHoldability(int)
.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
holdability | Integer | Es la capacidad de retención predeterminada de los objetos Jdbc creados con esta conexión, que puede ser Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT o Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT . |
set Read Only(readOnly)
Para obtener documentación sobre este método, consulta
java.sql.Connection#setReadOnly(boolean)
.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
read | Boolean | Si es true , se habilita el modo de solo lectura; false inhabilita. |
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/script.external_request
set Savepoint()
Para obtener documentación sobre este método, consulta
java.sql.Connection#setSavepoint()
.
Volver
Jdbc
: Es el nuevo punto de guardado sin nombre.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/script.external_request
set Savepoint(name)
Para obtener documentación sobre este método, consulta
java.sql.Connection#setSavepoint(String)
.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
name | String | Nombre del punto de guardado creado. |
Volver
Jdbc
: Es el nuevo punto de guardado con nombre.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/script.external_request
set Transaction Isolation(level)
Para obtener documentación sobre este método, consulta
java.sql.Connection#setTransactionIsolation(int)
.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
level | Integer | Es el nivel de transacción que se establecerá, que puede ser uno de los siguientes: Jdbc.Connection.TRANSACTION_READ_UNCOMMITTED , Jdbc.Connection.TRANSACTION_READ_COMMITTED , Jdbc.Connection.TRANSACTION_REPEATABLE_READ , Jdbc.Connection.TRANSACTION_SERIALIZABLE o Jdbc.Connection.TRANSACTION_NONE . |
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/script.external_request