Het Redis-opdrachtregelprogramma gebruiken met Azure Cache voor Redis

Artikel
04/27/2024

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:

Azure CLI met az redis list-keys
Azure PowerShell met Behulp van Get-AzRedisCacheKey
Met behulp van Azure Portal

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

Hostnaam, poorten en toegangssleutels ophalen uit Azure Portal

Om verbinding te maken met uw Azure Cache voor Redis-server, heeft de cacheclient de hostnaam, poorten en een sleutel voor de cache nodig. Sommige clients kunnen enigszins andere namen gebruiken om naar deze items te verwijzen. U kunt de hostnaam, poorten en toegangssleutels ophalen uit Azure Portal.

Als u de toegangssleutels wilt ophalen, selecteert u Verificatie in het menu Resource. Selecteer vervolgens het tabblad Toegangstoetsen .
Als u de hostnaam en poorten voor uw cache wilt ophalen, selecteert u Overzicht in het menu Resource. De hostnaam is van de dns-naam> van het formulier.redis.cache.windows.net<.

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:

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.
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.
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

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.exe -p 6380 -h yourcachename.redis.cache.windows.net -a YourAccessKey --tls
```
Verbinding maken naar een Basic-, Standard- of Premium-laag Azure Cache voor Redis exemplaar dat geen TLS gebruikt:
```
redis-cli.exe -p 6379 -h yourcachename.redis.cache.windows.net -a YourAccessKey
```
Verbinding maken naar een Basic-, Standard- of Premium-laag Azure Cache voor Redis exemplaar met behulp van TLS en clustering:
```
redis-cli.exe -p 6380 -h yourcachename.redis.cache.windows.net -a YourAccessKey --tls -c
```
Verbinding maken naar een cache-exemplaar van de Enterprise- of Enterprise Flash-laag met behulp van Enterprise-clusterbeleid met TLS:
```
redis-cli.exe -p 10000 -h yourcachename.eastus.redisenterprise.cache.azure.net -a YourAccessKey --tls
```
Verbinding maken naar een cache-exemplaar van de Enterprise- of Enterprise Flash-laag met behulp van OSS-clusterbeleid zonder TLS:
```
redis-cli.exe -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.

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