執行並連線至 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 殼層工作階段。

您也可以使用與 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 伺服器一樣。

後續步驟