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éthodeType renvoyéBrève description
getCloudSqlConnection(url)JdbcConnectionTente d'établir une connexion à l'URL Google Cloud SQL indiquée.
getCloudSqlConnection(url, info)JdbcConnectionTente d'établir une connexion à l'URL Google Cloud SQL indiquée.
getCloudSqlConnection(url, userName, password)JdbcConnectionTente d'établir une connexion à l'URL Google Cloud SQL indiquée.
getConnection(url)JdbcConnectionTentatives d'établissement d'une connexion à l'URL de la base de données spécifiée.
getConnection(url, info)JdbcConnectionTentatives d'établissement d'une connexion à l'URL de la base de données spécifiée.
getConnection(url, userName, password)JdbcConnectionTentatives 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)JdbcDateCrée une date à partir de millisecondes depuis l'epoch.
newTime(milliseconds)JdbcTimeCréez une heure à partir de millisecondes depuis l'epoch.
newTimestamp(milliseconds)JdbcTimestampCréez un code temporel à partir de millisecondes depuis l'epoch.
parseDate(date)JdbcDateCréez une date en analysant la chaîne de date SQL.
parseTime(time)JdbcTimeCréez une heure en analysant la chaîne de temps SQL.
parseTimestamp(timestamp)JdbcTimestampCré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

NomTypeDescription
urlStringURL 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

NomTypeDescription
urlStringURL de base de données au format jdbc:google:mysql://subname.
infoObjectObjet JavaScript facultatif spécifiant les paramètres avancés définis ci-dessous.

Paramètres avancés

NomTypeDescription
connectTimeoutSecondsIntegerDélai avant expiration de la connexion en secondes
databaseStringla base de données à laquelle se connecter ;
instanceStringle nom d'une instance de service SQL Google.
passwordStringle mot de passe de l'utilisateur.
queryTimeoutSecondsIntegerDélai avant expiration de la requête en secondes
userStringNom 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

NomTypeDescription
urlStringURL de base de données au format jdbc:google:mysql://subname.
userNameStringNom d'utilisateur à transmettre à la base de données.
passwordStringMot 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

NomTypeDescription
urlStringURL 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

NomTypeDescription
urlStringURL de base de données au format jdbc:subprotocol:subname.
infoObjectObjet JavaScript facultatif spécifiant les paramètres avancés définis ci-dessous.

Paramètres avancés

NomTypeDescription
databaseNameStringla base de données à laquelle se connecter ;
passwordStringle mot de passe de l'utilisateur.
useJDBCCompliantTimeZoneShiftBooleanindique si la connexion doit respecter les règles JDBC lors de la conversion des fuseaux horaires. La valeur par défaut est false.
userStringNom d'utilisateur à transmettre à la base de données
_serverSslCertificateStringle certificat SSL du serveur.
_clientSslCertificateStringle certificat SSL du client.
_clientSslKeyStringla 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

NomTypeDescription
urlStringURL de base de données au format jdbc:subprotocol:subname.
userNameStringNom d'utilisateur à transmettre à la base de données.
passwordStringMot 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

NomTypeDescription
millisecondsIntegerMillisecondes depuis l'epoch.

Renvois

JdbcDate : un objet JdbcDate.

newTime(milliseconds)

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

Paramètres

NomTypeDescription
millisecondsIntegerMillisecondes depuis l'epoch.

Renvois

JdbcTime : objet JdbcTime.

newTimestamp(milliseconds)

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

Paramètres

NomTypeDescription
millisecondsIntegerMillisecondes depuis l'epoch.

Renvois

JdbcTimestamp : objet JdbcTimestamp.

parseDate(date)

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

Paramètres

NomTypeDescription
dateStringChaî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

NomTypeDescription
timeStringChaî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

NomTypeDescription
timestampStringChaîne contenant une chaîne d'horodatage SQL.

Renvois

JdbcTimestamp : objet JdbcTimestamp.