Un Connection
de JDBC. Para ver la documentación de esta clase, consulta
java.sql.Connection
.
Métodos
Documentación detallada
clearWarnings()
Para ver la documentación de 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.
var 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 base de datos que retiene JdbcConnection
.
var conn = Jdbc.getConnection("jdbc:mysql://<host>:<port>/<instance>", "user", "password"); conn.setAutoCommit(false); var stmt = conn.prepareStatement("insert into person (lname,fname) values (?,?)"); var start = new Date(); for (var i = 0; i < 5000; i++) { // Objects are accessed using 1-based indexing stmt.setObject(1, 'firstName' + i); stmt.setObject(2, 'lastName' + i); stmt.addBatch(); } var 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 ver la documentación de este método, consulta
java.sql.Connection#createArrayOf(String, Object[])
.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
typeName | String | El nombre de 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[] | Los elementos que se propagarán en el objeto que se muestra. |
Devolvedor
JdbcArray
: Es un array cuyos elementos se asignan al tipo de SQL especificado.
createBlob()
Construye una instancia JdbcBlob
. Consulta también
java.sql.Connection#createBlob()
.
El objeto que se muestra 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 se creó con Utilities.newBlob(data)
. Para realizar la conversión entre los dos formatos, usa los métodos getBytes()
y setBytes()
definidos.
De manera alternativa, JdbcBlob
y JdbcClob
proporcionan un método de conveniencia getAppsScriptBlob()
para la conversión a un formato que Apps Script pueda usar.
Devolvedor
JdbcBlob
: Es un objeto BLOB vacío.
createClob()
Para ver la documentación de este método, consulta
java.sql.Connection#createClob()
.
Devolvedor
JdbcClob
: Es un objeto clob vacío.
createNClob()
Para ver la documentación de este método, consulta
java.sql.Connection#createNClob()
.
Devolvedor
JdbcClob
: Es un objeto nclob vacío.
createSQLXML()
Para ver la documentación de este método, consulta
java.sql.Connection#createSQLXML()
.
Devolvedor
JdbcSQLXML
: Es un objeto SQLXML vacío.
createStatement()
Crea un objeto JdbcStatement
para enviar instrucciones de SQL a la base de datos. Consulta también
java.sql.Connection#createStatement()
.
// This sample code assumes authentication is off var conn = Jdbc.getConnection("jdbc:mysql://<host>:3306/<instance>") var stmt = conn.createStatement(); stmt.setMaxRows(100); var rs = stmt.execute("select * from person"); while(rs.next()) { // Do something } rs.close(); stmt.close(); conn.close();
Devolvedor
JdbcStatement
: Es una instancia de declaración para ejecutar consultas.
createStatement(resultSetType, resultSetConcurrency)
Crea un objeto JdbcStatement
para enviar instrucciones de 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) var conn = Jdbc.getConnection("jdbc:mysql://<host>:3306/<instance>") var stmt = conn.createStatement(Jdbc.ResultSet.TYPE_FORWARD_ONLY, Jdbc.ResultSet.CONCUR_READ_ONLY); stmt.setMaxRows(100); var rs = stmt.execute("select * from person"); while(rs.next()) { // Do something } rs.close(); stmt.close(); conn.close();
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
resultSetType | Integer | Un tipo de conjunto de resultados; uno de Jdbc.ResultSet.TYPE_FORWARD_ONLY , Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE o Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE . |
resultSetConcurrency | Integer | Un tipo de simultaneidad, ya sea Jdbc.ResultSet.CONCUR_READ_ONLY o Jdbc.ResultSet.CONCUR_UPDATABLE . |
Devolvedor
JdbcStatement
: Es una instancia de declaración para ejecutar consultas.
createStatement(resultSetType, resultSetConcurrency, resultSetHoldability)
Crea un objeto JdbcStatement
para enviar instrucciones de 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 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) var conn = Jdbc.getConnection("jdbc:mysql://<host>:3306/<instance>") var stmt = conn.createStatement(Jdbc.ResultSet.TYPE_FORWARD_ONLY, Jdbc.ResultSet.CONCUR_READ_ONLY, Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT); stmt.setMaxRows(100); var rs = stmt.execute("select * from person"); while(rs.next()) { // Do something } rs.close(); stmt.close(); conn.close();
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
resultSetType | Integer | Un tipo de conjunto de resultados; uno de Jdbc.ResultSet.TYPE_FORWARD_ONLY , Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE o Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE . |
resultSetConcurrency | Integer | Un tipo de simultaneidad, ya sea Jdbc.ResultSet.CONCUR_READ_ONLY o Jdbc.ResultSet.CONCUR_UPDATABLE . |
resultSetHoldability | Integer | Una configuración de retención, que puede ser Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT o Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT |
Devolvedor
JdbcStatement
: Es una instancia de declaración para ejecutar consultas.
createStruct(typeName, attributes)
Para ver la documentación de este método, consulta
java.sql.Connection#createStruct(String, Object[])
.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
typeName | String | El nombre de 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[] | Los atributos que propagan el objeto mostrado. |
Devolvedor
JdbcStruct
: Es un objeto de estructura que se asigna al tipo de SQL determinado y se propaga con los atributos dados.
getAutoCommit()
Para ver la documentación de este método, consulta
java.sql.Connection#getAutoCommit()
.
Devolvedor
Boolean
: Es 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()
.
Devolvedor
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 ver la documentación de este método, consulta
java.sql.Connection#getHoldability()
.
Devolvedor
Integer
: Es la configuración de capacidad de retención de la conexión. Puede ser Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT
o Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT
.
getMetaData()
Para ver la documentación de este método, consulta
java.sql.Connection#getMetaData()
.
Devolvedor
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 ver la documentación de este método, consulta
java.sql.Connection#getTransactionIsolation()
.
Devolvedor
Integer
: Indica el nivel actual de la transacción, 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 alcances:
-
https://www.googleapis.com/auth/script.external_request
getWarnings()
Para ver la documentación de este método, consulta
java.sql.Connection#getWarnings()
.
Devolvedor
String[]
: Es un array de strings 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 ver la documentación de este método, consulta
java.sql.Connection#isClosed()
.
Devolvedor
Boolean
: Es true
si la conexión está cerrada; 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
isReadOnly()
Para ver la documentación de este método, consulta
java.sql.Connection#isReadOnly()
.
Devolvedor
Boolean
: Es 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 ver la documentación de este método, consulta
java.sql.Connection#isValid(int)
.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
timeout | Integer | El tiempo en segundos que se debe esperar hasta que se complete la operación de validación. El valor 0 indica que no se aplicó ningún tiempo de espera. |
Devolvedor
Boolean
: Es true
si la conexión es válida; de lo contrario, false
. También muestra false
si el 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 alcances:
-
https://www.googleapis.com/auth/script.external_request
nativeSQL(sql)
Para ver la documentación de este método, consulta
java.sql.Connection#nativeSQL(String)
.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
sql | String | Instrucción de SQL que puede contener más marcadores de posición "?". |
Devolvedor
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 ver la documentación de este método, consulta
java.sql.Connection#prepareCall(String)
.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
sql | String | Instrucción de SQL que puede contener más marcadores de posición "?", por lo general, se proporcionan mediante la sintaxis de escape de llamada de JDBC. |
Devolvedor
JdbcCallableStatement
: Es una declaración que admite llamadas y contiene la instrucción de SQL compilada previamente.
prepareCall(sql, resultSetType, resultSetConcurrency)
Para ver la documentación de este método, consulta
java.sql.Connection#prepareCall(String, int, int)
.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
sql | String | Instrucción de SQL que puede contener más marcadores de posición "?", por lo general, se proporcionan mediante la sintaxis de escape de llamada de JDBC. |
resultSetType | Integer | Un tipo de conjunto de resultados; uno de Jdbc.ResultSet.TYPE_FORWARD_ONLY , Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE o Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE . |
resultSetConcurrency | Integer | Un tipo de simultaneidad, ya sea Jdbc.ResultSet.CONCUR_READ_ONLY o Jdbc.ResultSet.CONCUR_UPDATABLE . |
Devolvedor
JdbcCallableStatement
: Es una declaración que admite llamadas y contiene la instrucción de SQL compilada previamente que produce conjuntos de resultados con el tipo y la simultaneidad proporcionados.
prepareCall(sql, resultSetType, resultSetConcurrency, resultSetHoldability)
Para ver la documentación de este método, consulta
java.sql.Connection#prepareCall(String, int, int, int)
.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
sql | String | Instrucción de SQL que puede contener más marcadores de posición "?", por lo general, se proporcionan mediante la sintaxis de escape de llamada de JDBC. |
resultSetType | Integer | Un tipo de conjunto de resultados; uno de Jdbc.ResultSet.TYPE_FORWARD_ONLY , Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE o Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE . |
resultSetConcurrency | Integer | Un tipo de simultaneidad, ya sea Jdbc.ResultSet.CONCUR_READ_ONLY o Jdbc.ResultSet.CONCUR_UPDATABLE . |
resultSetHoldability | Integer | Una configuración de retención, que puede ser Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT o Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT |
Devolvedor
JdbcCallableStatement
: Es una declaración que admite llamadas y contiene la instrucción de SQL compilada previamente que produce conjuntos de resultados con el tipo proporcionado, simultaneidad.
prepareStatement(sql)
Para ver la documentación de este método, consulta
java.sql.Connection#prepareStatement(String)
.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
sql | String | Instrucción de SQL que puede contener más marcadores de posición del parámetro "?" IN. |
Devolvedor
JdbcPreparedStatement
: Es una instrucción preparada que contiene la instrucción de SQL compilada previamente.
prepareStatement(sql, autoGeneratedKeys)
Para ver la documentación de este método, consulta
java.sql.Connection#prepareStatement(String, int)
.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
sql | String | Instrucción de SQL que puede contener más marcadores de posición del parámetro "?" IN. |
autoGeneratedKeys | Integer | Una marca que indica si se muestran las claves generadas de manera automática; Jdbc.Statement.RETURN_GENERATED_KEYS o Jdbc.Statement.NO_GENERATED_KEYS . |
Devolvedor
JdbcPreparedStatement
: Es una instrucción preparada que contiene la instrucción de SQL previamente compilada, posiblemente capaz de mostrar claves generadas de forma automática.
prepareStatement(sql, resultSetType, resultSetConcurrency)
Para ver la documentación de este método, consulta
java.sql.Connection#prepareStatement(String, int, int)
.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
sql | String | Instrucción de SQL que puede contener más marcadores de posición del parámetro "?" IN. |
resultSetType | Integer | Un tipo de conjunto de resultados; uno de Jdbc.ResultSet.TYPE_FORWARD_ONLY , Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE o Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE . |
resultSetConcurrency | Integer | Un tipo de simultaneidad, ya sea Jdbc.ResultSet.CONCUR_READ_ONLY o Jdbc.ResultSet.CONCUR_UPDATABLE . |
Devolvedor
JdbcPreparedStatement
: Es una instrucción preparada que contiene la instrucción de SQL previamente compilada que produce conjuntos de resultados con el tipo y la simultaneidad proporcionados.
prepareStatement(sql, resultSetType, resultSetConcurrency, resultSetHoldability)
Para ver la documentación de este método, consulta
java.sql.Connection#prepareStatement(String, int, int, int)
.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
sql | String | Instrucción de SQL que puede contener más marcadores de posición del parámetro "?" IN. |
resultSetType | Integer | Un tipo de conjunto de resultados; uno de Jdbc.ResultSet.TYPE_FORWARD_ONLY , Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE o Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE . |
resultSetConcurrency | Integer | Un tipo de simultaneidad, ya sea Jdbc.ResultSet.CONCUR_READ_ONLY o Jdbc.ResultSet.CONCUR_UPDATABLE . |
resultSetHoldability | Integer | Una configuración de retención, que puede ser Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT o Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT |
Devolvedor
JdbcPreparedStatement
: Es una instrucción preparada que contiene la instrucción de SQL compilada previamente que produce conjuntos de resultados con el tipo, la simultaneidad y la retención proporcionados.
prepareStatementByIndex(sql, indices)
Para ver la documentación de este método, consulta
java.sql.Connection#prepareStatement(String, int[])
.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
sql | String | Instrucción de SQL que puede contener más marcadores de posición del parámetro "?" IN. |
indices | Integer[] | Los índices de columna de las columnas que se muestran a partir de las filas insertadas. |
Devolvedor
JdbcPreparedStatement
: Es una instrucción preparada que contiene la instrucción de SQL compilada previamente, capaz de mostrar las claves generadas de forma automática especificadas por los índices de columna proporcionados.
prepareStatementByName(sql, columnNames)
Para ver la documentación de este método, consulta
java.sql.Connection#prepareStatement(String, String[])
.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
sql | String | Instrucción de SQL que puede contener más marcadores de posición del parámetro "?" IN. |
columnNames | String[] | Los nombres de columna que especifican qué columnas debe mostrar el método a partir de las filas insertadas. |
Devolvedor
JdbcPreparedStatement
: Es una instrucción preparada que contiene la instrucción de SQL previamente compilada, capaz de mostrar claves generadas de forma automática especificadas por los nombres de columna proporcionados.
releaseSavepoint(savepoint)
Para ver la documentación de este método, consulta
java.sql.Connection#releaseSavepoint(Savepoint)
.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
savepoint | JdbcSavepoint | 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 ver la documentación de 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 ver la documentación de este método, consulta
java.sql.Connection#rollback(Savepoint)
.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
savepoint | JdbcSavepoint | 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 alcances:
-
https://www.googleapis.com/auth/script.external_request
setAutoCommit(autoCommit)
Para ver la documentación de este método, consulta
java.sql.Connection#setAutoCommit(boolean)
.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
autoCommit | Boolean | Si es true , se habilita el modo de confirmación automática; se inhabilita 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
setCatalog(catalog)
Para ver la documentación de 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 se trabaja. |
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 ver la documentación de 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 JdbcResultSet creados con esta conexión: Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT o Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT . |
setReadOnly(readOnly)
Para ver la documentación de este método, consulta
java.sql.Connection#setReadOnly(boolean)
.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
readOnly | Boolean | Si es true , se habilita el modo de solo lectura; se inhabilita 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
setSavepoint()
Para ver la documentación de este método, consulta
java.sql.Connection#setSavepoint()
.
Devolvedor
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 ver la documentación de este método, consulta
java.sql.Connection#setSavepoint(String)
.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
name | String | El nombre del punto de guardado creado. |
Devolvedor
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 ver la documentación de este método, consulta
java.sql.Connection#setTransactionIsolation(int)
.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
level | Integer | El nivel de transacción que se 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 alcances:
-
https://www.googleapis.com/auth/script.external_request