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

連線至 Memorystore for Valkey 執行個體

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

客戶支援

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

跨區域存取

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

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

本節說明如何連線至已啟用叢集模式的 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_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

記下 endpoints: 區段中 connectionType: CONNECTION_TYPE_DISCOVERY 項目列出的端點位址和通訊埠號碼。這兩個值加總起來就是執行個體的探索端點。

使用 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 帳單帳戶收取費用。

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

本節提供範例，說明如何連線至已啟用傳輸中加密的 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 帳單帳戶收取費用。

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

本節提供範例，說明如何連線至已啟用傳輸中加密的 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
```