本頁說明如何在本機上安裝 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 run
或 podman run
指令,將 AlloyDB Omni Docker 容器的網路公開至主機。
如要選取自訂通訊埠編號,請在啟動 AlloyDB Omni 時使用 -p [HOST_PORT]:5432
。然後使用任何與 PostgreSQL 相容的用戶端或程式碼程式庫,連線至通訊埠 5432
或您指定的自訂通訊埠編號。
連線至資料庫伺服器後,您可以使用標準 PostgreSQL 通訊協定,透過 DML 和 SQL 查詢定義、查詢及修改資料庫。
由於 AlloyDB Omni 是在您自己的環境中執行,因此您可以控管連線至 AlloyDB Omni 的方式。包括根據應用程式需求,允許或限制對這項服務的網路存取權,就像使用一般 PostgreSQL 伺服器一樣。