Un Connection
JDBC. Pour plus d'informations sur cette classe, consultez
java.sql.Connection
.
Méthodes
Documentation détaillée
clearWarnings()
Pour en savoir plus sur cette méthode, consultez
java.sql.Connection#clearWarnings()
.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/script.external_request
close()
Libérez la base de données de cette connexion et toutes les ressources associées.
var conn = Jdbc.getConnection("jdbc:mysql://<host>:<port>/<instance>", "user", "password"); conn.close();
Voir aussi
-
Connection.close()
commit()
Rend toutes les modifications en attente permanentes et libère les verrous de base de données conservés par ce 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();
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/script.external_request
Voir aussi
-
Connection.commit()
createArrayOf(typeName, elements)
Pour en savoir plus sur cette méthode, consultez
java.sql.Connection#createArrayOf(String, Object[])
.
Paramètres
Nom | Type | Description |
---|---|---|
typeName | String | Nom SQL spécifique à la base de données du type des éléments du tableau. Les options incluent les types intégrés, les types définis par l'utilisateur ou les types SQL standard compatibles avec la base de données. |
elements | Object[] | Éléments à renseigner dans l'objet renvoyé. |
Renvois
JdbcArray
: tableau dont les éléments correspondent au type SQL spécifié.
createBlob()
Construit une instance JdbcBlob
. Voir également
java.sql.Connection#createBlob()
.
L'objet renvoyé initialement ne contient aucune donnée. Vous pouvez utiliser les méthodes setBytes
de JdbcBlob
pour définir les données qu'elle doit contenir. Ce blob est différent de celui créé avec Utilities.newBlob(data)
. Pour effectuer la conversion entre les deux formats, utilisez les méthodes getBytes()
et setBytes()
définies.
JdbcBlob
et JdbcClob
fournissent également une méthode pratique getAppsScriptBlob()
pour la conversion dans un format compatible avec Apps Script.
Renvois
JdbcBlob
: objet blob vide.
createClob()
Pour en savoir plus sur cette méthode, consultez
java.sql.Connection#createClob()
.
Renvois
JdbcClob
: objet Clob vide.
createNClob()
Pour en savoir plus sur cette méthode, consultez
java.sql.Connection#createNClob()
.
Renvois
JdbcClob
: objet nclob vide.
createSQLXML()
Pour en savoir plus sur cette méthode, consultez
java.sql.Connection#createSQLXML()
.
Renvois
JdbcSQLXML
: objet SQLXML vide.
createStatement()
Crée un objet JdbcStatement
pour envoyer des instructions SQL à la base de données. Consultez également la section sur
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();
Renvois
JdbcStatement
: instance d'instruction avec laquelle exécuter les requêtes.
createStatement(resultSetType, resultSetConcurrency)
Crée un objet JdbcStatement
pour envoyer des instructions SQL à la base de données. Consultez également la section sur
java.sql.Connection#createStatement(int, int)
.
Cette version permet de remplacer le type d'ensemble de résultats et la simultanéité.
// 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();
Paramètres
Nom | Type | Description |
---|---|---|
resultSetType | Integer | Type d'ensemble de résultats (Jdbc.ResultSet.TYPE_FORWARD_ONLY , Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE ou Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE ). |
resultSetConcurrency | Integer | Un type de simultanéité : Jdbc.ResultSet.CONCUR_READ_ONLY ou Jdbc.ResultSet.CONCUR_UPDATABLE |
Renvois
JdbcStatement
: instance d'instruction avec laquelle exécuter les requêtes.
createStatement(resultSetType, resultSetConcurrency, resultSetHoldability)
Crée un objet JdbcStatement
pour envoyer des instructions SQL à la base de données. Consultez également la section sur
java.sql.Connection#createStatement(int, int, int)
.
Cette version permet de remplacer le type d'ensemble de résultats, la simultanéité et la capacité de conservation.
// 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();
Paramètres
Nom | Type | Description |
---|---|---|
resultSetType | Integer | Type d'ensemble de résultats (Jdbc.ResultSet.TYPE_FORWARD_ONLY , Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE ou Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE ). |
resultSetConcurrency | Integer | Un type de simultanéité : Jdbc.ResultSet.CONCUR_READ_ONLY ou Jdbc.ResultSet.CONCUR_UPDATABLE |
resultSetHoldability | Integer | Paramètre de maintien : Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT ou Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT . |
Renvois
JdbcStatement
: instance d'instruction avec laquelle exécuter les requêtes.
createStruct(typeName, attributes)
Pour en savoir plus sur cette méthode, consultez
java.sql.Connection#createStruct(String, Object[])
.
Paramètres
Nom | Type | Description |
---|---|---|
typeName | String | Nom SQL spécifique à la base de données du type des éléments du tableau. Les options incluent les types intégrés, les types définis par l'utilisateur ou les types SQL standard compatibles avec la base de données. |
attributes | Object[] | Attributs qui renseignent l'objet renvoyé. |
Renvois
JdbcStruct
: objet structure mis en correspondance avec le type SQL donné et renseigné avec les attributs indiqués.
getAutoCommit()
Pour en savoir plus sur cette méthode, consultez
java.sql.Connection#getAutoCommit()
.
Renvois
Boolean
: true
si le mode de commit automatique de la connexion est activé, false
dans le cas contraire.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/script.external_request
getCatalog()
ou la documentation de cette méthode, consultez
java.sql.Connection#getCatalog()
.
Renvois
String
: nom actuel du catalogue ou null
si aucun nom n'a été défini.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/script.external_request
getHoldability()
Pour en savoir plus sur cette méthode, consultez
java.sql.Connection#getHoldability()
.
Renvois
Integer
: paramètre de maintien de la connexion (Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT
ou Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT
).
getMetaData()
Pour en savoir plus sur cette méthode, consultez
java.sql.Connection#getMetaData()
.
Renvois
JdbcDatabaseMetaData
: métadonnées de la base de données à laquelle cette connexion se connecte.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/script.external_request
getTransactionIsolation()
Pour en savoir plus sur cette méthode, consultez
java.sql.Connection#getTransactionIsolation()
.
Renvois
Integer
: niveau actuel de la transaction, soit Jdbc.Connection.TRANSACTION_READ_UNCOMMITTED
, Jdbc.Connection.TRANSACTION_READ_COMMITTED
, Jdbc.Connection.TRANSACTION_REPEATABLE_READ
, Jdbc.Connection.TRANSACTION_SERIALIZABLE
ou Jdbc.Connection.TRANSACTION_NONE
.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/script.external_request
getWarnings()
Pour en savoir plus sur cette méthode, consultez
java.sql.Connection#getWarnings()
.
Renvois
String[]
: tableau de chaînes d'avertissement.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/script.external_request
isClosed()
Pour en savoir plus sur cette méthode, consultez
java.sql.Connection#isClosed()
.
Renvois
Boolean
: true
si la connexion est fermée, false
dans le cas contraire.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/script.external_request
isReadOnly()
Pour en savoir plus sur cette méthode, consultez
java.sql.Connection#isReadOnly()
.
Renvois
Boolean
: true
si la connexion est en lecture seule, false
dans le cas contraire.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/script.external_request
isValid(timeout)
Pour en savoir plus sur cette méthode, consultez
java.sql.Connection#isValid(int)
.
Paramètres
Nom | Type | Description |
---|---|---|
timeout | Integer | Délai d'attente en secondes pour l'opération de validation. La valeur 0 indique qu'aucun délai d'inactivité n'est appliqué. |
Renvois
Boolean
: true
si la connexion est valide, false
dans le cas contraire. Renvoie également false
si le délai d'expiration expire avant la fin de l'opération.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/script.external_request
nativeSQL(sql)
Pour en savoir plus sur cette méthode, consultez
java.sql.Connection#nativeSQL(String)
.
Paramètres
Nom | Type | Description |
---|---|---|
sql | String | Une instruction SQL qui peut contenir un ou plusieurs espaces réservés "?". |
Renvois
String
: forme native de l'instruction fournie.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/script.external_request
prepareCall(sql)
Pour en savoir plus sur cette méthode, consultez
java.sql.Connection#prepareCall(String)
.
Paramètres
Nom | Type | Description |
---|---|---|
sql | String | Instruction SQL pouvant contenir un ou plusieurs espaces réservés "?", généralement fournis à l'aide de la syntaxe d'échappement d'appel JDBC. |
Renvois
JdbcCallableStatement
: instruction appelable contenant l'instruction SQL précompilée.
prepareCall(sql, resultSetType, resultSetConcurrency)
Pour en savoir plus sur cette méthode, consultez
java.sql.Connection#prepareCall(String, int, int)
.
Paramètres
Nom | Type | Description |
---|---|---|
sql | String | Instruction SQL pouvant contenir un ou plusieurs espaces réservés "?", généralement fournis à l'aide de la syntaxe d'échappement d'appel JDBC. |
resultSetType | Integer | Type d'ensemble de résultats (Jdbc.ResultSet.TYPE_FORWARD_ONLY , Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE ou Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE ). |
resultSetConcurrency | Integer | Un type de simultanéité : Jdbc.ResultSet.CONCUR_READ_ONLY ou Jdbc.ResultSet.CONCUR_UPDATABLE |
Renvois
JdbcCallableStatement
: instruction appelable contenant l'instruction SQL précompilée qui génère des ensembles de résultats avec le type et la simultanéité fournis.
prepareCall(sql, resultSetType, resultSetConcurrency, resultSetHoldability)
Pour en savoir plus sur cette méthode, consultez
java.sql.Connection#prepareCall(String, int, int, int)
.
Paramètres
Nom | Type | Description |
---|---|---|
sql | String | Instruction SQL pouvant contenir un ou plusieurs espaces réservés "?", généralement fournis à l'aide de la syntaxe d'échappement d'appel JDBC. |
resultSetType | Integer | Type d'ensemble de résultats (Jdbc.ResultSet.TYPE_FORWARD_ONLY , Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE ou Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE ). |
resultSetConcurrency | Integer | Un type de simultanéité : Jdbc.ResultSet.CONCUR_READ_ONLY ou Jdbc.ResultSet.CONCUR_UPDATABLE |
resultSetHoldability | Integer | Paramètre de maintien : Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT ou Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT . |
Renvois
JdbcCallableStatement
: instruction appelable contenant l'instruction SQL précompilée qui génère des ensembles de résultats avec le type fourni, à savoir la simultanéité.
prepareStatement(sql)
Pour en savoir plus sur cette méthode, consultez
java.sql.Connection#prepareStatement(String)
.
Paramètres
Nom | Type | Description |
---|---|---|
sql | String | Instruction SQL pouvant contenir un ou plusieurs espaces réservés de paramètre "?" IN. |
Renvois
JdbcPreparedStatement
: instruction préparée contenant l'instruction SQL précompilée.
prepareStatement(sql, autoGeneratedKeys)
Pour en savoir plus sur cette méthode, consultez
java.sql.Connection#prepareStatement(String, int)
.
Paramètres
Nom | Type | Description |
---|---|---|
sql | String | Instruction SQL pouvant contenir un ou plusieurs espaces réservés de paramètre "?" IN. |
autoGeneratedKeys | Integer | Indicateur indiquant si des clés générées automatiquement sont renvoyées (Jdbc.Statement.RETURN_GENERATED_KEYS ou Jdbc.Statement.NO_GENERATED_KEYS ). |
Renvois
JdbcPreparedStatement
: instruction préparée contenant l'instruction SQL précompilée, éventuellement capable de renvoyer des clés générées automatiquement.
prepareStatement(sql, resultSetType, resultSetConcurrency)
Pour en savoir plus sur cette méthode, consultez
java.sql.Connection#prepareStatement(String, int, int)
.
Paramètres
Nom | Type | Description |
---|---|---|
sql | String | Instruction SQL pouvant contenir un ou plusieurs espaces réservés de paramètre "?" IN. |
resultSetType | Integer | Type d'ensemble de résultats (Jdbc.ResultSet.TYPE_FORWARD_ONLY , Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE ou Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE ). |
resultSetConcurrency | Integer | Un type de simultanéité : Jdbc.ResultSet.CONCUR_READ_ONLY ou Jdbc.ResultSet.CONCUR_UPDATABLE |
Renvois
JdbcPreparedStatement
: instruction préparée contenant l'instruction SQL précompilée qui produit des ensembles de résultats avec le type et la simultanéité fournis.
prepareStatement(sql, resultSetType, resultSetConcurrency, resultSetHoldability)
Pour en savoir plus sur cette méthode, consultez
java.sql.Connection#prepareStatement(String, int, int, int)
.
Paramètres
Nom | Type | Description |
---|---|---|
sql | String | Instruction SQL pouvant contenir un ou plusieurs espaces réservés de paramètre "?" IN. |
resultSetType | Integer | Type d'ensemble de résultats (Jdbc.ResultSet.TYPE_FORWARD_ONLY , Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE ou Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE ). |
resultSetConcurrency | Integer | Un type de simultanéité : Jdbc.ResultSet.CONCUR_READ_ONLY ou Jdbc.ResultSet.CONCUR_UPDATABLE |
resultSetHoldability | Integer | Paramètre de maintien : Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT ou Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT . |
Renvois
JdbcPreparedStatement
: instruction préparée contenant l'instruction SQL précompilée qui génère des ensembles de résultats avec le type, la simultanéité et la capacité de retenue fournis.
prepareStatementByIndex(sql, indices)
Pour en savoir plus sur cette méthode, consultez
java.sql.Connection#prepareStatement(String, int[])
.
Paramètres
Nom | Type | Description |
---|---|---|
sql | String | Instruction SQL pouvant contenir un ou plusieurs espaces réservés de paramètre "?" IN. |
indices | Integer[] | Index de colonne des colonnes renvoyées à partir de la ou des lignes insérées. |
Renvois
JdbcPreparedStatement
: instruction préparée contenant l'instruction SQL précompilée, capable de renvoyer des clés générées automatiquement spécifiées par les index de colonne fournis.
prepareStatementByName(sql, columnNames)
Pour en savoir plus sur cette méthode, consultez
java.sql.Connection#prepareStatement(String, String[])
.
Paramètres
Nom | Type | Description |
---|---|---|
sql | String | Instruction SQL pouvant contenir un ou plusieurs espaces réservés de paramètre "?" IN. |
columnNames | String[] | Noms des colonnes qui spécifient les colonnes que la méthode doit renvoyer à partir de la ou des lignes insérées. |
Renvois
JdbcPreparedStatement
: instruction préparée contenant l'instruction SQL précompilée, capable de renvoyer des clés générées automatiquement spécifiées par les noms de colonne fournis.
releaseSavepoint(savepoint)
Pour en savoir plus sur cette méthode, consultez
java.sql.Connection#releaseSavepoint(Savepoint)
.
Paramètres
Nom | Type | Description |
---|---|---|
savepoint | JdbcSavepoint | Point d'enregistrement à supprimer. |
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/script.external_request
rollback()
Pour en savoir plus sur cette méthode, consultez
java.sql.Connection#rollback()
.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/script.external_request
rollback(savepoint)
Pour en savoir plus sur cette méthode, consultez
java.sql.Connection#rollback(Savepoint)
.
Paramètres
Nom | Type | Description |
---|---|---|
savepoint | JdbcSavepoint | Point d'enregistrement vers lequel effectuer le rollback. |
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/script.external_request
setAutoCommit(autoCommit)
Pour en savoir plus sur cette méthode, consultez
java.sql.Connection#setAutoCommit(boolean)
.
Paramètres
Nom | Type | Description |
---|---|---|
autoCommit | Boolean | Si la valeur est true , le mode de commit automatique est activé. false est désactivé. |
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/script.external_request
setCatalog(catalog)
Pour en savoir plus sur cette méthode, consultez
java.sql.Connection#setCatalog(String)
.
Paramètres
Nom | Type | Description |
---|---|---|
catalog | String | Nom d'un catalogue (le sous-espace de la base de données de la connexion) dans lequel travailler. |
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/script.external_request
setHoldability(holdability)
Pour en savoir plus sur cette méthode, consultez
java.sql.Connection#setHoldability(int)
.
Paramètres
Nom | Type | Description |
---|---|---|
holdability | Integer | Conservation par défaut des objets JdbcResultSet créés avec cette connexion (Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT ou Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT ). |
setReadOnly(readOnly)
Pour en savoir plus sur cette méthode, consultez
java.sql.Connection#setReadOnly(boolean)
.
Paramètres
Nom | Type | Description |
---|---|---|
readOnly | Boolean | Si la valeur est true , le mode lecture seule est activé. false est désactivé. |
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/script.external_request
setSavepoint()
Pour en savoir plus sur cette méthode, consultez
java.sql.Connection#setSavepoint()
.
Renvois
JdbcSavepoint
: nouveau point de sauvegarde sans nom.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/script.external_request
setSavepoint(name)
Pour en savoir plus sur cette méthode, consultez
java.sql.Connection#setSavepoint(String)
.
Paramètres
Nom | Type | Description |
---|---|---|
name | String | Nom du point d'enregistrement créé. |
Renvois
JdbcSavepoint
: nouveau point de sauvegarde nommé.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/script.external_request
setTransactionIsolation(level)
Pour en savoir plus sur cette méthode, consultez
java.sql.Connection#setTransactionIsolation(int)
.
Paramètres
Nom | Type | Description |
---|---|---|
level | Integer | Niveau de transaction à définir: Jdbc.Connection.TRANSACTION_READ_UNCOMMITTED , Jdbc.Connection.TRANSACTION_READ_COMMITTED , Jdbc.Connection.TRANSACTION_REPEATABLE_READ , Jdbc.Connection.TRANSACTION_SERIALIZABLE ou Jdbc.Connection.TRANSACTION_NONE . |
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation associée à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/script.external_request