本頁說明如何自訂 AlloyDB Omni 安裝作業,這項作業支援不同形式的自訂。本頁列出一些常見的自訂項目。
啟用及停用 AlloyDB Omni 遙測功能
AlloyDB Omni 遙測功能會導入輕量型用戶端代理程式,收集一組基本的匿名指標,並傳送至 Google 管理的端點。
AlloyDB Omni 是免費提供的可下載產品,因此這項遙測功能會向 Google 提供重要且非個人識別資訊 (非 PII) 的指標,包括執行個體的一般採用和部署環境。這類資料有助於我們制定產品開發策略,並決定支援服務的優先順序。
收集的指標包括:
- 不重複的安裝 ID (假名 UUID)
- AlloyDB Omni 版本和 PostgreSQL 主要版本
- 主機系統資訊,例如 CPU 數量、RAM 和正常運作時間
停用遙測資訊回報功能
如要防止遙測代理程式執行及回報使用指標,請將 PostgreSQL 設定參數 omni_enable_telemetry 設為 off。如要停用遙測代理程式,請在 postgresql.conf 檔案中設定遙測標記,或使用 ALTER SYSTEM 在執行階段設定標記。
在 postgresql.conf 檔案中設定遙測旗標
如要修改 PostgreSQL 設定檔,請按照下列步驟操作:
- 在資料庫的資料目錄中找出
postgresql.conf檔案。預設值為/var/lib/postgresql/MAJOR_VERSION/data。 停用 AlloyDB Omni 遙測功能。
omni_enable_telemetry = off
如要套用變更,請重新啟動 AlloyDB Omni 服務。 遙測代理程式會停止收集使用指標,並停止傳送給 Google。
systemctl restart alloydbomniMAJOR_VERSION
使用 ALTER SYSTEM 在執行階段設定遙測旗標
如要設定遙測旗標並在重新啟動後保留變更,請按照下列步驟操作:
使用
psql連線至 AlloyDB Omni 執行個體:/usr/lib/postgresql/18/bin/psql -h localhost -U postgres
執行下列指令:
ALTER SYSTEM SET omni_enable_telemetry = 'off';
重新啟動資料庫服務,確保背景工作人員完全擷取變更。
systemctl restart alloydbomni18
遙測代理程式會停止收集使用指標,並停止傳送給 Google。
啟用遙測資訊回報功能
如果您先前停用了 AlloyDB Omni 遙測功能,可以將 omni_enable_telemetry 旗標設為 on,重新啟用這項功能。如要啟用遙測代理程式,請在 postgresql.conf 檔案中設定標記,或使用 ALTER SYSTEM 在執行階段設定標記。
在 postgresql.conf 檔案中設定遙測旗標
- 在資料庫的資料目錄中找出
postgresql.conf檔案。 設定下列行:
omni_enable_telemetry = on
如要套用變更,請重新啟動 AlloyDB Omni 服務。
systemctl restart alloydbomni18
使用 ALTER SYSTEM 在執行階段設定遙測旗標
- 使用
psql連線至 AlloyDB Omni 執行個體。 執行下列指令:
ALTER SYSTEM SET omni_enable_telemetry = 'on';
如要套用變更,請重新啟動 AlloyDB Omni 服務。
systemctl restart alloydbomni18
檢查 AlloyDB Omni 遙測狀態
您可以檢查 AlloyDB Omni 遙測代理程式的狀態,包括是否已啟用或停用。您也可以檢查遙測代理程式活動。
檢查是否已啟用或停用遙測代理程式
如要檢查遙測設定的狀態,請按照下列步驟操作:
- 連線至執行個體。
- 執行以下指令:
SHOW omni_enable_telemetry;
輸出內容會傳回 on 或 off,視您是否停用或啟用 AlloyDB Omni 遙測功能而定。
檢查遙測代理程式是否正在執行
如要檢查遙測代理程式是否正在執行,請在主機中執行下列指令:
ps -ef | grep "omni telemetry worker"
如果已啟用並執行遙測功能,輸出內容會包含一行文字 postgres: omni telemetry worker。
檢查遙測代理程式活動
如要檢查遙測代理程式的活動,請在主機中執行下列指令:
journalctl -u alloydbomni18 | grep telemetry
如果遙測代理程式正在執行,記錄檔會包含類似以下的訊息:
LOG: [telemetry_agent_worker.cc:143] Started telemetry worker LOG: [telemetry_agent_worker.cc:161] Running telemetry reporting agent telemetry_agent: Uploading telemetry data to https://cloud.google.com/log.
連線至執行個體
視環境而定,您可以在本機或遠端連線至 AlloyDB Omni 執行個體。
在本機連線
如要在本機連線至 AlloyDB Omni 執行個體,請執行下列指令:/usr/lib/postgresql/18/bin/psql -U postgres -p HOST_PORT -h localhost
遠端連線
/usr/lib/postgresql/18/bin/psql -U postgres -p HOST_PORT -h IP_ADDRESS_OR_FQDN
請替換下列變數:
HOST_PORT:安裝期間使用的 TCP 通訊埠。IP_ADDRESS_OR_FQDN:執行 AlloyDB Omni 的主機 IP 位址或完整網域名稱。
啟用擴充功能
如要查看 AlloyDB Omni 支援的擴充功能清單,請參閱「支援的資料庫擴充功能」。雖然 AlloyDB Omni 未內建 PostGIS 和 Orafce,但您可以按照下列操作說明安裝這兩者:
如要啟用已安裝的擴充功能,請使用標準 PostgreSQL CREATE EXTENSION 陳述式,詳情請參閱「啟用擴充功能」。