Un Connection
JDBC. Per la documentazione di questa classe, consulta
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()
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()
createArrayOf(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.
createBlob()
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.
createClob()
Per la documentazione di questo metodo, consulta
java.sql.Connection#createClob()
.
Invio
Jdbc
: un oggetto clob vuoto.
createNClob()
Per la documentazione di questo metodo, consulta
java.sql.Connection#createNClob()
.
Invio
Jdbc
: un oggetto nclob vuoto.
createSQLXML()
Per la documentazione di questo metodo, consulta
java.sql.Connection#createSQLXML()
.
Invio
Jdbc
: un oggetto SQLXML vuoto.
createStatement()
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.
createStatement(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.
createStatement(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.
createStruct(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.
getAutoCommit()
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
getCatalog()
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
getHoldability()
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
.
getMetaData()
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
getTransactionIsolation()
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
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
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
isReadOnly()
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
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. 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
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 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
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 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.
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 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.
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 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.
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 uno o più segnaposto del parametro "?" IN. |
Invio
Jdbc
: 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 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.
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 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.
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 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.
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 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.
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 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.
releaseSavepoint(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
setAutoCommit(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
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 (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
setHoldability(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 . |
setReadOnly(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
setSavepoint()
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
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
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
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 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