AlloyDB Omni ausführen und eine Verbindung herstellen

Wählen Sie eine Dokumentationsversion aus:

Auf dieser Seite wird beschrieben, wie Sie AlloyDB Omni ausführen und eine Verbindung dazu herstellen, nachdem Sie es auf Ihrem eigenen Computer installiert haben.

Hinweise

Für die meisten Befehle auf dieser Seite wird die AlloyDB Omni-Befehlszeile verwendet.

Informationen zum Installieren dieses Befehlszeilentools auf Ihrem Computer finden Sie unter AlloyDB Omni-CLI installieren.

AlloyDB Omni ausführen

Die Verfahren, die Sie zum Ausführen von AlloyDB Omni verwenden, hängen davon ab, ob Sie AlloyDB Omni in einem Container auf einem einzelnen Server ausführen.

Bei der Installation von AlloyDB Omni wird ein Systemdienst namens alloydb-dataplane eingerichtet, der so konfiguriert ist, dass er bei jedem Start Ihres Computers gestartet wird.

Verwenden Sie für die grundlegende Steuerung und Überwachung von AlloyDB Omni den Befehl sudo alloydb, wie in den folgenden Abschnitten gezeigt.

AlloyDB Omni starten

sudo alloydb database-server start

Informationen zum Testen der Verbindung finden Sie unter Mit dem containerisierten psql verbinden.

Status von AlloyDB Omni prüfen

sudo alloydb database-server status

AlloyDB Omni beenden

sudo alloydb database-server stop

Start beim Start deaktivieren

Wenn Sie den folgenden Befehl ausführen, wird verhindert, dass AlloyDB Omni beim Starten Ihres Computers automatisch gestartet wird.

sudo systemctl disable alloydb-dataplane

Start beim Hochfahren wieder aktivieren

  sudo systemctl enable alloydb-dataplane

Verbindung zu AlloyDB Omni auf einem einzelnen Server herstellen

Der AlloyDB Omni-Container enthält eine eigene Kopie von psql, mit der Sie eine interaktive SQL-Shell-Sitzung mit dem Datenbankserver öffnen können.

Sie können auch von außerhalb des Containers eine Verbindung zu AlloyDB Omni herstellen und dazu die PostgreSQL-kompatible Software Ihrer Wahl verwenden.

Verbindung über den containerisierten psql herstellen

Führen Sie den folgenden Befehl aus, um über die eigene containerisierte Kopie von psql eine Verbindung zum AlloyDB Omni-Datenbankserver herzustellen:

Einzelserver 

docker exec -it pg-service psql -h localhost -U postgres

Mit diesem Befehl wird eine Verbindung zum Server als Nutzerrolle postgres hergestellt und eine postgres=#-Eingabeaufforderung angezeigt. Sie können jetzt psql-Befehle und SQL-Abfragen ausführen.

Um psql zu beenden, führen Sie den Befehl \q aus.

Verbindung über eigene Anwendungen herstellen

Jede Anwendung, die mit PostgreSQL funktioniert, kann auch mit AlloyDB Omni verwendet werden. Es sind keine Änderungen erforderlich.

Wenn Sie eine Verbindung zum AlloyDB Omni-Datenbankserver herstellen möchten, verwenden Sie einen beliebigen PostgreSQL-kompatiblen Client oder eine beliebige PostgreSQL-kompatible Codebibliothek, um eine Verbindung zum Port 5432 herzustellen. Das ist der Standardport des PostgreSQL-Datenbankservers der Maschine, auf der AlloyDB Omni ausgeführt wird.

Das funktioniert, weil der AlloyDB Omni-Container seinen eigenen Port 5432 für denselben Port des Computers freigibt, auf dem er ausgeführt wird.

Nachdem Sie eine Verbindung zum Datenbankserver hergestellt haben, können Sie Ihre Datenbanken mit DML- und SQL-Abfragen definieren, abfragen und ändern. Dazu verwenden Sie die standardmäßigen PostgreSQL-Kommunikationsprotokolle.

Da AlloyDB Omni in Ihrer eigenen Umgebung ausgeführt wird, können Sie selbst festlegen, wie Sie eine Verbindung zu AlloyDB Omni herstellen. Dazu gehört, den Netzwerkzugriff auf diesen Dienst entsprechend den Anforderungen Ihrer Anwendung zuzulassen oder einzuschränken, genau wie bei einem normalen PostgreSQL-Server.

Nächste Schritte