本頁面說明如何在自己的機器上安裝 AlloyDB Omni，並執行及連線至 AlloyDB Omni。
事前準備
執行 AlloyDB Omni
請參閱下列各節，瞭解如何啟動、檢查狀態及停止 AlloyDB Omni。
選用：更新 SELinux 政策
如果系統已啟用 SELinux，且您修改了 postgresql.conf 檔案中的特定 Grand Unified Configuration (GUC) 參數，則必須先更新 SELinux 政策，才能啟動 AlloyDB Omni 服務。更新這些政策可避免資源存取遭拒，以免資料庫伺服器無法使用，或備份等作業中斷。
執行 semanage 和 restorecon 指令時，需要 policycoreutils-python-utils 套件。
下表列出 GUC 參數，如果從預設值變更這些參數，就必須更新 SELinux 政策：
| GUC 參數 | 資源類型 | 未更新 SELinux 政策的影響 | 解析度 |
|---|---|---|---|
port |
通訊埠 | 資料庫伺服器無法啟動，因此無法使用。 | 將 postgresql_port_t 標籤指派給自訂 TCP 通訊埠。 |
external_pid_file |
檔案 | 資料庫伺服器仍可使用，但 SELinux 拒絕在 /var/run/postgresql/ 外部建立外部 PID 檔案。 |
將 postgresql_db_t 標籤指派給自訂 PID 檔案目錄。 |
unix_socket_directories |
檔案 | 資料庫伺服器無法建立通訊端檔案，因此無法使用。 | 將 postgresql_db_t 標籤指派給自訂 Unix 通訊端目錄。 |
log_directory |
檔案 | 資料庫伺服器無法寫入記錄，因此無法使用。 | 將 postgresql_db_t 標籤指派給自訂記錄目錄。 |
archive_command |
檔案 | 資料庫伺服器仍可使用，但 SELinux 會拒絕目標目錄的寫入權限，這可能會中斷預寫記錄檔 (WAL) 封存和備份作業。 | 將 postgresql_db_t 標籤指派給自訂封存目錄。 |
更新自訂通訊埠的 SELinux 政策
如果您變更 postgresql.conf 檔案中的 port 參數，請執行下列指令，允許 AlloyDB Omni 繫結至自訂 TCP 通訊埠：
將
postgresql_port_t標籤新增至自訂通訊埠：sudo /usr/sbin/semanage port -a -t postgresql_port_t -p tcp PORT_NUMBER將
PORT_NUMBER替換為自訂 TCP 通訊埠編號，例如5433。確認通訊埠政策已更新：
sudo /usr/sbin/semanage port -l | grep postgresql_port_t
更新自訂目錄的 SELinux 政策
如果您在 postgresql.conf 檔案中變更 external_pid_file、unix_socket_directories、log_directory 或 archive_command 參數，以使用自訂目錄，請執行下列指令，將 postgresql_db_t 內容套用至該目錄：
sudo /usr/sbin/semanage fcontext -a -t postgresql_db_t "DIRECTORY_PATH(/.*)?"
sudo /sbin/restorecon -R -F DIRECTORY_PATH將 DIRECTORY_PATH 替換為自訂 PID 檔案目錄、Unix 通訊端目錄、記錄目錄或 WAL 封存目錄的完整路徑。
啟動 AlloyDB Omni
sudo systemctl start alloydbomni17選用：啟用自動重新啟動服務
如要啟用 AlloyDB Omni 服務自動重新啟動功能，請按照下列步驟操作：
在
/etc/systemd/system/alloydbomni17.service.d/override.conf檔案中新增下列設定。[Service] Restart=on-failure重新載入
systemd管理員設定，並重新啟動alloydbomni17服務，讓變更生效。sudo systemctl daemon-reloadsudo systemctl restart alloydbomni17
檢查 AlloyDB Omni 的狀態
sudo systemctl status alloydbomni17停止 AlloyDB Omni
sudo systemctl stop alloydbomni17連線至 AlloyDB Omni
AlloyDB Omni RPM 套件也包含 psql 用戶端，可讓您與資料庫伺服器開啟互動式 SQL 殼層工作階段。
您也可以使用與 PostgreSQL 相容的軟體連線至 AlloyDB Omni。
使用隨附的 psql 連線
/usr/lib/postgresql/17/bin/psql -h localhost -U postgres這個指令會以 postgres 使用者角色連線至伺服器，並顯示 postgres=# 命令提示字元。現在可以執行 psql 指令和 SQL 查詢。
如要退出 psql，請執行 \q 指令。
使用自己的應用程式連線
任何與 PostgreSQL 相容的用戶端應用程式，也都能與 AlloyDB Omni 搭配使用，無須修改。
使用任何與 PostgreSQL 相容的用戶端或程式碼程式庫，連線至 AlloyDB Omni。
連線至資料庫伺服器後，您可以透過標準 PostgreSQL 通訊協定傳送 DML 和 SQL 查詢，定義、查詢及修改資料庫。
AlloyDB Omni 會在您的環境中執行，因此您可以控管連線至 AlloyDB Omni 的方式。您可以根據應用程式的需求，允許或限制 AlloyDB Omni 的網路存取權，就像使用一般 PostgreSQL 伺服器一樣。