Un objet JDBC Connection
. Pour obtenir de la documentation sur cette classe, consultez
java.sql.Connection
.
Méthodes
Documentation détaillée
clearWarnings()
Pour plus d'informations sur cette méthode, voir
java.sql.Connection#clearWarnings()
.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à 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 verrouillages de base de données détenus 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 correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/script.external_request
Voir aussi
-
Connection.commit()
createArrayOf(typeName, elements)
Pour plus d'informations sur cette méthode, voir
java.sql.Connection#createArrayOf(String, Object[])
.
Paramètres
Nom | Type | Description |
---|---|---|
typeName | String | Nom SQL spécifique à la base de données pour les éléments du tableau de mots clés. Les options sont les suivantes : types intégrés, définis par l'utilisateur ou types SQL standard pris en charge par la base de données. |
elements | Object[] | Éléments à renseigner dans l'objet renvoyé. |
Renvois
JdbcArray
: tableau dont les éléments sont mappés au type SQL spécifié.
createBlob()
Construit 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 est différent du
blob créé avec Utilities.newBlob(data)
. Pour convertir
entre les deux formats, utilisez les méthodes getBytes()
et setBytes()
définies.
JdbcBlob
et JdbcClob
fournissent également un getAppsScriptBlob()
.
pratique de conversion dans un format pouvant être utilisé par 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. Voir aussi
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 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) 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 | Un type d'ensemble de résultats ; au choix : 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 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 d'ignorer 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 | Un type d'ensemble de résultats ; au choix : 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 | Un paramètre de rétention Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT ou Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT . |
Renvois
JdbcStatement
: instance d'instruction avec laquelle exécuter des requêtes.
createStruct(typeName, attributes)
Pour plus d'informations sur cette méthode, voir
java.sql.Connection#createStruct(String, Object[])
.
Paramètres
Nom | Type | Description |
---|---|---|
typeName | String | Nom SQL spécifique à la base de données pour les éléments du tableau de mots clés. Les options sont les suivantes : types intégrés, définis par l'utilisateur ou types SQL standard pris en charge par la base de données. |
attributes | Object[] | Attributs qui renseignent l'objet renvoyé. |
Renvois
JdbcStruct
: objet de structure correspondant au type SQL donné et contenant la valeur
.
getAutoCommit()
Pour plus d'informations sur cette méthode, voir
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 correspondant à 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 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 correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/script.external_request
getHoldability()
Pour plus d'informations sur cette méthode, voir
java.sql.Connection#getHoldability()
.
Renvois
Integer
: paramètre de rétention 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 correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/script.external_request
getTransactionIsolation()
Pour plus d'informations sur cette méthode, voir
java.sql.Connection#getTransactionIsolation()
.
Renvois
Integer
: niveau de la transaction actuelle, à savoir 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 correspondant à 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 correspondant à 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 correspondant à 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 correspondant à 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, exprimé en secondes, jusqu'à la fin de l'opération de validation. Une valeur de 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 avant expiration expire avant la fin de l'opération.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/script.external_request
nativeSQL(sql)
Pour plus d'informations sur cette méthode, voir
java.sql.Connection#nativeSQL(String)
.
Paramètres
Nom | Type | Description |
---|---|---|
sql | String | Une instruction SQL pouvant contenir un autre caractère "?" des espaces réservés. |
Renvois
String
: forme native de l'instruction fournie.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/script.external_request
prepareCall(sql)
Pour plus d'informations sur cette méthode, voir
java.sql.Connection#prepareCall(String)
.
Paramètres
Nom | Type | Description |
---|---|---|
sql | String | Une instruction SQL pouvant contenir un autre caractère "?" des espaces réservés, généralement fournis à l'aide de la syntaxe d'échappement des appels JDBC. |
Renvois
JdbcCallableStatement
: instruction appelable contenant l'instruction SQL précompilée.
prepareCall(sql, resultSetType, resultSetConcurrency)
Pour plus d'informations sur cette méthode, voir
java.sql.Connection#prepareCall(String, int, int)
.
Paramètres
Nom | Type | Description |
---|---|---|
sql | String | Une instruction SQL pouvant contenir un autre caractère "?" des espaces réservés, généralement fournis à l'aide de la syntaxe d'échappement des appels JDBC. |
resultSetType | Integer | Un type d'ensemble de résultats ; au choix : 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 produit un résultat
avec le type et la simultanéité fournis.
prepareCall(sql, resultSetType, resultSetConcurrency, resultSetHoldability)
Pour plus d'informations sur cette méthode, voir
java.sql.Connection#prepareCall(String, int, int, int)
.
Paramètres
Nom | Type | Description |
---|---|---|
sql | String | Une instruction SQL pouvant contenir un autre caractère "?" des espaces réservés, généralement fournis à l'aide de la syntaxe d'échappement des appels JDBC. |
resultSetType | Integer | Un type d'ensemble de résultats ; au choix : 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 | Un paramètre de rétention 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 un résultat
avec le type fourni, la simultanéité.
prepareStatement(sql)
Pour plus d'informations sur cette méthode, voir
java.sql.Connection#prepareStatement(String)
.
Paramètres
Nom | Type | Description |
---|---|---|
sql | String | Une instruction SQL pouvant contenir un autre caractère "?" et les espaces réservés du paramètre IN. |
Renvois
JdbcPreparedStatement
: instruction préparée contenant l'instruction SQL précompilée.
prepareStatement(sql, autoGeneratedKeys)
Pour plus d'informations sur cette méthode, voir
java.sql.Connection#prepareStatement(String, int)
.
Paramètres
Nom | Type | Description |
---|---|---|
sql | String | Une instruction SQL pouvant contenir un autre caractère "?" et les espaces réservés du paramètre IN. |
autoGeneratedKeys | Integer | Indicateur qui indique si des clés générées automatiquement sont renvoyées l'un ou l'autre
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
et renvoient des clés générées automatiquement.
prepareStatement(sql, resultSetType, resultSetConcurrency)
Pour plus d'informations sur cette méthode, voir
java.sql.Connection#prepareStatement(String, int, int)
.
Paramètres
Nom | Type | Description |
---|---|---|
sql | String | Une instruction SQL pouvant contenir un autre caractère "?" et les espaces réservés du paramètre IN. |
resultSetType | Integer | Un type d'ensemble de résultats ; au choix : 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 un résultat
avec le type et la simultanéité fournis.
prepareStatement(sql, resultSetType, resultSetConcurrency, resultSetHoldability)
Pour plus d'informations sur cette méthode, voir
java.sql.Connection#prepareStatement(String, int, int, int)
.
Paramètres
Nom | Type | Description |
---|---|---|
sql | String | Une instruction SQL pouvant contenir un autre caractère "?" et les espaces réservés du paramètre IN. |
resultSetType | Integer | Un type d'ensemble de résultats ; au choix : 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 | Un paramètre de rétention 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 un résultat
avec le type, la simultanéité et la capacité de détention fournis.
prepareStatementByIndex(sql, indices)
Pour plus d'informations sur cette méthode, voir
java.sql.Connection#prepareStatement(String, int[])
.
Paramètres
Nom | Type | Description |
---|---|---|
sql | String | Une instruction SQL pouvant contenir un autre caractère "?" et les espaces réservés du paramètre IN. |
indices | Integer[] | Index de colonne des colonnes renvoyées à partir des lignes insérées. |
Renvois
JdbcPreparedStatement
: instruction préparée contenant l'instruction SQL précompilée, capable de renvoyer
clés générées automatiquement spécifiées par les index de colonne fournis.
prepareStatementByName(sql, columnNames)
Pour plus d'informations sur cette méthode, voir
java.sql.Connection#prepareStatement(String, String[])
.
Paramètres
Nom | Type | Description |
---|---|---|
sql | String | Une instruction SQL pouvant contenir un autre caractère "?" et les espaces réservés du paramètre IN. |
columnNames | String[] | Noms de colonne qui spécifient les colonnes à partir desquelles la méthode doit renvoyer la ou les lignes insérées. |
Renvois
JdbcPreparedStatement
: instruction préparée contenant l'instruction SQL précompilée, capable de renvoyer
clés générées automatiquement spécifiées par les noms de colonnes fournis.
releaseSavepoint(savepoint)
Pour plus d'informations sur cette méthode, voir
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 correspondant à 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 correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/script.external_request
rollback(savepoint)
Pour plus d'informations sur cette méthode, voir
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 correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/script.external_request
setAutoCommit(autoCommit)
Pour plus d'informations sur cette méthode, voir
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 correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/script.external_request
setCatalog(catalog)
Pour plus d'informations sur cette méthode, voir
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 travail. |
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/script.external_request
setHoldability(holdability)
Pour plus d'informations sur cette méthode, voir
java.sql.Connection#setHoldability(int)
.
Paramètres
Nom | Type | Description |
---|---|---|
holdability | Integer | La conservation par défaut des objets JdbcResultSet créés avec
connexion ; Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT ou Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT . |
setReadOnly(readOnly)
Pour plus d'informations sur cette méthode, voir
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 correspondant à 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 d'enregistrement sans nom.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/script.external_request
setSavepoint(name)
Pour plus d'informations sur cette méthode, voir
java.sql.Connection#setSavepoint(String)
.
Paramètres
Nom | Type | Description |
---|---|---|
name | String | Nom du point d'enregistrement créé. |
Renvois
JdbcSavepoint
: nouveau point d'enregistrement nommé.
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/script.external_request
setTransactionIsolation(level)
Pour plus d'informations sur cette méthode, voir
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 correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/script.external_request