Verbindung zu Google Cloud SQL for MySQL herstellen

Cloud SQL for MySQL ist ein vollständig verwalteter Datenbankdienst, mit dem Sie Ihre relationalen MySQL-Datenbanken schnell einrichten und verwalten können Google Cloud. Mit dem Cloud SQL for MySQL-Connector können Sie in Data Studio auf Daten aus Cloud SQL for MySQL-Datenbanken zugreifen.

Unterstützte Versionen

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

  • 5.6
  • 5.7
  • 8.0

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

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.

Verbindung herstellen

  1. Melden Sie sich in Data Studio an.
  2. Klicken Sie links oben auf der Data Studio-Startseite auf Das Symbol „Erstellen“ Erstellen und wählen Sie dann Datenquelle aus.
  3. Wählen Sie den Connector Cloud SQL for MySQL aus.
  4. Autorisieren Sie gegebenenfalls Data Studio, auf Ihre Daten zuzugreifen.

  5. Richten Sie die Verbindung mit Ihrer Datenbank ein:

    • Mit Hostnamen oder IP-Adresse verbinden
      1. Wählen Sie links BASIC aus.
      2. Geben Sie die Verbindungsdetails ein:
        1. Name der Instanzverbindung
        2. Datenbank
        3. Nutzername
        4. Passwort
    • Mit einer JDBC-URL verbinden
      1. Wählen Sie links JDBC-URL aus.
      2. Geben Sie die Verbindungsdetails ein:
        1. JDBC-URL

          Beispiel jdbc:google:mysql: //<instance connection name>/

        2. Nutzername
        3. Passwort
      > Wenn Sie einen JDBC-Hostnamen verwenden, kann mit öffentlichen DNS-Abfragetools wie Whois darauf zugegriffen werden.
    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
    • Hinweis : Data Studio kann keine Verbindung zu localhost herstellen. Verwenden Sie stattdessen einen öffentlichen Hostnamen oder eine öffentliche IP-Adresse.

  6. Klicken Sie auf AUTHENTIFIZIEREN.

  7. Wählen Sie eine Tabelle aus der Liste aus oder geben Sie eine benutzerdefinierte Abfrage ein.

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

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.
  1. Klicken Sie auf VERBINDEN.

Die Seite mit der Liste der Felder für Datenquellen wird angezeigt. Klicken Sie auf BERICHT ERSTELLEN , um mit der Visualisierung Ihrer Daten zu beginnen.

Hinweise

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 mit Data Studio auf Daten in Cloud SQL zugegriffen werden kann und sie über eine private Verbindung abgefragt werden können, wählen Sie in den Einstellungen Ihrer Cloud SQL for MySQL-Instanz die Option Privater Pfad für Google Cloud-Dienste aus.

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 findet, wird für diese Spalte kein Feld erstellt.

Hinweis : Raumbezogene Datenerweiterungen von MySQL werden in Data Studio nicht unterstützt.

Beschränkungen des Cloud SQL for MySQL-Connectors

  • 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.