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 esta base de datos de 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, libera los bloqueos de la base de datos que conserva este 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 arreglo 3. 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 mostrado. |
Volver
JdbcArray
: Es un arreglo 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 mostró inicialmente no contiene datos. Puedes usar los métodos setBytes
de JdbcBlob
para configurar los datos que debe contener. El BLOB que se usa aquí no es el mismo que el creado con Utilities.newBlob(data)
. Para convertir 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 pueda usar Apps Script.
Volver
JdbcBlob
: un objeto BLOB vacío
createClob()
Para ver la documentación de este método, consulta
java.sql.Connection#createClob()
.
Volver
JdbcClob
: un objeto de clob vacío.
createNClob()
Para ver la documentación de este método, consulta
java.sql.Connection#createNClob()
.
Volver
JdbcClob
: un objeto nclob vacío
createSQLXML()
Para ver la documentación de este método, consulta
java.sql.Connection#createSQLXML()
.
Volver
JdbcSQLXML
: 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();
Volver
JdbcStatement
: 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; puede ser Jdbc.ResultSet.TYPE_FORWARD_ONLY , Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE o Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE . |
resultSetConcurrency | Integer | Un tipo de simultaneidad: Jdbc.ResultSet.CONCUR_READ_ONLY o Jdbc.ResultSet.CONCUR_UPDATABLE . |
Volver
JdbcStatement
: 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; puede ser Jdbc.ResultSet.TYPE_FORWARD_ONLY , Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE o Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE . |
resultSetConcurrency | Integer | Un tipo de simultaneidad: Jdbc.ResultSet.CONCUR_READ_ONLY o Jdbc.ResultSet.CONCUR_UPDATABLE . |
resultSetHoldability | Integer | Una configuración de retención; ya sea Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT o Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT . |
Volver
JdbcStatement
: 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 arreglo 3. 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. |
Volver
JdbcStruct
: 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()
.
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 ver la documentación de este método, consulta java.sql.Connection#getHoldability()
.
Volver
Integer
: 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
.
getMetaData()
Para ver la documentación de este método, consulta
java.sql.Connection#getMetaData()
.
Volver
JdbcDatabaseMetaData
: 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()
.
Volver
Integer
: 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 alcances:
-
https://www.googleapis.com/auth/script.external_request
getWarnings()
Para ver la documentación de este método, consulta
java.sql.Connection#getWarnings()
.
Volver
String[]
: Es un arreglo 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()
.
Volver
Boolean
: true
si se cierra la conexión; 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()
.
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 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 espera a que se complete la operación de validación. Un valor de 0 indica que no se aplicó ningún tiempo de espera. |
Volver
Boolean
: 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 | Una instrucción de SQL que puede contener marcadores de posición más '?' |
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 ver la documentación de este método, consulta java.sql.Connection#prepareCall(String)
.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
sql | String | Una instrucción de SQL que puede contener uno o más marcadores de posición más, que, por lo general, se proporcionan con la sintaxis de escape de llamada de JDBC. |
Volver
JdbcCallableStatement
: Una instrucción que admite llamadas que contiene la instrucción de SQL ya compilada.
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 | Una instrucción de SQL que puede contener uno o más marcadores de posición más, que, por lo general, se proporcionan con la sintaxis de escape de llamada de JDBC. |
resultSetType | Integer | Un tipo de conjunto de resultados; puede ser Jdbc.ResultSet.TYPE_FORWARD_ONLY , Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE o Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE . |
resultSetConcurrency | Integer | Un tipo de simultaneidad: Jdbc.ResultSet.CONCUR_READ_ONLY o Jdbc.ResultSet.CONCUR_UPDATABLE . |
Volver
JdbcCallableStatement
: Es una instrucción que admite llamadas que contiene la instrucción de SQL ya compilada 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 | Una instrucción de SQL que puede contener uno o más marcadores de posición más, que, por lo general, se proporcionan con la sintaxis de escape de llamada de JDBC. |
resultSetType | Integer | Un tipo de conjunto de resultados; puede ser Jdbc.ResultSet.TYPE_FORWARD_ONLY , Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE o Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE . |
resultSetConcurrency | Integer | Un tipo de simultaneidad: Jdbc.ResultSet.CONCUR_READ_ONLY o Jdbc.ResultSet.CONCUR_UPDATABLE . |
resultSetHoldability | Integer | Una 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 que admite llamadas que contiene la instrucción de SQL ya compilada que produce conjuntos de resultados con el tipo proporcionado, la 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 | Una instrucción de 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 ya compilada.
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 | Una instrucción de SQL que puede contener uno o más marcadores de posición de parámetros IN. |
autoGeneratedKeys | Integer | Una marca que indica si se muestran las claves generadas de forma automática, ya sea Jdbc.Statement.RETURN_GENERATED_KEYS o Jdbc.Statement.NO_GENERATED_KEYS . |
Volver
JdbcPreparedStatement
: una declaración preparada que contiene la instrucción de SQL compilada previamente, que es posible que muestre 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 | Una instrucción de SQL que puede contener uno o más marcadores de posición de parámetros IN. |
resultSetType | Integer | Un tipo de conjunto de resultados; puede ser Jdbc.ResultSet.TYPE_FORWARD_ONLY , Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE o Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE . |
resultSetConcurrency | Integer | Un tipo de simultaneidad: 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 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 | Una instrucción de SQL que puede contener uno o más marcadores de posición de parámetros IN. |
resultSetType | Integer | Un tipo de conjunto de resultados; puede ser Jdbc.ResultSet.TYPE_FORWARD_ONLY , Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE o Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE . |
resultSetConcurrency | Integer | Un tipo de simultaneidad: Jdbc.ResultSet.CONCUR_READ_ONLY o Jdbc.ResultSet.CONCUR_UPDATABLE . |
resultSetHoldability | Integer | Una 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 retención que se proporcionan.
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 | Una instrucción de 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 muestran de las filas insertadas. |
Volver
JdbcPreparedStatement
: Es una instrucción preparada que contiene la instrucción de SQL ya compilada y capaz de mostrar 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 | Una instrucción de SQL que puede contener uno o más marcadores de posición de parámetros IN. |
columnNames | String[] | Los nombres de columna que especifican las columnas que el método debe mostrar de las filas insertadas. |
Volver
JdbcPreparedStatement
: Es una declaración preparada que contiene la instrucción de SQL compilada previamente, 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 | 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 para 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 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 , el modo de confirmación automática está habilitado; false se 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 ver la documentación de este método, consulta java.sql.Connection#setCatalog(String)
.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
catalog | String | El nombre de un catálogo (el subespacio en la base de datos de conexión) en el que se debe 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 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; ya sea 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 true está habilitado, el modo de solo lectura está habilitado y false se 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 ver la documentación de 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 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. |
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 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 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