Un objeto Connection de JDBC. Para obtener documentación sobre esta clase, consulta
java.sql.Connection.
Métodos
Documentación detallada
clearWarnings()
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 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();
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()
createArrayOf(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 elementos del array. Las opciones incluyen tipos integrados, tipos definidos por el usuario o tipos de SQL estándar compatibles con la base de datos. |
elements | Object[] | Elementos que se propagarán en el objeto devuelto. |
Volver
JdbcArray: Es un array cuyos elementos se asignan al tipo de SQL especificado.
createBlob()
Construye una instancia de JdbcBlob. Consulta también
java.sql.Connection#createBlob().
El objeto que se devuelve inicialmente no contiene datos. Puedes usar los métodos setBytes de JdbcBlob 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 getBytes() y setBytes() definidos.
Como alternativa, JdbcBlob y JdbcClob proporcionan un método de conveniencia getAppsScriptBlob() para convertir a un formato que se puede usar con Apps Script.
Volver
JdbcBlob: Es un objeto blob vacío.
createClob()
Para obtener documentación sobre este método, consulta
java.sql.Connection#createClob().
Volver
JdbcClob: Es un objeto CLOB vacío.
createNClob()
Para obtener documentación sobre este método, consulta
java.sql.Connection#createNClob().
Volver
JdbcClob: Es un objeto nclob vacío.
createSQLXML()
Para obtener documentación sobre este método, consulta
java.sql.Connection#createSQLXML().
Volver
JdbcSQLXML: Es un objeto SQLXML vacío.
createStatement()
Crea un objeto JdbcStatement 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
JdbcStatement: Es una instancia de instrucción para ejecutar consultas.
createStatement(resultSetType, resultSetConcurrency)
Crea un objeto JdbcStatement 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
JdbcStatement: Es una instancia de instrucción para ejecutar consultas.
createStatement(resultSetType, resultSetConcurrency, resultSetHoldability)
Crea un objeto JdbcStatement 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
JdbcStatement: Es una instancia de instrucción para ejecutar consultas.
createStruct(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 elementos del array. Las opciones incluyen tipos integrados, tipos definidos por el usuario o tipos de SQL estándar compatibles con la base de datos. |
attributes | Object[] | Son los atributos que completan el objeto devuelto. |
Volver
JdbcStruct: Es un objeto de estructura que se asigna al tipo de SQL determinado y se propaga con los atributos determinados.
getAutoCommit()
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
getCatalog()
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
getHoldability()
Para obtener documentación sobre este método, consulta
java.sql.Connection#getHoldability().
Volver
Integer: Es el parámetro de configuración de retención de la conexión, que puede ser Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT o Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT.
getMetaData()
Para obtener documentación sobre este método, consulta
java.sql.Connection#getMetaData().
Volver
JdbcDatabaseMetaData: 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
getTransactionIsolation()
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 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
getWarnings()
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
isClosed()
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
isReadOnly()
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
isValid(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
nativeSQL(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
prepareCall(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 suelen proporcionarse con la sintaxis de escape de llamadas JDBC. |
Volver
JdbcCallableStatement: Es una instrucción invocable que contiene la instrucción de SQL precompilada.
prepareCall(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 suelen proporcionarse 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
JdbcCallableStatement: 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.
prepareCall(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 suelen proporcionarse 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
JdbcCallableStatement: 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.
prepareStatement(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
JdbcPreparedStatement: Es una instrucción preparada que contiene la instrucción de SQL precompilada.
prepareStatement(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
JdbcPreparedStatement: Es una instrucción preparada que contiene la instrucción de SQL precompilada, posiblemente capaz de devolver claves generadas automáticamente.
prepareStatement(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
JdbcPreparedStatement: 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.
prepareStatement(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
JdbcPreparedStatement: 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.
prepareStatementByIndex(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
JdbcPreparedStatement: 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.
prepareStatementByName(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
JdbcPreparedStatement: 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.
releaseSavepoint(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
setAutoCommit(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
setCatalog(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
setHoldability(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: Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT o Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT. |
setReadOnly(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
setSavepoint()
Para obtener documentación sobre este método, consulta
java.sql.Connection#setSavepoint().
Volver
JdbcSavepoint: 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
setSavepoint(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
JdbcSavepoint: 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
setTransactionIsolation(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