Diese Seite wurde von der Cloud Translation API übersetzt.

Psql-Client mit einer Instanz verbinden

Auf dieser Seite wird beschrieben, wie Sie das psql-Clienttool mit einer AlloyDB-Instanz verbinden.

So stellen Sie eine Verbindung zwischen psql und einer AlloyDB-Instanz her:

Erstellen Sie eine Compute Engine-VM, die über den Zugriff auf private Dienste eine Verbindung zu AlloyDB-Instanzen herstellen kann.
Installieren Sie den psql-Client auf der Compute Engine-VM.
Rufen Sie die IP-Adresse der AlloyDB-Instanz ab, mit der Sie eine Verbindung herstellen möchten.
Führen Sie den psql-Client aus.

Die ersten beiden dieser Aufgaben sind einmalige Vorgänge. Nachdem Sie eine Compute Engine-VM erstellt und den psql-Client darauf installiert haben, können Sie die VM weiterhin verwenden, um psql mit AlloyDB-Instanzen zu verbinden. Führen Sie dazu die verbleibenden Aufgaben aus.

Hinweise

Für das von Ihnen verwendete Google Cloud-Projekt muss der Zugriff auf AlloyDB aktiviert sein.
Ein VPC-Netzwerk im von Ihnen verwendeten Google Cloud-Projekt muss bereits für den Zugriff auf private Dienste auf AlloyDB konfiguriert sein.
Sie benötigen eine der folgenden IAM-Rollen im verwendeten Google Cloud-Projekt:
- roles/alloydb.admin (die vordefinierte IAM-Rolle „AlloyDB Admin“)
- roles/owner (die einfache IAM-Rolle „Inhaber“)
- roles/editor (einfache IAM-Rolle „Bearbeiter“)
Wenn Sie keine dieser Rollen haben, wenden Sie sich an den Administrator Ihrer Organisation, um Zugriff anzufordern.
Wenn der Clienthost eine Firewall hat, muss sie ausgehende Verbindungen zu Port 5432 an den IP-Adressen Ihrer AlloyDB-Instanzen zulassen.

Compute Engine-VM erstellen

Rufen Sie in der Google Cloud Console die Seite VM-Instanzen auf.

Zu „VM-Instanzen“
Wählen Sie das Projekt mit der AlloyDB-Instanz aus, zu der Sie eine Verbindung herstellen möchten.
Klicken Sie auf Instanz erstellen.
Klicken Sie auf den Bereich Maschinenkonfiguration.
Geben Sie einen Namen für die Instanz ein.
Konfigurieren Sie die Region und Zone, in der Sie die Instanz erstellen möchten.
Wählen Sie eine Maschinenreihe und den entsprechenden Maschinentyp aus.
Übernehmen Sie die Standardwerte im Abschnitt Betriebssystem und Speicher.
Klicken Sie auf den Bereich Netzwerk und legen Sie unter Netzwerkschnittstellen das VPC-Netzwerk fest, das für den Zugriff auf private Dienste auf AlloyDB konfiguriert ist.
Wenn Netzwerkschnittstellen nicht auf das VPC-Netzwerk festgelegt ist, das für den Zugriff auf private Dienste konfiguriert wurde, maximieren Sie es und legen Sie dann Netzwerk auf das VPC-Netzwerk fest.
Behalten Sie im Abschnitt Observability (Sichtbarkeit) die Standardwerte bei.
Klicken Sie auf den Abschnitt Sicherheit.
Legen Sie unter Identität und API-Zugriff die Option Zugriffsbereiche auf Uneingeschränkten Zugriff auf alle Cloud APIs zulassen fest.
Behalten Sie die Standardwerte im Abschnitt Erweitert bei.
Klicken Sie auf Erstellen.

Stellen Sie nach dem Erstellen der VM über SSH eine Verbindung zu der von Ihnen erstellten Compute Engine-VM her.

psql-Clienttool installieren

Stellen Sie über SSH eine Verbindung zur von Ihnen erstellten Compute Engine-VM her.
Standardmäßig werden für SSH-Verbindungen zu Compute Engine-VMs Identity-Aware Proxy verwendet. Abhängig von den Netzwerkrichtlinien Ihrer Organisation müssen Sie möglicherweise eine Firewallregel für eingehenden Traffic erstellen, um Traffic zu Ihren VMs zuzulassen.
Console
1. Rufen Sie in der Google Cloud Console die Seite VM-Instanzen auf.
  Zu „VM-Instanzen“
2. Klicken Sie in der Liste der VM-Instanzen in der Zeile der von Ihnen erstellten Instanz auf SSH.
gcloud

Stellen Sie mit dem Befehl gcloud compute ssh eine Verbindung zur von Ihnen erstellten Instanz her.
```
gcloud compute ssh --project=PROJECT_ID --zone=ZONE VM_NAME
```
Ersetzen Sie Folgendes:
- PROJECT_ID: die ID des Projekts, das die Instanz enthält
- ZONE ist der Name der Zone, in der sich die Instanz befindet.
- VM_NAME ist der Name der Instanz.

Installieren Sie den psql-Client aus dem Paketmanager:

sudo apt-get update
sudo apt-get install postgresql-client

IP-Adresse der AlloyDB-Instanz abrufen

Die IP-Adresse der AlloyDB-Instanz, zu der Sie eine Verbindung herstellen möchten, finden Sie in den Einstellungen der Instanz.

psql-Client ausführen

Stellen Sie eine SSH-Verbindung zur VM her, die Sie erstellt haben.
Console
1. Rufen Sie in der Google Cloud Console die Seite VM-Instanzen auf.
  Zu „VM-Instanzen“
2. Klicken Sie in der Liste der VM-Instanzen in der Zeile der von Ihnen erstellten Instanz auf SSH.
gcloud

Stellen Sie mit dem Befehl gcloud compute ssh eine Verbindung zur von Ihnen erstellten Instanz her.
```
gcloud compute ssh --project=PROJECT_ID --zone=ZONE VM_NAME
```
Ersetzen Sie Folgendes:
- PROJECT_ID: die ID des Projekts, das die Instanz enthält
- ZONE ist der Name der Zone, in der sich die Instanz befindet.
- VM_NAME ist der Name der Instanz.
Führen Sie das psql-Clienttool aus:
```
psql -h IP_ADDRESS -U USERNAME
```
Sie werden aufgefordert, das Passwort des Nutzers USERNAME einzugeben.

Wenn Sie zum ersten Mal eine Verbindung herstellen, verwenden Sie den Standardwert postgres für USERNAME und das Passwort, das Sie beim Erstellen des Clusters für PASSWORD verwendet haben.