Class Jdbc

Jdbc

Il servizio JDBC consente agli script di connettersi ai database Google Cloud SQL, MySQL, Microsoft SQL Server e Oracle. Per ulteriori informazioni, consulta la guida a JDBC.

Metodi

MetodoTipo restituitoBreve descrizione
getCloudSqlConnection(url)JdbcConnectionTenta di stabilire una connessione all'URL Google Cloud SQL specificato.
getCloudSqlConnection(url, info)JdbcConnectionTenta di stabilire una connessione all'URL Google Cloud SQL specificato.
getCloudSqlConnection(url, userName, password)JdbcConnectionTenta di stabilire una connessione all'URL Google Cloud SQL specificato.
getConnection(url)JdbcConnectionTenta di stabilire una connessione all'URL del database specificato.
getConnection(url, info)JdbcConnectionTenta di stabilire una connessione all'URL del database specificato.
getConnection(url, userName, password)JdbcConnectionTenta di stabilire una connessione al database specificato utilizzando un nome utente e una password.
newDate(milliseconds)JdbcDateCrea una data da millisecondi trascorsi da epoca.
newTime(milliseconds)JdbcTimeCrea un'ora da millisecondi dall'epoca.
newTimestamp(milliseconds)JdbcTimestampCrea un timestamp da millisecondi dall'epoca.
parseDate(date)JdbcDateCrea una data analizzando la stringa della data SQL.
parseTime(time)JdbcTimeCrea un orario analizzando la stringa di ora SQL.
parseTimestamp(timestamp)JdbcTimestampCrea un timestamp analizzando la stringa del timestamp SQL.

Documentazione dettagliata

getCloudSqlConnection(url)

Tenta di stabilire una connessione all'URL Google Cloud SQL specificato.

Parametri

NomeTipoDescrizione
urlStringUn URL del database del tipo jdbc:google:mysql://subname.

Invio

JdbcConnection: un oggetto JdbcConnection.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

getCloudSqlConnection(url, info)

Tenta di stabilire una connessione all'URL Google Cloud SQL specificato.

Parametri

NomeTipoDescrizione
urlStringUn URL del database del tipo jdbc:google:mysql://subname.
infoObjectOggetto JavaScript facoltativo che specifica i parametri avanzati come definiti di seguito.

Parametri avanzati

NomeTipoDescrizione
connectTimeoutSecondsIntegerTimeout della connessione in secondi
databaseStringil database a cui connettersi
instanceStringil nome di un'istanza del servizio SQL di Google
passwordStringla password dell'utente
queryTimeoutSecondsIntegerTimeout della query in secondi
userStringil nome utente da passare al database

Invio

JdbcConnection: un oggetto JdbcConnection.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

getCloudSqlConnection(url, userName, password)

Tenta di stabilire una connessione all'URL Google Cloud SQL specificato.

Parametri

NomeTipoDescrizione
urlStringUn URL del database del tipo jdbc:google:mysql://subname.
userNameStringIl nome utente da passare al database.
passwordStringLa password dell'utente.

Invio

JdbcConnection: un oggetto JdbcConnection.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

getConnection(url)

Tenta di stabilire una connessione all'URL del database specificato.

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

Parametri

NomeTipoDescrizione
urlStringUn URL del database del tipo jdbc:subprotocol:subname.

Invio

JdbcConnection: un oggetto JdbcConnection.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

getConnection(url, info)

Tenta di stabilire una connessione all'URL del database specificato.

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

Parametri

NomeTipoDescrizione
urlStringUn URL del database del tipo jdbc:subprotocol:subname.
infoObjectOggetto JavaScript facoltativo che specifica i parametri avanzati come definiti di seguito.

Parametri avanzati

NomeTipoDescrizione
databaseNameStringil database a cui connettersi
passwordStringla password dell'utente
useJDBCCompliantTimeZoneShiftBooleanse la connessione deve o meno essere conforme alle regole JDBC durante la conversione dei fusi orari. Il valore predefinito è false.
userStringil nome utente da passare al database
_serverSslCertificateStringil certificato SSL del server
_clientSslCertificateStringil certificato SSL del client
_clientSslKeyStringla chiave SSL del client

Invio

JdbcConnection: un oggetto JdbcConnection.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

getConnection(url, userName, password)

Tenta di stabilire una connessione al database specificato utilizzando un nome utente e una password.

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

Parametri

NomeTipoDescrizione
urlStringUn URL del database del tipo jdbc:subprotocol:subname.
userNameStringIl nome utente da passare al database.
passwordStringLa password dell'utente.

Invio

JdbcConnection: un oggetto JdbcConnection.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

newDate(milliseconds)

Crea una data da millisecondi trascorsi da epoca.

Parametri

NomeTipoDescrizione
millisecondsIntegerMillisecondi dall'epoca.

Invio

JdbcDate: un oggetto JdbcDate.


newTime(milliseconds)

Crea un'ora da millisecondi dall'epoca.

Parametri

NomeTipoDescrizione
millisecondsIntegerMillisecondi dall'epoca.

Invio

JdbcTime: un oggetto JdbcTime.


newTimestamp(milliseconds)

Crea un timestamp da millisecondi dall'epoca.

Parametri

NomeTipoDescrizione
millisecondsIntegerMillisecondi dall'epoca.

Invio

JdbcTimestamp: un oggetto JdbcTimestamp.


parseDate(date)

Crea una data analizzando la stringa della data SQL.

Parametri

NomeTipoDescrizione
dateStringUna stringa contenente una stringa di data SQL.

Invio

JdbcDate: un oggetto JdbcDate.


parseTime(time)

Crea un orario analizzando la stringa di ora SQL.

Parametri

NomeTipoDescrizione
timeStringUna stringa contenente una stringa di ora SQL.

Invio

JdbcTime: un oggetto JdbcTime.


parseTimestamp(timestamp)

Crea un timestamp analizzando la stringa del timestamp SQL.

Parametri

NomeTipoDescrizione
timestampStringUna stringa contenente una stringa di timestamp SQL.

Invio

JdbcTimestamp: un oggetto JdbcTimestamp.