Class Jdbc

JDBC

Mit dem JDBC-Dienst können Skripts eine Verbindung zu Google Cloud SQL-, MySQL-, Microsoft SQL Server- und Oracle-Datenbanken herstellen. 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 einem Nutzernamen und Passwort eine Verbindung zur angegebenen Datenbank herzustellen.
newDate(milliseconds)JdbcDateErstellt ein Datum aus Millisekunden seit der Epoche.
newTime(milliseconds)JdbcTimeErstellt eine Zeit von 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.

Return

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 die Verbindung in Sekunden
databaseStringDatenbank, mit der Sie eine Verbindung
instanceStringden Namen einer Google SQL Service-Instanz
passwordStringPasswort des Nutzers
queryTimeoutSecondsIntegerZeitlimit für Abfragen in Sekunden
userStringNutzername, der an die Datenbank übergeben werden soll

Return

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.

Return

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.

Return

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 Sie eine Verbindung
passwordStringPasswort des Nutzers
useJDBCCompliantTimeZoneShiftBooleanGibt an, ob die Verbindung beim Konvertieren von Zeitzonen den JDBC-Regeln entsprechen soll. Der Standardwert ist false.
userStringNutzername, der an die Datenbank übergeben werden soll
_serverSslCertificateStringSSL-Zertifikat des Servers
_clientSslCertificateStringSSL-Zertifikat des Clients
_clientSslKeyStringSSL-Schlüssel des Clients

Return

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 einem Nutzernamen 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.

Return

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 aus Millisekunden seit der Epoche.

Parameter

NameTypBeschreibung
millisecondsIntegerMillisekunden seit Epoche.

Return

JdbcDate: Ein JSBcDate-Objekt.


newTime(milliseconds)

Erstellt eine Zeit von Millisekunden seit der Epoche.

Parameter

NameTypBeschreibung
millisecondsIntegerMillisekunden seit Epoche.

Return

JdbcTime: Ein JSBcTime-Objekt.


newTimestamp(milliseconds)

Erstellt einen Zeitstempel aus Millisekunden seit der Epoche.

Parameter

NameTypBeschreibung
millisecondsIntegerMillisekunden seit Epoche.

Return

JdbcTimestamp: Ein JSDBCTimestamp-Objekt.


parseDate(date)

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

Parameter

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

Return

JdbcDate: Ein JSBcDate-Objekt.


parseTime(time)

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

Parameter

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

Return

JdbcTime: Ein JSBcTime-Objekt.


parseTimestamp(timestamp)

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

Parameter

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

Return

JdbcTimestamp: Ein JSDBCTimestamp-Objekt.