此页面由 Cloud Translation API 翻译。

连接到 Memorystore for Valkey 实例
使用集合让一切井井有条根据您的偏好保存内容并对其进行分类。

本页介绍了如何连接到 Memorystore for Valkey 实例。

客户端支持

如需有关使用哪些连接客户端的示例和指南，请参阅客户端库代码示例。。

跨区域访问

您可以从与实例所在区域不同的区域的客户端访问 Memorystore for Valkey 实例。

连接到启用了集群模式的实例

本部分介绍了如何连接到启用了集群模式的 Memorystore for Redis 实例。

查看实例的发现端点

如需查看实例的发现端点，请按照以下说明操作：

gcloud

如需查看实例的发现端点，请按照查看实例信息中所述的方式运行 describegcloud 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 虚拟机连接

您可以从任何使用 Memorystore 实例的授权网络的 Compute Engine 虚拟机连接到 Memorystore for Valkey 实例。

如需连接到实例，请执行以下操作：

如果您还没有使用 Memorystore for Valkey 实例的授权网络的 Linux Compute Engine 虚拟机，请按照 Linux 虚拟机使用快速入门中的说明创建一个虚拟机并连接到该虚拟机。
按照安装 Valkey 中的说明，在 Compute Engine 虚拟机上安装 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
```
输入
```
SET HELLO WORLD
```
结果：
```
OK
```
请输入：
```
GET HELLO
```
结果：
```
"WORLD"
```
完成与 Valkey 节点的连接测试后，您应该考虑删除用于连接到 Valkey 实例的 Compute Engine 虚拟机。这样做有助于避免系统向您的 Cloud Billing 账号收取费用。

连接到启用了传输加密的实例

本部分举例说明如何连接到启用了传输加密的 Memorystore for Valkey 集群模式启用型实例。

如果您还没有与上一步的 Valkey 实例使用同一授权网络的 Compute Engine 虚拟机，请创建一个虚拟机并按照 Linux 虚拟机使用快速入门中的说明连接到该虚拟机。
1. 按照安装 Valkey 中的说明，在 Compute Engine 虚拟机上安装 valkey-cli 6.0 或更高版本。
按照在客户端上安装证书授权机构中的说明，在 Linux 虚拟机上安装实例的证书授权机构。
查看实例的发现端点并记下该端点。
运行以下命令，连接到实例的发现端点：
```
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 Cluster Mode Disabled 实例。

查看实例的主端点和读取器端点

如需查看实例的主端点和读取器端点，请按照以下说明操作：

gcloud

如需查看实例的主端点和读取器端点，请运行 describegcloud 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 虚拟机连接

您可以从任何使用 Memorystore 实例的授权网络的 Compute Engine 虚拟机连接到 Memorystore for Valkey 实例。

如需连接到实例，请执行以下操作：

如果您还没有使用 Memorystore for Valkey 实例的授权网络的 Linux Compute Engine 虚拟机，请按照 Linux 虚拟机使用快速入门中的说明创建一个虚拟机并连接到该虚拟机。
按照安装 Valkey 中的说明，在 Compute Engine 虚拟机上安装 valkey-cli。
查看实例的主端点和读取器端点，并记下它们。
运行以下命令，连接到实例的主端点：
```
valkey-cli -h PRIMARY_ENDPOINT_ADDRESS -p PORT_NUMBER
```
其中：
- PRIMARY_ENDPOINT_ADDRESS 和 PORT_NUMBER 是您在上一步中记下的值。
连接到主节点后，输入以下 Valkey 命令：

请输入：
```
PING
```
结果：
```
PONG
```
输入
```
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 虚拟机。这样做有助于避免系统向您的 Cloud Billing 账号收取费用。

连接到启用了传输加密的实例

本部分举例说明如何连接到启用了传输加密的 Memorystore for Valkey 集群模式已停用实例。

如果您还没有与上一步的 Valkey 实例使用同一授权网络的 Compute Engine 虚拟机，请创建一个虚拟机并按照 Linux 虚拟机使用快速入门中的说明连接到该虚拟机。
1. 按照安装 Valkey 中的说明，在 Compute Engine 虚拟机上安装 valkey-cli 6.0 或更高版本。
按照在客户端上安装证书授权机构中的说明，在 Linux 虚拟机上安装实例的证书授权机构。
查看实例的主端点和读取器端点，并记下它们。
运行以下命令，连接到实例的主端点：
```
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 虚拟机连接

连接到启用了传输加密的实例

连接到“集群模式已停用”实例

查看实例的主端点和读取器端点

gcloud

使用 valkey-cli 从 Compute Engine 虚拟机连接

连接到启用了传输加密的实例

连接到 Memorystore for Valkey 实例
使用集合让一切井井有条根据您的偏好保存内容并对其进行分类。