Un'Connection JDBC. Per la documentazione di questo corso, vedi
java.sql.Connection.
Metodi
Documentazione dettagliata
clearWarnings()
Per la documentazione di questo metodo, consulta
java.sql.Connection#clearWarnings().
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/script.external_request
close()
Rilascia il database di questa connessione e tutte le risorse associate.
const conn = Jdbc.getConnection( 'jdbc:mysql://<host>:<port>/<instance>', 'user', 'password', ); conn.close();
Vedi anche
-
Connection.close()
commit()
Rende permanenti tutte le modifiche in attesa e rilascia i blocchi del database conservati da questo 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();
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/script.external_request
Vedi anche
-
Connection.commit()
createArrayOf(typeName, elements)
Per la documentazione di questo metodo, consulta
java.sql.Connection#createArrayOf(String, Object[]).
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
typeName | String | Il nome SQL specifico del database dell'array degli elementi di testo. Le opzioni includono i tipi integrati, i tipi definiti dall'utente o i tipi SQL standard supportati dal database. |
elements | Object[] | Gli elementi da compilare nell'oggetto restituito. |
Invio
JdbcArray: un array i cui elementi sono mappati al tipo SQL specificato.
createBlob()
Crea un'istanza JdbcBlob. Vedi anche
java.sql.Connection#createBlob().
L'oggetto restituito inizialmente non contiene dati. Puoi usare i metodi setBytes di
JdbcBlob per impostare i dati che deve contenere. Il blob usato qui non è uguale al
blob creato con Utilities.newBlob(data). Per convertire
tra i due formati, utilizza i metodi getBytes() e setBytes() definiti.
In alternativa, sia JdbcBlob che JdbcClob forniscono un getAppsScriptBlob()
per convertire in un formato utilizzabile da Apps Script.
Invio
JdbcBlob: un oggetto blob vuoto.
createClob()
Per la documentazione di questo metodo, consulta
java.sql.Connection#createClob().
Invio
JdbcClob: un oggetto clob vuoto.
createNClob()
Per la documentazione di questo metodo, consulta
java.sql.Connection#createNClob().
Invio
JdbcClob: un oggetto nclob vuoto.
createSQLXML()
Per la documentazione di questo metodo, consulta
java.sql.Connection#createSQLXML().
Invio
JdbcSQLXML: un oggetto SQLXML vuoto.
createStatement()
Crea un oggetto JdbcStatement per l'invio di istruzioni SQL al database. Vedi anche
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();
Invio
JdbcStatement: un'istanza di istruzione con cui eseguire le query.
createStatement(resultSetType, resultSetConcurrency)
Crea un oggetto JdbcStatement per l'invio di istruzioni SQL al database. Vedi anche
java.sql.Connection#createStatement(int, int).
Questa versione consente di eseguire l'override del tipo di set di risultati e della contemporaneità.
// 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();
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
resultSetType | Integer | Un tipo di set di risultati; uno tra Jdbc.ResultSet.TYPE_FORWARD_ONLY, Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE o Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE. |
resultSetConcurrency | Integer | Un tipo di contemporaneità; Jdbc.ResultSet.CONCUR_READ_ONLY
o Jdbc.ResultSet.CONCUR_UPDATABLE. |
Invio
JdbcStatement: un'istanza di istruzione con cui eseguire le query.
createStatement(resultSetType, resultSetConcurrency, resultSetHoldability)
Crea un oggetto JdbcStatement per l'invio di istruzioni SQL al database. Vedi anche
java.sql.Connection#createStatement(int, int, int).
Questa versione consente di eseguire l'override del tipo di set di risultati, della contemporaneità e della conservazione.
// 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();
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
resultSetType | Integer | Un tipo di set di risultati; uno tra Jdbc.ResultSet.TYPE_FORWARD_ONLY, Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE o Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE. |
resultSetConcurrency | Integer | Un tipo di contemporaneità; Jdbc.ResultSet.CONCUR_READ_ONLY
o Jdbc.ResultSet.CONCUR_UPDATABLE. |
resultSetHoldability | Integer | Un'impostazione di conservazione; Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT o Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT. |
Invio
JdbcStatement: un'istanza di istruzione con cui eseguire le query.
createStruct(typeName, attributes)
Per la documentazione di questo metodo, consulta
java.sql.Connection#createStruct(String, Object[]).
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
typeName | String | Il nome SQL specifico del database dell'array degli elementi di testo. Le opzioni includono i tipi integrati, i tipi definiti dall'utente o i tipi SQL standard supportati dal database. |
attributes | Object[] | Gli attributi che popolano l'oggetto restituito. |
Invio
JdbcStruct: un oggetto struttura che viene mappato al tipo SQL specificato e che viene compilato con
attributi.
getAutoCommit()
Per la documentazione di questo metodo, consulta
java.sql.Connection#getAutoCommit().
Invio
Boolean - true se la modalità di commit automatico della connessione è abilitata. false negli altri casi.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/script.external_request
getCatalog()
o la documentazione di questo metodo, consulta
java.sql.Connection#getCatalog().
Invio
String: nome catalogo corrente o null se non è stato impostato alcun nome.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/script.external_request
getHoldability()
Per la documentazione di questo metodo, consulta
java.sql.Connection#getHoldability().
Invio
Integer: l'impostazione relativa alla proprietà della connessione. Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT o Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT.
getMetaData()
Per la documentazione di questo metodo, consulta
java.sql.Connection#getMetaData().
Invio
JdbcDatabaseMetaData: i metadati del database a cui si collega questa connessione.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/script.external_request
getTransactionIsolation()
Per la documentazione di questo metodo, consulta
java.sql.Connection#getTransactionIsolation().
Invio
Integer: livello corrente della transazione, che può essere Jdbc.Connection.TRANSACTION_READ_UNCOMMITTED, Jdbc.Connection.TRANSACTION_READ_COMMITTED, Jdbc.Connection.TRANSACTION_REPEATABLE_READ, Jdbc.Connection.TRANSACTION_SERIALIZABLE o Jdbc.Connection.TRANSACTION_NONE.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/script.external_request
getWarnings()
Per la documentazione di questo metodo, consulta
java.sql.Connection#getWarnings().
Invio
String[]: un array di stringhe di avviso.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/script.external_request
isClosed()
Per la documentazione di questo metodo, consulta
java.sql.Connection#isClosed().
Invio
Boolean: true se la connessione è chiusa. false negli altri casi.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/script.external_request
isReadOnly()
Per la documentazione di questo metodo, consulta
java.sql.Connection#isReadOnly().
Invio
Boolean: true se la connessione è di sola lettura; false negli altri casi.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/script.external_request
isValid(timeout)
Per la documentazione di questo metodo, consulta
java.sql.Connection#isValid(int).
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
timeout | Integer | Il tempo in secondi di attesa per il completamento dell'operazione di convalida. Il valore 0 indica che non è stato applicato alcun timeout. |
Invio
Boolean: true se la connessione è valida. false negli altri casi. Restituisce false anche se il periodo di timeout scade prima del completamento dell'operazione.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/script.external_request
nativeSQL(sql)
Per la documentazione di questo metodo, consulta
java.sql.Connection#nativeSQL(String).
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
sql | String | Un'istruzione SQL che può contenere un altro carattere "?" segnaposto. |
Invio
String: la forma nativa dell'affermazione fornita.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/script.external_request
prepareCall(sql)
Per la documentazione di questo metodo, consulta
java.sql.Connection#prepareCall(String).
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
sql | String | Un'istruzione SQL che può contenere un altro carattere "?" segnaposto, di solito forniti usando la sintassi di escape delle chiamate JDBC. |
Invio
JdbcCallableStatement: un'istruzione richiamabile contenente l'istruzione SQL precompilata.
prepareCall(sql, resultSetType, resultSetConcurrency)
Per la documentazione di questo metodo, consulta
java.sql.Connection#prepareCall(String, int, int).
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
sql | String | Un'istruzione SQL che può contenere un altro carattere "?" segnaposto, di solito forniti usando la sintassi di escape delle chiamate JDBC. |
resultSetType | Integer | Un tipo di set di risultati; uno tra Jdbc.ResultSet.TYPE_FORWARD_ONLY, Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE o Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE. |
resultSetConcurrency | Integer | Un tipo di contemporaneità; Jdbc.ResultSet.CONCUR_READ_ONLY
o Jdbc.ResultSet.CONCUR_UPDATABLE. |
Invio
JdbcCallableStatement: un'istruzione richiamabile contenente l'istruzione SQL precompilata che produce il risultato
con il tipo e la contemporaneità forniti.
prepareCall(sql, resultSetType, resultSetConcurrency, resultSetHoldability)
Per la documentazione di questo metodo, consulta
java.sql.Connection#prepareCall(String, int, int, int).
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
sql | String | Un'istruzione SQL che può contenere un altro carattere "?" segnaposto, di solito forniti usando la sintassi di escape delle chiamate JDBC. |
resultSetType | Integer | Un tipo di set di risultati; uno tra Jdbc.ResultSet.TYPE_FORWARD_ONLY, Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE o Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE. |
resultSetConcurrency | Integer | Un tipo di contemporaneità; Jdbc.ResultSet.CONCUR_READ_ONLY
o Jdbc.ResultSet.CONCUR_UPDATABLE. |
resultSetHoldability | Integer | Un'impostazione di conservazione; Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT o Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT. |
Invio
JdbcCallableStatement: un'istruzione richiamabile contenente l'istruzione SQL precompilata che produce il risultato
con il tipo fornito, ovvero contemporanei.
prepareStatement(sql)
Per la documentazione di questo metodo, consulta
java.sql.Connection#prepareStatement(String).
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
sql | String | Un'istruzione SQL che può contenere un altro carattere "?" segnaposto del parametro IN. |
Invio
JdbcPreparedStatement: un'istruzione preparata contenente l'istruzione SQL precompilata.
prepareStatement(sql, autoGeneratedKeys)
Per la documentazione di questo metodo, consulta
java.sql.Connection#prepareStatement(String, int).
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
sql | String | Un'istruzione SQL che può contenere un altro carattere "?" segnaposto del parametro IN. |
autoGeneratedKeys | Integer | Un flag che indica se vengono restituite chiavi generate automaticamente; o
Jdbc.Statement.RETURN_GENERATED_KEYS o Jdbc.Statement.NO_GENERATED_KEYS. |
Invio
JdbcPreparedStatement: un'istruzione preparata contenente l'istruzione SQL precompilata, potenzialmente in grado di
che restituiscono chiavi generate automaticamente.
prepareStatement(sql, resultSetType, resultSetConcurrency)
Per la documentazione di questo metodo, consulta
java.sql.Connection#prepareStatement(String, int, int).
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
sql | String | Un'istruzione SQL che può contenere un altro carattere "?" segnaposto del parametro IN. |
resultSetType | Integer | Un tipo di set di risultati; uno tra Jdbc.ResultSet.TYPE_FORWARD_ONLY, Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE o Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE. |
resultSetConcurrency | Integer | Un tipo di contemporaneità; Jdbc.ResultSet.CONCUR_READ_ONLY
o Jdbc.ResultSet.CONCUR_UPDATABLE. |
Invio
JdbcPreparedStatement: un'istruzione preparata contenente l'istruzione SQL precompilata che produce il risultato
con il tipo e la contemporaneità forniti.
prepareStatement(sql, resultSetType, resultSetConcurrency, resultSetHoldability)
Per la documentazione di questo metodo, consulta
java.sql.Connection#prepareStatement(String, int, int, int).
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
sql | String | Un'istruzione SQL che può contenere un altro carattere "?" segnaposto del parametro IN. |
resultSetType | Integer | Un tipo di set di risultati; uno tra Jdbc.ResultSet.TYPE_FORWARD_ONLY, Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE o Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE. |
resultSetConcurrency | Integer | Un tipo di contemporaneità; Jdbc.ResultSet.CONCUR_READ_ONLY
o Jdbc.ResultSet.CONCUR_UPDATABLE. |
resultSetHoldability | Integer | Un'impostazione di conservazione; Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT o Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT. |
Invio
JdbcPreparedStatement: un'istruzione preparata contenente l'istruzione SQL precompilata che produce il risultato
set con il tipo, la contemporaneità e la conservazione forniti.
prepareStatementByIndex(sql, indices)
Per la documentazione di questo metodo, consulta
java.sql.Connection#prepareStatement(String, int[]).
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
sql | String | Un'istruzione SQL che può contenere un altro carattere "?" segnaposto del parametro IN. |
indices | Integer[] | Gli indici delle colonne restituiti dalle righe inserite. |
Invio
JdbcPreparedStatement: un'istruzione preparata contenente l'istruzione SQL precompilata, in grado di restituire
Chiavi generate automaticamente specificate dagli indici di colonna forniti.
prepareStatementByName(sql, columnNames)
Per la documentazione di questo metodo, consulta
java.sql.Connection#prepareStatement(String, String[]).
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
sql | String | Un'istruzione SQL che può contenere un altro carattere "?" segnaposto del parametro IN. |
columnNames | String[] | I nomi delle colonne che specificano le colonne da cui deve essere restituito il metodo la riga o le righe inserite. |
Invio
JdbcPreparedStatement: un'istruzione preparata contenente l'istruzione SQL precompilata, in grado di restituire
e generate automaticamente specificate dai nomi delle colonne forniti.
releaseSavepoint(savepoint)
Per la documentazione di questo metodo, consulta
java.sql.Connection#releaseSavepoint(Savepoint).
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
savepoint | JdbcSavepoint | Il punto di salvataggio da rimuovere. |
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/script.external_request
rollback()
Per la documentazione di questo metodo, consulta
java.sql.Connection#rollback().
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/script.external_request
rollback(savepoint)
Per la documentazione di questo metodo, consulta
java.sql.Connection#rollback(Savepoint).
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
savepoint | JdbcSavepoint | Il punto di salvataggio a cui eseguire il rollback. |
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/script.external_request
setAutoCommit(autoCommit)
Per la documentazione di questo metodo, consulta
java.sql.Connection#setAutoCommit(boolean).
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
autoCommit | Boolean | Se true, la modalità di commit automatico è abilitata. Disattivazione di false effettuata. |
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/script.external_request
setCatalog(catalog)
Per la documentazione di questo metodo, consulta
java.sql.Connection#setCatalog(String).
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
catalog | String | Il nome di un catalogo (il sottospazio nel database della connessione) in cui al lavoro. |
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/script.external_request
setHoldability(holdability)
Per la documentazione di questo metodo, consulta
java.sql.Connection#setHoldability(int).
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
holdability | Integer | La proprietà predefinita di JdbcResultSet oggetti creati con questo
connessione; Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT o Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT. |
setReadOnly(readOnly)
Per la documentazione di questo metodo, consulta
java.sql.Connection#setReadOnly(boolean).
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
readOnly | Boolean | Se true, la modalità di sola lettura è attivata. Disattivazione di false effettuata. |
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/script.external_request
setSavepoint()
Per la documentazione di questo metodo, consulta
java.sql.Connection#setSavepoint().
Invio
JdbcSavepoint: il nuovo punto di salvataggio senza nome.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/script.external_request
setSavepoint(name)
Per la documentazione di questo metodo, consulta
java.sql.Connection#setSavepoint(String).
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
name | String | Il nome del punto di salvataggio creato. |
Invio
JdbcSavepoint: il nuovo punto di salvataggio denominato.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/script.external_request
setTransactionIsolation(level)
Per la documentazione di questo metodo, consulta
java.sql.Connection#setTransactionIsolation(int).
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
level | Integer | Il livello di transazione da impostare, che è uno tra: Jdbc.Connection.TRANSACTION_READ_UNCOMMITTED, Jdbc.Connection.TRANSACTION_READ_COMMITTED, Jdbc.Connection.TRANSACTION_REPEATABLE_READ, Jdbc.Connection.TRANSACTION_SERIALIZABLE o Jdbc.Connection.TRANSACTION_NONE. |
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/script.external_request