Un Connection
JDBC. Pour obtenir la documentation de cette classe, consultez
java.sql.Connection
.
Méthodes
Documentation détaillée
clear Warnings()
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 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();
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()
create Array Of(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
Jdbc
: tableau dont les éléments correspondent au type SQL spécifié.
create Blob()
Crée une instance Jdbc
. Voir aussi
java.sql.Connection#createBlob()
.
L'objet renvoyé initialement ne contient aucune donnée. Vous pouvez utiliser les méthodes set
de Jdbc
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 get
et set
définies.
Jdbc
et Jdbc
fournissent également une méthode pratique get
pour la conversion dans un format utilisable par Apps Script.
Renvois
Jdbc
: objet blob vide.
create Clob()
Pour obtenir la documentation de cette méthode, consultez
java.sql.Connection#createClob()
.
Renvois
Jdbc
: objet CLOB vide.
create NClob()
Pour obtenir la documentation de cette méthode, consultez
java.sql.Connection#createNClob()
.
Renvois
Jdbc
: objet nclob vide.
create SQLXML()
Pour obtenir la documentation de cette méthode, consultez
java.sql.Connection#createSQLXML()
.
Renvois
Jdbc
: objet SQLXML vide.
create Statement()
Crée un objet Jdbc
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
Jdbc
: instance d'instruction permettant d'exécuter des requêtes.
create Statement(resultSetType, resultSetConcurrency)
Crée un objet Jdbc
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
Jdbc
: instance d'instruction permettant d'exécuter des requêtes.
create Statement(resultSetType, resultSetConcurrency, resultSetHoldability)
Crée un objet Jdbc
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 de jeu de résultats, la simultanéité et la capacité de maintien.
// 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
Jdbc
: instance d'instruction permettant d'exécuter des requêtes.
create Struct(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
Jdbc
: objet de structure qui correspond au type SQL donné et qui est renseigné avec les attributs donnés.
get Auto Commit()
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
get Catalog()
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 avec un ou plusieurs des scopes suivants :
-
https://www.googleapis.com/auth/script.external_request
get Holdability()
Pour obtenir la documentation de cette méthode, consultez
java.sql.Connection#getHoldability()
.
Renvois
Integer
: paramètre de capacité de rétention de la connexion (Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT
ou Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT
).
get Meta Data()
Pour obtenir la documentation de cette méthode, consultez
java.sql.Connection#getMetaData()
.
Renvois
Jdbc
: 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
get Transaction Isolation()
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
get Warnings()
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
is Closed()
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
is Read Only()
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
is Valid(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. La valeur 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
native SQL(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 la déclaration 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
prepare Call(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
Jdbc
: instruction appelable contenant l'instruction SQL précompilée.
prepare Call(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
Jdbc
: instruction appelable contenant l'instruction SQL précompilée qui produit des ensembles de résultats avec le type et la concurrence fournis.
prepare Call(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
Jdbc
: instruction appelable contenant l'instruction SQL précompilée qui produit des ensembles de résultats avec le type et la concurrence fournis.
prepare Statement(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
Jdbc
: instruction préparée contenant l'instruction SQL précompilée.
prepare Statement(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
Jdbc
: instruction préparée contenant l'instruction SQL précompilée, pouvant renvoyer des clés générées automatiquement.
prepare Statement(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
Jdbc
: 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.
prepare Statement(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
Jdbc
: 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.
prepare Statement By Index(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
Jdbc
: 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.
prepare Statement By Name(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
Jdbc
: 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.
release Savepoint(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 revenir. |
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
set Auto Commit(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
set Catalog(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
set Holdability(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 retenue par défaut des objets Jdbc créés avec cette connexion (Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT ou Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT ). |
set Read Only(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
set Savepoint()
Pour obtenir la documentation de cette méthode, consultez
java.sql.Connection#setSavepoint()
.
Renvois
Jdbc
: le 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
set Savepoint(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
Jdbc
: 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
set Transaction Isolation(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