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.

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.

AlloyDB Omni starten

Wenn Sie einen beendeten AlloyDB Omni-Container starten möchten, führen Sie entweder den Befehl docker container start oder den Befehl podman container start aus:

Docker 

docker container start CONTAINER_NAME

Ersetzen Sie CONTAINER_NAME durch den Namen, den Sie dem AlloyDB Omni-Container bei der Installation zugewiesen haben.

Podman 

podman container start CONTAINER_NAME

Ersetzen Sie CONTAINER_NAME durch den Namen, den Sie dem AlloyDB Omni-Container bei der Installation zugewiesen haben.

Status von AlloyDB Omni prüfen

Führen Sie entweder den Befehl docker container ls oder den Befehl podman container ls aus, um den Status aller ausgeführten Container zu prüfen:

Docker 

docker container ls

Podman 

podman container ls

Wenn Ihr AlloyDB Omni-Container ausgeführt wird, wird sein Name in der Spalte NAMES der Ausgabetabelle angezeigt. In der entsprechenden Zeile wird der Status des Containers zusammengefasst.

Wenn der Name Ihres Containers nicht in der Spalte NAMES angezeigt wird, wird AlloyDB Omni nicht ausgeführt.

AlloyDB Omni beenden

Wenn Sie einen AlloyDB Omni-Container beenden möchten, führen Sie entweder den Befehl docker container stop oder den Befehl podman container stop aus:

Docker 

  docker container stop CONTAINER_NAME

Ersetzen Sie CONTAINER_NAME durch den Namen, den Sie dem AlloyDB Omni-Container bei der Installation zugewiesen haben.

Podman 

  podman container stop CONTAINER_NAME

Ersetzen Sie CONTAINER_NAME durch den Namen, den Sie dem AlloyDB Omni-Container bei der Installation zugewiesen haben.

Verbindung zu AlloyDB Omni herstellen, das auf einem einzelnen Server ausgeführt wird

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. Verwenden Sie dazu die PostgreSQL-kompatible Software Ihrer Wahl.

Informationen zum Herstellen einer Verbindung zu einem AlloyDB Omni-Datenbankcluster, der in einem Kubernetes-Cluster ausgeführt wird, finden Sie unter Verbindung zu AlloyDB Omni herstellen, das in Kubernetes ausgeführt wird.

Verbindung über den containerisierten psql herstellen

Führen Sie den folgenden Befehl aus, um eine Verbindung zum AlloyDB Omni-Datenbankserver mit seiner eigenen containerisierten Kopie von psql herzustellen:

Docker 

  docker exec -it CONTAINER_NAME psql -U postgres

Ersetzen Sie CONTAINER_NAME durch den Namen, den Sie dem AlloyDB Omni-Container bei der Installation zugewiesen haben.

Podman 

  podman exec -it CONTAINER_NAME psql -U postgres

Ersetzen Sie CONTAINER_NAME durch den Namen, den Sie dem AlloyDB Omni-Container bei der Installation zugewiesen haben.

Mit diesem Befehl werden Sie als Nutzerrolle postgres mit dem Server verbunden und es wird eine postgres=#-Eingabeaufforderung angezeigt. Sie können jetzt psql-Befehle und SQL-Abfragen ausführen.

Führen Sie den Befehl \q aus, um psql zu beenden.

Verbindung über eigene Anwendungen herstellen

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

Wenn Sie eine Verbindung zum AlloyDB Omni-Datenbankserver herstellen möchten, müssen Sie das Netzwerk vom AlloyDB Omni-Docker-Container für Ihren Hostcomputer freigeben. Fügen Sie dazu beim Starten von AlloyDB Omni --network=host oder -p 5432:5432 zum Befehl docker run oder podman run hinzu.

Wenn Sie eine benutzerdefinierte Portnummer auswählen möchten, verwenden Sie beim Starten von AlloyDB Omni -p [HOST_PORT]:5432. Verwenden Sie dann einen beliebigen PostgreSQL-kompatiblen Client oder eine beliebige Codebibliothek, um eine Verbindung zu Port 5432 oder der von Ihnen angegebenen benutzerdefinierten Portnummer herzustellen.

Nachdem Sie eine Verbindung zum Datenbankserver hergestellt haben, können Sie Ihre Datenbanken mithilfe von DML- und SQL-Abfragen über Standard-PostgreSQL-Kommunikationsprotokolle definieren, abfragen und ändern.

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

Nächste Schritte