Verwenden Sie Client-Tools zum Verwalten von Daten in verwaltetem Azure Redis.

Mit den folgenden Tools können Sie als Client auf Daten in der von Azure verwalteten Redis-Instanz zugreifen und diese verwalten. Verwenden Sie diese Tools, um direkt mit Ihrer Azure Verwalteten Redis-Instanz und zum Debuggen und Zur Problembehandlung zu interagieren.

• Redis Insight
• Befehlszeilentool "redis-cli"

Redis Insight

Redis Insight ist ein umfangreiches grafisches Open-Source-Tool und CLI-Tool zum Ausgeben von Redis-Befehlen und zum Anzeigen des Inhalts einer Redis-Instanz. Es funktioniert mit Azure Managed Redis und wird unter Linux, Windows und macOS unterstützt.

Installieren von Redis Insight

Um Redis Insight zu installieren, befolgen Sie die Anweisungen in der Redis Insight-Dokumentation.

Konfigurieren des Zugriffs auf verwaltete Azure Redis mit Redis Insight

Redis Insight kann sich bei einer Azure verwalteten Redis-Instanz mithilfe von Microsoft Entra ID oder Zugriffsschlüsselauthentifizierung authentifizieren. Es wird empfohlen, Microsoft Entra ID für eine bessere Sicherheit zu verwenden.

Ab Version 3.2.0 ermöglicht es Redis Insight, sich bei Azure Managed Redis mit Microsoft Entra ID zu authentifizieren, indem der PKCE OAuth 2.0-Fluss verwendet wird, wodurch die automatische Ermittlung von Datenbanken über Abonnements hinweg ermöglicht wird, sowie eine kennwortlose Authentifizierung.

Anweisungen zum Konfigurieren des Zugriffs auf Azure Managed Redis mit Redis Insight finden Sie im Redis Insight GitHub Repo. Dies ist ein einmaliges Setup pro Azure Mandanten.

Herstellen einer Verbindung zum Azure Managed Redis-Dienst mithilfe von Redis Insight

Nachdem Microsoft Entra ID Zugriff konfiguriert wurde, stellen Sie eine Verbindung mit einer Azure Verwalteten Redis-Instanz in Redis Insight her, indem Sie die folgenden Schritte ausführen:

1. Wählen Sie in Redis Insight auf der Registerkarte "Redis-Datenbanken " +Vorhandene Datenbank verbinden aus.
2. Im Fenster Add database wählen Sie Azure Managed Redis aus.
3. Folgen Sie den Anweisungen, um eine Verbindung mit Microsoft Entra ID Authentifizierung herzustellen.
4. Wählen Sie auf der Seite Subscription das Abonnement aus, das Ihre Azure Verwaltete Redis-Instanz enthält, und wählen Sie Datenbank hinzufügen aus.
5. Wählen Sie die verwaltete Azure Redis-Instanz (Datenbank) aus, mit der Sie eine Verbindung herstellen möchten, und wählen Sie dann Datenbank hinzufügen aus. Sie können mehrere Datenbanken auswählen, mit der gleichzeitig eine Verbindung hergestellt werden soll.
6. Wiederholen Sie die vorstehenden Schritte, um Azure Verwaltete Redis-Instanzen nach Bedarf im selben oder einem anderen Azure-Abonnement hinzuzufügen.

• Nachdem Sie eine Azure Verwaltete Redis-Instanz hinzugefügt haben, können Sie sie aus der Liste der Redis-Datenbanken in Redis Insight auswählen und mit dem Ausgeben von Befehlen und Anzeigen von Daten beginnen.

• Um auf die integrierte CLI zuzugreifen, wählen Sie unten auf dem Bildschirm für die ausgewählte Datenbank (>_ CLI) aus.

Befehlszeilentool "redis-cli"

Verwenden Sie das Befehlszeilentool redis-cli, um mit einer Azure verwalteten Redis-Instanz als Client zu interagieren. Verwenden Sie redis_cli als einfache Möglichkeit zum Ausgeben von Befehlen und für wiederholbare Tests in Skripts.

Installieren von redis-cli

Das Redis-cli-Tool wird automatisch mit dem Redis-Paket installiert, das für mehrere Betriebssysteme verfügbar ist. In der Anleitung zu Open Source Install Redis finden Sie die detaillierteste Dokumentation zu Ihrem bevorzugten Betriebssystem.

Linux

Die Redis-Cli wird nativ unter Linux ausgeführt, und die meisten Distributionen enthalten ein Redis-Paket , das das Redis-Cli-Tool enthält. Auf Ubuntu installieren Sie beispielsweise das Redis-Paket mit den folgenden Befehlen:

sudo apt-get update
sudo apt-get install redis

Windows

Die beste Möglichkeit, redis-cli auf einem Windows Computer zu verwenden, besteht darin, die Windows-Subsystem für Linux (WSL) zu installieren. Mit dem Linux-Subsystem können Sie Linux-Tools direkt auf Windows ausführen. Um WSL zu installieren, befolgen Sie die WSL-Installationsanweisungen.

Nachdem WSL installiert wurde, können Sie redis-cli mithilfe der verfügbaren Paketverwaltung in der Linux-Distribution installieren, die Sie für WSL ausgewählt haben.

Sammeln von Cachezugriffsinformationen

Mithilfe dieser Methoden können Sie die erforderlichen Informationen sammeln, um auf den Cache zuzugreifen:

• Azure CLI mit az redisenterprise-Datenbanklistenschlüsseln
• Azure PowerShell mit Get-AzRedisEnterpriseCacheKey
• Verwenden des Azure-Portals

In diesem Abschnitt rufen Sie die Informationen aus dem Azure Portal ab.

Um Ihren Azure Verwalteten Redis-Server zu verbinden, benötigt der Cacheclient den Cacheendpunkt, den Port und einen Schlüssel für den Cache. Von einigen Clients wird unter Umständen mit etwas anderen Namen auf diese Elemente verwiesen. Sie können diese Informationen über das portal Azure abrufen.

• Um den Endpunkt und den Port für Ihren Cache abzurufen, wählen Sie im Menü "Ressource" die Option "Übersicht" aus. Der Endpunkt hat das Format {yourcachename}.{region}.redis.azure.net. Der Port ist 10000 für alle Azure verwalteten Redis-Instanzen.

• Um die Zugriffstasten abzurufen, wählen Sie im Menü "Einstellungen" die Option "Authentifizierung" aus. Wählen Sie dann die Registerkarte "Zugriffstasten " aus. Hier finden Sie die primären und sekundären Schlüssel für den Cache. Sie können beide Schlüssel verwenden, um eine Verbindung mit Ihrem Clienttool herzustellen.

Verbinden mit redis-cli

Öffnen Sie eine Shell oder ein Terminal auf einem Computer, auf dem das Redis-Paket installiert ist. Wenn Sie WSL verwenden, können Sie use the Windows-Terminal verwenden, um eine Linux-Befehlszeile zu öffnen. Bevor Sie eine Verbindung mit redis-cli herstellen, überprüfen Sie Folgendes:

1. Ob TLS-Zugriff erforderlich ist – standardmäßig verwenden Azure verwaltete Redis-Instanzen TLS-Verschlüsselung für Verbindungen. Wenn TLS auf serverseitiger Seite verwendet wird, muss TLS auf Redis-Cli mithilfe der --tls Option aktiviert werden.
2. Der verwendete Port – alle Azure verwalteten Redis-Instanzen verwenden Port 10000. Beachten Sie, dass dies anders als die Standardeinstellung für die Redis Community Edition ist 6379.
3. Gibt an, ob die Cacheinstanz die OSS-Clusterrichtlinie verwendet– Wenn Sie die OSS-Clusterrichtlinie verwenden, fügen Sie die -cOption hinzu, um sicherzustellen, dass auf alle Shards zugegriffen werden kann.

Beispiele

1. Verbinden mit einer verwalteten Azure Redis-Instanz unter Verwendung der Enterprise-Clusterrichtlinie mit TLS:

   redis-cli -p 10000 -h {yourcachename}.{region}.redis.azure.net -a YourAccessKey --tls
   

2. Stellen Sie eine Verbindung mit einer Azure verwalteten Redis-Instanz mithilfe der OSS-Clusterrichtlinie und TLS her:

   redis-cli -p 10000 -h {yourcachename}.{region}.redis.azure.net -a YourAccessKey --tls -c
   

Testen der Verbindung

Nachdem die Verbindung hergestellt wurde, können Sie Befehle für Ihre Azure Verwaltete Redis-Instanz ausgeben. Eine einfache Möglichkeit zum Testen der Verbindung ist die Verwendung des Befehls PING. Dieser Befehl gibt PONG in der Konsole zurück.

yourcachename.region.redis.azure.net:10000> PING
PONG

Sie können auch Befehle wie SET und GET:

yourcachename.region.redis.azure.net:10000> SET hello world
OK
yourcachename.region.redis.azure.net:10000> GET hello
"world"

Sie sind jetzt mithilfe der redis-cli mit Ihrer Azure verwalteten Redis-Instanz verbunden.

Verwandte Inhalte

Erstellen Sie zunächst eine neue Azure Verwaltete Redis-Instanzinstanz.