Un Connection JDBC. Pour obtenir la documentation de cette classe, consultez
java.sql.Connection.
Méthodes
Documentation détaillée
clearWarnings()
Pour obtenir la documentation de cette méthode, consultez
java.sql.Connection#clearWarnings().
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes 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.
const 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 détenus par ce 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();
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :
-
https://www.googleapis.com/auth/script.external_request
Voir aussi
-
Connection.commit()
createArrayOf(typeName, elements)
Pour obtenir la documentation de cette méthode, consultez
java.sql.Connection#createArrayOf(String, Object[]).
Paramètres
| Nom | Type | Description |
|---|---|---|
type | 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 standards compatibles avec la base de données. |
elements | Object[] | Éléments à insérer dans l'objet renvoyé. |
Renvois
JdbcArray : tableau dont les éléments correspondent au type SQL spécifié.
createBlob()
Crée une instance JdbcBlob. Voir aussi
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'il doit contenir. Le blob utilisé ici n'est pas le même que celui créé avec Utilities.newBlob(data). Pour convertir 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 utilisable par Apps Script.
Renvois
JdbcBlob : objet blob vide.
createClob()
Pour obtenir la documentation de cette méthode, consultez
java.sql.Connection#createClob().
Renvois
JdbcClob : objet CLOB vide.
createNClob()
Pour obtenir la documentation de cette méthode, consultez
java.sql.Connection#createNClob().
Renvois
JdbcClob : objet nclob vide.
createSQLXML()
Pour obtenir la documentation de 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. Voir aussi
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();
Renvois
JdbcStatement : instance d'instruction permettant d'exécuter des requêtes.
createStatement(resultSetType, resultSetConcurrency)
Crée un objet JdbcStatement pour envoyer des instructions SQL à la base de données. Voir aussi
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) 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();
Paramètres
| Nom | Type | Description |
|---|---|---|
result | Integer | Type de jeu de résultats : Jdbc.ResultSet.TYPE_FORWARD_ONLY, Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE ou Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE. |
result | Integer | Type de simultanéité : Jdbc.ResultSet.CONCUR_READ_ONLY ou Jdbc.ResultSet.CONCUR_UPDATABLE. |
Renvois
JdbcStatement : instance d'instruction permettant d'exécuter des requêtes.
createStatement(resultSetType, resultSetConcurrency, resultSetHoldability)
Crée un objet JdbcStatement pour envoyer des instructions SQL à la base de données. Voir aussi
java.sql.Connection#createStatement(int, int, int).
Cette version permet de remplacer le type d'ensemble de résultats, la concurrence et la capacité de retenue.
// 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();
Paramètres
| Nom | Type | Description |
|---|---|---|
result | Integer | Type de jeu de résultats : Jdbc.ResultSet.TYPE_FORWARD_ONLY, Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE ou Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE. |
result | Integer | Type de simultanéité : Jdbc.ResultSet.CONCUR_READ_ONLY ou Jdbc.ResultSet.CONCUR_UPDATABLE. |
result | Integer | Paramètre de disponibilité : Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT ou Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT. |
Renvois
JdbcStatement : instance d'instruction permettant d'exécuter des requêtes.
createStruct(typeName, attributes)
Pour obtenir la documentation de cette méthode, consultez
java.sql.Connection#createStruct(String, Object[]).
Paramètres
| Nom | Type | Description |
|---|---|---|
type | 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 standards compatibles avec la base de données. |
attributes | Object[] | Attributs qui remplissent l'objet renvoyé. |
Renvois
JdbcStruct : objet de structure qui correspond au type SQL donné et qui est renseigné avec les attributs donnés.
getAutoCommit()
Pour obtenir la documentation de cette méthode, consultez
java.sql.Connection#getAutoCommit().
Renvois
Boolean : true si le mode commit automatique de la connexion est activé, false sinon.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes 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 du catalogue actuel ou null si aucun nom n'a été défini.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :
-
https://www.googleapis.com/auth/script.external_request
getHoldability()
Pour obtenir la documentation de cette méthode, consultez
java.sql.Connection#getHoldability().
Renvois
Integer : paramètre de disponibilité de la connexion (Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT ou Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT).
getMetaData()
Pour obtenir la documentation de 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 avec un ou plusieurs des scopes suivants :
-
https://www.googleapis.com/auth/script.external_request
getTransactionIsolation()
Pour obtenir la documentation de cette méthode, consultez
java.sql.Connection#getTransactionIsolation().
Renvois
Integer : niveau de transaction actuel (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 avec un ou plusieurs des scopes suivants :
-
https://www.googleapis.com/auth/script.external_request
getWarnings()
Pour obtenir la documentation de 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 avec un ou plusieurs des scopes suivants :
-
https://www.googleapis.com/auth/script.external_request
isClosed()
Pour obtenir la documentation de cette méthode, consultez
java.sql.Connection#isClosed().
Renvois
Boolean : true si la connexion est fermée, false sinon.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :
-
https://www.googleapis.com/auth/script.external_request
isReadOnly()
Pour obtenir la documentation de cette méthode, consultez
java.sql.Connection#isReadOnly().
Renvois
Boolean : true si la connexion est en lecture seule, false sinon.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :
-
https://www.googleapis.com/auth/script.external_request
isValid(timeout)
Pour obtenir la documentation de cette méthode, consultez
java.sql.Connection#isValid(int).
Paramètres
| Nom | Type | Description |
|---|---|---|
timeout | Integer | Temps d'attente (en secondes) pour que l'opération de validation se termine. Une valeur de 0 indique qu'aucun délai d'expiration n'est appliqué. |
Renvois
Boolean : true si la connexion est valide, false sinon. Renvoie également false si le délai avant expiration expire avant la fin de l'opération.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :
-
https://www.googleapis.com/auth/script.external_request
nativeSQL(sql)
Pour obtenir la documentation de cette méthode, consultez
java.sql.Connection#nativeSQL(String).
Paramètres
| Nom | Type | Description |
|---|---|---|
sql | String | Instruction SQL pouvant 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 avec un ou plusieurs des scopes suivants :
-
https://www.googleapis.com/auth/script.external_request
prepareCall(sql)
Pour obtenir la documentation de 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 obtenir la documentation de 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. |
result | Integer | Type de jeu de résultats : Jdbc.ResultSet.TYPE_FORWARD_ONLY, Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE ou Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE. |
result | Integer | 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 produit des ensembles de résultats avec le type et la concurrence fournis.
prepareCall(sql, resultSetType, resultSetConcurrency, resultSetHoldability)
Pour obtenir la documentation de 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. |
result | Integer | Type de jeu de résultats : Jdbc.ResultSet.TYPE_FORWARD_ONLY, Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE ou Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE. |
result | Integer | Type de simultanéité : Jdbc.ResultSet.CONCUR_READ_ONLY ou Jdbc.ResultSet.CONCUR_UPDATABLE. |
result | Integer | Paramètre de disponibilité : 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 produit des ensembles de résultats avec le type et la concurrence fournis.
prepareStatement(sql)
Pour obtenir la documentation de 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 pour les paramètres IN "?". |
Renvois
JdbcPreparedStatement : instruction préparée contenant l'instruction SQL précompilée.
prepareStatement(sql, autoGeneratedKeys)
Pour obtenir la documentation de 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 pour les paramètres IN "?". |
auto | Integer | Indicateur qui indique si les 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, pouvant renvoyer des clés générées automatiquement.
prepareStatement(sql, resultSetType, resultSetConcurrency)
Pour obtenir la documentation de 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 pour les paramètres IN "?". |
result | Integer | Type de jeu de résultats : Jdbc.ResultSet.TYPE_FORWARD_ONLY, Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE ou Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE. |
result | Integer | 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 concurrence fournis.
prepareStatement(sql, resultSetType, resultSetConcurrency, resultSetHoldability)
Pour obtenir la documentation de 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 pour les paramètres IN "?". |
result | Integer | Type de jeu de résultats : Jdbc.ResultSet.TYPE_FORWARD_ONLY, Jdbc.ResultSet.TYPE_SCROLL_INSENSITIVE ou Jdbc.ResultSet.TYPE_SCROLL_SENSITIVE. |
result | Integer | Type de simultanéité : Jdbc.ResultSet.CONCUR_READ_ONLY ou Jdbc.ResultSet.CONCUR_UPDATABLE. |
result | Integer | Paramètre de disponibilité : 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 produit des ensembles de résultats avec le type, la concurrence et la maintenabilité fournis.
prepareStatementByIndex(sql, indices)
Pour obtenir la documentation de 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 pour les paramètres IN "?". |
indices | Integer[] | Indices 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 les clés générées automatiquement spécifiées par les index de colonne fournis.
prepareStatementByName(sql, columnNames)
Pour obtenir la documentation de 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 pour les paramètres IN "?". |
column | 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 les clés générées automatiquement spécifiées par les noms de colonnes fournis.
releaseSavepoint(savepoint)
Pour obtenir la documentation de cette méthode, consultez
java.sql.Connection#releaseSavepoint(Savepoint).
Paramètres
| Nom | Type | Description |
|---|---|---|
savepoint | Jdbc | Point de sauvegarde à supprimer. |
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :
-
https://www.googleapis.com/auth/script.external_request
rollback()
Pour obtenir la documentation de cette méthode, consultez
java.sql.Connection#rollback().
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :
-
https://www.googleapis.com/auth/script.external_request
rollback(savepoint)
Pour obtenir la documentation de cette méthode, consultez
java.sql.Connection#rollback(Savepoint).
Paramètres
| Nom | Type | Description |
|---|---|---|
savepoint | Jdbc | Point de sauvegarde vers lequel effectuer le rollback. |
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :
-
https://www.googleapis.com/auth/script.external_request
setAutoCommit(autoCommit)
Pour obtenir la documentation de cette méthode, consultez
java.sql.Connection#setAutoCommit(boolean).
Paramètres
| Nom | Type | Description |
|---|---|---|
auto | Boolean | Si la valeur est true, le mode d'auto-commit est activé. false le désactive. |
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :
-
https://www.googleapis.com/auth/script.external_request
setCatalog(catalog)
Pour obtenir la documentation de cette méthode, consultez
java.sql.Connection#setCatalog(String).
Paramètres
| Nom | Type | Description |
|---|---|---|
catalog | String | Nom d'un catalogue (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 avec un ou plusieurs des scopes suivants :
-
https://www.googleapis.com/auth/script.external_request
setHoldability(holdability)
Pour obtenir la documentation de cette méthode, consultez
java.sql.Connection#setHoldability(int).
Paramètres
| Nom | Type | Description |
|---|---|---|
holdability | Integer | La capacité de maintien par défaut des objets Jdbc créés avec cette connexion (Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT ou Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT). |
setReadOnly(readOnly)
Pour obtenir la documentation de cette méthode, consultez
java.sql.Connection#setReadOnly(boolean).
Paramètres
| Nom | Type | Description |
|---|---|---|
read | Boolean | Si la valeur est true, le mode lecture seule est activé. false le désactive. |
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :
-
https://www.googleapis.com/auth/script.external_request
setSavepoint()
Pour obtenir la documentation de 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 avec un ou plusieurs des scopes suivants :
-
https://www.googleapis.com/auth/script.external_request
setSavepoint(name)
Pour obtenir la documentation de cette méthode, consultez
java.sql.Connection#setSavepoint(String).
Paramètres
| Nom | Type | Description |
|---|---|---|
name | String | Nom du point de sauvegarde créé. |
Renvois
JdbcSavepoint : le nouveau point de sauvegarde nommé.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :
-
https://www.googleapis.com/auth/script.external_request
setTransactionIsolation(level)
Pour obtenir la documentation de 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 avec un ou plusieurs des scopes suivants :
-
https://www.googleapis.com/auth/script.external_request