Class Jdbc

Jdbc

Le service JDBC permet aux scripts de se connecter aux bases de données Google Cloud SQL, MySQL, Microsoft SQL Server et Oracle. Pour en savoir plus, consultez le guide JDBC.

Méthodes

Méthode	Type renvoyé	Brève description
getCloudSqlConnection(url)	JdbcConnection	Tente d'établir une connexion à l'URL Google Cloud SQL indiquée.
getCloudSqlConnection(url, info)	JdbcConnection	Tente d'établir une connexion à l'URL Google Cloud SQL indiquée.
getCloudSqlConnection(url, userName, password)	JdbcConnection	Tente d'établir une connexion à l'URL Google Cloud SQL indiquée.
getConnection(url)	JdbcConnection	Tentatives d'établissement d'une connexion à l'URL de la base de données spécifiée.
getConnection(url, info)	JdbcConnection	Tentatives d'établissement d'une connexion à l'URL de la base de données spécifiée.
getConnection(url, userName, password)	JdbcConnection	Tentatives d'établir une connexion à la base de données spécifiée à l'aide d'un nom d'utilisateur et d'un mot de passe.
newDate(milliseconds)	JdbcDate	Crée une date à partir de millisecondes depuis l'epoch.
newTime(milliseconds)	JdbcTime	Créez une heure à partir de millisecondes depuis l'epoch.
newTimestamp(milliseconds)	JdbcTimestamp	Créez un code temporel à partir de millisecondes depuis l'epoch.
parseDate(date)	JdbcDate	Créez une date en analysant la chaîne de date SQL.
parseTime(time)	JdbcTime	Créez une heure en analysant la chaîne de temps SQL.
parseTimestamp(timestamp)	JdbcTimestamp	Créez un code temporel en analysant la chaîne de code temporel SQL.

Documentation détaillée

getCloudSqlConnection(url)

Tente d'établir une connexion à l'URL Google Cloud SQL indiquée.

Paramètres

Nom	Type	Description
url	String	URL de base de données au format jdbc:google:mysql://subname.

Renvois

JdbcConnection : objet JdbcConnection.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

• https://www.googleapis.com/auth/sqlservice

---

getCloudSqlConnection(url, info)

Tente d'établir une connexion à l'URL Google Cloud SQL indiquée.

Paramètres

Nom	Type	Description
url	String	URL de base de données au format jdbc:google:mysql://subname.
info	Object	Objet JavaScript facultatif spécifiant les paramètres avancés définis ci-dessous.

Paramètres avancés

Nom	Type	Description
connectTimeoutSeconds	Integer	Délai avant expiration de la connexion en secondes
database	String	la base de données à laquelle se connecter ;
instance	String	le nom d'une instance de service SQL Google.
password	String	le mot de passe de l'utilisateur.
queryTimeoutSeconds	Integer	Délai avant expiration de la requête en secondes
user	String	Nom d'utilisateur à transmettre à la base de données

Renvois

JdbcConnection : objet JdbcConnection.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

• https://www.googleapis.com/auth/sqlservice

---

getCloudSqlConnection(url, userName, password)

Tente d'établir une connexion à l'URL Google Cloud SQL indiquée.

Paramètres

Nom	Type	Description
url	String	URL de base de données au format jdbc:google:mysql://subname.
userName	String	Nom d'utilisateur à transmettre à la base de données.
password	String	Mot de passe de l'utilisateur.

Renvois

JdbcConnection : objet JdbcConnection.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

• https://www.googleapis.com/auth/sqlservice

---

getConnection(url)

Tentatives d'établissement d'une connexion à l'URL de la base de données spécifiée.

const conn = Jdbc.getConnection(
    'jdbc:mysql://yoursqlserver.example.com:3306/database_name',
);

Paramètres

Nom	Type	Description
url	String	URL de base de données au format jdbc:subprotocol:subname.

Renvois

JdbcConnection : objet JdbcConnection.

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

---

getConnection(url, info)

Tentatives d'établissement d'une connexion à l'URL de la base de données spécifiée.

const conn = Jdbc.getConnection(
    'jdbc:mysql://yoursqlserver.example.com:3306/database_name',
    {user: 'username', password: 'password'},
);

Paramètres

Nom	Type	Description
url	String	URL de base de données au format jdbc:subprotocol:subname.
info	Object	Objet JavaScript facultatif spécifiant les paramètres avancés définis ci-dessous.

Paramètres avancés

Nom	Type	Description
databaseName	String	la base de données à laquelle se connecter ;
password	String	le mot de passe de l'utilisateur.
useJDBCCompliantTimeZoneShift	Boolean	indique si la connexion doit respecter les règles JDBC lors de la conversion des fuseaux horaires. La valeur par défaut est false.
user	String	Nom d'utilisateur à transmettre à la base de données
_serverSslCertificate	String	le certificat SSL du serveur.
_clientSslCertificate	String	le certificat SSL du client.
_clientSslKey	String	la clé SSL du client.

Renvois

JdbcConnection : objet JdbcConnection.

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

---

getConnection(url, userName, password)

Tentatives d'établir une connexion à la base de données spécifiée à l'aide d'un nom d'utilisateur et d'un mot de passe.

const conn = Jdbc.getConnection(
    'jdbc:mysql://yoursqlserver.example.com:3306/database_name',
    'username',
    'password',
);

Paramètres

Nom	Type	Description
url	String	URL de base de données au format jdbc:subprotocol:subname.
userName	String	Nom d'utilisateur à transmettre à la base de données.
password	String	Mot de passe de l'utilisateur.

Renvois

JdbcConnection : objet JdbcConnection.

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

---

newDate(milliseconds)

Crée une date à partir de millisecondes depuis l'epoch.

Paramètres

Nom	Type	Description
milliseconds	Integer	Millisecondes depuis l'epoch.

Renvois

JdbcDate : un objet JdbcDate.

---

newTime(milliseconds)

Créez une heure à partir de millisecondes depuis l'epoch.

Paramètres

Nom	Type	Description
milliseconds	Integer	Millisecondes depuis l'epoch.

Renvois

JdbcTime : objet JdbcTime.

---

newTimestamp(milliseconds)

Créez un code temporel à partir de millisecondes depuis l'epoch.

Paramètres

Nom	Type	Description
milliseconds	Integer	Millisecondes depuis l'epoch.

Renvois

JdbcTimestamp : objet JdbcTimestamp.

---

parseDate(date)

Créez une date en analysant la chaîne de date SQL.

Paramètres

Nom	Type	Description
date	String	Chaîne contenant une chaîne de date SQL.

Renvois

JdbcDate : un objet JdbcDate.

---

parseTime(time)

Créez une heure en analysant la chaîne de temps SQL.

Paramètres

Nom	Type	Description
time	String	Chaîne contenant une chaîne temporelle SQL.

Renvois

JdbcTime : objet JdbcTime.

---

parseTimestamp(timestamp)

Créez un code temporel en analysant la chaîne de code temporel SQL.

Paramètres

Nom	Type	Description
timestamp	String	Chaîne contenant une chaîne d'horodatage SQL.

Renvois

JdbcTimestamp : objet JdbcTimestamp.