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

Metodo	Tipo restituito	Breve descrizione
getCloudSqlConnection(url)	JdbcConnection	Tenta di stabilire una connessione all'URL di Google Cloud SQL specificato.
getCloudSqlConnection(url, info)	JdbcConnection	Tenta di stabilire una connessione all'URL di Google Cloud SQL specificato.
getCloudSqlConnection(url, userName, password)	JdbcConnection	Tenta di stabilire una connessione all'URL di Google Cloud SQL specificato.
getConnection(url)	JdbcConnection	Tenta di stabilire una connessione all'URL del database specificato.
getConnection(url, info)	JdbcConnection	Tenta di stabilire una connessione all'URL del database specificato.
getConnection(url, userName, password)	JdbcConnection	Tenta di stabilire una connessione al database specificato utilizzando un nome utente e una password.
newDate(milliseconds)	JdbcDate	Crea una data in millisecondi dall'epoca.
newTime(milliseconds)	JdbcTime	Crea un intervallo di tempo in millisecondi dall'epoca.
newTimestamp(milliseconds)	JdbcTimestamp	Crea un timestamp a partire dai millisecondi dall'epoca.
parseDate(date)	JdbcDate	Crea una data analizzando la stringa della data SQL.
parseTime(time)	JdbcTime	Crea un'ora analizzando la stringa di tempo SQL.
parseTimestamp(timestamp)	JdbcTimestamp	Crea un timestamp analizzando la stringa del timestamp SQL.

Documentazione dettagliata

getCloudSqlConnection(url)

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

Parametri

Nome	Tipo	Descrizione
url	String	Un URL del database nel formato jdbc:google:mysql://subname.

Ritorni

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 di Google Cloud SQL specificato.

Parametri

Nome	Tipo	Descrizione
url	String	Un URL del database nel formato jdbc:google:mysql://subname.
info	Object	Oggetto JavaScript facoltativo che specifica i parametri avanzati come definito di seguito.

Parametri avanzati

Nome	Tipo	Descrizione
connectTimeoutSeconds	Integer	timeout della connessione in secondi
database	String	il database a cui connetterti
instance	String	il nome di un'istanza del servizio SQL di Google
password	String	la password dell'utente
queryTimeoutSeconds	Integer	timeout della query in secondi
user	String	il nome utente da passare al database

Ritorni

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 di Google Cloud SQL specificato.

Parametri

Nome	Tipo	Descrizione
url	String	Un URL del database nel formato jdbc:google:mysql://subname.
userName	String	Il nome utente da passare al database.
password	String	La password dell'utente.

Ritorni

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.

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

Parametri

Nome	Tipo	Descrizione
url	String	Un URL del database nel formato jdbc:subprotocol:subname.

Ritorni

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.

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

Parametri

Nome	Tipo	Descrizione
url	String	Un URL del database nel formato jdbc:subprotocol:subname.
info	Object	Oggetto JavaScript facoltativo che specifica i parametri avanzati come definito di seguito.

Parametri avanzati

Nome	Tipo	Descrizione
databaseName	String	il database a cui connetterti
password	String	la password dell'utente
useJDBCCompliantTimeZoneShift	Boolean	se la connessione deve rispettare o meno le regole JDBC durante la conversione dei fusi orari. Il valore predefinito è false.
user	String	il nome utente da passare al database
_serverSslCertificate	String	il certificato SSL del server
_clientSslCertificate	String	il certificato SSL del client
_clientSslKey	String	la chiave SSL del client

Ritorni

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.

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

Parametri

Nome	Tipo	Descrizione
url	String	Un URL del database nel formato jdbc:subprotocol:subname.
userName	String	Il nome utente da passare al database.
password	String	La password dell'utente.

Ritorni

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 in millisecondi dall'epoca.

Parametri

Nome	Tipo	Descrizione
milliseconds	Integer	Millisecondi dall'epoca.

Ritorni

JdbcDate: un oggetto JdbcDate.

---

newTime(milliseconds)

Crea un intervallo di tempo in millisecondi dall'epoca.

Parametri

Nome	Tipo	Descrizione
milliseconds	Integer	Millisecondi dall'epoca.

Ritorni

JdbcTime: un oggetto JdbcTime.

---

newTimestamp(milliseconds)

Crea un timestamp a partire dai millisecondi dall'epoca.

Parametri

Nome	Tipo	Descrizione
milliseconds	Integer	Millisecondi dall'epoca.

Ritorni

JdbcTimestamp: un oggetto JdbcTimestamp.

---

parseDate(date)

Crea una data analizzando la stringa della data SQL.

Parametri

Nome	Tipo	Descrizione
date	String	Una stringa contenente una stringa di data SQL.

Ritorni

JdbcDate: un oggetto JdbcDate.

---

parseTime(time)

Crea un'ora analizzando la stringa di tempo SQL.

Parametri

Nome	Tipo	Descrizione
time	String	Una stringa contenente una stringa di tempo SQL.

Ritorni

JdbcTime: un oggetto JdbcTime.

---

parseTimestamp(timestamp)

Crea un timestamp analizzando la stringa del timestamp SQL.

Parametri

Nome	Tipo	Descrizione
timestamp	String	Una stringa contenente una stringa di timestamp SQL.

Ritorni

JdbcTimestamp: un oggetto JdbcTimestamp.