Snabbstart: Så här använder du Azure Cache for Redis i Python
I den här artikeln införlivar du Azure Cache for 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.
Hoppa till koden på GitHub
Om du vill hoppa direkt till koden kan du läsa Python-snabbstarten på GitHub.
Förutsättningar
- Azure-prenumeration – skapa en kostnadsfritt
- Python 3
- För macOS eller Linux laddar du ned från python.org.
- För Windows 11 använder du Windows Store.
Skapa en Azure Cache for Redis-instans
Om du vill skapa en cache loggar du in på Azure-portalen och väljer Skapa en resurs.
På sidan Nytt väljer du Databaser och sedan Azure Cache for Redis.
På sidan Ny Redis Cache konfigurerar du inställningarna för din nya cache.
Inställning Välj ett värde beskrivning Abonnemang Listrutan och välj din prenumeration. Prenumerationen som den nya Azure Cache for Redis-instansen ska skapas under. Resursgrupp Listrutan och välj en resursgrupp eller välj Skapa ny och ange ett nytt resursgruppsnamn. Namn på den resursgrupp där cacheminnet och andra resurser ska skapas. Genom att placera alla dina appresurser i en resursgrupp kan du enkelt hantera eller ta bort dem tillsammans. DNS-namn Ange ett unikt namn. Cachenamnet måste vara en sträng mellan 1 och 63 tecken som endast innehåller siffror, bokstäver eller bindestreck. Namnet måste börja och sluta med ett tal eller en bokstav och får inte innehålla bindestreck i följd. Värdnamnet för cacheinstansen är <DNS-namnet.redis.cache.windows.net>. Plats Listrutan och välj en plats. Välj en region nära andra tjänster som använder din cache. Cachetyp Listrutan och välj en nivå. Nivån avgör storlek, prestanda och funktioner som är tillgängliga för cacheminnet. Mer information finns i Översikt över Azure Cache for Redis. Välj fliken Nätverk eller välj knappen Nätverk längst ned på sidan.
På fliken Nätverk väljer du din anslutningsmetod.
Välj fliken Nästa: Avancerat eller välj knappen Nästa: Avancerat längst ned på sidan för att se fliken Avancerat .
- För Basic- eller Standard-cacheminnen växlar du markeringen för en icke-TLS-port. Du kan också välja om du vill aktivera Microsoft Entra-autentisering.
- För en Premium-cache konfigurerar du inställningarna för icke-TLS-port, klustring, hanterad identitet och datapersistence. Du kan också välja om du vill aktivera Microsoft Entra-autentisering.
Välj fliken Nästa: Taggar eller välj knappen Nästa: Taggar längst ned på sidan.
Du kan också ange namn och värde på fliken Taggar om du vill kategorisera resursen.
Välj Granska + skapa. Du kommer till fliken Granska + skapa där Azure verifierar din konfiguration.
När det gröna verifieringsmeddelandet har skickats väljer du Skapa.
Det tar en stund innan en cache skapas. Du kan övervaka förloppet på översiktssidan för Azure Cache for Redis. När Status visas som Körs är cachen redo att användas.
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 går du till det vänstra navigeringsfönstret i cachen och väljer Åtkomstnycklar.
Om du vill hämta värdnamnet och portarna går du till det vänstra navigeringsfönstret i cachen och väljer Egenskaper. Värdnamnet är av formatet DNS name.redis.cache.windows.net>.<
Installera redis-py
Redis-py är ett Python-gränssnitt för Azure Cache for Redis. Använd Python-paketverktyget , pipför att installera redis-py paketet från en kommandotolk.
Följande exempel används pip3 för att installera redis-py Python 3 på Windows 11 från en kommandotolk för administratör.
Läsa och skriva till cachen
Kör Python från kommandoraden och testa cacheminnet med hjälp av följande kod. Ersätt <Your Host Name> och <Your Access Key> med värdena från din Azure Cache for Redis-instans. Värdnamnet är av formuläret <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 for Redis version 3.0 eller senare tillämpas kontroll av TLS/SSL-certifikat. ssl_ca_certs måste anges explicit när du ansluter till Azure Cache for Redis. För RedHat Linux ssl_ca_certs finns i certifikatmodulen /etc/pki/tls/certs/ca-bundle.crt .
Skapa en Python-exempelapp
Skapa en ny textfil, lägg till följande skript och spara filen som PythonApplication1.py. Ersätt <Your Host Name> och <Your Access Key> med värdena från din Azure Cache for Redis-instans. Värdnamnet är av formuläret <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(f"id : {c['id']}, addr : {c['addr']}")
Kör PythonApplication1.py med Python. Du bör se resultat som i följande exempel:
Rensa resurser
Om du är klar med den Azure-resursgrupp och de resurser som du skapade i den här snabbstarten kan du ta bort dem för att undvika avgifter.
Viktigt!
Det går inte att ångra borttagningen av en resursgrupp och resursgruppen och alla resurser i den tas bort permanent. Om du har skapat din Azure Cache for Redis-instans i en befintlig resursgrupp som du vill behålla kan du bara ta bort cachen genom att välja Ta bort från cacheöversiktssidan.
Så här tar du bort resursgruppen och dess Redis Cache for Azure-instans:
Från Azure-portalen söker du efter och väljer Resursgrupper.
I textrutan Filtrera efter namn anger du namnet på resursgruppen som innehåller cacheinstansen och väljer den sedan i sökresultaten.
Välj Ta bort resursgrupp på din resursgruppssida.
Skriv resursgruppens namn och välj sedan Ta bort.
