Szybki Start: korzystanie z usługi Azure cache for Redis w języku PythonQuickstart: Use Azure Cache for Redis in Python

W tym artykule opisano obsługę usługi Azure cache for Redis w aplikacji w języku Python w celu uzyskania dostępu do bezpiecznej, dedykowanej pamięci podręcznej dostępnej z dowolnej aplikacji na platformie Azure.In this article, you incorporate Azure Cache for Redis into a Python app to have access to a secure, dedicated cache that is accessible from any application within Azure.

Wymagania wstępnePrerequisites

Tworzenie wystąpienia pamięci podręcznej Azure Cache for RedisCreate an Azure Cache for Redis instance

  1. Aby utworzyć pamięć podręczną, zaloguj się do Azure Portal i wybierz pozycję Utwórz zasób.To create a cache, sign in to the Azure portal and select Create a resource.

    W okienku nawigacji po lewej stronie zostanie wyróżniony zasób.

  2. Na stronie Nowy wybierz pozycję bazy danych , a następnie wybierz pozycję Azure cache for Redis.On the New page, select Databases and then select Azure Cache for Redis.

    W obszarze nowe są wyróżnione bazy danych, a usługa Azure cache for Redis jest wyróżniona.

  3. Na stronie nowy Redis Cache Skonfiguruj ustawienia dla nowej pamięci podręcznej.On the New Redis Cache page, configure the settings for your new cache.

    UstawienieSetting Sugerowana wartośćSuggested value OpisDescription
    Nazwa DNSDNS name Podaj globalnie unikatową nazwę.Enter a globally unique name. Nazwa pamięci podręcznej musi być ciągiem z przedziału od 1 do 63 znaków, który zawiera tylko cyfry, litery lub łączniki.The cache name must be a string between 1 and 63 characters that contains only numbers, letters, or hyphens. Nazwa musi zaczynać się i kończyć cyfrą lub literą i nie może zawierać następujących po sobie łączników.The name must start and end with a number or letter, and can't contain consecutive hyphens. Nazwa hosta wystąpienia pamięci podręcznej to <DNS name> . Redis.cache.Windows.NET.Your cache instance's host name will be <DNS name>.redis.cache.windows.net.
    SubskrypcjaSubscription Lista rozwijana i wybierz swoją subskrypcję.Drop down and select your subscription. Subskrypcja, w ramach której ma zostać utworzone nowe wystąpienie usługi Azure cache for Redis.The subscription under which to create this new Azure Cache for Redis instance.
    Grupa zasobówResource group Rozwiń i wybierz grupę zasobów lub wybierz pozycję Utwórz nową , a następnie wprowadź nową nazwę grupy zasobów.Drop down and select a resource group, or select Create new and enter a new resource group name. Nazwa grupy zasobów, w której ma zostać utworzona pamięć podręczna i inne zasoby.Name for the resource group in which to create your cache and other resources. Umieszczenie wszystkich zasobów aplikacji w jednej grupie zasobów pozwala łatwo zarządzać nimi i usuwać je razem.By putting all your app resources in one resource group, you can easily manage or delete them together.
    LokalizacjaLocation Lista rozwijana i wybierz lokalizację.Drop down and select a location. Wybierz region blisko innych usług, które będą korzystać z pamięci podręcznej.Select a region near other services that will use your cache.
    Warstwa cenowaPricing tier Lista rozwijana i wybierz warstwę cenową.Drop down and select a Pricing tier. Warstwa cenowa decyduje o rozmiarze, wydajności i funkcjach dostępnych dla pamięci podręcznej.The pricing tier determines the size, performance, and features that are available for the cache. Aby uzyskać więcej informacji, zobacz Omówienie pamięci podręcznej Azure Cache for Redis.For more information, see Azure Cache for Redis Overview.
  4. Wybierz kartę Sieć lub kliknij przycisk sieci w dolnej części strony.Select the Networking tab or click the Networking button at the bottom of the page.

  5. Na karcie Sieć wybierz metodę łączności.In the Networking tab, select your connectivity method.

  6. Wybierz kartę Dalej: Zaawansowane lub kliknij przycisk Dalej: Zaawansowane w dolnej części strony.Select the Next: Advanced tab or click the Next: Advanced button on the bottom of the page.

  7. Na karcie Zaawansowane dla podstawowego lub standardowego wystąpienia pamięci podręcznej wybierz opcję Włącz przełącznik, jeśli chcesz włączyć port inny niż TLS.In the Advanced tab for a basic or standard cache instance, select the enable toggle if you want to enable a non-TLS port. Możesz również wybrać, która wersja Redis ma być używana, 4 lub (wersja zapoznawcza) 6.You can also select which Redis version you would like use, either 4 or (PREVIEW) 6.

    Redis w wersji 4 lub 6.

  8. Na karcie Zaawansowane wystąpienia pamięci podręcznej Premium Skonfiguruj ustawienia dla portu niezwiązanego z protokołem TLS, klastrowanie i trwałość danych.In the Advanced tab for premium cache instance, configure the settings for non-TLS port, clustering, and data persistence. Możesz również wybrać, która wersja Redis ma być używana, 4 lub (wersja zapoznawcza) 6.You can also select which Redis version you would like use, either 4 or (PREVIEW) 6.

  9. Wybierz kartę następne: Tagi lub kliknij przycisk Dalej: Tagi w dolnej części strony.Select the Next: Tags tab or click the Next: Tags button at the bottom of the page.

  10. Opcjonalnie na karcie Tagi wprowadź nazwę i wartość, jeśli chcesz przydzielić zasób.Optionally, in the Tags tab, enter the name and value if you wish to categorize the resource.

  11. Wybierz pozycję Przeglądanie + tworzenie.Select Review + create. Nastąpi przekierowanie do karty Recenzja + tworzenie, w której platforma Azure weryfikuje konfigurację.You're taken to the Review + create tab where Azure validates your configuration.

  12. Po wyświetleniu komunikatu o pomyślnym sprawdzeniu poprawności, wybierz pozycję Utwórz.After the green Validation passed message appears, select Create.

Tworzenie pamięci podręcznej zajmuje trochę czasu.It takes a while for the cache to create. Postęp można monitorować na stronie Przegląd usługi Azure cache for Redis.You can monitor progress on the Azure Cache for Redis Overview page. Gdy stan jest wyświetlany jako uruchomiony, pamięć podręczna jest gotowa do użycia.When Status shows as Running, the cache is ready to use.

Pobieranie nazwy hosta, portów i kluczy dostępu z Azure PortalRetrieve host name, ports, and access keys from the Azure portal

Aby nawiązać połączenie z usługą Azure cache for Redis, klienci pamięci podręcznej potrzebują nazwy hosta, portów i klucza dla pamięci podręcznej.To connect to an Azure Cache for Redis instance, cache clients need the host name, ports, and a key for the cache. Niektórzy klienci mogą odwoływać się do tych elementów przy użyciu nieco innych nazw.Some clients might refer to these items by slightly different names. Możesz uzyskać nazwę hosta, porty i klucze z Azure Portal.You can get the host name, ports, and keys from the Azure portal.

  • Aby uzyskać klucze dostępu, w obszarze nawigacji po lewej stronie wybierz pozycję klucze dostępu.To get the access keys, from your cache left navigation, select Access keys.

    Klucze usługi Azure Cache for Redis

  • Aby uzyskać nazwę hosta i porty, z okienka nawigacji po lewej stronie wybierz pozycję Właściwości.To get the host name and ports, from your cache left navigation, select Properties. Nazwa hosta ma postać <DNS name> . Redis.cache.Windows.NET.The host name is of the form <DNS name>.redis.cache.windows.net.

    Właściwości usługi Azure Cache for Redis

Instalowanie klienta redis-pyInstall redis-py

Redis-py to interfejs języka Python dla usługi Azure Cache for Redis.Redis-py is a Python interface to Azure Cache for Redis. Użyj narzędzia pakiety Python, PIP, aby zainstalować pakiet Redis-PR z wiersza polecenia.Use the Python packages tool, pip, to install the redis-py package from a command prompt.

W poniższym przykładzie użyto PIP3 for Python 3 do zainstalowania Redis-PR w systemie Windows 10 z poziomu wiersza polecenia administratora.The following example used pip3 for Python 3 to install redis-py on Windows 10 from an Administrator command prompt.

Zainstaluj interfejs Python Redis-PR w usłudze Azure cache dla Redis

Odczytywanie i zapisywanie w pamięci podręcznejRead and write to the cache

Uruchom Język Python z wiersza polecenia i przetestuj pamięć podręczną przy użyciu następującego kodu.Run Python from the command line and test your cache by using the following code. Zamień <Your Host Name> i <Your Access Key> na wartości z wystąpienia usługi Azure cache for Redis.Replace <Your Host Name> and <Your Access Key> with the values from your Azure Cache for Redis instance. Nazwa hosta ma postać <DNS name> . Redis.cache.Windows.NET.Your host name is of the form <DNS name>.redis.cache.windows.net.

>>> import redis
>>> r = redis.StrictRedis(host='<Your Host Name>',
        port=6380, db=0, password='<Your Access Key>', ssl=True)
>>> r.set('foo', 'bar')
True
>>> r.get('foo')
b'bar'

Ważne

W przypadku usługi Azure cache for Redis w wersji 3,0 lub nowszej wymuszone jest sprawdzenie certyfikatu TLS/SSL.For Azure Cache for Redis version 3.0 or higher, TLS/SSL certificate check is enforced. ssl_ca_certs musi być jawnie ustawiona podczas nawiązywania połączenia z usługą Azure cache for Redis.ssl_ca_certs must be explicitly set when connecting to Azure Cache for Redis. W przypadku systemu RedHat Linux ssl_ca_certs znajdują się w module certyfikatu /etc/pki/tls/certs/CA-Bundle.CRT .For RedHat Linux, ssl_ca_certs are in the /etc/pki/tls/certs/ca-bundle.crt certificate module.

Tworzenie przykładowej aplikacji w języku PythonCreate a Python sample app

Utwórz nowy plik tekstowy, Dodaj następujący skrypt i Zapisz plik jako PythonApplication1.py.Create a new text file, add the following script, and save the file as PythonApplication1.py. Zamień <Your Host Name> i <Your Access Key> na wartości z wystąpienia usługi Azure cache for Redis.Replace <Your Host Name> and <Your Access Key> with the values from your Azure Cache for Redis instance. Nazwa hosta ma postać <DNS name> . Redis.cache.Windows.NET.Your host name is of the form <DNS name>.redis.cache.windows.net.

import redis

myHostname = "<Your Host Name>"
myPassword = "<Your Access Key>"

r = redis.StrictRedis(host=myHostname, port=6380,
                      password=myPassword, ssl=True)

result = r.ping()
print("Ping returned : " + str(result))

result = r.set("Message", "Hello!, The cache is working with Python!")
print("SET Message returned : " + str(result))

result = r.get("Message")
print("GET Message returned : " + result.decode("utf-8"))

result = r.client_list()
print("CLIENT LIST returned : ")
for c in result:
    print("id : " + c['id'] + ", addr : " + c['addr'])

Uruchom PythonApplication1.py za pomocą języka Python.Run PythonApplication1.py with Python. Powinny być widoczne wyniki podobne do następującego przykładu:You should see results like the following example:

Uruchom skrypt języka Python, aby przetestować dostęp do pamięci podręcznej

Czyszczenie zasobówClean up resources

Jeśli zakończysz pracę z grupą zasobów i zasobami platformy Azure utworzoną w tym przewodniku Szybki Start, możesz je usunąć, aby uniknąć naliczania opłat.If you're finished with the Azure resource group and resources you created in this quickstart, you can delete them to avoid charges.

Ważne

Usuwanie grupy zasobów jest nieodwracalne, a grupa zasobów i wszystkie znajdujące się w niej zasoby są trwale usuwane.Deleting a resource group is irreversible, and the resource group and all the resources in it are permanently deleted. Jeśli utworzono wystąpienie usługi Azure cache for Redis w istniejącej grupie zasobów, która ma zostać zachowana, można usunąć tylko pamięć podręczną, wybierając pozycję Usuń na stronie Przegląd pamięci podręcznej.If you created your Azure Cache for Redis instance in an existing resource group that you want to keep, you can delete just the cache by selecting Delete from the cache Overview page.

Aby usunąć grupę zasobów i jej Redis Cache dla wystąpienia platformy Azure:To delete the resource group and its Redis Cache for Azure instance:

  1. W Azure PortalWyszukaj i wybierz pozycję grupy zasobów.From the Azure portal, search for and select Resource groups.

  2. W polu tekstowym Filtruj według nazwy wprowadź nazwę grupy zasobów zawierającej wystąpienie pamięci podręcznej, a następnie wybierz ją z wyników wyszukiwania.In the Filter by name text box, enter the name of the resource group that contains your cache instance, and then select it from the search results.

  3. Na stronie grupy zasobów wybierz pozycję Usuń grupę zasobów.On your resource group page, select Delete resource group.

  4. Wpisz nazwę grupy zasobów, a następnie wybierz pozycję Usuń.Type the resource group name, and then select Delete.

    Usuwanie grupy zasobów dla usługi Azure cache for Redis

Następne krokiNext steps