設定 AlloyDB Omni 以用於實際工作環境

選取文件版本:

本頁面列出使用 AlloyDB Omni 處理正式版工作負載時的常見設定。

啟用巨型頁面

與 PostgreSQL 相同,AlloyDB Omni 也支援使用巨頁。這需要機器啟用巨頁,您也需要啟用資料庫設定 huge_pages

執行提供的指令碼,在電腦上啟用巨頁:

Docker

      docker run --rm --privileged google/alloydbomni setup-host
      

Docker

      docker run --rm --privileged google/alloydbomni setup-host
      

Podman

      podman run --rm --privileged google/alloydbomni setup-host
      

Podman

      podman run --rm --privileged google/alloydbomni setup-host
      
postgresql.conf 中新增下列程式碼,即可啟用巨型頁面:

   huge_pages=on

啟用交換功能

作業系統的交換功能可讓您在隨機存取記憶體 (RAM) 和硬碟之間移動閒置記憶體頁面,藉此擴充可用實體記憶體,為作用中程序釋出 RAM 空間。AlloyDB Omni 在高負載且需要額外記憶體時,會使用交換空間。

如要查看系統上啟用的交換空間大小,請執行下列指令:

   cat /proc/meminfo | grep SwapTotal

輸出看起來類似以下內容:

   SwapTotal:      165748732 kB

如果輸出值為 0,請參閱下列說明,瞭解如何在作業系統上啟用交換:

啟用核心傾印

如果 AlloyDB Omni 發生無法復原的錯誤並當機,核心傾印檔有助於進行分析。核心傾印是 AlloyDB Omni 程序在當機時的記憶體快照。

如要設定核心傾印,請按照下列方式設定 kernel.core_pattern

  1. 使用 sysctl 指令設定執行階段核心參數。
  2. 如要立即設定 kernel.core_pattern,請使用:

    sysctl -w kernel.core_pattern="CORE_PATTERN"

    CORE_PATTERN 替換為核心檔案名稱模式,例如「%e-%t.core」。

    如要進一步瞭解核心檔案名稱模式,請參閱「如何設定程序核心檔案名稱」一文。

    systemd-coredump 處理常式可進一步設定核心傾印設定。這項工具預設會安裝在 RHEL 中。在 Debian 和 Ubuntu 系統上,執行 sudo apt install coredumpctl 安裝工具。

啟動 AlloyDB Omni 時,請務必在 docker run 指令中傳遞 --ulimit=core:-1:-1 引數:

Docker

   docker run --name CONTAINER_NAME 
-e POSTGRES_PASSWORD=NEW_PASSWORD
--ulimit=core:-1:-1
-p HOST_PORT:5432 -d google/alloydbomni

Docker

   docker run --name CONTAINER_NAME 
-e POSTGRES_PASSWORD=NEW_PASSWORD
--ulimit=core:-1:-1
-p HOST_PORT:5432 -d google/alloydbomni

Podman

   podman run --name CONTAINER_NAME 
-e POSTGRES_PASSWORD=NEW_PASSWORD
--ulimit=core:-1:-1
-p HOST_PORT:5432 -d google/alloydbomni

Podman

   podman run --name CONTAINER_NAME 
-e POSTGRES_PASSWORD=NEW_PASSWORD
--ulimit=core:-1:-1
-p HOST_PORT:5432 -d google/alloydbomni

更改下列內容:

  - `CONTAINER_NAME`: the name of a new
    AlloyDB Omni container—for example, `my-omni-1`.
  - `NEW_PASSWORD`: the password assigned to the new
    container's `postgres` user after the password creation.

啟用內部記錄功能

除了標準 PostgreSQL 記錄外,AlloyDB Omni 還提供更多訊息。這些訊息具有技術性質,因此適用於 AlloyDB for PostgreSQL 支援服務。不過,額外資訊有助於偵錯資料庫問題。

如要啟用內部記錄,請完成下列步驟:

  1. 將資料庫參數 enable_alloydb_internal_log 設為 on

    ALTER SYSTEM SET enable_alloydb_internal_log=on;
    

    如要進一步瞭解如何修改 AlloyDB Omni 設定,請參閱「設定 AlloyDB Omni 資料庫參數」。

  2. 重新啟動 AlloyDB Omni 服務:

Docker

   docker restart CONTAINER_NAME
   

Docker

   docker restart CONTAINER_NAME
   

Podman

   podman restart CONTAINER_NAME
   

Podman

   podman restart CONTAINER_NAME
   

如要進一步自訂內部記錄,例如設定記錄檔名和輪替政策,請使用 PostgreSQL 參數

舉例來說,log_directory 參數會指定記錄檔的儲存目錄,而 log_filename 參數則會定義個別記錄檔的名稱。

AlloyDB Omni 會合併 log_directorylog_filename 參數,並依下列方式儲存內部記錄:

LOG_DIRECTORY/LOG_FILENAME.internal

設定 systemd 單位,自動執行作業

如果您在專用伺服器上執行 AlloyDB Omni,可能需要設定在伺服器啟動時自動啟動特定作業。其中一種做法是透過 systemd 單位。

舉例來說,下列步驟會設定 systemd,讓伺服器啟動時自動啟用巨頁。

/etc/systemd/system/alloydb-setup-env.service 中建立檔案:

   [Unit]
   Description=Setup huge pages for AlloyDB Omni

   [Service]
   Type=oneshot

   ExecStart=/usr/bin/docker run --rm --privileged google/alloydbomni setup-host

   [Install]
   WantedBy=multi-user.target

請按照下列步驟啟用服務:

   sudo systemctl enable alloydb-setup-env.service

後續步驟