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

将 Redis 命令行工具与 Azure Redis 缓存配合使用

使用 redis-cli 命令行工具作为客户端与 Azure Redis 缓存进行交互。使用此工具直接与 Azure Cache for Redis 实例交互，并进行调试和故障排除。

安装 redis-cli

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

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

sudo apt-get update
sudo apt-get install redis

在 Windows 计算机上使用 redis-cli 的最佳方式是安装适用于 Linux 的 Windows 子系统（WSL）。 Linux 子系统允许直接在 Windows 上运行 Linux 工具。若要安装 WSL，请按照 WSL 安装说明进行操作。

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

可以使用以下方法收集访问缓存所需的信息：

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

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

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

是否需要 TLS 访问 - 默认情况下，Azure Redis 缓存实例使用 TLS 加密进行连接。每当在服务器端使用 TLS 时，必须使用此选项 --tls 启用 redis-cli 上的 TLS。
使用的端口 - 所有企业和企业闪存层缓存都使用端口 10000。但是，基本、标准和高级版层缓存对非 TLS 连接使用端口6379或 TLS 连接的端口6380。
缓存实例是否使用聚类分析 - 如果使用使用聚类分析的高级版层缓存，还是使用 OSS 群集策略的企业/企业闪存层缓存，请添加该-c选项以确保可以访问所有分片。

使用以下命令使用 TLS 连接到基本、标准或高级版层 Azure Redis 缓存实例：
```
redis-cli.exe -p 6380 -h yourcachename.redis.cache.windows.net -a YourAccessKey --tls
```
连接到不使用 TLS 的基本、标准或高级版层 Azure Redis 缓存实例：
```
redis-cli.exe -p 6379 -h yourcachename.redis.cache.windows.net -a YourAccessKey
```
使用 TLS 和聚类分析连接到基本、标准或高级版层 Azure Redis 缓存实例：
```
redis-cli.exe -p 6380 -h yourcachename.redis.cache.windows.net -a YourAccessKey --tls -c
```

使用具有 TLS 的企业群集策略连接企业或企业闪存层缓存实例：

redis-cli.exe -p 10000 -h yourcachename.eastus.redisenterprise.cache.azure.net -a YourAccessKey --tls

使用不带 TLS 的 OSS 群集策略连接企业或企业闪存层缓存实例：

redis-cli.exe -p 10000 -h yourcachename.eastus.redisenterprise.cache.azure.net -a YourAccessKey -c

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

yourcachename.redis.cache.windows.net:6380> PING
PONG

还可以运行如下SET命令：GET

yourcachename.redis.cache.windows.net:6380> SET hello world
OK
yourcachename.redis.cache.windows.net:6380> GET hello
"world"

现在，你已使用 redis-cli 连接到 Azure Cache for Redis 实例。

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

Azure Redis 缓存提供内置于 Azure 门户中的 Redis 控制台，你可以在其中发出命令，而无需安装命令行工具。 Redis 控制台功能目前仅在基本层、标准层和高级版层中可用。
RedisInsight 是一种丰富的开放源代码图形工具，用于发出 Redis 命令和查看 Redis 实例的内容。它适用于 Azure Redis 缓存，在 Linux、Windows 和 macOS 上受支持。

通过创建新的企业层缓存实例开始。