Skip to content

Commit bfb8420

Browse files
v-shilsv-shils
authored
Merge pull request #310319 from flang-msft/fxl---update-python-sample
Fxl update python sample
2 parents c83d46f + 9413a3f commit bfb8420

1 file changed

Lines changed: 36 additions & 154 deletions

File tree

‎articles/redis/python-get-started.md‎

Lines changed: 36 additions & 154 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: "Quickstart: Create a Python app with Azure Managed Redis"
33
description: In this quickstart, you learn how to create a Python app that uses Azure Managed Redis.
4-
ms.date: 07/29/2025
4+
ms.date: 01/09/2026
55
ms.topic: quickstart
66
ms.custom:
77
- mode-api
@@ -52,69 +52,21 @@ import redis
5252
from azure.identity import DefaultAzureCredential
5353
from redis_entraid.cred_provider import create_from_default_azure_credential
5454

55-
# Connection details for your cache
56-
# Get the connection details for the Redis instance
57-
redis_host = "contosob116.westus3.redis.azure.net"
58-
redis_port = 10000 #For an Azure
55+
redis_host = "<host-url>"
56+
redis_port = 10000 # Managed Redis default port
5957

60-
print("🚀 Starting Azure Redis Cache connection test...")
61-
print(f"📡 Connecting to: {redis_host}:{redis_port}")
58+
credential_provider = create_from_default_azure_credential(
59+
("https://redis.azure.com/.default",),
60+
)
6261

63-
# Validate configuration
64-
if not redis_host or not redis_port:
65-
print("❌ Error: Redis host and port must be configured")
66-
exit(1)
62+
r = redis.Redis(
63+
host=redis_host,
64+
port=redis_port,
65+
ssl=True,
66+
decode_responses=True,
67+
credential_provider=credential_provider
68+
)
6769

68-
print() # Add a new line
69-
70-
try:
71-
# Create credential provider using DefaultAzureCredential for Azure Entra ID authentication
72-
credential_provider = create_from_default_azure_credential(
73-
("https://redis.azure.com/.default",),)
74-
75-
# Create a Redis client with Azure Entra ID authentication
76-
r = redis.Redis(host=redis_host,
77-
port=redis_port,
78-
ssl=True,
79-
decode_responses=True,
80-
credential_provider=credential_provider,
81-
socket_timeout=10,
82-
socket_connect_timeout=10
83-
)
84-
```
85-
86-
## Code to test a connection
87-
88-
In the next section, test the connection using the Redis command `ping` that returns the `True` value.
89-
90-
```python
91-
# Ping the Redis server to test the connection
92-
result = r.ping()
93-
if result:
94-
print("Ping returned: ", result)
95-
```
96-
97-
## Code set a key, get a key
98-
99-
In this section, use a basic `set` and `get` sequence to start using the Redis cache in the simplest way to get started.
100-
101-
```python
102-
# Create a simple set and get operation
103-
result = r.set("Message", "Hello, The cache is working with Python!")
104-
print("✅ SET Message succeeded: " + str(result))
105-
print() # Add a new line
106-
107-
value = r.get("Message")
108-
109-
if value is not None:
110-
print("✅ GET Message returned : " + str(value))
111-
print() # Add a new line
112-
else:
113-
print("⚠️ GET Message returned None")
114-
print() # Add a new line
115-
116-
print("🎉 All Redis operations completed successfully!")
117-
print() # Add a new line
11870
```
11971

12072
Before you can run this code, you must add yourself as a Redis user to the cache.
@@ -126,115 +78,45 @@ You should also [add users or a System principal to your cache](entra-for-authen
12678
The result looks like this:
12779

12880
```console
129-
C:\utils\python-quickstart>python quickstart-amr.py
130-
🚀 Starting Azure Redis Cache connection test...
131-
📡 Connecting to: contosob116.westus3.redis.azure.net:10000
132-
133-
✅ Ping returned : True
134-
135-
✅ SET Message succeeded: True
136-
137-
✅ GET Message returned : Hello, The cache is working with Python!
138-
139-
🎉 All Redis operations completed successfully!
140-
141-
🔐 Redis connection closed
81+
PING: True
82+
GET: Hello from Azure Managed Redis!
14283

14384
```
14485

14586
Here, you can see this code sample in its entirety. The code contains some error checking omitted from the earlier code explanations for simplicity. The final step is closing the connection to the cache.
14687

14788
```python
148-
# Python Quickstart using Azure Entra ID authentication
149-
# Azure Managed Redis cache that you created using the Azure portal, or CLI
150-
# This script demonstrates secure connection using Microsoft Entra ID authentication
151-
# This script demonstrates secure connection using the default Azure credential provider
152-
# You should be a user on the cache and logged in to Azure CLI with the same account using `az login`
153-
15489
import redis
15590
from azure.identity import DefaultAzureCredential
15691
from redis_entraid.cred_provider import create_from_default_azure_credential
15792

158-
# Connection details for your cache
159-
# Get the connection details for the Redis instance
160-
redis_host = "<host-url>" # Replace with your cache info
161-
redis_port = <port number> # Replace with your cache info
162-
163-
print("🚀 Starting Azure Redis Cache connection test...")
164-
print(f"📡 Connecting to: {redis_host}:{redis_port}")
93+
redis_host = "<host-url>"
94+
redis_port = 10000 # Managed Redis default port
16595

166-
# Validate configuration
167-
if not redis_host or not redis_port:
168-
print("❌ Error: Redis host and port must be configured")
169-
exit(1)
170-
171-
print() # Add a new line
96+
credential_provider = create_from_default_azure_credential(
97+
("https://redis.azure.com/.default",),
98+
)
17299

173100
try:
174-
# Create credential provider using DefaultAzureCredential for Azure Entra ID authentication
175-
credential_provider = create_from_default_azure_credential(
176-
("https://redis.azure.com/.default",),)
177-
178-
# Create a Redis client with Azure Entra ID authentication
179-
r = redis.Redis(host=redis_host,
180-
port=redis_port,
181-
ssl=True,
182-
decode_responses=True,
183-
credential_provider=credential_provider,
184-
socket_timeout=10,
185-
socket_connect_timeout=10
186-
)
187-
188-
# Test connection
189-
result = r.ping()
190-
print("✅ Ping returned : " + str(result))
191-
print() # Add a new line
192-
193-
# Create a simple set and get operation
194-
result = r.set("Message", "Hello, The cache is working with Python!")
195-
print("✅ SET Message succeeded: " + str(result))
196-
print() # Add a new line
197-
198-
value = r.get("Message")
199-
200-
if value is not None:
201-
print("✅ GET Message returned : " + str(value))
202-
print() # Add a new line
203-
else:
204-
print("⚠️ GET Message returned None")
205-
print() # Add a new line
206-
207-
print("🎉 All Redis operations completed successfully!")
208-
print() # Add a new line
209-
210-
except redis.ConnectionError as e:
211-
print(f"❌ Connection error: {e}")
212-
print("💡 Check if Redis host and port are correct, and ensure network connectivity")
213-
print() # Add a new line
214-
except redis.AuthenticationError as e:
215-
print(f"❌ Authentication error: {e}")
216-
print("💡 Check if Azure Entra ID authentication is properly configured")
217-
print() # Add a new line
218-
except redis.TimeoutError as e:
219-
print(f"❌ Timeout error: {e}")
220-
print("💡 Check network latency and Redis server performance")
221-
print() # Add a new line
101+
r = redis.Redis(
102+
host=redis_host,
103+
port=redis_port,
104+
ssl=True,
105+
decode_responses=True,
106+
credential_provider=credential_provider,
107+
socket_timeout=10,
108+
socket_connect_timeout=10
109+
)
110+
111+
print("PING:", r.ping())
112+
r.set("Message", "Hello from Azure Managed Redis!")
113+
print("GET:", r.get("Message"))
114+
222115
except Exception as e:
223-
print(f"❌ Unexpected error: {e}")
224-
if "999" in str(e):
225-
print("💡 Error 999 typically indicates a network connectivity issue or firewall restriction")
226-
print(" - Verify the Redis hostname is correct")
227-
print(" - Verify that you have logged in with Az CLI")
228-
print(" - Ensure the Redis cache is running and accessible")
229-
print() # Add a new line
116+
print(f"Error: {e}")
230117
finally:
231-
# Clean up connection if it exists
232118
if 'r' in locals():
233-
try:
234-
r.close()
235-
print("🔐 Redis connection closed")
236-
except Exception as e:
237-
print(f"❌ Error closing connection: {e}")
119+
r.close()
238120

239121
```
240122

0 commit comments

Comments
 (0)