Class Jdbc

JDBC

Le service JDBC permet aux scripts de se connecter à des 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)JdbcConnectionTente d'établir une connexion à l'URL de base de données indiquée.
getConnection(url, info)JdbcConnectionTente d'établir une connexion à l'URL de base de données indiquée.
getConnection(url, userName, password)JdbcConnectionTente d'établir une connexion à la base de données indiquée à l'aide d'un nom d'utilisateur et d'un mot de passe.
newDate(milliseconds)JdbcDateCréez une date en millisecondes depuis l'epoch.
newTime(milliseconds)JdbcTimeCrée une durée à partir de quelques millisecondes depuis l'epoch.
newTimestamp(milliseconds)JdbcTimestampCréez un code temporel à partir du nombre de millisecondes écoulées 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 d'heure SQL.
parseTimestamp(timestamp)JdbcTimestampCréez un code temporel en analysant la chaîne d'horodatage SQL.

Documentation détaillée

getCloudSqlConnection(url)

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

Paramètres

NomTypeDescription
urlStringURL de la 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 associée à un ou plusieurs des champs d'application 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 la 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
instanceStringNom d'une instance de service SQL Google
passwordStringle mot de passe de l'utilisateur
queryTimeoutSecondsIntegerdélai avant expiration de la requête en secondes
userStringle 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 associée à un ou plusieurs des champs d'application 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 la 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 associée à un ou plusieurs des champs d'application suivants:

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

getConnection(url)

Tente d'établir une connexion à l'URL de base de données indiquée.

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

Paramètres

NomTypeDescription
urlStringURL de la 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 associée à un ou plusieurs des champs d'application suivants:

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

getConnection(url, info)

Tente d'établir une connexion à l'URL de base de données indiquée.

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

Paramètres

NomTypeDescription
urlStringURL de la 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
useJDBCCompliantTimeZoneShiftBooleansi la connexion doit ou non être conforme aux règles JDBC lors de la conversion des fuseaux horaires. La valeur par défaut est false.
userStringle nom 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 associée à 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 indiquée à l'aide d'un nom d'utilisateur et d'un mot de passe.

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

Paramètres

NomTypeDescription
urlStringURL de la 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 associée à un ou plusieurs des champs d'application suivants:

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

newDate(milliseconds)

Créez une date en millisecondes depuis l'epoch.

Paramètres

NomTypeDescription
millisecondsIntegerMillisecondes depuis l'epoch.

Renvois

JdbcDate : objet JdbcDate.


newTime(milliseconds)

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

Paramètres

NomTypeDescription
millisecondsIntegerMillisecondes depuis l'epoch.

Renvois

JdbcTime : objet JdbcTime.


newTimestamp(milliseconds)

Créez un code temporel à partir du nombre de millisecondes écoulées 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 : objet JdbcDate.


parseTime(time)

Créez une heure en analysant la chaîne d'heure SQL.

Paramètres

NomTypeDescription
timeStringChaîne contenant une chaîne d'heure SQL.

Renvois

JdbcTime : objet JdbcTime.


parseTimestamp(timestamp)

Créez un code temporel en analysant la chaîne d'horodatage SQL.

Paramètres

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

Renvois

JdbcTimestamp : objet JdbcTimestamp.