本頁面由 Cloud Translation API 翻譯而成。

連線至 Memorystore for Valkey 執行個體

本頁面說明如何連線至 Memorystore for Valkey 執行個體。

客戶支援

如需相關範例和使用連線用戶端的相關指引，請參閱用戶端程式庫程式碼範例。。

跨區域存取

您可以從位於不同地區的用戶端存取 Memorystore for Valkey 執行個體。

連線至已啟用叢集模式的執行個體

本節說明如何連線至啟用叢集模式的 Memorystore for Valkey 執行個體。

查看執行個體的探索端點

如要查看執行個體的探索端點，請按照下列說明操作：

gcloud

如要查看執行個體的探索端點，請執行 describe gcloud CLI，如「查看執行個體資訊」一節所述。

畫面會顯示如下的輸出內容：

--location=us-central1 \
authorizationMode: AUTH_DISABLED
createTime: '2024-08-06T22:02:55.224704101Z'
deletionProtectionEnabled: false
discoveryEndpoints:
- address: 10.128.0.58
  network: projects/my-project/global/networks/default
  port: 6379
engineVersion: VALKEY_7_2
name: projects/myproject/locations/us-central1/instances/my-instance
nodeConfig:
  sizeGb: 6.5
nodeType: STANDARD_SMALL
persistenceConfig:
  mode: DISABLED
endpoints:
- connections:
  - pscAutoConnection:
       connectionType: CONNECTION_TYPE_DISCOVERY
       forwardingRule: https://www.googleapis.com/compute/v1/projects/my-project/regions/us-central1/forwardingRules/sca-auto-fr-ec00907a-3ee3-4740-8092-ae832428f8e4
       ipAddress: 10.128.0.58
       network: projects/my-project/global/networks/default
       port: 6379
       projectId: my-project
       pscConnectionId: '38876592440606778'
       serviceAttachment: projects/129109085717/regions/us-east1/serviceAttachments/gcp-memorystore-auto-58e78f71-fdb7-48-psc-sa
    - pscAutoConnection:
       forwardingRule: https://www.googleapis.com/compute/v1/projects/my-project/regions/us-central1/forwardingRules/sca-auto-fr-5ce5518f-1c59-4b46-aa74-799fad70d7b1
       ipAddress: 10.128.0.59
       network: projects/my-project/global/networks/default
       port: 6379
       projectId: my-project
       pscConnectionId: '38876592440606779'
       serviceAttachment: projects/129109085717/regions/us-east1/serviceAttachments/gcp-memorystore-auto-58e78f71-fdb7-48-psc-sa-2
replicaCount: 2
shardCount: 5
state: ACTIVE
transitEncryptionMode: TRANSIT_ENCRYPTION_DISABLED
uid: 869f2d09-d20b-46d8-94ba-be83c48ceb54
updateTime: '2024-08-06T22:18:59.389980051Z'
zoneDistributionConfig:
  mode: MULTI_ZONE

請記下 discovery_endpoints: 部分列出的端點位址和通訊埠號碼。這兩個值搭配使用，就是執行個體的探索端點。

使用 valkey-cli 從 Compute Engine VM 連線

您可以從任何使用 Memorystore 執行個體授權網路的 Compute Engine VM 連線至 Memorystore for Valkey 執行個體。

如要連線至執行個體，請按照下列步驟操作：

如果您尚未擁有使用 Memorystore for Valkey 執行個體授權網路的 Linux Compute Engine VM，請按照快速入門：建立 Linux VM建立及連線至 VM。
按照「安裝 Valkey」中的操作說明，在 Compute Engine VM 上安裝 valkey-cli。
查看執行個體的探索端點，並記下端點。
執行下列指令，連線至執行個體的探索端點：
```
valkey-cli -h DISCOVERY_ENDPOINT_ADDRESS -p PORT_NUMBER -c
```
其中：
- DISCOVERY_ENDPOINT_ADDRESS 和 PORT_NUMBER 是您在上一個步驟中記下的值。
注意： -c 切換鈕可用於啟用 valkey-cli 叢集支援模式。如果未提供 -c 切換鈕，當您嘗試從與您連線的不同區塊存取金鑰時，會導致 MOVED 錯誤。在叢集支援模式中，用戶端會自動重新連線至錯誤回應中傳回的地址。
執行 CLUSTER SHARDS 指令，查看節點拓樸圖。記下其中一個節點的 IP 位址和通訊埠號碼。
執行下列指令，連線至所需節點：
```
valkey-cli -h NODE_IP_ADDRESS -p NODE_PORT -c
```
更改下列內容：
- NODE_IP_ADDRESS 是您在上一個步驟中找到的節點 IP 位址。
- NODE_PORT 是您在上一個步驟中找到的節點連接埠號碼。
連線至節點後，輸入一些 Valkey 指令：

輸入：
```
PING
```
結果：
```
PONG
```
Enter 鍵
```
SET HELLO WORLD
```
結果：
```
OK
```
輸入：
```
GET HELLO
```
結果：
```
"WORLD"
```
測試與 Valkey 節點的連線後，建議您刪除用於連線至 Valkey 執行個體的 Compute Engine VM。這有助於避免系統向您的 Cloud Billing 帳戶收取費用。

連線至已啟用傳輸中加密功能的執行個體

本節提供範例，說明如何連線至已啟用傳輸中加密功能的 Memorystore for Valkey 叢集模式啟用執行個體。

如果您尚未擁有與上一個步驟中的 Valkey 執行個體使用相同授權網路的 Compute Engine VM，請按照快速入門導覽課程：使用 Linux VM建立及連線至 VM。
1. 按照「安裝 Valkey」中的操作說明，在 Compute Engine VM 上安裝 valkey-cli 6.0 以上版本。
按照「在用戶端上安裝憑證授權單位」一節的操作說明，在 Linux VM 上安裝執行個體的憑證授權單位。
查看執行個體的探索端點，並記下端點。
執行下列指令，連線至執行個體的探索端點：
```
valkey-cli -h DISCOVERY_ENDPOINT_ADDRESS -p PORT_NUMBER -c --tls  --cacert /tmp/server_ca.pem
```
其中：
- DISCOVERY_ENDPOINT_ADDRESS 和 PORT_NUMBER 是您在上一個步驟中記下的值。
注意： -c 切換鈕可用於啟用 valkey-cli 叢集支援模式。如果未提供 -c 切換鈕，當您嘗試從與您連線的不同區塊存取金鑰時，會導致 MOVED 錯誤。在叢集支援模式中，用戶端會自動重新連線至錯誤回應中傳回的地址。
執行 CLUSTER SHARDS 指令，查看節點拓樸圖。記下其中一個節點的 IP 位址和通訊埠號碼。
執行下列指令，連線至所需節點：
```
valkey-cli -h NODE_IP_ADDRESS -p NODE_PORT -c --tls  --cacert /tmp/server_ca.pem
```
更改下列內容：
- NODE_IP_ADDRESS 是您在上一個步驟中找到的節點 IP 位址。
- NODE_PORT 是您在上一個步驟中找到的節點連接埠號碼。
連線至節點後，請輸入下列 Valkey 指令：

輸入：
```
PING
```
結果：
```
PONG
```

連線至叢集模式已停用的執行個體

本節說明如何連線至 Memorystore for Valkey 叢集模式停用的執行個體。

查看執行個體的主要端點和讀取端點

如要查看執行個體的主要和讀取端點，請按照下列操作說明操作：

gcloud

如要查看執行個體的主要端點和讀取器端點，請執行 describe gcloud CLI，如「查看執行個體資訊」一節所述。

畫面會顯示如下的輸出內容：

authorizationMode: AUTH_DISABLED
createTime: '2024-08-06T22:02:55.224704101Z'
deletionProtectionEnabled: false
engineVersion: VALKEY_7_2
name: projects/myproject/locations/us-central1/instances/my-instance
nodeConfig:
  sizeGb: 6.5
nodeType: STANDARD_SMALL
persistenceConfig:
  mode: DISABLED
endpoints:
- connections:
  - pscAutoConnection:
      connectionType: CONNECTION_TYPE_PRIMARY
      forwardingRule: https://www.googleapis.com/compute/v1/projects/my-project/regions/us-central1/forwardingRules/sca-auto-fr-ec00907a-3ee3-4740-8092-ae832428f8e4
      ipAddress: 10.128.0.124
      network: projects/my-project/global/networks/default
      port: 6379
      projectId: my-project
      pscConnectionId: '38876592440606778'
      serviceAttachment: projects/448055306617/regions/us-central1/serviceAttachments/gcp-memorystore-auto-b3c43536-4a77-40-psc-sa
  - pscAutoConnection:
      connectionType: CONNECTION_TYPE_READER
      forwardingRule: https://www.googleapis.com/compute/v1/projects/my-project/regions/us-central1/forwardingRules/sca-auto-fr-5ce5518f-1c59-4b46-aa74-799fad70d7b1
      ipAddress: 10.128.0.125
      network: projects/my-project/global/networks/default
      port: 6379
      projectId: my-project
      pscConnectionId: '38876592440606779'
      serviceAttachment: projects/448055306617/regions/us-central1/serviceAttachments/gcp-memorystore-auto-b3c43536-4a77-40-psc-sa-2
replicaCount: 2
shardCount: 1
mode: CLUSTER_DISABLED
state: ACTIVE
transitEncryptionMode: TRANSIT_ENCRYPTION_DISABLED
uid: 869f2d09-d20b-46d8-94ba-be83c48ceb54
updateTime: '2024-08-06T22:18:59.389980051Z'
zoneDistributionConfig:
  mode: MULTI_ZONE

主要端點：請記下 endpoints: 部分 CONNECTION_TYPE_PRIMARY 下方列出的端點位址和連接埠號碼。這兩個值搭配使用，就是執行個體的主要端點。

讀取器端點：請記下 endpoints: 部分 CONNECTION_TYPE_READER 下方所列的端點位址和連接埠號碼。這兩個值搭配使用，就是執行個體的讀取器端點。

使用 valkey-cli 從 Compute Engine VM 連線

您可以從任何使用 Memorystore 執行個體授權網路的 Compute Engine VM 連線至 Memorystore for Valkey 執行個體。

如要連線至執行個體，請按照下列步驟操作：

如果您尚未擁有使用 Memorystore for Valkey 執行個體授權網路的 Linux Compute Engine VM，請按照快速入門：建立 Linux VM建立及連線至 VM。
按照「安裝 Valkey」中的操作說明，在 Compute Engine VM 上安裝 valkey-cli。
查看執行個體的主要端點和讀取端點，並記下這兩個端點。
執行下列指令，即可連線至執行個體的主要端點：
```
valkey-cli -h PRIMARY_ENDPOINT_ADDRESS -p PORT_NUMBER
```
其中：
- PRIMARY_ENDPOINT_ADDRESS 和 PORT_NUMBER 是您在上一個步驟中記下的值。
連線至主要節點後，請輸入下列 Valkey 指令：

輸入：
```
PING
```
結果：
```
PONG
```
Enter 鍵
```
SET HELLO WORLD
```
結果：
```
OK
```
輸入：
```
GET HELLO
```
結果：
```
"WORLD"
```
執行下列指令，即可連線至執行個體的讀取器端點：
```
valkey-cli -h READER_ENDPOINT_ADDRESS -p PORT_NUMBER
```
其中：
- READER_ENDPOINT_ADDRESS 和 PORT_NUMBER 是您在上一個步驟中記下的值。
連線至主要節點後，請輸入下列 Valkey Get 指令：

輸入：
```
PING
```
結果：
```
PONG
```
輸入：
```
GET HELLO
```
結果：
```
"WORLD"
```
測試與 Valkey 節點的連線後，請刪除用於連線至 Valkey 執行個體的 Compute Engine VM。這有助於避免系統向您的 Cloud Billing 帳戶收取費用。

連線至已啟用傳輸中資料加密功能的執行個體

本節提供範例，說明如何連線至已啟用傳輸中加密功能的 Memorystore for Valkey 叢集模式停用例項。

如果您尚未擁有與上一個步驟中的 Valkey 執行個體使用相同授權網路的 Compute Engine VM，請按照快速入門導覽課程：使用 Linux VM建立及連線至 VM。
1. 按照「安裝 Valkey」中的操作說明，在 Compute Engine VM 上安裝 valkey-cli 6.0 以上版本。
按照「在用戶端上安裝憑證授權單位」一節的操作說明，在 Linux VM 上安裝執行個體的憑證授權單位。
查看執行個體的主要端點和讀取端點，並記下這兩個端點。
執行下列指令，即可連線至執行個體的主要端點：
```
valkey-cli -h PRIMARY_ENDPOINT_ADDRESS -p PORT_NUMBER --tls  --cacert /tmp/server_ca.pem
```
其中：
- PRIMARY_ENDPOINT_ADDRESS 和 PORT_NUMBER 是您在上一個步驟中記下的值。
執行下列指令，即可連線至執行個體的讀取器端點：
```
valkey-cli -h READER_ENDPOINT_ADDRESS -p PORT_NUMBER --tls  --cacert /tmp/server_ca.pem
```
其中：
- READER_ENDPOINT_ADDRESS 和 PORT_NUMBER 是您在上一個步驟中記下的值。
連線至節點後，輸入一些 Valkey 指令：

輸入：
```
PING
```
結果：
```
PONG
```

連線至 Memorystore for Valkey 執行個體 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

客戶支援

跨區域存取

連線至已啟用叢集模式的執行個體

查看執行個體的探索端點

gcloud

使用 valkey-cli 從 Compute Engine VM 連線

連線至已啟用傳輸中加密功能的執行個體

連線至叢集模式已停用的執行個體

查看執行個體的主要端點和讀取端點

gcloud

使用 valkey-cli 從 Compute Engine VM 連線

連線至已啟用傳輸中資料加密功能的執行個體

連線至 Memorystore for Valkey 執行個體