Guida introduttiva: Usare Cache Redis di Azure con PythonQuickstart: Use Azure Redis Cache with Python

IntroduzioneIntroduction

Questa guida introduttiva illustra come connettersi a una Cache Redis di Azure con Python per leggere e scrivere in una cache.This quickstart shows how to connect to an Azure Redis Cache with Python to read and write to a cache.

Test Python completato

Se non si ha una sottoscrizione di Azure, creare un account gratuito prima di iniziare.If you don't have an Azure subscription, create a free account before you begin.

prerequisitiPrerequisites

Creare una cache Redis in AzureCreate a Redis cache on Azure

  1. Per creare una cache, accedere al portale di Azure.To create a cache, first sign in to the Azure portal. Selezionare quindi Crea una risorsa > Database > Cache Redis.Then select Create a resource > Databases > Redis Cache.

    New cache

  2. In Nuova cache Redis, configurare le impostazioni per la nuova cache.In New Redis Cache, configure the settings for your new cache.

    ImpostazioneSetting Valore consigliatoSuggested value DESCRIZIONEDescription
    Nome DNSDNS name Nome globalmente univocoGlobally unique name Nome della cache.The cache name. Deve essere una stringa contenente da 1 a 63 caratteri che possono includere solo numeri, lettere e il carattere -.It must be a string between 1 and 63 characters and contain only numbers, letters, and the - character. Il nome della cache non può iniziare o terminare con il carattere - e i caratteri - consecutivi non sono validi.The cache name cannot start or end with the - character, and consecutive - characters are not valid.
    SottoscrizioneSubscription Sottoscrizione in usoYour subscription Sottoscrizione in cui viene creata questa nuova istanza di Cache Redis di Azure.The subscription under which this new Azure Redis Cache instance is created.
    Gruppo di risorseResource group TestResourcesTestResources Nome del nuovo gruppo di risorse in cui creare la cache.Name for the new resource group in which to create your cache. Inserendo tutte le risorse per un'app in un gruppo è possibile gestirle insieme.By putting all the resources for an app in a group, you can manage them together. Ad esempio, eliminando il gruppo di risorse si eliminano tutte le risorse associate all'app.For example, deleting the resource group deletes all resources that are associated with the app.
    PosizioneLocation Stati Uniti orientaliEast US Scegliere una regione nelle vicinanze di altri servizi che utilizzeranno la cache.Choose a region near to other services that will use your cache.
    Piano tariffarioPricing tier C0 Basic (cache da 250 MB)Basic C0 (250 MB Cache) Il piano tariffario determina le dimensioni, le prestazioni e le funzionalità disponibili per la cache.The pricing tier determines the size, performance, and features that are available for the cache. Per altre informazioni, vedere Panoramica della cache Redis di Azure.For more information, see Azure Redis Cache Overview.
    Aggiungi al dashboardPin to dashboard SelezionatoSelected Aggiungere la nuova cache al dashboard per renderla più semplice da trovare.Pin the new cache to your dashboard to make it easy to find.

    Create cache

  3. Dopo aver configurato le impostazioni della nuova cache, selezionare Crea.After the new cache settings are configured, select Create.

    La creazione della cache può richiedere alcuni minuti.It can take a few minutes for the cache to be created. Per verificare lo stato è possibile monitorare l'avanzamento nel dashboard.To check the status, you can monitor the progress on the dashboard. Dopo la creazione, lo stato della cache sarà In esecuzione e sarà possibile usarla subito.After the cache has been created, it shows the status Running, and is ready for use.

    Cache created

Recuperare il nome dell'host, le porte e le chiavi di accesso usando il portale di AzureRetrieve host name, ports, and access keys by using the Azure portal

Per connettersi a un'istanza Cache Redis di Azure, è necessario specificare il nome host, le porte e le chiavi della cache.When connecting to an Azure Redis Cache instance, cache clients need the host name, ports, and a key for the cache. Alcuni client possono fare riferimento a questi elementi usando nomi leggermente diversi.Some clients might refer to these items by slightly different names. Queste informazioni possono essere recuperate nel portale di Azure.You can retrieve this information in the Azure portal.

Per recuperare le chiavi di accesso e il nome hostTo retrieve the access keys and host name

  1. Per recuperare le chiavi di accesso tramite il portale di Azure, individuare la cache e selezionare Chiavi di accesso.To retrieve the access keys by using the Azure portal, browse to your cache and select Access keys.

    Chiavi di Cache Redis di Azure

  2. Per recuperare il nome host e le porte, selezionare Proprietà.To retrieve the host name and ports, select Properties.

    Proprietà di Cache Redis di Azure

Installare redis-pyInstall redis-py

Redis py è un'interfaccia di Python per Cache Redis.Redis-py is a Python interface to Redis Cache. Usare lo strumento per i pacchetti Python pip per installare il pacchetto redis-py.Use the Python packages tool, pip, to install the redis-py package.

L'esempio seguente usa pip3 per Python3 per installare il pacchetto redis-py in Windows 10 usando un prompt dei comandi per gli sviluppatori per Visual Studio 2017 con privilegi di amministratore elevati.The following example uses pip3 for Python3 to install the redis-py package on Windows 10 using a Visual Studio 2017 Developer Command prompt running with elevated Administrator privileges.

pip3 install redis

Installare redis-py

Leggere e scrivere nella cacheRead and write to the cache

Eseguire Python e testare l'uso della cache dalla riga di comando.Run Python and test using the cache from the command line. Sostituire <Your Host Name> e <Your Access Key> con i valori per la Cache Redis.Replace <Your Host Name> and <Your Access Key> with the values for your Redis Cache.

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

Creare uno script PythonCreate a Python script

Creare un nuovo file di testo di script denominato PythonApplication1.py.Create a new script text file named PythonApplication1.py.

Aggiungere lo script seguente in PythonApplication1.py e salvare il file.Add the following script to PythonApplication1.py and save the file. Questo script eseguirà il test di accesso alla cache.This script will test the cache access. Sostituire <Your Host Name> e <Your Access Key> con i valori per la Cache Redis.Replace <Your Host Name> and <Your Access Key> with the values for your Redis Cache.

import redis

myHostname = "<Your Host Name>.redis.cache.windows.net"
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'])

Eseguire lo script con Python.Run the script with Python.

Test Python completato

Pulire le risorseClean up resources

Se si prevede di proseguire con un'altra esercitazione, è possibile conservare le risorse create in questa guida introduttiva e riutilizzarle.If you will be continuing with another tutorial, you can keep the resources created in this quickstart and reuse them.

In caso contrario, se si è terminato il lavoro con l'applicazione di esempio di avvio rapido, è possibile eliminare le risorse di Azure create in questo avvio rapido per evitare i costi correlati.Otherwise, if you are finished with the quickstart sample application, you can delete the Azure resources created in this quickstart to avoid charges.

Importante

L'eliminazione di un gruppo di risorse è irreversibile e comporta l'eliminazione definitiva del gruppo di risorse e di tutte le risorse incluse nel gruppo.Deleting a resource group is irreversible and that the resource group and all the resources in it are permanently deleted. Assicurarsi di non eliminare accidentalmente il gruppo di risorse sbagliato o le risorse errate.Make sure that you do not accidentally delete the wrong resource group or resources. Se le risorse per questo esempio sono state create all'interno di un gruppo di risorse esistente che contiene anche elementi da mantenere, è possibile eliminare ogni elemento singolarmente dai rispettivi pannelli anziché eliminare il gruppo di risorse.If you created the resources for hosting this sample inside an existing resource group that contains resources you want to keep, you can delete each resource individually from their respective blades instead of deleting the resource group.

Accedere al portale di Azure e fare clic su Gruppi di risorse.Sign in to the Azure portal and click Resource groups.

Nella casella di testo Filtra per nome... immettere il nome del gruppo di risorse.In the Filter by name... textbox, type the name of your resource group. Le istruzioni di questo articolo usano un gruppo di risorse denominato TestResources.The instructions for this article used a resource group named TestResources. Nel gruppo di risorse nell'elenco dei risultati fare clic su ... quindi su Elimina gruppo di risorse.On your resource group in the result list, click ... then Delete resource group.

Delete

Verrà chiesto di confermare l'eliminazione del gruppo di risorse.You will be asked to confirm the deletion of the resource group. Immettere il nome del gruppo di risorse per confermare e fare clic su Elimina.Type the name of your resource group to confirm, and click Delete.

Dopo qualche istante il gruppo di risorse e tutte le risorse che contiene vengono eliminati.After a few moments, the resource group and all of its contained resources are deleted.

Passaggi successiviNext steps