Cloud Code unterstützt das Ausführen des Cloud SQL Auth-Proxys, um eine Verbindung zu einer Cloud SQL-Datenbank herzustellen, Cloud SQL-Instanzen aufzurufen und neue Datenquellen zu erstellen.
Hinweise
Installieren Sie Cloud Code, falls Sie dies noch nicht getan haben.
Zum Erstellen einer neuen Datenquelle können Sie eine der folgenden JetBrains-Premium-IDEs verwenden:
IntelliJ Ultimate oder eine andere Premium-JetBrains-IDE, die das Plug-in Datenbanktools und SQL enthält (standardmäßig aktiviert).
DataGrip, die eigenständige Datenbankverwaltungsumgebung
Sie können auch andere bevorzugte Datenbanktools wie DBeaver, MySQL Workbench und SQL Server Management Studio verwenden, um über den von Cloud Code bereitgestellten lokalen Port eine Verbindung zu den Cloud SQL-Instanzen herzustellen.
Über den Cloud SQL Auth-Proxy eine Verbindung zur Cloud SQL-Datenbank herstellen
Mit Cloud Code können Sie eine Verbindung zu einer Cloud SQL-Datenbank herstellen und eine Liste der Cloud SQL-Instanzen in IntelliJ oder anderen unterstützten JetBrains IDEs aufrufen.
So stellen Sie mit Cloud Code eine Verbindung zu einer Cloud SQL-Datenbank her:
Klicken Sie in Ihrer IDE in der Seitenleiste auf Google Cloud-Datenbanken oder auf Ansicht > Toolfenster > Google Cloud-Datenbanken.
Wenn noch kein Google Cloud-Projekt ausgewählt ist, klicken Sie auf Google Cloud-Projekt auswählen und folgen Sie der Anleitung, um Ihr Google Cloud-Projekt zu laden.
Cloud SQL-Instanzen in Ihrem Google Cloud-Projekt werden unter Cloud SQL angezeigt.
Wenn Sie eine Verbindung zu einer Cloud SQL-Instanz herstellen möchten, klicken Sie mit der rechten Maustaste auf eine Instanz und wählen Sie Über Cloud SQL Proxy verbinden aus. Sie können auch eine private IP-Adresse verwenden. Dazu wählen Sie Über Cloud SQL-Proxy verbinden (private IP-Adresse) aus.
Weitere Informationen zum Herstellen einer Verbindung zu SQL-Instanzen finden Sie unter Informationen zu Verbindungsoptionen.
Neue Datenquelle erstellen
Nachdem eine Cloud SQL Auth-Proxy-Verbindung hergestellt wurde, wird das Dialogfeld Cloud SQL-Instanz verbunden angezeigt. Hier können Sie eine neue Datenquelle für die lokal verfügbare Datenbank erstellen oder vorhandene Datenquellen anzeigen.
Wenn Sie eine neue Datenquelle erstellen möchten, wählen Sie Neue Datenquelle erstellen aus.
Alternativ können Sie mit der rechten Maustaste auf eine Instanz klicken und Neue Datenquelle erstellen auswählen.
Wählen Sie im Feld Authentifizierung eine Methode aus (standardmäßig ist dies ein Nutzername und ein Passwort).
Speichern Sie die Konfiguration.
Cloud Code erstellt eine neue Datenquellenverbindung mit einem Namen im folgenden Format:
gcp-project:location:db-instance-name
.Sie können mit der Datenbankinstanz über die Datenbanktools und SQL-Plug-in-Funktionen von JetBrains oder DataGrip beginnen.
(Optional) Klicken Sie in der Seitenleiste auf Datenbank oder Ansicht > Toolfenster > Datenbank, um die Liste der Datenquellen in Ihrer IDE aufzurufen. Wenn Sie mit der rechten Maustaste auf eine Datenquelle klicken, wird eine Liste mit Optionen angezeigt, mit denen Sie sich z. B. Schemas, Tabellen und andere Datenbankvorgänge ansehen können.
Weitere Informationen zum Arbeiten mit Datenbanken in DataGrip finden Sie unter Kurzanleitung mit DataGrip.
Verbindung zum Cloud SQL Auth-Proxy trennen
Drücken Sie im Terminal Ctrl+C
, um den Proxyprozess zu beenden und den Port der lokalen Datenbank freizugeben.
Bekannte Probleme
In diesem Abschnitt werden alle bekannten Probleme und deren aktuelle Lösungen aufgeführt.
Anderen Port für die Verbindung mit mehreren Datenbanken festlegen
Der Cloud SQL Auth-Proxy wählt bei ausgelasteten Ports nicht automatisch aus. Er ist immer von einem Port abhängig, wodurch Sie auf eine einzelne verbundene Instanz eines bestimmten Datenbanktyps beschränkt sind.
Cloud Code führt den Cloud SQL Auth-Proxy im Terminal aus. Wenn ein Portkonflikt auftritt, können Sie einen anderen Port für die Verbindung mit einer Datenbank festlegen. Dazu führen Sie im Terminal denselben Befehl mit einem benutzerdefinierten --port
-Flag aus. Beispiel:
--port=PORT_NUMBER
Sie können diesen Port dann in Ihrer Datenbankverbindung verwenden. Der Befehl wird automatisch generiert. Beispiel:
path_to_proxy/cloud-sql-proxy INSTANCE_CONNECTION_STRING