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.
var 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
.
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();
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 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();
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) 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();
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) 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();
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