Udostępnij za pomocą

Jak używać narzędzia wiersza polecenia Redis z usługą Azure Cache for Redis

  • Dotyczy: ✅ Azure Cache for Redis

Ważne

Usługa Azure Cache for Redis ogłosiła harmonogram wycofania wszystkich SKU. Zalecamy przeniesienie istniejących wystąpień usługi Azure Cache for Redis do usługi Azure Managed Redis tak szybko, jak to możliwe.

Aby uzyskać więcej informacji na temat przejścia na emeryturę:

W tym artykule opisano sposób korzystania z interfejsu wiersza polecenia redis-cli do interakcji z usługą Azure Cache for Redis jako klientem. Interfejs wiersza polecenia redis umożliwia bezpośrednią interakcję z wystąpieniem usługi Azure Redis Cache oraz debugowanie i rozwiązywanie problemów.

Warunek wstępny

Dostęp do wystąpienia serwera usługi Azure Cache for Redis.

Instalacja redis-cli

Narzędzie redis-cli jest instalowane automatycznie przy użyciu pakietu Redis, który jest dostępny dla systemów Linux, macOS i Windows. Aby uzyskać szczegółowe instrukcje dotyczące instalacji, zobacz dokumentację usługi Redis typu open source.

Instalowanie w systemie Linux

Narzędzie redis-cli działa natywnie w Linux, a większość dystrybucji Linux zawiera pakiet Redis, który zawiera narzędzie redis-cli. Na przykład pakiet Redis jest instalowany w systemie Ubuntu za pomocą następujących poleceń:

sudo apt-get update
sudo apt-get install redis

Zainstaluj w systemie Windows

Najlepszym sposobem korzystania z interfejsu wiersza polecenia redis w systemie Windows jest zainstalowanie podsystemu Windows dla systemu Linux (WSL), który umożliwia uruchamianie narzędzi systemu Linux bezpośrednio w systemie Windows. Aby zainstalować program WSL, zobacz How to install Linux on Windows with WSL (Jak zainstalować system Linux w systemie Windows przy użyciu programu WSL).

Po zainstalowaniu użyj WSL, aby zainstalować dystrybucję systemu Linux, a następnie zainstaluj redis-cli, używając dostępnego menedżera pakietów dla wybranej dystrybucji systemu Linux. Domyślna dystrybucja dla systemu WSL to Ubuntu. Aby uzyskać więcej informacji, zobacz dokumentację usługi Redis typu open source.

Połącz się przy użyciu redis-cli

Aby nawiązać połączenie z pamięcią podręczną Azure Redis Cache jako klient przy użyciu interfejsu wiersza polecenia redis, należy określić nazwę hosta pamięci podręcznej, port i klucze. Te wartości można pobrać przy użyciu następujących metod:

W poniższej sekcji opisano sposób pobierania tych wartości z witryny Azure Portal.

Pobieranie nazwy hosta pamięci podręcznej, portu i kluczy dostępu z witryny Azure Portal

Aby nawiązać połączenie z pamięcią podręczną Azure Redis Cache, klient pamięci podręcznej potrzebuje nazwy hosta, portów i kluczy pamięci podręcznej. Niektórzy klienci mogą odwoływać się do tych elementów przy użyciu nieco innych nazw. Postępuj zgodnie z tymi instrukcjami, aby uzyskać nazwę hosta pamięci podręcznej, porty i klucze z witryny Azure Portal.

  • Pobierz nazwę hosta ze strony Przegląd pamięci podręcznej. Nazwa hosta ma postać <cachename>.redis.cache.windows.net.

  • Wybierz link obok pozycji Porty , aby pobrać porty. Pamięci podręczne poziomu Flash i poziomu korporacyjnego używają portu 10000. Pamięci podręczne w warstwie Podstawowa, Standardowa i Premium używają portu 6380 dla połączeń protokołu Transport Layer Security (TLS) lub portu 6379 dla połączeń innych niż TLS.

  • Aby uzyskać klucze dostępu, wybierz pozycję Pokaż klucze dostępu.

    Zrzut ekranu przedstawiający właściwości pamięci podręcznej Azure Redis.

    W okienku CacheKeys zostaną wyświetlone klucze.

    Zrzut ekranu przedstawiający okienko kluczy dostępu do Azure Cache dla Redis.

    Możesz również wybrać pozycję Uwierzytelnianie w obszarze Ustawienia w menu nawigacji po lewej stronie, a następnie wybrać kartę Klucze dostępu .

    Zrzut ekranu przedstawiający klucze dostępu do pamięci podręcznej Azure Redis Cache.

Pobierz inne informacje o pamięci podręcznej

Może być również konieczne określenie następujących opcji dla interfejsu wiersza polecenia redis:

  • TLS: Domyślnie wystąpienia usługi Azure Redis używają szyfrowania TLS dla połączeń. Jeśli pamięć podręczna używa protokołu TLS, należy włączyć TLS dla redis-cli przy użyciu opcji --tls.
  • Klastrowanie: jeśli masz pamięć podręczną w warstwie Premium korzystającą z klastrowania, lub pamięć podręczną w warstwie Enterprise lub Enterprise Flash, które używają polityki OSS klastrów, dodaj opcję -c, aby zapewnić dostęp do wszystkich fragmentów.

Uruchom polecenie połączenia redis-cli

Aby nawiązać połączenie z pamięcią podręczną, otwórz powłokę lub terminal na komputerze z zainstalowanym pakietem Redis. W systemie Windows można użyć programu WSL z terminalem systemu Windows , aby otworzyć wiersz polecenia systemu Linux.

Uruchom jeden z następujących wierszy polecenia, w zależności od opcji tls, portów i klastrowania. Zastąp symbole zastępcze <cache name> i <access key> wartościami dla swojej pamięci podręcznej.

  • Połącz się z wystąpieniem usługi Azure Redis na poziomie Podstawowym, Standardowym lub Premium, które używa protokołu TLS.

    redis-cli -p 6380 -h <cache name>.redis.cache.windows.net -a <access key> --tls

  • Połącz się z instancją usługi Azure Redis w warstwie Podstawowej, Standardowej lub Premium, która nie korzysta z TLS.

    redis-cli -p 6379 -h <cache name>.redis.cache.windows.net -a <access key>

  • Połącz się z wystąpieniem usługi Azure Redis w warstwie Premium, które korzysta z protokołu TLS i klastrowania:

    redis-cli -p 6380 -h <cache name>.redis.cache.windows.net -a <access key> --tls -c

  • Nawiąż połączenie z wystąpieniem pamięci podręcznej warstwy Flash Enterprise lub Enterprise używającym zasad klastra przedsiębiorstwa z protokołem TLS:

    redis-cli -p 10000 -h <cache name>.eastus.redisenterprise.cache.azure.net -a <access key> --tls

  • Połącz się z wystąpieniem pamięci podręcznej warstwy Flash Enterprise lub Enterprise, które korzysta z zasad klastra systemu operacyjnego bez protokołu TLS:

    redis-cli -p 10000 -h <cache name>.eastus.redisenterprise.cache.azure.net -a <access key> -c

Masz teraz połączenie z wystąpieniem usługi Azure Redis Cache.

Używanie poleceń redis-cli z pamięcią podręczną Azure Redis Cache

Po nawiązaniu połączenia możesz wydać polecenia do wystąpienia usługi Azure Redis w wierszu polecenia redis-cli. W poniższych przykładach pokazano połączenie z pamięcią podręczną o nazwie contoso , która używa portu 6380.

Jednym z prostych sposobów przetestowania połączenia jest użycie PING polecenia . Polecenie jest zwracane PONG w konsoli programu .

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

Możesz również uruchamiać polecenia, takie jak SET i GET.

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

Alternatywy dla redis-cli

Chociaż redis-cli jest przydatnym narzędziem, możesz również użyć następujących metod, aby nawiązać połączenie z pamięcią podręczną na potrzeby rozwiązywania problemów lub testowania.

  • Konsola Redis umożliwia wydawanie poleceń bez konieczności instalowania redis-cli. Konsola Redis jest obecnie dostępna tylko dla warstw Podstawowa, Standardowa i Premium. Jeśli konsola Redis jest dostępna, możesz jej użyć, wybierając pozycję Konsola na górnym pasku narzędzi strony Przegląd pamięci podręcznej w portalu Azure.
  • RedisInsight to zaawansowane narzędzie graficzne typu open source do wydawania poleceń redis i wyświetlania zawartości wystąpienia usługi Redis. Usługa RedisInsight współpracuje z usługą Azure Cache for Redis i jest obsługiwana w systemach Linux, Windows i macOS.

Powiązana zawartość

  • Last updated on