Delen via

Het Redis-opdrachtregelprogramma gebruiken met Azure Cache voor Redis

  • Artikel

Gebruik het opdrachtregelprogramma redis-cli om te communiceren met een Azure Cache voor Redis als client. Gebruik dit hulpprogramma om rechtstreeks te communiceren met uw Azure Cache voor Redis exemplaar en voor foutopsporing en probleemoplossing.

Redis-cli installeren

Het redis-cli-hulpprogramma wordt automatisch geïnstalleerd met het Redis-pakket, dat beschikbaar is voor meerdere besturingssystemen. Raadpleeg de opensource-installatie redis-handleiding voor de meest gedetailleerde documentatie over uw voorkeursbesturingssysteem.

Linux

De redis-cli wordt systeemeigen uitgevoerd op Linux en de meeste distributies bevatten een Redis-pakket dat het redis-cli-hulpprogramma bevat. Op Ubuntu installeert u bijvoorbeeld het Redis-pakket met de volgende opdrachten:

sudo apt-get update
sudo apt-get install redis

Windows

De beste manier om redis-cli op een Windows-computer te gebruiken, is door de Windows-subsysteem voor Linux (WSL) te installeren. Met het Linux-subsysteem kunt u Linux-hulpprogramma's rechtstreeks in Windows uitvoeren. Volg de installatie-instructies voor WSL om WSL te installeren.

Zodra WSL is geïnstalleerd, kunt u redis-cli installeren met behulp van welk pakketbeheer ook beschikbaar is in de Linux-distributie die u voor WSL hebt gekozen.

Cachetoegangsgegevens verzamelen

U kunt de informatie verzamelen die nodig is voor toegang tot de cache met behulp van deze methoden:

In deze sectie haalt u de sleutels op uit Azure Portal.

De hostnaam, poorten en toegangssleutel ophalen

Om verbinding te maken met uw Azure Cache voor Redis-server, heeft de cacheclient de hostnaam, poorten en een toegangssleutel van de cache nodig. Sommige clients kunnen naar deze items verwijzen door iets andere namen te gebruiken. U kunt de hostnaam, poorten en sleutels ophalen in Azure Portal.

  • Ga als volgende te werk om een toegangssleutel voor uw cache op te halen:

    1. Ga in Azure Portal naar uw cache.
    2. Selecteer Verificatie in het servicemenu onder Instellingen.
    3. Selecteer in het deelvenster Verificatie het tabblad Toegangssleutels .
    4. Als u de waarde voor een toegangssleutel wilt kopiëren, selecteert u het pictogram Kopiëren in het sleutelveld.

    Schermopname van het zoeken en kopiëren van een toegangssleutel voor een exemplaar van Azure Cache voor Redis.

  • Ga als volgende te werk om de hostnaam en poorten voor uw cache op te halen:

    1. Ga in Azure Portal naar uw cache.
    2. Selecteer Overzicht in het servicemenu.
    3. Selecteer onder Essentials voor Hostnaam het pictogram Kopiëren om de waarde van de hostnaam te kopiëren. De waarde van de hostnaam heeft het formulier <DNS name>.redis.cache.windows.net.
    4. Selecteer voor Poorten het pictogram Kopiëren om de poortwaarden te kopiëren.

    Schermopname van het zoeken en kopiëren van de hostnaam en poorten voor een exemplaar van Azure Cache voor Redis.

Verbinding maken met redis-cli

Open een shell of terminal op een computer waarop het Redis-pakket is geïnstalleerd. Als u WSL gebruikt, kunt u de Windows-terminal gebruiken om een Linux-opdrachtregel te openen. Voordat u verbinding maakt met redis-cli, controleert u:

  1. Of TLS-toegang nodig is. Standaard gebruiken Azure Cache voor Redis exemplaren TLS-versleuteling voor verbindingen. Wanneer TLS aan de serverzijde wordt gebruikt, moet TLS op redis-cli worden ingeschakeld met behulp van de --tls optie.
  2. De gebruikte poort : alle caches voor Enterprise- en Enterprise Flash-lagen maken gebruik van poort 10000. Basic-, Standard- en Premium-laagcaches gebruiken echter poort 6379 voor niet-TLS-verbindingen of poort 6380 voor TLS-verbindingen.
  3. Of het cache-exemplaar clustering gebruikt: als u een Premium-laagcache gebruikt die gebruikmaakt van clustering of een Enterprise/Enterprise Flash-laagcache die gebruikmaakt van OSS-clusterbeleid, voegt u de -coptie toe om ervoor te zorgen dat alle shards toegankelijk zijn.

Voorbeelden

  1. Gebruik de volgende opdracht om verbinding te maken met een Basic-, Standard- of Premium-laag Azure Cache voor Redis exemplaar met behulp van TLS:

    redis-cli -p 6380 -h yourcachename.redis.cache.windows.net -a YourAccessKey --tls

  2. Maak verbinding met een Basic-, Standard- of Premium-laag Azure Cache voor Redis exemplaar dat geen TLS gebruikt:

    redis-cli -p 6379 -h yourcachename.redis.cache.windows.net -a YourAccessKey

  3. Maak verbinding met een Basic-, Standard- of Premium-laag Azure Cache voor Redis exemplaar met behulp van TLS en clustering:

    redis-cli -p 6380 -h yourcachename.redis.cache.windows.net -a YourAccessKey --tls -c

  4. Verbinding maken met een cache-exemplaar van een Enterprise- of Enterprise Flash-laag met behulp van Enterprise-clusterbeleid met TLS:

    redis-cli -p 10000 -h yourcachename.eastus.redisenterprise.cache.azure.net -a YourAccessKey --tls

  5. Verbinding maken met een cache-exemplaar van een Enterprise- of Enterprise Flash-laag met behulp van OSS-clusterbeleid zonder TLS:

    redis-cli -p 10000 -h yourcachename.eastus.redisenterprise.cache.azure.net -a YourAccessKey -c

De verbinding testen

Zodra de verbinding tot stand is gebracht, kunt u opdrachten aan uw Azure Cache voor Redis exemplaar uitgeven. Een eenvoudige manier om de verbinding te testen, is door de PING opdracht te gebruiken. Deze opdracht wordt geretourneerd PONG in de console.

yourcachename.redis.cache.windows.net:6380> PING
PONG

U kunt ook opdrachten uitvoeren zoals SET en GET:

yourcachename.redis.cache.windows.net:6380> SET hello world
OK
yourcachename.redis.cache.windows.net:6380> GET hello
"world"

U bent nu verbonden met uw Azure Cache voor Redis exemplaar met behulp van de redis-cli.

alternatieven voor redis-cli

Hoewel de redis-cli een nuttig hulpprogramma is, kunt u op andere manieren verbinding maken met uw cache om problemen op te lossen of te testen:

  • Azure Cache voor Redis biedt een Redis Console is ingebouwd in Azure Portal, waar u opdrachten kunt uitgeven zonder dat u het opdrachtregelprogramma hoeft te installeren. De functie Redis Console is momenteel alleen beschikbaar in de Basic-, Standard- en Premium-lagen.
  • RedisInsight is een uitgebreid opensource-grafische hulpprogramma voor het uitgeven van Redis-opdrachten en het weergeven van de inhoud van een Redis-exemplaar. Het werkt met Azure Cache voor Redis en wordt ondersteund in Linux, Windows en macOS.

Gerelateerde inhoud

Ga aan de slag door een nieuw cache-exemplaar voor enterprise-lagen te maken.