Un Connection
JDBC. Per la documentazione di questa classe, consulta
java.sql.Connection
.
Metodi
Documentazione dettagliata
clear Warnings()
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()
Esegui il rilascio del database di questa connessione e di tutte le risorse associate.
const conn = Jdbc.getConnection( 'jdbc:mysql://<host>:<port>/<instance>', 'user', 'password', ); conn.close();
Vedi anche
-
Connection.close()
commit()
Rendi permanenti tutte le modifiche in attesa, rilascia i blocchi del database detenuti da questo Jdbc
.
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()
create Array Of(typeName, elements)
Per la documentazione di questo metodo, consulta
java.sql.Connection#createArrayOf(String, Object[])
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
type | String | Il nome SQL specifico del database del tipo di elementi dell'array. Le opzioni includono tipi integrati, tipi definiti dall'utente o tipi SQL standard supportati dal database. |
elements | Object[] | Gli elementi da compilare nell'oggetto restituito. |
Invio
Jdbc
: un array i cui elementi vengono mappati al tipo SQL specificato.
create Blob()
Costruisce un'istanza Jdbc
. Vedi anche
java.sql.Connection#createBlob()
.
L'oggetto restituito inizialmente non contiene dati. Puoi utilizzare i metodi set
di
Jdbc
per impostare i dati che deve contenere. Il blob utilizzato qui non è uguale al
blob creato con Utilities.newBlob(data)
. Per eseguire la conversione tra i due formati, utilizza i metodi get
e set
definiti.
In alternativa, sia Jdbc
che Jdbc
forniscono un metodo di comodità get
per la conversione in un formato utilizzabile da Apps Script.
Invio
Jdbc
: un oggetto blob vuoto.
create Clob()
Per la documentazione di questo metodo, consulta
java.sql.Connection#createClob()
.
Invio
Jdbc
: un oggetto clob vuoto.
create NClob()
Per la documentazione di questo metodo, consulta
java.sql.Connection#createNClob()
.
Invio
Jdbc
: un oggetto nclob vuoto.
create SQLXML()
Per la documentazione di questo metodo, consulta
java.sql.Connection#createSQLXML()
.
Invio
Jdbc
: un oggetto SQLXML vuoto.
create Statement()
Crea un oggetto Jdbc
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
Jdbc
: un'istanza di istruzione con cui eseguire query.
create Statement(resultSetType, resultSetConcurrency)
Crea un oggetto Jdbc
per l'invio di istruzioni SQL al database. Vedi anche
java.sql.Connection#createStatement(int, int)
.
Questa versione consente di ignorare il tipo di insieme di risultati e la concorrenza.
// 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 |
---|---|---|
result | Integer | Un tipo di insieme di risultati; uno dei valori Jdbc.ResultSet.TYPE_FORWARD_ONLY , Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE o Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE . |
result | Integer | Un tipo di concorrenza: Jdbc.ResultSet.CONCUR_READ_ONLY
o Jdbc.ResultSet.CONCUR_UPDATABLE . |
Invio
Jdbc
: un'istanza di istruzione con cui eseguire query.
create Statement(resultSetType, resultSetConcurrency, resultSetHoldability)
Crea un oggetto Jdbc
per l'invio di istruzioni SQL al database. Vedi anche
java.sql.Connection#createStatement(int, int, int)
.
Questa versione consente di ignorare il tipo di insieme di risultati, la concorrenza e la tenacità.
// 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 |
---|---|---|
result | Integer | Un tipo di insieme di risultati; uno dei valori Jdbc.ResultSet.TYPE_FORWARD_ONLY , Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE o Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE . |
result | Integer | Un tipo di concorrenza: Jdbc.ResultSet.CONCUR_READ_ONLY
o Jdbc.ResultSet.CONCUR_UPDATABLE . |
result | Integer | Un'impostazione di trattenimento; Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT o Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT . |
Invio
Jdbc
: un'istanza di istruzione con cui eseguire query.
create Struct(typeName, attributes)
Per la documentazione di questo metodo, consulta
java.sql.Connection#createStruct(String, Object[])
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
type | String | Il nome SQL specifico del database del tipo di elementi dell'array. Le opzioni includono tipi integrati, tipi definiti dall'utente o tipi SQL standard supportati dal database. |
attributes | Object[] | Gli attributi che compilano l'oggetto restituito. |
Invio
Jdbc
: un oggetto struttura che viene mappato al tipo SQL specificato e compilato con gli attributi specificati.
get Auto Commit()
Per la documentazione di questo metodo, consulta
java.sql.Connection#getAutoCommit()
.
Invio
Boolean
- true
se la modalità di commit automatico della connessione è attivata; false
in caso contrario.
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
get Catalog()
o la documentazione di questo metodo, consulta
java.sql.Connection#getCatalog()
.
Invio
String
: il nome del 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
get Holdability()
Per la documentazione di questo metodo, consulta
java.sql.Connection#getHoldability()
.
Invio
Integer
: l'impostazione di trattenimento della connessione; Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT
o Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT
.
get Meta Data()
Per la documentazione di questo metodo, consulta
java.sql.Connection#getMetaData()
.
Invio
Jdbc
: i metadati del database a cui si connette 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
get Transaction Isolation()
Per la documentazione di questo metodo, consulta
java.sql.Connection#getTransactionIsolation()
.
Invio
Integer
: il livello di transazione corrente, 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
get Warnings()
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
is Closed()
Per la documentazione di questo metodo, consulta
java.sql.Connection#isClosed()
.
Invio
Boolean
- true
se la connessione è chiusa; false
in caso contrario.
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
is Read Only()
Per la documentazione di questo metodo, consulta
java.sql.Connection#isReadOnly()
.
Invio
Boolean
: true
se la connessione è di sola lettura; false
in caso contrario.
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
is Valid(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. Un valore pari a 0 indica che non viene applicato alcun timeout. |
Invio
Boolean
: true
se la connessione è valida; false
in caso contrario. Restituisce anche false
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
native SQL(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 uno o più segnaposto "?". |
Invio
String
: la forma nativa dell'istruzione 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
prepare Call(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 uno o più segnaposto "?", in genere forniti utilizzando la sintassi di escape della chiamata JDBC. |
Invio
Jdbc
: un'istruzione chiamabile contenente l'istruzione SQL precompilata.
prepare Call(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 uno o più segnaposto "?", in genere forniti utilizzando la sintassi di escape della chiamata JDBC. |
result | Integer | Un tipo di insieme di risultati; uno dei valori Jdbc.ResultSet.TYPE_FORWARD_ONLY , Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE o Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE . |
result | Integer | Un tipo di concorrenza: Jdbc.ResultSet.CONCUR_READ_ONLY
o Jdbc.ResultSet.CONCUR_UPDATABLE . |
Invio
Jdbc
: un'istruzione chiamabile contenente l'istruzione SQL precompilata che genera set di risultati con il tipo e la concorrenza forniti.
prepare Call(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 uno o più segnaposto "?", in genere forniti utilizzando la sintassi di escape della chiamata JDBC. |
result | Integer | Un tipo di insieme di risultati; uno dei valori Jdbc.ResultSet.TYPE_FORWARD_ONLY , Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE o Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE . |
result | Integer | Un tipo di concorrenza: Jdbc.ResultSet.CONCUR_READ_ONLY
o Jdbc.ResultSet.CONCUR_UPDATABLE . |
result | Integer | Un'impostazione di trattenimento; Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT o Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT . |
Invio
Jdbc
: un'istruzione chiamabile contenente l'istruzione SQL precompilata che produce set di risultati con il tipo fornito, la concorrenza.
prepare Statement(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 uno o più segnaposto del parametro "?" IN. |
Invio
Jdbc
: un'istruzione preparata contenente l'istruzione SQL precompilata.
prepare Statement(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 uno o più segnaposto del parametro "?" IN. |
auto | Integer | Un flag che indica se vengono restituite chiavi generate automaticamente:
Jdbc.Statement.RETURN_GENERATED_KEYS o Jdbc.Statement.NO_GENERATED_KEYS . |
Invio
Jdbc
: un'istruzione preparata contenente l'istruzione SQL precompilata, eventualmente in grado di
restituire chiavi generate automaticamente.
prepare Statement(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 uno o più segnaposto del parametro "?" IN. |
result | Integer | Un tipo di insieme di risultati; uno dei valori Jdbc.ResultSet.TYPE_FORWARD_ONLY , Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE o Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE . |
result | Integer | Un tipo di concorrenza: Jdbc.ResultSet.CONCUR_READ_ONLY
o Jdbc.ResultSet.CONCUR_UPDATABLE . |
Invio
Jdbc
: un'istruzione preparata contenente l'istruzione SQL precompilata che genera set di risultati con il tipo e la concorrenza specificati.
prepare Statement(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 uno o più segnaposto del parametro "?" IN. |
result | Integer | Un tipo di insieme di risultati; uno dei valori Jdbc.ResultSet.TYPE_FORWARD_ONLY , Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE o Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE . |
result | Integer | Un tipo di concorrenza: Jdbc.ResultSet.CONCUR_READ_ONLY
o Jdbc.ResultSet.CONCUR_UPDATABLE . |
result | Integer | Un'impostazione di trattenimento; Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT o Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT . |
Invio
Jdbc
: un'istruzione preparata contenente l'istruzione SQL precompilata che produce set di risultati con il tipo, la concorrenza e la tenacità forniti.
prepare Statement By Index(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 uno o più segnaposto del parametro "?" IN. |
indices | Integer[] | Gli indici delle colonne restituite dalla riga o dalle righe inserite. |
Invio
Jdbc
: un'istruzione preparata contenente l'istruzione SQL precompilata, in grado di restituire le chiavi generate automaticamente specificate dagli indici di colonna forniti.
prepare Statement By Name(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 uno o più segnaposto del parametro "?" IN. |
column | String[] | I nomi delle colonne che specificano le colonne che il metodo deve restituire dalla riga o dalle righe inserite. |
Invio
Jdbc
: un'istruzione preparata contenente l'istruzione SQL precompilata, in grado di restituire chiavi generate automaticamente specificate dai nomi di colonna forniti.
release Savepoint(savepoint)
Per la documentazione di questo metodo, consulta
java.sql.Connection#releaseSavepoint(Savepoint)
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
savepoint | Jdbc | 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 | Jdbc | 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
set Auto Commit(autoCommit)
Per la documentazione di questo metodo, consulta
java.sql.Connection#setAutoCommit(boolean)
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
auto | Boolean | Se true , la modalità di commit automatico è attivata; false la disattiva. |
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
set Catalog(catalog)
Per la documentazione di questo metodo, consulta
java.sql.Connection#setCatalog(String)
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
catalog | String | Il nome di un catalogo (lo spazio sottostante nel database della connessione) in cui lavorare. |
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
set Holdability(holdability)
Per la documentazione di questo metodo, consulta
java.sql.Connection#setHoldability(int)
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
holdability | Integer | La tenacità predefinita degli oggetti Jdbc creati con questa connessione; Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT o Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT . |
set Read Only(readOnly)
Per la documentazione di questo metodo, consulta
java.sql.Connection#setReadOnly(boolean)
.
Parametri
Nome | Tipo | Descrizione |
---|---|---|
read | Boolean | Se true , la modalità di sola lettura è attivata; false la disattiva. |
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
set Savepoint()
Per la documentazione di questo metodo, consulta
java.sql.Connection#setSavepoint()
.
Invio
Jdbc
: 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
set Savepoint(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
Jdbc
: 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
set Transaction Isolation(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 può essere uno dei seguenti: 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