執行並連線至 AlloyDB Omni

選取文件版本:

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

事前準備

本頁的大部分指令都使用 AlloyDB Omni CLI。

如要在電腦上安裝這項指令列工具,請參閱「安裝 AlloyDB Omni CLI」。

執行 AlloyDB Omni

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

安裝 AlloyDB Omni 時,系統會設定名為 alloydb-dataplane 的系統服務,並在每次機器啟動時啟動。

如要基本控制及監控 AlloyDB Omni,請使用 sudo alloydb 指令,如下列章節所示。

啟動 AlloyDB Omni

sudo alloydb database-server start

如要執行測試連線,請參閱「使用容器化 psql 連線」。

檢查 AlloyDB Omni 的狀態

sudo alloydb database-server status

停止 AlloyDB Omni

sudo alloydb database-server stop

停用啟動時啟動功能

執行下列指令可防止 AlloyDB Omni 在機器啟動時自動啟動。

sudo systemctl disable alloydb-dataplane

重新啟用開機時啟動功能

  sudo systemctl enable alloydb-dataplane

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

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

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

使用容器化的 psql 建立連線

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

單一伺服器

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

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

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

使用自己的應用程式連線

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

如要連線至 AlloyDB Omni 資料庫伺服器,請使用任何與 PostgreSQL 相容的用戶端或程式碼程式庫,連線至執行 AlloyDB Omni 的機器通訊埠 5432 (預設的 PostgreSQL 資料庫伺服器通訊埠)。

這是因為 AlloyDB Omni 容器會將自己的通訊埠 5432 公開至執行所在機器的相同通訊埠。

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

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

後續步驟