Dela via

Använda kommandoradsverktyget för Redis med Azure Cache for Redis

  • Artikel

Använd kommandoradsverktyget redis-cli för att interagera med en Azure Cache for Redis som klient. Använd det här verktyget för att interagera direkt med din Azure Cache for Redis-instans och för felsökning och felsökning.

Installera redis-cli

Redis-cli-verktyget installeras automatiskt med Redis-paketet, som är tillgängligt för flera operativsystem. Se öppen källkod installera Redis-guiden för den mest detaljerade dokumentationen om ditt operativsystem.

Linux

Redis-cli körs internt i Linux, och de flesta distributioner innehåller ett Redis-paket som innehåller redis-cli-verktyget. I Ubuntu installerar du till exempel Redis-paketet med följande kommandon:

sudo apt-get update
sudo apt-get install redis

Windows

Det bästa sättet att använda redis-cli på en Windows-dator är att installera Windows-undersystem för Linux (WSL). Med Linux-undersystemet kan du köra Linux-verktyg direkt i Windows. Om du vill installera WSL följer du installationsanvisningarna för WSL.

När WSL har installerats kan du installera redis-cli med den pakethantering som är tillgänglig i den Linux-distribution som du valde för WSL.

Samla in information om cacheåtkomst

Du kan samla in den information som behövs för att komma åt cacheminnet med hjälp av följande metoder:

I det här avsnittet hämtar du nycklarna från Azure-portalen.

Hämta värdnamn, portar och åtkomstnycklar från Azure-portalen

För att ansluta din Azure Cache for Redis-server behöver cacheklienten värdnamnet, portarna och en nyckel för cachen. Vissa klienter kan hänvisa till dessa objekt med namn som skiljer sig något. Du kan hämta värdnamnet, portarna och nycklarna från Azure-portalen.

  • Om du vill hämta åtkomstnycklarna väljer du Autentisering på resursmenyn. Välj sedan fliken Åtkomstnycklar .

    Nycklar för Azure Cache for Redis

  • Om du vill hämta värdnamnet och portarna för cacheminnet väljer du Översikt på resursmenyn. Värdnamnet är av formatet DNS name.redis.cache.windows.net>.<

    Egenskaper för Azure Cache for Redis

Anslut med redis-cli

Öppna ett gränssnitt eller en terminal på en dator med Redis-paketet installerat. Om du använder WSL kan du använda Windows-terminal för att öppna en Linux-kommandorad. Kontrollera innan du ansluter med redis-cli:

  1. Om TLS-åtkomst behövs – Som standard använder Azure Cache for Redis-instanser TLS-kryptering för anslutningar. När TLS används på serversidan måste TLS på redis-cli aktiveras med hjälp av --tls alternativet .
  2. Porten som används – Alla Enterprise- och Enterprise Flash-nivåcacheminnen använder port 10000. Cacheminnen på basic-, Standard- och Premium-nivå använder dock antingen port 6379 för icke-TLS-anslutningar eller port 6380 för TLS-anslutningar.
  3. Oavsett om cacheinstansen använder klustring – Om du använder en Premium-nivåcache som använder klustring eller en Enterprise-/Enterprise Flash-nivåcache som använder OSS-klusterprincip lägger du till -calternativet för att säkerställa att alla shards kan nås.

Exempel

  1. Använd följande kommando för att ansluta till en Azure Cache for Redis-instans på Basic-, Standard- eller Premium-nivå med hjälp av TLS:

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

  2. Anslut till en Azure Cache for Redis-instans på Basic-, Standard- eller Premium-nivå som inte använder TLS:

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

  3. Anslut till en Azure Cache for Redis-instans på Basic-, Standard- eller Premium-nivå med hjälp av TLS och klustring:

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

  4. Anslut till en Enterprise- eller Enterprise Flash-nivåcacheinstans med hjälp av enterprise-klusterprincip med TLS:

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

  5. Anslut till en Enterprise- eller Enterprise Flash-nivåcacheinstans med hjälp av OSS-klusterprincip utan TLS:

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

Testa anslutningen

När anslutningen har upprättats kan du utfärda kommandon till din Azure Cache for Redis-instans. Ett enkelt sätt att testa anslutningen är att använda PING kommandot . Det här kommandot returnerar PONG i -konsolen.

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

Du kan också köra kommandon som SET och GET:

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

Nu är du ansluten till din Azure Cache for Redis-instans med hjälp av redis-cli.

redis-cli-alternativ

Även om redis-cli är ett användbart verktyg kan du ansluta till cacheminnet på andra sätt för felsökning eller testning:

  • Azure Cache for Redis erbjuder en Redis-konsol inbyggd i Azure-portalen där du kan utfärda kommandon utan att behöva installera kommandoradsverktyget. Funktionen Redis-konsolen är för närvarande endast tillgänglig på nivåerna Basic, Standard och Premium.
  • RedisInsight är ett omfattande öppen källkod grafiskt verktyg för att utfärda Redis-kommandon och visa innehållet i en Redis-instans. Den fungerar med Azure Cache for Redis och stöds i Linux, Windows och macOS.

Relaterat innehåll

Kom igång genom att skapa en ny cacheinstans på Företagsnivå.