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	Tentation d'établir une connexion à l'URL Google Cloud SQL donnée.
getCloudSqlConnection(url, info)	JdbcConnection	Tentation d'établir une connexion à l'URL Google Cloud SQL donnée.
getCloudSqlConnection(url, userName, password)	JdbcConnection	Tentation d'établir une connexion à l'URL Google Cloud SQL donnée.
getConnection(url)	JdbcConnection	Tentative d'établissement d'une connexion à l'URL de la base de données spécifiée.
getConnection(url, info)	JdbcConnection	Tentative d'établissement d'une connexion à l'URL de la base de données spécifiée.
getConnection(url, userName, password)	JdbcConnection	Tente d'établir une connexion à la base de données donné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)

Tentation d'établir une connexion à l'URL Google Cloud SQL donné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 champs d'application suivants:

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

---

getCloudSqlConnection(url, info)

Tentation d'établir une connexion à l'URL Google Cloud SQL donné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, comme défini 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	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	le 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 champs d'application suivants:

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

---

getCloudSqlConnection(url, userName, password)

Tentation d'établir une connexion à l'URL Google Cloud SQL donné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 champs d'application suivants:

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

---

getConnection(url)

Tentative 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 champs d'application suivants:

• https://www.googleapis.com/auth/script.external_request

---

getConnection(url, info)

Tentative 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, comme défini 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	si la connexion doit ou non respecter les règles JDBC lors de la conversion des fuseaux horaires. La valeur par défaut est false.
user	String	le 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 champs d'application suivants:

• https://www.googleapis.com/auth/script.external_request

---

getConnection(url, userName, password)

Tente d'établir une connexion à la base de données donné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 champs d'application 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 : 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 : 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 de code temporel SQL.

Renvois

JdbcTimestamp : objet JdbcTimestamp.