You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/redis/how-to-redis-access-data.md
+30-22Lines changed: 30 additions & 22 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,24 +1,32 @@
1
1
---
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
6
6
ms.custom:
7
-
- ignite-2024
8
-
- build-2025
9
7
appliesto:
10
-
- ✅ Azure Cache for Redis
11
8
- ✅ Azure Managed Redis
12
9
---
13
-
# Use the Redis command-line tool with Azure Managed Redis
10
+
# Use client tools to manage data in Azure Managed Redis
14
11
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.
16
13
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
18
26
19
27
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.
20
28
21
-
### Linux
29
+
####Linux
22
30
23
31
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:
24
32
@@ -27,25 +35,29 @@ sudo apt-get update
27
35
sudo apt-get install redis
28
36
```
29
37
30
-
### Windows
38
+
####Windows
31
39
32
40
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).
33
41
34
42
Once WSL is installed, you can install _redis-cli_ using whatever package management is available in the Linux distro you chose for WSL.
35
43
36
-
## Gather cache access information
44
+
###Gather cache access information
37
45
38
46
You can gather the information needed to access the cache using these methods:
39
47
40
48
- Azure CLI using [az redisenterprise database list-keys](/cli/azure/redisenterprise/database#az-redisenterprise-database-list-keys)
41
49
- Azure PowerShell using [Get-AzRedisEnterpriseCacheKey](/powershell/module/az.redisenterprisecache/get-azredisenterprisecachekey)
42
50
- Using the Azure portal
43
51
44
-
In this section, you retrieve the keys from the Azure portal.
52
+
In this section, you retrieve the information from the Azure portal.
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).
47
55
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
49
61
50
62
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:
51
63
@@ -61,7 +73,7 @@ Open up a shell or terminal on a computer with the _Redis package_ installed. If
61
73
redis-cli -p 10000 -h {yourcachename}.{region}.redis.azure.net -a YourAccessKey --tls
62
74
```
63
75
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:
65
77
66
78
```console
67
79
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
87
99
88
100
You're now connected to your Azure Managed Redis instance using the _redis-cli_.
89
101
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.
95
102
96
103
## Related content
97
104
98
105
Get started by creating a [new Azure Managed Redis Instance](quickstart-create-managed-redis.md) instance.
0 commit comments