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

使用客户端工具管理 Azure 托管 Redis 中的数据

  • 适用于: ✅ Azure Managed Redis

可以使用以下工具作为客户端访问和管理 Azure 托管 Redis 中的数据。 使用这些工具直接与Azure托管 Redis 实例进行交互，并进行调试和故障排除。

  • Redis Insight
  • redis-cli 命令行工具

Redis Insight

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

安装 Redis Insight

若要安装 Redis Insight，请按照 Redis Insight 文档中的说明进行操作。

小窍门

建议在安装过程中在 EULA 和隐私设置页上选择“使用建议的设置”。

使用 Redis Insight 配置对 Azure 托管 Redis 的访问

Redis Insight 可以使用Microsoft Entra ID或访问密钥身份验证对Azure托管 Redis 实例进行身份验证。 建议使用Microsoft Entra ID来提高安全性。

从版本 3.2.0 开始，Redis Insight 可以使用 PKCE OAuth 2.0 流通过 Microsoft Entra ID 进行 Azure 托管 Redis 的身份验证，从而实现跨订阅的自动数据库发现和无密码身份验证。

有关使用 Redis Insight 配置对 Azure 托管 Redis 的访问的说明，请参阅 Redis Insight GitHub 存储库。 这是每个 Azure 租户的一次性设置。

使用 Redis Insight 连接到 Azure 托管 Redis

配置Microsoft Entra ID访问后，请按照以下步骤连接到 Redis Insight 中的 Azure 托管 Redis 实例：

  1. 在 Redis Insight 中，在 “Redis 数据库 ”选项卡上，选择“ + 连接现有数据库”。
  2. 在 Add database 窗口中，选择Azure托管 Redis。
  3. 按照提示使用Microsoft Entra ID身份验证进行连接。
  4. 在 Subscription 页上，选择包含Azure托管 Redis 实例的订阅，然后选择 Add 数据库。
  5. 选择要连接到Azure托管 Redis 实例（数据库），然后选择 Add 数据库。 可以选择多个数据库以同时连接到该数据库。
  6. 重复上述步骤，根据需要在同一订阅或其他Azure订阅中添加Azure托管 Redis 实例。

  • 添加Azure托管 Redis 实例后，可以从 Redis Insight 中的 Redis 数据库列表中选择它，并开始发出命令和查看数据。

  • 若要访问内置 CLI，请选择所选数据库的屏幕底部的 （>_ CLI）。

redis-cli 命令行工具

使用 redis-cli 命令行工具作为客户端与Azure托管 Redis 实例进行交互。 使用 redis_cli 作为发出命令并在脚本中执行可重复测试的轻量方法。

安装 redis-cli

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

Linux

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

sudo apt-get update
sudo apt-get install redis

Windows

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

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

收集缓存访问信息

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

在本部分中，将从Azure门户检索信息。

若要连接Azure托管 Redis 服务器，缓存客户端需要缓存终结点、端口和缓存密钥。 在某些客户端中，这些项的名称可能略有不同。 可以从 Azure 门户获取此信息。

  • 若要获取缓存的终结点和端口，请从“资源”菜单中选择“概述”。 终结点的格式为{yourcachename}.{region}.redis.azure.net。 对于所有 Azure 托管 Redis 实例，端口是10000。

  • 若要获取访问密钥，请从“设置”菜单中选择“身份验证”。 然后，选择 “访问密钥 ”选项卡。在这里，可以找到缓存的主密钥和辅助密钥。 可以使用任一密钥连接到客户端工具。

使用 redis-cli 进行连接

在安装了 Redis 包的计算机上打开 shell 或终端。 如果使用 WSL，则可以使用 Windows Terminal 打开 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 实例。

相关内容

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

  • Last updated on