Snabb start: Använd Azure cache för Redis i pythonQuickstart: Use Azure Cache for Redis in Python

I den här artikeln införlivar du Azure cache för Redis i en python-app för att få åtkomst till en säker, dedikerad cache som är tillgänglig från alla program i 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.

FörutsättningarPrerequisites

Skapa en Azure Cache for Redis-instansCreate an Azure Cache for Redis instance

  1. Om du vill skapa en cache loggar du in på Azure Portal och väljer skapa en resurs.To create a cache, sign in to the Azure portal and select Create a resource.

    Skapa en resurs markeras i det vänstra navigerings fönstret.

  2. Välj databaser på sidan nytt och välj sedan Azure cache för Redis.On the New page, select Databases and then select Azure Cache for Redis.

    På nytt markeras databaser och Azure cache för Redis är markerat.

  3. På sidan ny Redis cache konfigurerar du inställningarna för din nya cache.On the New Redis Cache page, configure the settings for your new cache.

    InställningSetting Föreslaget värdeSuggested value BeskrivningDescription
    DNS-namnDNS name Ange ett globalt unikt namn.Enter a globally unique name. Cache-namnet måste vara en sträng mellan 1 och 63 tecken som bara innehåller siffror, bokstäver eller bindestreck.The cache name must be a string between 1 and 63 characters that contains only numbers, letters, or hyphens. Namnet måste börja och sluta med en siffra eller en bokstav och får inte innehålla flera bindestreck i rad.The name must start and end with a number or letter, and can't contain consecutive hyphens. Din cacheposts värdnamn är <DNS name> . Redis.cache.Windows.net.Your cache instance's host name will be <DNS name>.redis.cache.windows.net.
    PrenumerationSubscription List rutan och välj din prenumeration.Drop down and select your subscription. Den prenumeration som du vill skapa den här nya Azure-cache för Redis-instansen för.The subscription under which to create this new Azure Cache for Redis instance.
    ResursgruppResource group List rutan och välj en resurs grupp, eller Välj Skapa ny och ange ett nytt resurs grupp namn.Drop down and select a resource group, or select Create new and enter a new resource group name. Namnet på resurs gruppen där du vill skapa cachen och andra resurser.Name for the resource group in which to create your cache and other resources. Genom att lägga till alla dina app-resurser i en resurs grupp kan du enkelt hantera eller ta bort dem tillsammans.By putting all your app resources in one resource group, you can easily manage or delete them together.
    PlatsLocation List rutan och välj en plats.Drop down and select a location. Välj en region nära andra tjänster som ska använda din cache.Select a region near other services that will use your cache.
    PrisnivåPricing tier List rutan och välj en pris nivå.Drop down and select a Pricing tier. Prisnivån avgör storlek, prestanda och funktioner som är tillgängliga för cacheminnet.The pricing tier determines the size, performance, and features that are available for the cache. Mer information finns i Översikt över Azure Cache for Redis.For more information, see Azure Cache for Redis Overview.
  4. Välj fliken nätverk eller klicka på knappen nätverk längst ned på sidan.Select the Networking tab or click the Networking button at the bottom of the page.

  5. På fliken nätverk väljer du anslutnings metod.In the Networking tab, select your connectivity method.

  6. Välj Nästa: fliken Avancerat eller klicka på Nästa: Avancerat längst ned på sidan.Select the Next: Advanced tab or click the Next: Advanced button on the bottom of the page.

  7. På fliken Avancerat för en Basic-eller standard-cachepost väljer du aktivera växling om du vill aktivera en icke-TLS-port.In the Advanced tab for a basic or standard cache instance, select the enable toggle if you want to enable a non-TLS port. Du kan också välja vilken Redis-version du vill använda, antingen 4 eller (för hands version) 6.You can also select which Redis version you would like use, either 4 or (PREVIEW) 6.

    Redis-version 4 eller 6.

  8. På fliken Avancerat för Premium-cache-instans konfigurerar du inställningarna för icke-TLS-port, klustring och data beständighet.In the Advanced tab for premium cache instance, configure the settings for non-TLS port, clustering, and data persistence. Du kan också välja vilken Redis-version du vill använda, antingen 4 eller (för hands version) 6.You can also select which Redis version you would like use, either 4 or (PREVIEW) 6.

  9. Välj fliken Nästa: Taggar eller klicka på knappen Nästa: Taggar längst ned på sidan.Select the Next: Tags tab or click the Next: Tags button at the bottom of the page.

  10. Alternativt går du till fliken taggar och anger namn och värde om du vill kategorisera resursen.Optionally, in the Tags tab, enter the name and value if you wish to categorize the resource.

  11. Välj Granska + skapa.Select Review + create. Du kommer till fliken Granska + skapa där Azure verifierar konfigurationen.You're taken to the Review + create tab where Azure validates your configuration.

  12. När meddelandet grön verifiering har skickats visas väljer du skapa.After the green Validation passed message appears, select Create.

Det tar en stund innan cacheminnet skulle skapas.It takes a while for the cache to create. Du kan övervaka förloppet på översikts sidan för Azure-cache för Redis.You can monitor progress on the Azure Cache for Redis Overview page. När statusen är igång är cacheminnet redo att användas.When Status shows as Running, the cache is ready to use.

Hämta värdnamn, portar och åtkomst nycklar från Azure PortalRetrieve host name, ports, and access keys from the Azure portal

För att ansluta till en Azure-cache för Redis-instansen behöver cache-klienterna värd namnet, portarna och en nyckel för cachen.To connect to an Azure Cache for Redis instance, cache clients need the host name, ports, and a key for the cache. Vissa klienter kan hänvisa till dessa objekt med namn som skiljer sig något.Some clients might refer to these items by slightly different names. Du kan hämta värdnamn, portar och nycklar från Azure Portal.You can get the host name, ports, and keys from the Azure portal.

  • Hämta åtkomst nycklarna genom att gå till vänster navigering i cachen och välja åtkomst nycklar.To get the access keys, from your cache left navigation, select Access keys.

    Nycklar för Azure Cache for Redis

  • För att hämta värd namnet och portarna, från din cache-vänstra navigering, väljer du Egenskaper.To get the host name and ports, from your cache left navigation, select Properties. Värd namnet är av formatet <DNS name> . Redis.cache.Windows.net.The host name is of the form <DNS name>.redis.cache.windows.net.

    Egenskaper för Azure Cache for Redis

Installera redis-pyInstall redis-py

Redis-py är ett Python-gränssnitt för Azure Cache for Redis.Redis-py is a Python interface to Azure Cache for Redis. Använd verktyget python packages, pip för att installera Redis-py- paketet från en kommando tolk.Use the Python packages tool, pip, to install the redis-py package from a command prompt.

I följande exempel användes PIP3 för python 3 för att installera Redis-py på Windows 10 från en administratörs kommando tolk.The following example used pip3 for Python 3 to install redis-py on Windows 10 from an Administrator command prompt.

Installera Redis-py python-gränssnittet till Azure cache för Redis

Läsa och skriva till cachenRead and write to the cache

Kör python från kommando raden och testa cacheminnet med hjälp av följande kod.Run Python from the command line and test your cache by using the following code. Ersätt <Your Host Name> och <Your Access Key> med värdena från Azure-cachen för Redis-instansen.Replace <Your Host Name> and <Your Access Key> with the values from your Azure Cache for Redis instance. Värd namnet har formatet form <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'

Viktigt

För Azure cache för Redis version 3,0 eller högre tillämpas TLS/SSL-certifikat kontroll.For Azure Cache for Redis version 3.0 or higher, TLS/SSL certificate check is enforced. ssl_ca_certs måste anges explicit vid anslutning till Azure cache för Redis.ssl_ca_certs must be explicitly set when connecting to Azure Cache for Redis. För RedHat Linux finns ssl_ca_certs i /etc/PKI/TLS/certs/ca-Bundle.CRT -modulen för certifikat.For RedHat Linux, ssl_ca_certs are in the /etc/pki/tls/certs/ca-bundle.crt certificate module.

Skapa en python-exempel AppCreate a Python sample app

Skapa en ny textfil, Lägg till följande skript och spara filen som PythonApplication1.py.Create a new text file, add the following script, and save the file as PythonApplication1.py. Ersätt <Your Host Name> och <Your Access Key> med värdena från Azure-cachen för Redis-instansen.Replace <Your Host Name> and <Your Access Key> with the values from your Azure Cache for Redis instance. Värd namnet har formatet form <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'])

Kör PythonApplication1.py med python.Run PythonApplication1.py with Python. Du bör se resultatet som i följande exempel:You should see results like the following example:

Kör Python-skript för att testa cache-åtkomst

Rensa resurserClean up resources

Om du är klar med den Azure-resurs grupp och de resurser som du skapade i den här snabb starten kan du ta bort dem för att undvika avgifter.If you're finished with the Azure resource group and resources you created in this quickstart, you can delete them to avoid charges.

Viktigt

Att ta bort en resurs grupp går inte att ångra, och resurs gruppen och alla resurser i den tas bort permanent.Deleting a resource group is irreversible, and the resource group and all the resources in it are permanently deleted. Om du har skapat Azure cache för Redis-instansen i en befintlig resurs grupp som du vill behålla, kan du ta bort bara cachen genom att välja ta bort på sidan cache- Översikt .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.

Så här tar du bort resurs gruppen och dess Redis Cache för Azure-instansen:To delete the resource group and its Redis Cache for Azure instance:

  1. Sök efter och välj resurs grupper från Azure Portal.From the Azure portal, search for and select Resource groups.

  2. I text rutan Filtrera efter namn anger du namnet på den resurs grupp som innehåller din cache-instans och väljer sedan den från Sök resultaten.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. Välj Ta bort resursgrupp på din resursgruppssida.On your resource group page, select Delete resource group.

  4. Skriv namnet på resurs gruppen och välj sedan ta bort.Type the resource group name, and then select Delete.

    Ta bort din resurs grupp för Azure cache för Redis

Nästa stegNext steps