設定執行個體

Memorystore for Valkey 支援部分 Valkey 設定參數，您可以修改這些參數，自訂執行個體的行為。

變更設定時，您不必重新啟動執行個體，也不會中斷服務。Memorystore for Valkey 會立即儲存變更。如果執行個體重新啟動，則會保留設定變更。建立執行個體後，您可以更新可修改的設定參數。詳情請參閱「支援的執行個體設定」。

事前準備

請務必安裝最新版本的 Google Cloud CLI。如要更新現有安裝項目，請使用 gcloud components update 指令。

查看設定參數

如要查看設定參數，請使用 gcloud memorystore instances describe 指令。

gcloud memorystore instances describe INSTANCE_ID --location=REGION_ID

請依指示取代下列項目：

  • INSTANCE_ID：執行個體 ID
  • REGION_ID：執行個體所在的區域

例如：

gcloud memorystore instances describe my-instance --location=us-central1

如果未變更任何設定參數的預設值，輸出內容就不會顯示這些參數。

在建立執行個體時設定參數

如要在建立執行個體時設定參數，請使用
gcloud memorystore instances create 指令搭配 --engine-configs 旗標。

gcloud memorystore instances create INSTANCE_ID \
--location=REGION_ID \
--project=PROJECT_ID \
--node-type=NODE_TYPE \
--mode=MODE \
--shard-count=SHARD_COUNT \
--engine-configs=CONFIG_NAME=CONFIG_VALUE

請依指示取代下列項目：

  • INSTANCE_ID：要建立的執行個體 ID。
  • REGION_ID：您希望執行個體所在的區域。
  • PROJECT_ID：您的專案 ID。

  • NODE_TYPE：執行個體的節點類型。

  • MODE：是否要建立已啟用叢集模式或已停用叢集模式的執行個體。如果省略這個欄位，Memorystore for Valkey 預設會建立已啟用叢集模式的執行個體。詳情請參閱「啟用及停用叢集模式」。

  • SHARD_COUNT：執行個體中的 shard 數量。shard 數量會決定儲存執行個體資料的總記憶體容量。

    如果選取的模式為「已停用叢集模式」，則執行個體只能指定一個分片。詳情請參閱「執行個體和節點規格」。

  • CONFIG_NAME：要設定的設定參數名稱。

  • CONFIG_VALUE：您要設定的參數值。

例如：

已啟用叢集模式範例

  gcloud memorystore instances create my-instance --location=us-east1 --project=my-project --node-type=highmem-medium --shard-count=3 --engine-configs=maxmemory-policy=allkeys-lru

已停用叢集模式的範例

  gcloud memorystore instances create my-instance --location=us-east1 --project=my-project --node-type=highmem-medium --mode=cluster-disabled --shard-count=1 --engine-configs=maxmemory-policy=allkeys-lru

更新設定參數

如要更新現有執行個體的設定參數，請使用
gcloud memorystore instances update 指令，並加上 --update-engine-configs 旗標。

gcloud memorystore instances update INSTANCE_ID \
--location=REGION_ID \
--project=PROJECT_ID \
--update-engine-configs=CONFIG_NAME=CONFIG_VALUE

請將下列項目改為對應的值：

  • INSTANCE_ID：執行個體 ID
  • REGION_ID：執行個體所在的區域
  • PROJECT_ID：專案 ID
  • CONFIG_NAME：要更新的設定參數名稱
  • CONFIG_VALUE：參數的新值

例如：

gcloud memorystore instances update my-instance --location=us-east1 --project=my-project --update-engine-configs=maxmemory-policy=allkeys-lru

如要進一步瞭解可更新的設定參數，請參閱「 可修改的設定參數」。

重設設定參數

如要將設定參數重設為預設值，請使用
gcloud memorystore instances update 指令，並加上 --remove-engine-configs 旗標。

gcloud memorystore instances update INSTANCE_ID \
--location=REGION_ID \
--project=PROJECT_ID \
--remove-engine-configs=CONFIG_NAME

請依指示取代下列項目：

  • INSTANCE_ID：執行個體 ID
  • REGION_ID：執行個體所在的區域
  • PROJECT_ID：專案 ID
  • CONFIG_NAME：要重設為預設值的設定參數名稱

例如：

gcloud memorystore instances update my-instance --location=us-east1 --project=my-project --remove-engine-configs=maxmemory-policy

重設所有設定參數

如要將所有設定參數重設為預設值，請使用
gcloud memorystore instances update 指令，並加上 --clear-engine-configs 旗標。

gcloud memorystore instances update INSTANCE_ID \
--location=REGION_ID \
--project=PROJECT_ID \
--clear-engine-configs

請依指示取代下列項目：

  • INSTANCE_ID：執行個體 ID
  • REGION_ID：執行個體所在的區域
  • PROJECT_ID：專案 ID

例如：

gcloud memorystore instances update my-instance --location=us-east1 --project=my-project --clear-engine-configs