Mit Google Cloud SQL for MySQL verbinden

Mit dem Cloud SQL for MySQL-Connector können Sie Ihre Cloud SQL for MySQL-Datenbanken mit Data Studio verbinden. Erstellen Sie interaktive Berichte und Dashboards mit Ihren Datenbanktabellen oder benutzerdefinierten Abfragen. Anschließend können Sie diese Statistiken mit Stakeholdern oder Teammitgliedern teilen, die keinen direkten Datenbankzugriff haben.

Unterstützte Versionen

Der Cloud SQL for MySQL-Connector wurde mit den folgenden MySQL-Versionen getestet:

  • 5.6
  • 5.7
  • 8.0

Wenn Probleme mit einer unterstützten Version auftreten, teilen Sie uns dies bitte im Data Studio-Forum mit. Sie können auch Funktionen anfragen und im Issue Tracker darüber abstimmen.

Verbindung zu Cloud SQL for MySQL herstellen

Data Studio-Datenquellen können mit einer einzelnen Cloud SQL for MySQL-Datenbanktabelle oder einer von Ihnen angegebenen benutzerdefinierten Abfrage verbunden werden.

So stellen Sie eine Verbindung zu Ihrer Cloud SQL for MySQL-Datenbank her:

  1. Melden Sie sich in Data Studio an.
  2. Klicken Sie auf der Data Studio-Startseite auf Erstellen und wählen Sie dann Datenquelle aus.
  3. Wählen Sie den Connector Cloud SQL for MySQL aus.
  4. Konfigurieren Sie den Zugriff auf Ihre Datenbank mit einer der Verbindungsoptionen.
  5. Klicken Sie auf AUTHENTICATE. Sie erhalten eine Liste der Tabellen in dieser Datenbank.
  6. Wählen Sie eine Tabelle aus der Liste aus oder geben Sie eine benutzerdefinierte Abfrage ein.
  7. Klicken Sie auf Verbinden.

In den Berichten werden jetzt alle Spalten der Tabelle als Felder dargestellt.

Verbindungsoptionen

Verbindung über einen Hostnamen oder eine IP-Adresse herstellen

Wählen Sie im Verbindungsbereich BASIC aus. Geben Sie die Verbindungsdetails ein:

  • Name der Instanzverbindung
  • Datenbank
  • Nutzername
  • Passwort

Verbindung über eine JDBC-URL herstellen

Wählen Sie im Verbindungsbereich JDBC-URL aus. Geben Sie die Verbindungsdetails ein:

  • JDBC-URL

    • Beispiel jdbc:google:mysql://INSTANCE_CONNECTION_NAME/DATABASE

  • Nutzername
  • Passwort

Wenn Sie eine Verbindung über eine literale IPv6-Adresse herstellen möchten, setzen Sie die Adresse in eckige Klammern. Beispiel: jdbc:google:mysql://[2001:db8:1:1:1:1:1:1]/your_db

Benutzerdefinierte Abfrage

Wählen Sie die Option BENUTZERDEFINIERTE ABFRAGE aus, um eine SQL-Abfrage anzugeben, anstatt eine Verbindung zu einer einzelnen Tabelle herzustellen. Ihre benutzerdefinierte SQL-Abfrage wird dabei als innere SELECT-Anweisung für jede generierte Datenbankabfrage verwendet.

Benutzerdefinierte SQL-Abfragen dürfen nicht mehr als eine Anweisung enthalten. Die folgende Abfrage würde z. B. nicht funktionieren, weil sie mehrere SQL-Anweisungen enthält:


DECLARE cost_per_tb_in_dollar FLOAT64 DEFAULT 4.2;

SELECT total_bytes_billed / (1024 * 1024))* cost_per_tb_in_dollar)/(1024*1024))) FROM billing-table;

Bei Abfragen in Data Studio kann es nach drei bis fünf Minuten zu einer Zeitüberschreitung kommen. So können Sie diesem Problem entgegenwirken:

  • Vereinfachen Sie die Abfrage, damit sie schneller ausgeführt werden kann.
  • Führen Sie die Abfrage in Ihrer Datenbank aus und speichern Sie die Ergebnisse in einer separaten Tabelle. Verbinden Sie die neue Tabelle in Ihrer Datenquelle.

Hinweise

In den folgenden Abschnitten finden Sie weitere Informationen zum Ermitteln des Namens der Instanzverbindung, zum Konfigurieren der erforderlichen Berechtigungen und zum Einrichten der Netzwerkverbindung.

Namen der Instanzverbindung ermitteln

Der Name der Instanzverbindung dient der Identifizierung der Instanz in Google Cloud. Sie können ihn über die Google Cloud Konsole oder die Befehlszeile abrufen.

Die Konsole verwenden

  1. Gehen Sie zu https://console.cloud.google.com/sql/instances.
  2. Klicken Sie auf die Instanz-ID, zu der Sie eine Verbindung herstellen möchten.
  3. Links im Bereich „Mit dieser Instanz verbinden“ sehen Sie den Namen der Instanz.

Befehlszeile verwenden

Geben Sie in der Befehlszeile Folgendes ein, um den Namen der Verbindung zu ermitteln:

gcloud sql instances describe [INSTANCE_NAME] | grep connectionName

Berechtigungen

Sie benötigen mindestens die Berechtigung cloudsql.client für das Cloud SQL for MySQL-Projekt, um die Verbindung herzustellen. Falls Sie diese Berechtigung nicht haben, können Sie stattdessen den MySQL-Connector verwenden.

Netzwerkverbindung

Der Cloud SQL for MySQL-Connector unterstützt Verbindungen zu Cloud SQL for MySQL-Instanzen mit öffentlicher und privater IP-Verbindung.

Sie müssen die öffentliche IP-Verbindung oder private IP-Verbindung für Ihre Cloud SQL for MySQL-Instanz konfigurieren, bevor Sie den Cloud SQL for MySQL-Connector verwenden können.

Damit Data Studio auf Daten in Cloud SQL zugreifen und sie über eine private Verbindung abfragen kann, wählen Sie in den Einstellungen Ihrer Cloud SQL for MySQL-Instanz die Option Privater Pfad für Google Cloud-Dienste aus.

Unterstützte Datentypen

Data Studio ordnet die integrierten Datentypen aus Ihrer Datenbank einem standardisierten Satz von Datentypen zu. Wenn Data Studio in Ihrer Tabelle oder Abfrage eine Spalte mit einem nicht unterstützten Typ erkennt, wird für diese Spalte kein Feld erstellt.

Firewall und Datenbankzugriff

Damit Data Studio eine Verbindung zu Datenbanken herstellen kann, die durch eine Firewall geschützt sind, und Abfragen an sie senden kann, müssen Sie den Zugriff auf eine der folgenden IP-Adressen gestatten. Möglicherweise müssen Sie Ihre Datenbank auch so konfigurieren, dass Zugriffe von diesen Adressen akzeptiert werden. Entsprechende Anleitungen finden Sie in der Dokumentation Ihrer Datenbank.

IP-Adressen

Die folgenden Adressen sind für die globale Infrastruktur von Data Studio reserviert:

  • 142.251.74.0/23

  • 2001:4860:4807::/48 (optional für Plattformen, die IPv6 unterstützen)

Wenn Sie die Datenstandort aktiviert für Ihr Data Studio Pro-Abo haben, verwenden Sie stattdessen die folgenden Adressen:

  • 142.251.56.0/24

  • 2001:4860:4815::/48 (optional für Plattformen, die IPv6 unterstützen)

Beschränkungen des Cloud SQL for MySQL-Connectors

  • Raumbezogene Datenerweiterungen von MySQL werden in Data Studio nicht unterstützt.
  • Mit diesem Connector können pro Vorgang bis zu 150.000 Zeilen abgefragt werden. Wird das Limit überschritten, werden die Daten abgeschnitten.
  • Spaltenüberschriften (Feldnamen) dürfen nur ASCII-Zeichen enthalten. Andere Zeichen werden nicht unterstützt.

Fehlerbehebung

In den Tipps zur Fehlerbehebung in der Data Studio-Hilfe finden Sie eine Liste häufiger Fehlermeldungen und Schritte zur Fehlerbehebung.