Class Jdbc

Jdbc

Mit dem JDBC-Dienst können Skripts eine Verbindung zu Google Cloud SQL, MySQL, Microsoft SQL Server- und Oracle-Datenbanken. Weitere Informationen finden Sie im Leitfaden zu JDBC.

Methoden

MethodeRückgabetypKurzbeschreibung
getCloudSqlConnection(url)JdbcConnectionVersucht, eine Verbindung zur angegebenen Google Cloud SQL-URL herzustellen.
getCloudSqlConnection(url, info)JdbcConnectionVersucht, eine Verbindung zur angegebenen Google Cloud SQL-URL herzustellen.
getCloudSqlConnection(url, userName, password)JdbcConnectionVersucht, eine Verbindung zur angegebenen Google Cloud SQL-URL herzustellen.
getConnection(url)JdbcConnectionVersucht, eine Verbindung zur angegebenen Datenbank-URL herzustellen.
getConnection(url, info)JdbcConnectionVersucht, eine Verbindung zur angegebenen Datenbank-URL herzustellen.
getConnection(url, userName, password)JdbcConnectionVersucht, mit Nutzername und Passwort eine Verbindung zur angegebenen Datenbank herzustellen.
newDate(milliseconds)JdbcDateErstellt ein Datum in Millisekunden seit der Epoche.
newTime(milliseconds)JdbcTimeErstellt eine Zeit in Millisekunden seit der Epoche.
newTimestamp(milliseconds)JdbcTimestampErstellt einen Zeitstempel aus Millisekunden seit der Epoche.
parseDate(date)JdbcDateErstellen Sie ein Datum, indem Sie den SQL-Datumsstring parsen.
parseTime(time)JdbcTimeErstellen Sie eine Uhrzeit, indem Sie den SQL-Zeitstring parsen.
parseTimestamp(timestamp)JdbcTimestampErstellen Sie einen Zeitstempel, indem Sie den SQL-Zeitstempelstring parsen.

Detaillierte Dokumentation

getCloudSqlConnection(url)

Versucht, eine Verbindung zur angegebenen Google Cloud SQL-URL herzustellen.

Parameter

NameTypBeschreibung
urlStringEine Datenbank-URL im Format jdbc:google:mysql://subname.

Rückflug

JdbcConnection: Ein JdbcConnection-Objekt.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getCloudSqlConnection(url, info)

Versucht, eine Verbindung zur angegebenen Google Cloud SQL-URL herzustellen.

Parameter

NameTypBeschreibung
urlStringEine Datenbank-URL im Format jdbc:google:mysql://subname.
infoObjectOptionales JavaScript-Objekt, das erweiterte Parameter wie unten definiert angibt.

Erweiterte Parameter

NameTypBeschreibung
connectTimeoutSecondsIntegerZeitlimit für Verbindung in Sekunden
databaseStringDatenbank, mit der eine Verbindung hergestellt werden soll
instanceStringDen Namen einer Google SQL Service-Instanz
passwordStringdas Passwort des Nutzers
queryTimeoutSecondsIntegerZeitlimit für Abfrage in Sekunden
userStringNutzername, der an die Datenbank übergeben werden soll

Rückflug

JdbcConnection: Ein JdbcConnection-Objekt.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getCloudSqlConnection(url, userName, password)

Versucht, eine Verbindung zur angegebenen Google Cloud SQL-URL herzustellen.

Parameter

NameTypBeschreibung
urlStringEine Datenbank-URL im Format jdbc:google:mysql://subname.
userNameStringDer an die Datenbank zu übergebende Nutzername.
passwordStringDas Passwort des Nutzers.

Rückflug

JdbcConnection: Ein JdbcConnection-Objekt.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getConnection(url)

Versucht, eine Verbindung zur angegebenen Datenbank-URL herzustellen.

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

Parameter

NameTypBeschreibung
urlStringEine Datenbank-URL im Format jdbc:subprotocol:subname.

Rückflug

JdbcConnection: Ein JdbcConnection-Objekt.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getConnection(url, info)

Versucht, eine Verbindung zur angegebenen Datenbank-URL herzustellen.

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

Parameter

NameTypBeschreibung
urlStringEine Datenbank-URL im Format jdbc:subprotocol:subname.
infoObjectOptionales JavaScript-Objekt, das erweiterte Parameter wie unten definiert angibt.

Erweiterte Parameter

NameTypBeschreibung
databaseNameStringDatenbank, mit der eine Verbindung hergestellt werden soll
passwordStringdas Passwort des Nutzers
useJDBCCompliantTimeZoneShiftBooleanob die Verbindung beim Konvertieren von Zeitzonen die JDBC-Regeln einhalten. Der Standardwert ist false.
userStringNutzername, der an die Datenbank übergeben werden soll
_serverSslCertificateStringdas SSL-Zertifikat des Servers
_clientSslCertificateStringDas SSL-Zertifikat des Clients
_clientSslKeyStringDer SSL-Schlüssel des Clients

Rückflug

JdbcConnection: Ein JdbcConnection-Objekt.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

getConnection(url, userName, password)

Versucht, mit Nutzername und Passwort eine Verbindung zur angegebenen Datenbank herzustellen.

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

Parameter

NameTypBeschreibung
urlStringEine Datenbank-URL im Format jdbc:subprotocol:subname.
userNameStringDer an die Datenbank zu übergebende Nutzername.
passwordStringDas Passwort des Nutzers.

Rückflug

JdbcConnection: Ein JdbcConnection-Objekt.

Autorisierung

Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:

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

newDate(milliseconds)

Erstellt ein Datum in Millisekunden seit der Epoche.

Parameter

NameTypBeschreibung
millisecondsIntegerMillisekunden seit Epoche.

Rückflug

JdbcDate: Ein JdbcDate-Objekt.


newTime(milliseconds)

Erstellt eine Zeit in Millisekunden seit der Epoche.

Parameter

NameTypBeschreibung
millisecondsIntegerMillisekunden seit Epoche.

Rückflug

JdbcTime: Ein JdbcTime-Objekt.


newTimestamp(milliseconds)

Erstellt einen Zeitstempel aus Millisekunden seit der Epoche.

Parameter

NameTypBeschreibung
millisecondsIntegerMillisekunden seit Epoche.

Rückflug

JdbcTimestamp: Ein JdbcTimestamp-Objekt.


parseDate(date)

Erstellen Sie ein Datum, indem Sie den SQL-Datumsstring parsen.

Parameter

NameTypBeschreibung
dateStringEin String, der einen SQL-Datumsstring enthält.

Rückflug

JdbcDate: Ein JdbcDate-Objekt.


parseTime(time)

Erstellen Sie eine Uhrzeit, indem Sie den SQL-Zeitstring parsen.

Parameter

NameTypBeschreibung
timeStringEin String, der einen SQL-Zeitstring enthält.

Rückflug

JdbcTime: Ein JdbcTime-Objekt.


parseTimestamp(timestamp)

Erstellen Sie einen Zeitstempel, indem Sie den SQL-Zeitstempelstring parsen.

Parameter

NameTypBeschreibung
timestampStringEin String, der einen SQL-Zeitstempelstring enthält.

Rückflug

JdbcTimestamp: Ein JdbcTimestamp-Objekt.