通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

将 Redis 命令行工具与 Azure 托管 Redis 配合使用（预览版）

  • 项目

使用 redis-cli 命令行工具与作为客户端的 Azure 托管 Redis（预览版）进行交互。 使用此工具直接与 Azure 托管 Redis 实例交互，并进行调试和故障排除。

安装 redis-cli

redis-cli 工具随 Redis 包一起自动安装，可用于多个操作系统。 有关首选操作系统的最详细文档，请参阅开源的安装 Redis 指南。

Linux

redis-cli 在 Linux 上本机运行，大多数发行版都有一个包含 redis-cli 工具的 Redis 包。 例如，在 Ubuntu 上，使用以下命令安装 Redis 包：

sudo apt-get update
sudo apt-get install redis

Windows

要在 Windows 计算机上使用 redis-cli，最佳方式是安装适用于 Linux 的 Windows 子系统 (WSL)。 通过 Linux 子系统，可以直接在 Windows 上运行 Linux 工具。 若要安装 WSL，请按照 WSL 安装说明操作。

安装 WSL 后，可以使用为 WSL 选择的 Linux 发行版中提供的任何包管理来安装 redis-cli。

收集缓存访问信息

可通过以下方式收集访问缓存所需的信息：

本部分介绍如何从 Azure 门户检索密钥。

从 Azure 门户检索主机名、端口和访问密钥

若要连接到你的 Azure Cache for Redis 服务器，缓存客户端需要该缓存的主机名、端口和密钥。 在某些客户端中，这些项的名称可能略有不同。 可以从 Azure 门户检索主机名、端口和访问密钥。

  • 若要获取访问密钥，请从“资源”菜单中选择“身份验证”。 然后，选择“访问密钥”选项卡。

    显示 Azure Cache for Redis 访问密钥的屏幕截图。

  • 若要获取缓存的主机名和端口，请从“资源”菜单中选择“概述”。 主机名的格式为 <DNS 名称>.redis.cache.windows.net。

    屏幕截图显示 Azure Cache for Redis 属性。

使用 redis-cli 进行连接

在安装了 Redis 包的计算机上打开 shell 或终端。 如果使用 WSL，可以使用 Windows 终端打开 Linux 命令行。 在使用 redis-cli 进行连接之前，请检查：

  1. 是否需要 TLS 访问权限 - 默认情况下，Azure 托管 Redis 实例使用 TLS 加密进行连接。 每当在服务器端使用 TLS 时，都必须使用 --tls 选项启用 redis-cli 上的 TLS。
  2. 使用的端口 - 所有 Azure 托管 Redis 实例都使用端口 10000。 请注意，这不同于 Redis 社区版的默认值 6379。
  3. 缓存实例是否使用 OSS 群集策略 - 如果使用 OSS 群集策略，请添加 -c 选项以确保可以访问所有分片。

示例

  1. 通过 TLS 使用企业群集策略连接到 Azure 托管 Redis 实例：

    redis-cli -p 10000 -h {yourcachename}.{region}.redis.azure.net -a YourAccessKey --tls

  2. 使用 OSS 群集策略和 TLS 连接到 Azure 托管 Redis 实例：

    redis-cli -p 10000 -h {yourcachename}.{region}.redis.azure.net -a YourAccessKey --tls -c

测试连接

建立连接后，可以向 Azure 托管 Redis 实例发出命令。 测试连接的一种简单方法是使用 PING 命令。 此命令在控制台中返回 PONG。

yourcachename.region.redis.azure.net:10000> PING
PONG

还可以运行 SET 和 GET 等命令：

yourcachename.region.redis.azure.net:10000> SET hello world
OK
yourcachename.region.redis.azure.net:10000> GET hello
"world"

可以使用 redis-cli 连接到 Azure 托管 Redis 实例。

redis-cli 备选方法

虽然 redis-cli 是一种有用的工具，但可通过其他方式连接到缓存来进行故障排除或测试：

  • RedisInsight 是一种丰富的开源图形工具，用于发出 Redis 命令和查看 Redis 实例的内容。 它适用于 Azure 托管 Redis，在 Linux、Windows 和 macOS 上受支持。

相关内容

首先开始创建新的 Azure 托管 Redis 实例。