在 AlloyDB Omni 中設定資料欄引擎

單一伺服器

如要將 google_columnar_engine.enabled 設為 on，請按照下列步驟操作：

1. 執行 ALTER SYSTEM PostgreSQL 指令：

   ALTER SYSTEM SET google_columnar_engine.enabled = 'on'
   

2. 如要調整資料欄引擎的設定，請先按照下一節的指示操作，再重新啟動資料庫伺服器。否則，請完成下列步驟，立即重新啟動資料庫伺服器。

3. 如要讓設定參數變更生效，請使用 AlloyDB Omni 重新啟動執行中的容器。

   Docker

     sudo docker restart CONTAINER_NAME

   Podman

     sudo podman restart CONTAINER_NAME

Kubernetes

如要將 google_columnar_engine.enabled 旗標設為 on，請修改資料庫叢集資訊清單，將 parameters 屬性新增至 primarySpec 區段：

    apiVersion: alloydbomni.dbadmin.goog/v1
    kind: DBCluster
    metadata:
      name: CLUSTER_NAME
    spec:
      databaseVersion: "16.3.0"
      primarySpec:
        parameters:
          google_columnar_engine.enabled: "on"

將 CLUSTER_NAME 替換為資料庫叢集名稱。這個名稱與您建立資料庫叢集時宣告的名稱相同。

單一伺服器

如要在執行個體上設定 google_columnar_engine.memory_size_in_mb 旗標，請按照下列步驟操作：

1. 執行 ALTER SYSTEM PostgreSQL 指令，設定記憶體：

   ALTER SYSTEM SET google_columnar_engine.memory_size_in_mb = COLUMN_MEMORY_SIZE;
   

   將 COLUMN_MEMORY_SIZE 替換為新的資料欄儲存空間大小 (以 MB 為單位)，例如 256。

2. 如要讓設定參數變更生效，請使用 AlloyDB Omni 重新啟動執行中的容器。

   Docker

   sudo docker restart CONTAINER_NAME

   Podman

   sudo podman restart CONTAINER_NAME

Kubernetes

如要設定 google_columnar_engine.memory_size_in_mb 旗標，請修改資料庫叢集資訊清單，將 parameters 屬性新增至 primarySpec 區段：

    apiVersion: alloydbomni.dbadmin.goog/v1
    kind: DBCluster
    metadata:
      name: CLUSTER_NAME
    spec:
      databaseVersion: "16.3.0"
      primarySpec:
        parameters:
          google_columnar_engine.memory_size_in_mb: "COLUMN_MEMORY_SIZE"

更改下列內容：

• CLUSTER_NAME：資料庫叢集的名稱。這個名稱與您建立資料庫叢集時宣告的名稱相同。
• COLUMN_MEMORY_SIZE：資料欄儲存空間的新大小，以 MB 為單位，例如 256。

單一伺服器

1. 按照下列步驟設定儲存空間快取：

   ALTER SYSTEM SET google_columnar_engine.storage_cache_size = STORAGE_CACHE_SIZE;
   

   將 STORAGE_CACHE_SIZE 替換為所需的儲存空間快取大小 (以 MB 為單位)。根據預設，磁碟快取的 5% 會分配給資料欄引擎。這個旗標的值上限為磁碟快取總量的 50%，或 1000 * google_columnar_engine.memory_size_in_mb，以較小者為準。

2. 如要讓設定參數變更生效，請使用 AlloyDB Omni 重新啟動執行中的容器。

   Docker

   sudo docker restart CONTAINER_NAME

   Podman

   sudo podman restart CONTAINER_NAME

Kubernetes

如要為資料庫啟用儲存空間快取，請修改資料庫叢集資訊清單，將 columnarSpillToDisk 屬性新增至 primarySpec 區段的 features 區段：

apiVersion: alloydbomni.dbadmin.goog/v1
kind: DBCluster
metadata:
  name: CLUSTER_NAME
spec:
  databaseVersion: "16.3.0"
  primarySpec:
    features:
      columnarSpillToDisk:
        cacheSize: STORAGE_CACHE_SIZE
      ultraFastCache:
        cacheSize: ULTRAFAST_CACHE_SIZE
        genericVolume:
          storageClass: "STORAGE_CLASS_NAME"
...

更改下列內容：

• CLUSTER_NAME：資料庫叢集的名稱。這個名稱與您建立資料庫叢集時宣告的名稱相同。
• STORAGE_CACHE_SIZE：資料欄儲存空間快取的大小，例如 5Gi。如未指定這個欄位的值，系統預設會將 5% 的磁碟快取分配給資料欄引擎。
• ULTRAFAST_CACHE_SIZE：快取大小，例如 100Gi。必須大於 shared_buffers。這是選填欄位。如未指定這個欄位的值，AlloyDB Omni 會使用磁碟上的所有剩餘空間，這適用於容器和 Kubernetes 叢集中的 AlloyDB Omni。如要進一步瞭解測量單位，請參閱「記憶體資源單位」。
• STORAGE_CLASS_NAME：超快速快取磁碟區的儲存空間類別名稱，例如 local-storage。

單一伺服器

如要將 google_columnar_engine.enabled 設為 off，請按照下列步驟操作：

1. 執行 ALTER SYSTEM PostgreSQL 指令：

ALTER SYSTEM SET google_columnar_engine.enabled = 'off'

1. 如要讓設定參數變更生效，請使用 AlloyDB Omni 重新啟動執行中的容器。

  sudo docker restart CONTAINER_NAME

  sudo podman restart CONTAINER_NAME

Kubernetes

如要將 google_columnar_engine.enabled 旗標設為 off，請修改資料庫叢集資訊清單，將 parameters 屬性新增至 primarySpec 區段：

  apiVersion: alloydbomni.dbadmin.goog/v1
  kind: DBCluster
  metadata:
    name: CLUSTER_NAME
  spec:
    databaseVersion: "16.3.0"
    primarySpec:
      parameters:
        google_columnar_engine.enabled: "off"

將 CLUSTER_NAME 替換為資料庫叢集名稱。這個名稱與您建立資料庫叢集時宣告的名稱相同。