Verbindung zu Cloud SQL for PostgreSQL mit Cloud Shell herstellen

Cloud SQL-Instanz erstellen

In dieser Kurzanleitung verwenden Sie die Google Cloud Console. Informationen zur Verwendung von gcloud CLI, cURL oder PowerShell finden Sie unter Instanzen erstellen.

1. Wechseln Sie in der Google Cloud Console zur Seite Cloud SQL-Instanzen.

   Cloud SQL-Instanzen aufrufen

2. Klicken Sie auf Instanz erstellen.
3. Klicken Sie auf PostgreSQL auswählen.
4. Geben Sie im Feld Instanz-ID den Wert myinstance ein.
5. Geben Sie im Feld Passwort ein Passwort für den Nutzer postgres ein.

6. Klicken Sie auf Instanz erstellen.

   Sie werden zur Instanzliste zurückgeleitet. Sie können direkt auf die neue Instanz klicken, um die Details aufzurufen. Die Instanz steht jedoch erst für andere Vorgänge zur Verfügung, wenn sie initialisiert und gestartet wurde.

Mit Instanz verbinden

In dieser Kurzanleitung verwenden wir den psql-Client in Cloud Shell, um eine Verbindung zu Ihrer Instanz herzustellen. Cloud Shell ist eine Remote-Sandbox-Umgebung.

1. Optional: Wenn Sie eine lokale Instanz von PostgreSQL ausführen, beenden Sie sie, bevor Sie eine Verbindung zu Ihrer Cloud SQL-Instanz herstellen. Andernfalls können Fehler wie address already in use auftreten.

2. Klicken Sie in der Google Cloud Console rechts oben auf das Cloud Shell-Symbol ().

   Wenn Cloud Shell die Initialisierung abgeschlossen hat, wird eine Meldung wie die folgende angezeigt:

   Welcome to Cloud Shell! Type "help" to get started.
   Your Cloud Platform project in this session is set to sample-project.
   Use "gcloud config set project [PROJECT_ID]" to change to a different project.
   username@sample-project:~ (sample-project)$
   

3. Optional: Wenn Sie die gcloud CLI nicht autorisiert haben, mit Ihren Google-Nutzeranmeldedaten auf die Google Cloud Platform zuzugreifen, verwenden Sie den Befehl gcloud auth login.

4. Stellen Sie von der Cloud Shell-Eingabeaufforderung aus eine Verbindung zur Cloud SQL-Instanz her: Verwenden Sie den Befehl gcloud sql connect so: Ersetzen Sie den Instanznamen, wenn es sich um einen anderen Namen handelt.

   gcloud sql connect myinstance --user=postgres

5. Klicken Sie im Dialogfeld auf Autorisieren, um Cloud Shell für API-Aufrufe zu autorisieren.

   Die folgende Meldung wird angezeigt:

   Allowlisting your IP for incoming connection for 5 minutes...done.
   

   Diese Meldung gibt an, dass eingehende Verbindungen zur öffentlichen IP-Adresse Ihrer Cloud SQL-Instanz zulässig sind. Danach werden Sie aufgefordert, Ihr Passwort einzugeben.

6. Geben Sie das Postgres-Passwort ein.

   Die Eingabeaufforderung psql wird angezeigt.

Datenbank erstellen und Daten hochladen

1. Erstellen Sie eine SQL-Datenbank auf Ihrer Cloud SQL-Instanz:

   CREATE DATABASE guestbook;

2. Stellen Sie eine Verbindung zur Datenbank her, indem Sie den folgenden Befehl eingeben und Ihr Passwort angeben.

   \connect guestbook;

3. Fügen Sie Beispieldaten in die Datenbank ein:

   CREATE TABLE entries (guestName VARCHAR(255), content VARCHAR(255),
                           entryID SERIAL PRIMARY KEY);
   INSERT INTO entries (guestName, content) values ('first guest', 'I got here!');
   INSERT INTO entries (guestName, content) values ('second guest', 'Me too!');

4. Rufen Sie die Daten ab:

   SELECT * FROM entries;

   Das Ergebnis lautet:

     guestname   |   content   | entryid
   --------------+-------------+---------
    first guest  | I got here! |       1
    second guest | Me too!     |       2
   (2 rows)
   postgres=>