Un Connection
JDBC. Pour en savoir plus sur cette classe, consultez
java.sql.Connection
.
Méthodes
Documentation détaillée
clear Warnings()
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 avec 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.
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, libère les verrous de base de données détenus par cette 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 champs d'application suivants:
-
https://www.googleapis.com/auth/script.external_request
Voir aussi
-
Connection.commit()
create Array Of(typeName, elements)
Pour en savoir plus sur 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 à renseigner dans l'objet renvoyé. |
Renvois
Jdbc
: tableau dont les éléments sont mappés au type SQL spécifié.
create Blob()
Crée une instance Jdbc
. Voir aussi
java.sql.Connection#createBlob()
.
L'objet renvoyé ne contient initialement 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 entre les deux formats, utilisez les méthodes get
et set
définies.
Jdbc
et Jdbc
fournissent également une méthode pratique get
pour convertir un format pouvant être utilisé par Apps Script.
Renvois
Jdbc
: objet blob vide.
create Clob()
Pour en savoir plus sur cette méthode, consultez
java.sql.Connection#createClob()
.
Renvois
Jdbc
: objet clob vide.
create NClob()
Pour en savoir plus sur cette méthode, consultez
java.sql.Connection#createNClob()
.
Renvois
Jdbc
: objet nclob vide.
create SQLXML()
Pour en savoir plus sur 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 à utiliser pour 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 concurrence.
// 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 résultat (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 à utiliser pour 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 concurrence et la rétention.
// 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 résultat (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 maintien, Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT ou Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT . |
Renvois
Jdbc
: instance d'instruction à utiliser pour exécuter des requêtes.
create Struct(typeName, attributes)
Pour en savoir plus sur 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 est renseigné avec les attributs donnés.
get Auto Commit()
Pour en savoir plus sur cette méthode, consultez
java.sql.Connection#getAutoCommit()
.
Renvois
Boolean
: true
si le mode de validation 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 champs d'application 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 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 champs d'application suivants:
-
https://www.googleapis.com/auth/script.external_request
get Holdability()
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
).
get Meta Data()
Pour en savoir plus sur 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 champs d'application suivants:
-
https://www.googleapis.com/auth/script.external_request
get Transaction Isolation()
Pour en savoir plus sur cette méthode, consultez
java.sql.Connection#getTransactionIsolation()
.
Renvois
Integer
: niveau de transaction actuel, qui peut être 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 champs d'application suivants:
-
https://www.googleapis.com/auth/script.external_request
get Warnings()
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 avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/script.external_request
is Closed()
Pour en savoir plus sur 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 champs d'application suivants:
-
https://www.googleapis.com/auth/script.external_request
is Read Only()
Pour en savoir plus sur 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 champs d'application suivants:
-
https://www.googleapis.com/auth/script.external_request
is Valid(timeout)
Pour en savoir plus sur cette méthode, consultez
java.sql.Connection#isValid(int)
.
Paramètres
Nom | Type | Description |
---|---|---|
timeout | Integer | Durée d'attente (en secondes) pour l'achèvement de l'opération de validation. La valeur 0 indique qu'aucun délai d'expiration n'est appliqué. |
Renvois
Boolean
: true
si la connexion est valide, false
dans le cas contraire. 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 champs d'application suivants:
-
https://www.googleapis.com/auth/script.external_request
native SQL(sql)
Pour en savoir plus sur 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 champs d'application suivants:
-
https://www.googleapis.com/auth/script.external_request
prepare Call(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
Jdbc
: instruction appelable contenant l'instruction SQL précompilée.
prepare Call(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. |
result | Integer | Type de résultat (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 génère des ensembles de résultats avec le type et la concurrence fournis.
prepare Call(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. |
result | Integer | Type de résultat (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 maintien, 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 génère des ensembles de résultats avec le type fourni, la concurrence.
prepare Statement(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
Jdbc
: instruction préparée contenant l'instruction SQL précompilée.
prepare Statement(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. |
auto | 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
Jdbc
: instruction préparée contenant l'instruction SQL précompilée, pouvant éventuellement renvoyer des clés générées automatiquement.
prepare Statement(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. |
result | Integer | Type de résultat (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 génère des ensembles de résultats avec le type et la concurrence fournis.
prepare Statement(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. |
result | Integer | Type de résultat (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 maintien, 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 génère des ensembles de résultats avec le type, la concurrence et la rétention fournis.
prepare Statement By Index(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[] | Indices 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 des clés générées automatiquement spécifiées par les indices de colonne fournis.
prepare Statement By Name(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. |
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 des clés générées automatiquement spécifiées par les noms de colonnes fournis.
release Savepoint(savepoint)
Pour en savoir plus sur cette méthode, consultez
java.sql.Connection#releaseSavepoint(Savepoint)
.
Paramètres
Nom | Type | Description |
---|---|---|
savepoint | Jdbc | Point d'enregistrement à supprimer. |
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec 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 avec 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 | Jdbc | Point d'enregistrement auquel effectuer le rollback. |
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/script.external_request
set Auto Commit(autoCommit)
Pour en savoir plus sur cette méthode, consultez
java.sql.Connection#setAutoCommit(boolean)
.
Paramètres
Nom | Type | Description |
---|---|---|
auto | Boolean | Si la valeur est true , le mode d'engagement automatique est activé. Si elle est false , il est désactivé. |
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/script.external_request
set Catalog(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 (sous-espace dans 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 champs d'application suivants:
-
https://www.googleapis.com/auth/script.external_request
set Holdability(holdability)
Pour en savoir plus sur cette méthode, consultez
java.sql.Connection#setHoldability(int)
.
Paramètres
Nom | Type | Description |
---|---|---|
holdability | Integer | Capacité de conservation 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 en savoir plus sur cette méthode, consultez
java.sql.Connection#setReadOnly(boolean)
.
Paramètres
Nom | Type | Description |
---|---|---|
read | Boolean | Si 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 champs d'application suivants:
-
https://www.googleapis.com/auth/script.external_request
set Savepoint()
Pour en savoir plus sur cette méthode, consultez
java.sql.Connection#setSavepoint()
.
Renvois
Jdbc
: nouveau point de sauvegarde sans nom.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/script.external_request
set Savepoint(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 de sauvegarde créé. |
Renvois
Jdbc
: nouveau point d'enregistrement nommé.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/script.external_request
set Transaction Isolation(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, parmi les valeurs suivantes: 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 champs d'application suivants:
-
https://www.googleapis.com/auth/script.external_request