Skip to content

Commit 4ac39f0

Browse files
authored
Merge pull request #313010 from dlepow/redisdata
[AMR] Data access tools
2 parents c743f17 + 41bf6fc commit 4ac39f0

3 files changed

Lines changed: 37 additions & 24 deletions

File tree

articles/redis/.openpublishing.redirection.redis.json

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,11 @@
66
"redirect_url": "/azure/redis/configure",
77
"redirect_document_id": false
88
},
9+
{
10+
"source_path_from_root": "/articles/redis/how-to-redis-cli-tool.md",
11+
"redirect_url": "/azure/redis/how-to-redis-access-data",
12+
"redirect_document_id": false
13+
},
914
{
1015
"source_path_from_root": "/articles/redis/high-availability.md",
1116
"redirect_url": "/azure/azure-cache-for-redis/cache-high-availability",

articles/redis/TOC.yml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -122,8 +122,8 @@ items:
122122
href: how-to-import-export-data.md
123123
- name: Scheduled maintenance
124124
href: scheduled-maintenance.md
125-
- name: Configure redis-cli access
126-
href: how-to-redis-cli-tool.md
125+
- name: Manage data with client tools
126+
href: how-to-redis-access-data.md
127127
- name: Management FAQs
128128
href: management-faq.yml
129129
- name: Azure Functions

articles/redis/how-to-redis-cli-tool.md renamed to articles/redis/how-to-redis-access-data.md

Lines changed: 30 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -1,24 +1,32 @@
11
---
2-
title: Use redis-cli with Azure Managed Redis
3-
description: Learn how to use *redis-cli* as a command-line tool for interacting with an Azure Managed Redis as a client
4-
ms.date: 08/18/2025
5-
ms.topic: conceptual
2+
title: Use Client Tools to Access Data in Azure Managed Redis
3+
description: Learn how to use *Redis Insight* and *redis-cli* as client tools to access data and for troubleshooting and debugging Azure Managed Redis.
4+
ms.date: 03/11/2026
5+
ms.topic: concept-article
66
ms.custom:
7-
- ignite-2024
8-
- build-2025
97
appliesto:
10-
- ✅ Azure Cache for Redis
118
- ✅ Azure Managed Redis
129
---
13-
# Use the Redis command-line tool with Azure Managed Redis
10+
# Use client tools to manage data in Azure Managed Redis
1411

15-
Use the [redis-cli command-line tool](https://redis.io/docs/latest/operate/rs/references/cli-utilities/redis-cli/#connect-to-a-database) to interact with an Azure Managed Redis as a client. Use this tool to directly interact with your Azure Managed Redis instance and for debugging and troubleshooting.
12+
You can use the following tools to access and manage data in Azure Managed Redis as a client. Use these tools to directly interact with your Azure Managed Redis instance and for debugging and troubleshooting.
1613

17-
## Install redis-cli
14+
- Redis Insight
15+
- redis-cli command-line tool
16+
17+
## Redis Insight
18+
19+
[Redis Insight](https://redis.com/redis-enterprise/redis-insight/) is a rich open-source graphical tool for issuing Redis commands and viewing the contents of a Redis instance. It works with Azure Managed Redis and is supported on Linux, Windows, and macOS.
20+
21+
## redis-cli command-line tool
22+
23+
Use the [redis-cli command-line tool](https://redis.io/docs/latest/operate/rs/references/cli-utilities/redis-cli/#connect-to-a-database) to interact with an Azure Managed Redis instance as a client. Use _redis_cli_ as a lightweight way to issue commands and for repeatable testing in scripts.
24+
25+
### Install redis-cli
1826

1927
The _redis-cli_ tool is installed automatically with the _Redis package_, which is available for multiple operating systems. See the open source [install Redis](https://redis.io/docs/latest/operate/oss_and_stack/install/) guide for the most detailed documentation on your preferred operating system.
2028

21-
### Linux
29+
#### Linux
2230

2331
The _redis-cli_ runs natively on Linux, and most distributions include a _Redis package_ that contains the _redis-cli_ tool. On Ubuntu, for instance, you install the _Redis package_ with the following commands:
2432

@@ -27,25 +35,29 @@ sudo apt-get update
2735
sudo apt-get install redis
2836
```
2937

30-
### Windows
38+
#### Windows
3139

3240
The best way to use _redis-cli_ on a Windows computer is to install the [Windows Subsystem for Linux (WSL)](/windows/wsl/about). The Linux subsystem allows you to run linux tools directly on Windows. To install WSL, follow the [WSL installation instructions](/windows/wsl/install).
3341

3442
Once WSL is installed, you can install _redis-cli_ using whatever package management is available in the Linux distro you chose for WSL.
3543

36-
## Gather cache access information
44+
### Gather cache access information
3745

3846
You can gather the information needed to access the cache using these methods:
3947

4048
- Azure CLI using [az redisenterprise database list-keys](/cli/azure/redisenterprise/database#az-redisenterprise-database-list-keys)
4149
- Azure PowerShell using [Get-AzRedisEnterpriseCacheKey](/powershell/module/az.redisenterprisecache/get-azredisenterprisecachekey)
4250
- Using the Azure portal
4351

44-
In this section, you retrieve the keys from the Azure portal.
52+
In this section, you retrieve the information from the Azure portal.
4553

46-
[!INCLUDE [redis-cache-create](includes/redis-cache-access-keys.md)]
54+
To connect your Azure Managed Redis server, the cache client needs the cache endpoint, port, and a key for the cache. Some clients might refer to these items by slightly different names. You can get this information from the [Azure portal](https://portal.azure.com).
4755

48-
## Connect using redis-cli
56+
- To get the endpoint and port for your cache, select **Overview** from the **Resource** menu. The endpoint is of the form `{yourcachename}.{region}.redis.azure.net`. The port is `10000` for all Azure Managed Redis instances.
57+
58+
- To get the access keys, select **Authentication** from the **Settings** menu. Then, select the **Access keys** tab. Here, you can find the primary and secondary keys for the cache. You can use either key to connect with your client tool.
59+
60+
### Connect using redis-cli
4961

5062
Open up a shell or terminal on a computer with the _Redis package_ installed. If using WSL, you can [use the Windows Terminal](/windows/wsl/install#ways-to-run-multiple-linux-distributions-with-wsl) to open a Linux command line. Before connecting with redis-cli, check:
5163

@@ -61,7 +73,7 @@ Open up a shell or terminal on a computer with the _Redis package_ installed. If
6173
redis-cli -p 10000 -h {yourcachename}.{region}.redis.azure.net -a YourAccessKey --tls
6274
```
6375

64-
1. Connect to an Azure Managed Redis instance using OSS cluster policy and TLS:
76+
1. Connect to an Azure Managed Redis instance using OSS cluster policy and TLS:
6577

6678
```console
6779
redis-cli -p 10000 -h {yourcachename}.{region}.redis.azure.net -a YourAccessKey --tls -c
@@ -87,12 +99,8 @@ yourcachename.region.redis.azure.net:10000> GET hello
8799

88100
You're now connected to your Azure Managed Redis instance using the _redis-cli_.
89101

90-
## redis-cli alternatives
91-
92-
While the _redis-cli_ is a useful tool, you can connect to your cache in other ways for troubleshooting or testing:
93-
94-
- [RedisInsight](https://redis.com/redis-enterprise/redis-insight/) is a rich open source graphical tool for issuing Redis commands and viewing the contents of a Redis instance. It works with Azure Managed Redis and is supported on Linux, Windows, and macOS.
95102

96103
## Related content
97104

98105
Get started by creating a [new Azure Managed Redis Instance](quickstart-create-managed-redis.md) instance.
106+

0 commit comments

Comments
 (0)