Un Connection
de JDBC. Para obtener documentación de 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 ámbitos:
-
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 ámbitos:
-
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 | El 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[] | Son los elementos que se propagarán en el objeto que se muestra. |
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 muestra 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, tanto Jdbc
como Jdbc
proporcionan un método de conveniencia get
para convertir a un formato que puede usar 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
: 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 sentencia 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, uno de los siguientes: Jdbc.ResultSet.TYPE_FORWARD_ONLY , Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE o Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE . |
result | Integer | Un tipo de simultaneidad, ya sea Jdbc.ResultSet.CONCUR_READ_ONLY o Jdbc.ResultSet.CONCUR_UPDATABLE . |
Volver
Jdbc
: Es una instancia de sentencia 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, uno de los siguientes: Jdbc.ResultSet.TYPE_FORWARD_ONLY , Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE o Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE . |
result | Integer | 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 sentencia 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 | El 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 propagan el objeto que se muestra. |
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
: Es true
si el modo de confirmación automática de la conexión está habilitado; false
de lo contrario.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
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 ámbitos:
-
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 la configuración de retención de la conexión, ya sea 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 ámbitos:
-
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 es 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 ámbitos:
-
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 ámbitos:
-
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
de lo contrario.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
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
: Es true
si la conexión es de solo lectura; 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 ámbitos:
-
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
: Es true
si la conexión es válida; false
de lo contrario. También muestra false
si el período de tiempo de espera vence 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 ámbitos:
-
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 | Una sentencia SQL que puede contener uno o más marcadores de posición "?". |
Volver
String
: Es la forma nativa de la sentencia proporcionada.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
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 | Una sentencia SQL que puede contener uno o más marcadores de posición "?", que suelen proporcionarse con la sintaxis de escape de llamadas de JDBC. |
Volver
Jdbc
: Es una sentencia que se puede llamar y que contiene la sentencia 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 | Una sentencia SQL que puede contener uno o más marcadores de posición "?", que suelen proporcionarse con la sintaxis de escape de llamadas de JDBC. |
result | Integer | Es un tipo de conjunto de resultados, uno de los siguientes: Jdbc.ResultSet.TYPE_FORWARD_ONLY , Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE o Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE . |
result | Integer | Un tipo de simultaneidad, ya sea Jdbc.ResultSet.CONCUR_READ_ONLY o Jdbc.ResultSet.CONCUR_UPDATABLE . |
Volver
Jdbc
: Es una sentencia que se puede llamar y que contiene la sentencia 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 | Una sentencia SQL que puede contener uno o más marcadores de posición "?", que suelen proporcionarse con la sintaxis de escape de llamadas de JDBC. |
result | Integer | Es un tipo de conjunto de resultados, uno de los siguientes: Jdbc.ResultSet.TYPE_FORWARD_ONLY , Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE o Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE . |
result | Integer | 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 sentencia que se puede llamar y que contiene la sentencia 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 | Una sentencia 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 | Una sentencia 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, ya sea Jdbc.Statement.RETURN_GENERATED_KEYS o Jdbc.Statement.NO_GENERATED_KEYS . |
Volver
Jdbc
: Es una sentencia preparada que contiene la sentencia de SQL precompilada, que puede mostrar 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 | Una sentencia 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, uno de los siguientes: Jdbc.ResultSet.TYPE_FORWARD_ONLY , Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE o Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE . |
result | Integer | Un tipo de simultaneidad, ya sea Jdbc.ResultSet.CONCUR_READ_ONLY o Jdbc.ResultSet.CONCUR_UPDATABLE . |
Volver
Jdbc
: Es una sentencia preparada que contiene la sentencia 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 | Una sentencia 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, uno de los siguientes: Jdbc.ResultSet.TYPE_FORWARD_ONLY , Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE o Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE . |
result | Integer | 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 sentencia preparada que contiene la sentencia 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 | Una sentencia SQL que puede contener uno o más marcadores de posición de parámetros "?" IN. |
indices | Integer[] | Los índices de columna de las columnas que se devuelven de la fila o filas insertadas. |
Volver
Jdbc
: Es una sentencia preparada que contiene la sentencia SQL precompilada, capaz de mostrar 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 | Una sentencia SQL que puede contener uno o más marcadores de posición de parámetros "?" IN. |
column | String[] | Los nombres de las columnas que especifican qué columnas debe mostrar el método de las filas insertadas. |
Volver
Jdbc
: Es una sentencia preparada que contiene la sentencia SQL precompilada, capaz de mostrar claves generadas automáticamente especificadas por los nombres de las columnas 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 | 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 ámbitos:
-
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 ámbitos:
-
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 realizará la reversión. |
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
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 , el modo de confirmación automática está habilitado; false lo inhabilita. |
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
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 | Es el nombre de un catálogo (el subespacio en la base de datos de la conexión) en el que trabajar. |
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
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 | La capacidad de retención predeterminada de los objetos Jdbc creados con esta conexión, ya sea 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 , el modo de solo lectura está habilitado; false lo inhabilita. |
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:
-
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 ámbitos:
-
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 | Es el 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 ámbitos:
-
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 debe establecer, que es 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 ámbitos:
-
https://www.googleapis.com/auth/script.external_request