Un Connection
de JDBC. Para ver la documentación de esta clase, consulta
java.sql.Connection
.
Métodos
Documentación detallada
clearWarnings()
Para 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 la base de datos que mantiene 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 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 de los elementos del array el tipo de letra. Se incluyen las siguientes opciones: 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. |
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 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
BLOB creado 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 getAppsScriptBlob()
.
conveniente para la conversión a un formato que pueda usar 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 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
: Es una instancia de instrucción con la que se pueden 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; 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
: Es una instancia de instrucción con la que se pueden 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 conservació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; 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 | Un parámetro de configuración de capacidad de conservación Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT o Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT . |
Volver
JdbcStatement
: Es una instancia de instrucción con la que se pueden ejecutar consultas.
createStruct(typeName, attributes)
Para 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 de los elementos del array el tipo de letra. Se incluyen las siguientes opciones: 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 que se muestra. |
Volver
JdbcStruct
: Es un objeto de estructura que se asigna al tipo de SQL determinado y se propaga con el dado.
atributos.
getAutoCommit()
Para 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 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 estableció 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 documentación de este método, consulta
java.sql.Connection#getHoldability()
Volver
Integer
: Es la configuración de conservación de la conexión. 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
: 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 documentación de este método, consulta
java.sql.Connection#getTransactionIsolation()
Volver
Integer
: Indica 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 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 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 | El tiempo en segundos que se debe esperar para 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 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 un signo más "?" los 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 alcances:
-
https://www.googleapis.com/auth/script.external_request
prepareCall(sql)
Para 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 un signo más "?" los marcadores de posición que se proporcionan con la sintaxis de escape de llamada de JDBC. |
Volver
JdbcCallableStatement
: Indica una instrucción que admite llamadas que contiene la instrucción de SQL precompilada.
prepareCall(sql, resultSetType, resultSetConcurrency)
Para 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 un signo más "?" los marcadores de posición que se proporcionan con la sintaxis de escape de llamada de JDBC. |
resultSetType | Integer | Un tipo de conjunto de resultados; 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 declaración que admite llamadas y contiene la instrucción de SQL precompilada que produce el resultado.
con el tipo y la simultaneidad proporcionados.
prepareCall(sql, resultSetType, resultSetConcurrency, resultSetHoldability)
Para 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 un signo más "?" los marcadores de posición que se proporcionan con la sintaxis de escape de llamada de JDBC. |
resultSetType | Integer | Un tipo de conjunto de resultados; 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 | Un parámetro de configuración de capacidad de conservación Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT o Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT . |
Volver
JdbcCallableStatement
: Es una declaración que admite llamadas y contiene la instrucción de SQL precompilada que produce el resultado.
con el tipo proporcionado, simultaneidad.
prepareStatement(sql)
Para 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 un signo más "?" Marcadores de posición del parámetro IN. |
Volver
JdbcPreparedStatement
: Es una instrucción preparada que contiene la instrucción de SQL precompilada.
prepareStatement(sql, autoGeneratedKeys)
Para 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 un signo más "?" Marcadores de posición del parámetro IN. |
autoGeneratedKeys | Integer | Marca que indica si se muestran claves generadas de manera automática cualquiera de los dos
Jdbc.Statement.RETURN_GENERATED_KEYS o Jdbc.Statement.NO_GENERATED_KEYS . |
Volver
JdbcPreparedStatement
: Es una sentencia preparada que contiene la instrucción de SQL precompilada, posiblemente capaz de
mostrar las claves generadas automáticamente.
prepareStatement(sql, resultSetType, resultSetConcurrency)
Para 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 un signo más "?" Marcadores de posición del parámetro IN. |
resultSetType | Integer | Un tipo de conjunto de resultados; 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 declaración preparada que contiene la instrucción de SQL precompilada que produce el resultado.
con el tipo y la simultaneidad proporcionados.
prepareStatement(sql, resultSetType, resultSetConcurrency, resultSetHoldability)
Para 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 un signo más "?" Marcadores de posición del parámetro IN. |
resultSetType | Integer | Un tipo de conjunto de resultados; 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 | Un parámetro de configuración de capacidad de conservación Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT o Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT . |
Volver
JdbcPreparedStatement
: Es una declaración preparada que contiene la instrucción de SQL precompilada que produce el resultado.
con el tipo, la simultaneidad y la capacidad de conservación proporcionados.
prepareStatementByIndex(sql, indices)
Para 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 un signo más "?" Marcadores de posición del parámetro IN. |
indices | Integer[] | Los índices de columna que se muestran a partir de la fila o filas insertadas. |
Volver
JdbcPreparedStatement
: Es una declaración preparada que contiene la instrucción de SQL precompilada, que puede mostrar resultados.
generadas de forma automática, especificadas por los índices de columna proporcionados.
prepareStatementByName(sql, columnNames)
Para 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 un signo más "?" Marcadores de posición del parámetro IN. |
columnNames | String[] | Los nombres de las columnas que especifican las columnas desde las que se debe mostrar el método la fila o las filas insertadas. |
Volver
JdbcPreparedStatement
: Es una declaración preparada que contiene la instrucción de SQL precompilada, que puede mostrar resultados.
generadas automáticamente, especificadas por los nombres de columna proporcionados.
releaseSavepoint(savepoint)
Para 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 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 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 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 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 la conexión) en el que el trabajo. |
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 documentación de este método, consulta
java.sql.Connection#setHoldability(int)
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
holdability | Integer | La capacidad de conservación predeterminada de los objetos JdbcResultSet creados con este
la conexión, Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT o Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT . |
setReadOnly(readOnly)
Para 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 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 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 nombrado.
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 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