Freigeben über


Schnellstart: Erstellen einer Python-App mit Azure Managed Redis

In diesem Artikel erfahren Sie, wie Sie einen Azure Managed Redis-Cache mit der Python-Sprache verwenden und mithilfe von Microsoft Entra ID eine Verbindung herstellen.

Voraussetzungen

  • Azure-Abonnement – Erstellen eines kostenlosen Kontos
  • Installieren der Python 3.7+- Sprachumgebung
  • Fügen Sie diese Importe aus Ihrem Projekt und ihrer Entwicklungsumgebung hinzu.
    • redis - Der Redis Python-Client
    • redis-entraid - Redis Microsoft Entra ID-Authentifizierungserweiterung
    • azure-identity – Azure-Authentifizierungsbibliothek

Erstellen einer Azure Managed Redis-Instanz

Erstellen Sie zunächst einen Cache. Sie können einen Cache mithilfe von Azure Managed Redis oder Azure Cache für Redis mithilfe des Azure-Portals erstellen. In dieser Schnellstartanleitung verwenden wir Azure Managed Redis.

Wenn Sie den Cache erstellen, ist die Microsoft Entra-ID standardmäßig aktiviert, sodass sie von Anfang an sicher ist. Ihr Cache muss auch einen öffentlichen Endpunkt für diese Schnellstartanleitung verwenden.

Führen Sie zum Erstellen eines Caches mit dem Portal eine der folgenden Verfahren aus:

Optional können Sie einen Cache mit Azure CLI, PowerShell, je nachdem, was Sie bevorzugen, erstellen.

Code zum Herstellen einer Verbindung mit einem Redis-Cache

Legen Sie im ersten Teil des Codebeispiels Ihre Verbindung mit dem Cache fest.

  • Ports für azure Managed Redis und Enterprise Caches: 10000
  • Ports für Azure Cache für Redis-Instanzen: 6380
import redis
from azure.identity import DefaultAzureCredential
from redis_entraid.cred_provider import create_from_default_azure_credential

redis_host = "<host-url>"
redis_port = 10000  # Managed Redis default port

credential_provider = create_from_default_azure_credential(
    ("https://redis.azure.com/.default",),
)

r = redis.Redis(
    host=redis_host,
    port=redis_port,
    ssl=True,
    decode_responses=True,
    credential_provider=credential_provider
)

Bevor Sie diesen Code ausführen können, müssen Sie sich selbst als Redis-Benutzer zum Cache hinzufügen.

Sie müssen Ihre Verbindung mit Azure auch über die Befehlszeile oder über die Azure-Entwickler-Befehlszeile (azd) autorisieren.

Sie sollten ihrem Cache auch Benutzer oder einen Systemprinzipal hinzufügen. Fügen Sie alle Benutzer hinzu, die das Programm möglicherweise als Benutzer im Redis-Cache ausführen.

Das Ergebnis sieht wie folgt aus:

PING: True
GET: Hello from Azure Managed Redis!

Hier sehen Sie dieses Codebeispiel vollständig. Der Code enthält einige Fehlerüberprüfungen, die aus den früheren Codeerklärungen aus Gründen der Einfachheit weggelassen wurden. Der letzte Schritt besteht darin, die Verbindung mit dem Cache zu schließen.

import redis
from azure.identity import DefaultAzureCredential
from redis_entraid.cred_provider import create_from_default_azure_credential

redis_host = "<host-url>"
redis_port = 10000  # Managed Redis default port

credential_provider = create_from_default_azure_credential(
    ("https://redis.azure.com/.default",),
)

try:
    r = redis.Redis(
        host=redis_host,
        port=redis_port,
        ssl=True,
        decode_responses=True,
        credential_provider=credential_provider,
        socket_timeout=10,
        socket_connect_timeout=10
    )

    print("PING:", r.ping())
    r.set("Message", "Hello from Azure Managed Redis!")
    print("GET:", r.get("Message"))

except Exception as e:
    print(f"Error: {e}")
finally:
    if 'r' in locals():
        r.close()

Bereinigen von Ressourcen

Wenn Sie die in diesem Artikel erstellten Ressourcen weiterhin verwenden möchten, behalten Sie die Ressourcengruppe bei.

Wenn Sie die Ressourcen nicht mehr benötigen, können Sie die erstellte Azure-Ressourcengruppe ansonsten löschen, um Kosten zu vermeiden.

Von Bedeutung

Das Löschen einer Ressourcengruppe kann nicht rückgängig gemacht werden. Beim Löschen einer Ressourcengruppe werden alle darin enthaltenen Ressourcen unwiderruflich gelöscht. Achten Sie daher darauf, dass Sie nicht versehentlich die falsche Ressourcengruppe oder die falschen Ressourcen löschen. Falls Sie die Ressourcen in einer vorhandenen Ressourcengruppe erstellt haben, die Ressourcen enthält, die Sie behalten wollen, können Sie jede Ressource einzeln löschen, statt die Ressourcengruppe zu löschen.

So löschen Sie eine Ressourcengruppe

  1. Melden Sie sich beim Azure-Portal an, und wählen Sie anschließend Ressourcengruppen aus.

  2. Wählen Sie die Ressourcengruppe aus, die Sie löschen möchten.

    Wenn viele Ressourcengruppen vorhanden sind, verwenden Sie das Feld Nach einem beliebigen Feld filtern..., und geben Sie den Namen Ihrer Ressourcengruppe ein, die Sie für diesen Artikel erstellt haben. Wählen Sie die Ressourcengruppe in der Ergebnisliste aus.

    Screenshot: Liste mit zu löschenden Ressourcengruppen im Arbeitsbereich.

  3. Wählen Sie die Option Ressourcengruppe löschen.

  4. Sie werden aufgefordert, das Löschen der Ressourcengruppe zu bestätigen. Geben Sie den Namen Ihrer Ressourcengruppe ein, und wählen Sie Löschen aus.

    Screenshot: Formular, in das der Ressourcenname eingegeben werden muss, um den Löschvorgang zu bestätigen.

Daraufhin werden die Ressourcengruppe und alle darin enthaltenen Ressourcen gelöscht.