執行並連線至 AlloyDB Omni

選取說明文件版本:

本頁說明如何在本機上安裝 AlloyDB Omni 後執行及連線。

執行 AlloyDB Omni

執行 AlloyDB Omni 的程序取決於您是否在單一伺服器上的容器中執行 AlloyDB Omni。

啟動 AlloyDB Omni

如要啟動已停止的 AlloyDB Omni 容器,請執行docker container start 指令podman container start 指令

Docker

docker container start CONTAINER_NAME

CONTAINER_NAME 替換為您在安裝 AlloyDB Omni 容器時指派的名稱。

Podman

podman container start CONTAINER_NAME

CONTAINER_NAME 替換為您在安裝 AlloyDB Omni 容器時指派的名稱。

檢查 AlloyDB Omni 的狀態

如要檢查所有執行中容器的狀態,請執行docker container ls 指令podman container ls 指令

Docker

docker container ls

Podman

podman container ls

如果 AlloyDB Omni 容器正在執行,輸出資料表的 NAMES 欄會顯示容器名稱。對應的資料列會摘要顯示容器的狀態。

如果容器名稱未顯示在 NAMES 欄中,表示 AlloyDB Omni 未執行。

停止 AlloyDB Omni

如要停止 AlloyDB Omni 容器,請執行docker container stop 指令podman container stop 指令

Docker

  docker container stop CONTAINER_NAME

CONTAINER_NAME 替換為您在安裝 AlloyDB Omni 容器時指派的名稱。

Podman

  podman container stop CONTAINER_NAME

CONTAINER_NAME 替換為您在安裝 AlloyDB Omni 容器時指派的名稱。

連線至在單一伺服器上執行的 AlloyDB Omni

AlloyDB Omni 容器包含自己的 psql 副本,可讓您開啟與資料庫伺服器的互動式 SQL Shell 工作階段。

您也可以使用所選的 PostgreSQL 相容軟體,從容器外部連線至 AlloyDB Omni。

如要瞭解如何連線至 Kubernetes 叢集上執行的 AlloyDB Omni 資料庫叢集,請參閱「連線至 Kubernetes 上執行的 AlloyDB Omni」。

使用容器化的 psql 建立連線

如要使用 psql 的容器化副本連線至 AlloyDB Omni 資料庫伺服器,請執行下列指令:

Docker

  docker exec -it CONTAINER_NAME psql -U postgres

CONTAINER_NAME 替換為您在安裝 AlloyDB Omni 容器時指派的名稱。

Podman

  podman exec -it CONTAINER_NAME psql -U postgres

CONTAINER_NAME 替換為您在安裝 AlloyDB Omni 容器時指派的名稱。

這項指令會以 postgres 使用者角色連線至伺服器,並顯示 postgres=# 命令提示字元。您現在可以執行 psql 指令和 SQL 查詢。

如要退出 psql,請執行 \q 指令。

使用自己的應用程式連線

凡是能與 PostgreSQL 搭配使用的應用程式,也都能與 AlloyDB Omni 搭配使用,完全不需要修改。

如要連線至 AlloyDB Omni 資料庫伺服器,請在啟動 AlloyDB Omni 時,將 --network=host-p 5432:5432 新增至 docker runpodman run 指令,將 AlloyDB Omni Docker 容器的網路公開至主機。

如要選取自訂通訊埠編號,請在啟動 AlloyDB Omni 時使用 -p [HOST_PORT]:5432。然後使用任何與 PostgreSQL 相容的用戶端或程式碼程式庫,連線至通訊埠 5432 或您指定的自訂通訊埠編號。

連線至資料庫伺服器後,您可以使用標準 PostgreSQL 通訊協定,透過 DML 和 SQL 查詢定義、查詢及修改資料庫。

由於 AlloyDB Omni 是在您自己的環境中執行,因此您可以控管連線至 AlloyDB Omni 的方式。包括根據應用程式需求,允許或限制對這項服務的網路存取權,就像使用一般 PostgreSQL 伺服器一樣。

後續步驟