Clienthulpprogramma's gebruiken om gegevens te beheren in Azure Managed Redis

U kunt de volgende hulpprogramma's gebruiken voor toegang tot en beheer van gegevens in Azure Managed Redis als client. Gebruik deze hulpprogramma's om rechtstreeks te communiceren met uw Azure Managed Redis-exemplaar en voor foutopsporing en probleemoplossing.

• Redis Insight
• het commandoregelprogramma redis-cli

Redis Insight

Redis Insight is een uitgebreid opensource-grafische en CLI-hulpprogramma voor het uitgeven van Redis-opdrachten en het weergeven van de inhoud van een Redis-exemplaar. Het werkt met Azure Managed Redis en wordt ondersteund in Linux, Windows en macOS.

Redis Insight installeren

Volg de instructies in de Redis Insight-documentatie om Redis Insight te installeren.

Toegang tot Azure Beheerde Redis configureren met Redis Insight

Redis Insight kan zich authenticeren bij een Azure Managed Redis-exemplaar met behulp van Microsoft Entra ID of toegangssleutelverificatie. We raden u aan Microsoft Entra ID te gebruiken voor betere beveiliging.

Vanaf versie 3.2.0 kan Redis Insight authenticeren naar Azure Managed Redis met Microsoft Entra ID using de PKCE OAuth 2.0 flow, wat de automatische ontdekking van databases over abonnementen mogelijk maakt en wachtwoordloze authenticatie mogelijk maakt.

Zie de Redis Insight GitHub voor instructies voor het configureren van toegang tot Azure Managed Redis met Redis Insight. Dit is een eenmalige installatie per Azure tenant.

Verbinding maken met Azure Managed Redis met Redis Insight

Nadat Microsoft Entra ID toegang is geconfigureerd, maakt u verbinding met een Azure Managed Redis-exemplaar in Redis Insight door de volgende stappen uit te voeren:

1. Selecteer in Redis Insight op het tabblad Redis-databasesde optie +Verbinding maken met bestaande database.
2. Selecteer in het venster ToevoegingsdatabaseAzure Managed Redis.
3. Volg de aanwijzingen om verbinding te maken met behulp van Microsoft Entra ID-verificatie.
4. Selecteer op de pagina Subscription het abonnement met uw beheerde Redis-exemplaar Azure en selecteer Database toevoegen.
5. Selecteer het Azure Managed Redis-exemplaar (database) waarmee u verbinding wilt maken en selecteer vervolgens Database toevoegen. U kunt meerdere databases selecteren waarmee u tegelijkertijd verbinding wilt maken.
6. Herhaal de voorgaande stappen om Azure Beheerde Redis-exemplaren toe te voegen, indien nodig in hetzelfde of een ander Azure abonnement.

• Nadat u een Azure Managed Redis-exemplaar hebt toegevoegd, kunt u deze selecteren in de lijst met Redis-databases in Redis Insight en beginnen met het uitgeven van opdrachten en het weergeven van gegevens.

• Als u toegang wilt krijgen tot de ingebouwde CLI, selecteert u (>_ CLI) onderaan het scherm voor de geselecteerde database.

het commandoregelprogramma redis-cli

Gebruik het opdrachtregelprogramma redis-cli om te communiceren met een Azure Beheerd Redis-exemplaar als client. Gebruik redis_cli als een lichtgewicht manier om opdrachten uit te geven en voor herhaalbare tests in scripts.

Redis-cli installeren

Het redis-cli-hulpprogramma wordt automatisch geïnstalleerd met het Redis-pakket, dat beschikbaar is voor meerdere besturingssystemen. Zie de handleiding open source install Redis voor de meest gedetailleerde documentatie over het besturingssysteem van uw voorkeur.

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 Subsystem for Linux (WSL) te installeren. Met het Linux-subsysteem kunt u Linux-hulpprogramma's rechtstreeks op 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 gebruiken met az redisenterprise database list-keys
• Azure PowerShell met Get-AzRedisEnterpriseCacheKey
• De Azure-portal gebruiken

In deze sectie haalt u de gegevens op uit de Azure-portal.

Als u verbinding wilt maken met uw Azure Beheerde Redis-server, heeft de cacheclient het cache-eindpunt, de poort en een sleutel voor de cache nodig. Sommige clients kunnen enigszins andere namen gebruiken om naar deze items te verwijzen. U kunt deze informatie ophalen via de Azure portal.

• Als u het eindpunt en de poort voor uw cache wilt ophalen, selecteert u Overzicht in het menu Resource . Het eindpunt is van de vorm {yourcachename}.{region}.redis.azure.net. De poort is 10000 voor alle beheerde Redis-exemplaren Azure.

• Als u de toegangssleutels wilt ophalen, selecteert u Verificatie in het menu Instellingen . Selecteer vervolgens het tabblad Toegangstoetsen . Hier vindt u de primaire en secundaire sleutels voor de cache. U kunt een van beide sleutels gebruiken om verbinding te maken met uw clienthulpprogramma.

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: Azure beheerde Redis-exemplaren maken standaard gebruik van 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 Azure-beheerde Redis-exemplaren gebruiken poort 10000. Houd er rekening mee dat dit anders is dan de standaardversie van de Redis-community.6379
3. Of het cache-exemplaar het OSS-clusterbeleid gebruikt: als u het OSS-clusterbeleid gebruikt, voegt u de -coptie toe om ervoor te zorgen dat alle shards toegankelijk zijn.

Examples

1. Verbinding maken met een Azure Beheerd Redis-exemplaar met behulp van enterprise-clusterbeleid met TLS:

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

2. Verbinding maken met een Azure Beheerd Redis-exemplaar met behulp van OSS-clusterbeleid en TLS:

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

De verbinding testen

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

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

U kunt ook opdrachten uitvoeren zoals SET en GET:

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

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

Verwante inhoud

Ga aan de slag door een nieuw Azure Beheerd Redis-exemplaar te maken.