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 JDBC-Leitfaden.

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
getCloudSqlConnection(url)	JdbcConnection	Versucht, eine Verbindung zur angegebenen Google Cloud SQL-URL herzustellen.
getCloudSqlConnection(url, info)	JdbcConnection	Versucht, eine Verbindung zur angegebenen Google Cloud SQL-URL herzustellen.
getCloudSqlConnection(url, userName, password)	JdbcConnection	Versucht, eine Verbindung zur angegebenen Google Cloud SQL-URL herzustellen.
getConnection(url)	JdbcConnection	Versucht, eine Verbindung zur angegebenen Datenbank-URL herzustellen.
getConnection(url, info)	JdbcConnection	Versucht, eine Verbindung zur angegebenen Datenbank-URL herzustellen.
getConnection(url, userName, password)	JdbcConnection	Es wird versucht, eine Verbindung zur angegebenen Datenbank mit einem Nutzernamen und einem Passwort herzustellen.
newDate(milliseconds)	JdbcDate	Erstellt ein Datum aus Millisekunden seit der Epoche.
newTime(milliseconds)	JdbcTime	Erstellt eine Zeit aus Millisekunden seit der Epoche.
newTimestamp(milliseconds)	JdbcTimestamp	Erstellt einen Zeitstempel aus Millisekunden seit der Epoche.
parseDate(date)	JdbcDate	Erstellt ein Datum durch Parsen des SQL-Datumsstrings.
parseTime(time)	JdbcTime	Erstellen Sie eine Zeit, indem Sie den SQL-Zeitstring parsen.
parseTimestamp(timestamp)	JdbcTimestamp	Erstellen Sie einen Zeitstempel, indem Sie den SQL-Zeitstempelstring parsen.

Detaillierte Dokumentation

getCloudSqlConnection(url)

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

Parameter

Name	Typ	Beschreibung
url	String	Eine Datenbank-URL im Format jdbc:google:mysql://subname.

Rückflug

JdbcConnection – Ein JdbcConnection-Objekt.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

---

getCloudSqlConnection(url, info)

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

Parameter

Name	Typ	Beschreibung
url	String	Eine Datenbank-URL im Format jdbc:google:mysql://subname.
info	Object	Optionales JavaScript-Objekt, das erweiterte Parameter wie unten definiert enthält.

Erweiterte Parameter

Name	Typ	Beschreibung
connectTimeoutSeconds	Integer	Zeitlimit für Verbindungen in Sekunden
database	String	die Datenbank, zu der eine Verbindung hergestellt werden soll
instance	String	Der Name einer Google SQL Service-Instanz
password	String	das Passwort des Nutzers
queryTimeoutSeconds	Integer	Zeitüberschreitung bei Abfragen in Sekunden
user	String	Der Nutzername, der an die Datenbank übergeben werden soll

Rückflug

JdbcConnection – Ein JdbcConnection-Objekt.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

---

getCloudSqlConnection(url, userName, password)

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

Parameter

Name	Typ	Beschreibung
url	String	Eine Datenbank-URL im Format jdbc:google:mysql://subname.
userName	String	Der Nutzername, der an die Datenbank übergeben werden soll.
password	String	Das Passwort des Nutzers.

Rückflug

JdbcConnection – Ein JdbcConnection-Objekt.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

---

getConnection(url)

Versucht, eine Verbindung zur angegebenen Datenbank-URL herzustellen.

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

Parameter

Name	Typ	Beschreibung
url	String	Eine Datenbank-URL im Format jdbc:subprotocol:subname.

Rückflug

JdbcConnection – Ein JdbcConnection-Objekt.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

---

getConnection(url, info)

Versucht, eine Verbindung zur angegebenen Datenbank-URL herzustellen.

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

Parameter

Name	Typ	Beschreibung
url	String	Eine Datenbank-URL im Format jdbc:subprotocol:subname.
info	Object	Optionales JavaScript-Objekt, das erweiterte Parameter wie unten definiert enthält.

Erweiterte Parameter

Name	Typ	Beschreibung
databaseName	String	die Datenbank, zu der eine Verbindung hergestellt werden soll
password	String	das Passwort des Nutzers
useJDBCCompliantTimeZoneShift	Boolean	Gibt an, ob die Verbindung bei der Konvertierung von Zeitzonen den JDBC-Regeln entsprechen soll. Der Standardwert ist false.
user	String	Der Nutzername, der an die Datenbank übergeben werden soll
_serverSslCertificate	String	das SSL-Zertifikat des Servers
_clientSslCertificate	String	das SSL-Zertifikat des Clients
_clientSslKey	String	SSL-Schlüssel des Clients

Rückflug

JdbcConnection – Ein JdbcConnection-Objekt.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

---

getConnection(url, userName, password)

Es wird versucht, eine Verbindung zur angegebenen Datenbank mit einem Nutzernamen und einem Passwort herzustellen.

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

Parameter

Name	Typ	Beschreibung
url	String	Eine Datenbank-URL im Format jdbc:subprotocol:subname.
userName	String	Der Nutzername, der an die Datenbank übergeben werden soll.
password	String	Das Passwort des Nutzers.

Rückflug

JdbcConnection – Ein JdbcConnection-Objekt.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

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

---

newDate(milliseconds)

Erstellt ein Datum aus Millisekunden seit der Epoche.

Parameter

Name	Typ	Beschreibung
milliseconds	Integer	Millisekunden seit Epoche.

Rückflug

JdbcDate: Ein JdbcDate-Objekt.

---

newTime(milliseconds)

Erstellt eine Zeit aus Millisekunden seit der Epoche.

Parameter

Name	Typ	Beschreibung
milliseconds	Integer	Millisekunden seit Epoche.

Rückflug

JdbcTime – Ein JdbcTime-Objekt.

---

newTimestamp(milliseconds)

Erstellt einen Zeitstempel aus Millisekunden seit der Epoche.

Parameter

Name	Typ	Beschreibung
milliseconds	Integer	Millisekunden seit Epoche.

Rückflug

JdbcTimestamp – Ein JdbcTimestamp-Objekt.

---

parseDate(date)

Erstellt ein Datum durch Parsen des SQL-Datumsstrings.

Parameter

Name	Typ	Beschreibung
date	String	Ein String, der einen SQL-Datumsstring enthält.

Rückflug

JdbcDate: Ein JdbcDate-Objekt.

---

parseTime(time)

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

Parameter

Name	Typ	Beschreibung
time	String	Ein 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

Name	Typ	Beschreibung
timestamp	String	Ein String, der einen SQL-Zeitstempelstring enthält.

Rückflug

JdbcTimestamp – Ein JdbcTimestamp-Objekt.