自訂 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. 在資料庫的資料目錄中找出 postgresql.conf 檔案。預設值為 /var/lib/postgresql/MAJOR_VERSION/data
  2. 停用 AlloyDB Omni 遙測功能。

    omni_enable_telemetry = off
    
  3. 如要套用變更,請重新啟動 AlloyDB Omni 服務。 遙測代理程式會停止收集使用指標,並停止傳送給 Google。

    systemctl restart alloydbomniMAJOR_VERSION
    

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

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

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

    /usr/lib/postgresql/18/bin/psql -h localhost -U postgres
    
  2. 執行下列指令:

    ALTER SYSTEM SET omni_enable_telemetry = 'off';
    
  3. 重新啟動資料庫服務,確保背景工作人員完全擷取變更。

    systemctl restart alloydbomni18
    

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

啟用遙測資訊回報功能

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

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

  1. 在資料庫的資料目錄中找出 postgresql.conf 檔案。
  2. 設定下列行:

    omni_enable_telemetry = on
    
  3. 如要套用變更,請重新啟動 AlloyDB Omni 服務。

    systemctl restart alloydbomni18
    

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

  1. 使用 psql 連線至 AlloyDB Omni 執行個體。
  2. 執行下列指令:

    ALTER SYSTEM SET omni_enable_telemetry = 'on';
    
  3. 如要套用變更,請重新啟動 AlloyDB Omni 服務。

    systemctl restart alloydbomni18
    

檢查 AlloyDB Omni 遙測狀態

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

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

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

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

輸出內容會傳回 onoff,視您是否停用或啟用 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 陳述式,詳情請參閱「啟用擴充功能」。