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 avec un ou plusieurs des champs d'application suivants :
-
https://www.googleapis.com/auth/script.external_request
close()
Libérer 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 permanentes toutes les modifications en attente, libère les verrous de base de données soumis à 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 avec 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 de la base de données du type d'éléments du tableau. Les options incluent des types intégrés, des types définis par l'utilisateur ou des types SQL standards compatibles avec la base de données. |
elements | Object[] | Éléments à renseigner dans l'objet renvoyé. |
Aller-retour
JdbcArray
: tableau dont les éléments correspondent au type SQL spécifié.
createBlob()
Construit une instance JdbcBlob
. Consultez également
java.sql.Connection#createBlob()
.
L'objet renvoyé ne contient initialement 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 effectuer la conversion d'un format à l'autre, utilisez les méthodes getBytes()
et setBytes()
définies.
Vous pouvez également JdbcBlob
et JdbcClob
getAppsScriptBlob()
conserver une méthode pratique de conversion dans un format compatible avec Apps Script.
Aller-retour
JdbcBlob
: objet blob vide.
createClob()
Pour en savoir plus sur cette méthode, consultez
java.sql.Connection#createClob()
.
Aller-retour
JdbcClob
: objet clob vide.
createNClob()
Pour en savoir plus sur cette méthode, consultez
java.sql.Connection#createNClob()
.
Aller-retour
JdbcClob
: objet nclob vide.
createSQLXML()
Pour en savoir plus sur cette méthode, consultez
java.sql.Connection#createSQLXML()
.
Aller-retour
JdbcSQLXML
: objet SQLXML vide.
createStatement()
Crée un objet JdbcStatement
pour envoyer des instructions SQL à la base de données. Consultez également 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();
Aller-retour
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. Consultez également 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 | Type de simultanéité : Jdbc.ResultSet.CONCUR_READ_ONLY ou Jdbc.ResultSet.CONCUR_UPDATABLE . |
Aller-retour
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. Consultez également java.sql.Connection#createStatement(int, int, int)
.
Cette version permet de remplacer le type d'ensemble de résultats, la simultanéité et la propriété.
// 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 | Type de simultanéité : Jdbc.ResultSet.CONCUR_READ_ONLY ou Jdbc.ResultSet.CONCUR_UPDATABLE . |
resultSetHoldability | Integer | Paramètre de possibilité de conserver une propriété Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT ou Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT . |
Aller-retour
JdbcStatement
: instance d'instruction avec laquelle exécuter des 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 de la base de données du type d'éléments du tableau. Les options incluent des types intégrés, des types définis par l'utilisateur ou des types SQL standards compatibles avec la base de données. |
attributes | Object[] | Attributs qui renseignent l'objet renvoyé. |
Aller-retour
JdbcStruct
: objet de structure qui correspond au type SQL donné et qui est renseigné avec les attributs donnés.
getAutoCommit()
Pour en savoir plus sur cette méthode, consultez java.sql.Connection#getAutoCommit()
.
Aller-retour
Boolean
: true
si le mode de commit automatique est activé. Sinon, false
.
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
getCatalog()
ou la documentation de cette méthode, consultez
java.sql.Connection#getCatalog()
.
Aller-retour
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
getHoldability()
Pour en savoir plus sur cette méthode, consultez java.sql.Connection#getHoldability()
.
Aller-retour
Integer
: paramètre de prévisibilité 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()
.
Aller-retour
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 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()
.
Aller-retour
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
getWarnings()
Pour en savoir plus sur cette méthode, consultez
java.sql.Connection#getWarnings()
.
Aller-retour
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
isClosed()
Pour en savoir plus sur cette méthode, consultez
java.sql.Connection#isClosed()
.
Aller-retour
Boolean
: true
si la connexion est fermée. Sinon, false
.
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
isReadOnly()
Pour en savoir plus sur cette méthode, consultez
java.sql.Connection#isReadOnly()
.
Aller-retour
Boolean
: true
si la connexion est en lecture seule, sinon false
.
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
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 la fin de l'opération de validation. La valeur 0 indique qu'aucun délai avant expiration n'est appliqué. |
Aller-retour
Boolean
: true
si la connexion est valide, sinon false
. 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
nativeSQL(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 "'". |
Aller-retour
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
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 de type JDBC, généralement fournis à l'aide de la syntaxe d'échappement d'appel JDBC. |
Aller-retour
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 de type JDBC, 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 | Type de simultanéité : Jdbc.ResultSet.CONCUR_READ_ONLY ou Jdbc.ResultSet.CONCUR_UPDATABLE . |
Aller-retour
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 de type JDBC, 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 | Type de simultanéité : Jdbc.ResultSet.CONCUR_READ_ONLY ou Jdbc.ResultSet.CONCUR_UPDATABLE . |
resultSetHoldability | Integer | Paramètre de possibilité de conserver une propriété Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT ou Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT . |
Aller-retour
JdbcCallableStatement
: instruction appelable contenant l'instruction SQL précompilée qui génère des ensembles de résultats avec le type fourni, 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 des paramètres "'". |
Aller-retour
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 des paramètres "'". |
autoGeneratedKeys | Integer | Un indicateur qui indique si des clés générées automatiquement sont renvoyées (Jdbc.Statement.RETURN_GENERATED_KEYS ou Jdbc.Statement.NO_GENERATED_KEYS ). |
Aller-retour
JdbcPreparedStatement
: instruction préparée contenant l'instruction SQL précompilée, pouvant éventuellement 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 des paramètres "'". |
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 | Type de simultanéité : Jdbc.ResultSet.CONCUR_READ_ONLY ou Jdbc.ResultSet.CONCUR_UPDATABLE . |
Aller-retour
JdbcPreparedStatement
: 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 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 des paramètres "'". |
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 | Type de simultanéité : Jdbc.ResultSet.CONCUR_READ_ONLY ou Jdbc.ResultSet.CONCUR_UPDATABLE . |
resultSetHoldability | Integer | Paramètre de possibilité de conserver une propriété Jdbc.ResultSet.HOLD_CURSORS_OVER_COMMIT ou Jdbc.ResultSet.CLOSE_CURSORS_AT_COMMIT . |
Aller-retour
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 possibilité de préhension 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 des paramètres "'". |
indices | Integer[] | Index des colonnes renvoyées à partir des lignes insérées. |
Aller-retour
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 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 des paramètres "'". |
columnNames | String[] | Noms des colonnes spécifiant les colonnes que la méthode doit renvoyer à partir des lignes insérées. |
Aller-retour
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 colonnes 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 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 | JdbcSavepoint | Point de sauvegarde sur lequel 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
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 avec 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 (sous-espace dans la base de données de 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
setHoldability(holdability)
Pour en savoir plus sur cette méthode, consultez java.sql.Connection#setHoldability(int)
.
Paramètres
Nom | Type | Description |
---|---|---|
holdability | Integer | Disponibilité 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 avec 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()
.
Aller-retour
JdbcSavepoint
: nouveau point d'enregistrement 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
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éé. |
Aller-retour
JdbcSavepoint
: 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
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 avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/script.external_request