自訂 AlloyDB Omni 安裝作業

選取文件版本：

本頁說明如何自訂 AlloyDB Omni 安裝作業，這項作業支援不同形式的自訂。本頁列出一些常見的自訂項目。

啟用及停用 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 設定檔，請按照下列步驟操作：

  1. 在資料庫的資料目錄 ($PGDATA) 中找出 postgresql.conf 檔案。

  2. 停用 AlloyDB Omni 遙測功能。

    omni_enable_telemetry = off

  3. 如要套用變更，請重新啟動 AlloyDB Omni 容器。 遙測代理程式會停止收集使用指標，並停止傳送給 Google。

使用 ALTER SYSTEM 在執行階段設定遙測旗標

如要設定遙測旗標並在重新啟動後保留變更，請按照下列步驟操作：

  1. 使用 psql 連線至 AlloyDB Omni 執行個體：

    psql -h HOST -U USER -d DATABASE

    請替換下列項目：

    • HOST：AlloyDB Omni 執行個體的主機名稱或 IP 位址，例如 127.0.0.1。
    • USER：您要連線的資料庫使用者，例如 postgres。
    • DATABASE：要連線的資料庫，例如 postgres。

  2. 執行下列指令：

    ALTER SYSTEM SET omni_enable_telemetry = 'off';

  3. 重新載入設定或重新啟動執行個體。在某些容器設定中，您可能需要重新啟動執行個體，確保背景工作站完全採用變更。

    SELECT pg_reload_conf();

    遙測代理程式會停止收集使用指標，並停止傳送給 Google。

啟用遙測資訊回報功能

如果您先前停用了 AlloyDB Omni 遙測功能，可以將 omni_enable_telemetry 旗標設為 on，重新啟用這項功能。如要啟用遙測代理程式，請在 postgresql.conf 檔案中設定標記，或使用 ALTER SYSTEM 在執行階段設定標記。

在 postgresql.conf 檔案中設定遙測旗標

  1. 在資料庫的資料目錄 ($PGDATA) 中找出 postgresql.conf 檔案。

  2. 設定下列行：

    omni_enable_telemetry = on

  3. 如要套用變更，請重新啟動 AlloyDB Omni 容器。

使用 ALTER SYSTEM 在執行階段設定遙測旗標

  1. 使用 psql 連線至 AlloyDB Omni 執行個體。

  2. 執行下列指令：

    ALTER SYSTEM SET omni_enable_telemetry = 'on';

  3. 如要套用變更，請重新啟動 AlloyDB Omni 容器。

    docker restart CONTAINER_NAME

    請替換下列項目：

    • CONTAINER_NAME：AlloyDB Omni 容器的名稱，例如 my-omni-1。

檢查 AlloyDB Omni 遙測狀態

您可以檢查 AlloyDB Omni 遙測代理程式的狀態，包括是否已啟用或正在執行。您也可以檢查遙測代理程式活動。

檢查是否已啟用或停用遙測代理程式

如要檢查遙測設定的狀態，請按照下列步驟操作：

  1. 連線至執行個體。
  2. 執行以下指令：
SHOW omni_enable_telemetry;

輸出內容會傳回 on 或 off，視您是否停用或啟用 AlloyDB Omni 遙測功能而定。

檢查遙測代理程式是否正在執行

如要檢查遙測代理程式是否正在執行，請在容器主機中執行下列指令：

docker top CONTAINER_NAME

請替換下列項目：

  • CONTAINER_NAME：AlloyDB Omni 容器的名稱，例如 my-omni-1。

如果已啟用並執行遙測功能，輸出內容會包含一行文字 postgres: omni telemetry worker。

檢查遙測代理程式活動

如要檢查遙測代理程式的活動，請在容器主機中執行下列指令：

docker logs CONTAINER_NAME 2>&1 | grep telemetry

請替換下列項目：

  • CONTAINER_NAME：AlloyDB Omni 容器的名稱，例如 my-omni-1。

如果遙測代理程式正在執行，記錄檔會包含類似以下的訊息：

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 執行個體。

在本機連線

Docker

docker exec -it CONTAINER_NAME psql -U postgres

Docker

docker exec -it CONTAINER_NAME psql -U postgres

Podman

podman exec -it CONTAINER_NAME psql -U postgres

Podman

podman exec -it CONTAINER_NAME psql -U postgres

請替換下列變數：

  • CONTAINER_NAME：AlloyDB Omni 容器的名稱，例如 my-omni-1。

遠端連線

/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 陳述式，詳情請參閱「啟用擴充功能」。