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 zum Ausführen von AlloyDB Omni hängen davon ab, ob Sie AlloyDB Omni in einem Container auf einem einzelnen Server ausführen.

AlloyDB Omni starten

Führen Sie den Befehl the docker container start command oder the podman container start command aus, um einen beendeten AlloyDB Omni-Container zu starten:

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

Führen Sie den Befehl the docker container stop oder the podman container stop aus, um einen AlloyDB Omni-Container zu beenden:

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 , das in einem Kubernetes-Cluster ausgeführt wird, finden Sie unter Verbindung zu AlloyDB Omni herstellen, das in Kubernetes ausgeführt wird.

Verbindung mit dem containerisierten psql herstellen

Führen Sie den folgenden Befehl aus, um mit der eigenen containerisierten Kopie von psql eine Verbindung zum AlloyDB Omni-Datenbankserver 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 wird eine Verbindung zum Server als Nutzerrolle postgres hergestellt und eine postgres=# Eingabeaufforderung angezeigt. Sie können jetzt run psql Befehle und SQL Abfragen ausführen.

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

Verbindung mit eigenen 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, müssen Sie die Netzwerkverbindung vom AlloyDB Omni-Docker-Container zu Ihrem Hostcomputer freigeben. Fügen Sie dazu beim Starten von AlloyDB Omni --network=host oder -p 5432:5432 zu Ihrem 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 mit DML- und SQL-Abfragen definieren, abfragen und ändern. Verwenden Sie dazu die Standard-PostgreSQL-Kommunikationsprotokolle.

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

Nächste Schritte