Un objeto Connection de JDBC. Para obtener documentación sobre esta clase, consulta 
java.sql.Connection.
Métodos
Documentación detallada
clear
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
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
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
Para obtener documentación sobre este método, consulta 
java.sql.Connection#createClob().
Volver
Jdbc: Es un objeto CLOB vacío.
create
Para obtener documentación sobre este método, consulta 
java.sql.Connection#createNClob().
Volver
Jdbc: Es un objeto nclob vacío.
create
Para obtener documentación sobre este método, consulta 
java.sql.Connection#createSQLXML().
Volver
Jdbc: Es un objeto SQLXML vacío.
create
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
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_INSENSITIVEoJdbc.ResultSet.TYPE_SCROLL_SENSITIVE. | 
| result | Integer | Es un tipo de simultaneidad, ya sea Jdbc.ResultSet.CONCUR_READ_ONLYoJdbc.ResultSet.CONCUR_UPDATABLE. | 
Volver
Jdbc: Es una instancia de instrucción para ejecutar consultas.
create
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_INSENSITIVEoJdbc.ResultSet.TYPE_SCROLL_SENSITIVE. | 
| result | Integer | Es un tipo de simultaneidad, ya sea Jdbc.ResultSet.CONCUR_READ_ONLYoJdbc.ResultSet.CONCUR_UPDATABLE. | 
| result | Integer | Es un parámetro de configuración de retención, ya sea Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIToJdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT. | 
Volver
Jdbc: Es una instancia de instrucción para ejecutar consultas.
create
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
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
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
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
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
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
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
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
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
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
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
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
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_INSENSITIVEoJdbc.ResultSet.TYPE_SCROLL_SENSITIVE. | 
| result | Integer | Es un tipo de simultaneidad, ya sea Jdbc.ResultSet.CONCUR_READ_ONLYoJdbc.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
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_INSENSITIVEoJdbc.ResultSet.TYPE_SCROLL_SENSITIVE. | 
| result | Integer | Es un tipo de simultaneidad, ya sea Jdbc.ResultSet.CONCUR_READ_ONLYoJdbc.ResultSet.CONCUR_UPDATABLE. | 
| result | Integer | Es un parámetro de configuración de retención, ya sea Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIToJdbc.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
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
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_KEYSoJdbc.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
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_INSENSITIVEoJdbc.ResultSet.TYPE_SCROLL_SENSITIVE. | 
| result | Integer | Es un tipo de simultaneidad, ya sea Jdbc.ResultSet.CONCUR_READ_ONLYoJdbc.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
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_INSENSITIVEoJdbc.ResultSet.TYPE_SCROLL_SENSITIVE. | 
| result | Integer | Es un tipo de simultaneidad, ya sea Jdbc.ResultSet.CONCUR_READ_ONLYoJdbc.ResultSet.CONCUR_UPDATABLE. | 
| result | Integer | Es un parámetro de configuración de retención, ya sea Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIToJdbc.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
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
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
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
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;falseinhabilita. | 
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
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
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 Jdbccreados con esta conexión, que puede serJdbc.ResultSet.HOLD_CURSORS_OVER_COMMIToJdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT. | 
set
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;falseinhabilita. | 
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
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
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
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_SERIALIZABLEoJdbc.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