Quickstart: Azure Cache voor Redis in Python gebruiken

In dit artikel neemt u Azure Cache voor Redis op in een Python-app voor toegang tot een veilige, toegewezen cache die toegankelijk is vanuit elke toepassing binnen Azure.

Ga naar de code op GitHub

Zie de Python-quickstart op GitHub als u direct naar de code wilt gaan.

Vereisten

Een instantie van Azure Cache voor Redis maken

  1. Als u een cache wilt maken, meldt u zich aan bij de Azure-portal en selecteert u Een resource maken.

    Een resource maken is gemarkeerd in het linkernavigatiedeelvenster.

  2. Selecteer op de pagina Nieuw de optie Databases en selecteer vervolgens Azure Cache voor Redis.

    In Nieuw is Databases gemarkeerd. Azure Cache voor Redis is ook gemarkeerd.

  3. Configureer op de pagina Nieuwe Redis-cache de instellingen voor de nieuwe cache.

    Instelling Voorgestelde waarde Beschrijving
    DNS-naam Geef een wereldwijd unieke naam op. De cachenaam is een tekenreeks van 1 tot 63 tekens die alleen cijfers, letters en afbreekstreepjes mag bevatten. De naam moet beginnen en eindigen met een cijfer of letter en mag geen opeenvolgende afbreekstreepjes bevatten. De hostnaam van uw cache-exemplaar wordt <DNS name>.redis.cache.windows.net.
    Abonnement Open de vervolgkeuzelijst en selecteer uw abonnement. Het abonnement waarmee dit nieuwe Azure Cache voor Redis-exemplaar wordt gemaakt.
    Resourcegroep Open de vervolgkeuzelijst en selecteer een resourcegroep of kies Nieuwe maken en geef een naam voor de nieuwe resourcegroep op. Naam voor de resourcegroep waarin de cache en andere resources moeten worden gemaakt. Door al uw app-resources in één resourcegroep te plaatsen, kunt u ze eenvoudig beheren of verwijderen.
    Locatie Open de vervolgkeuzelijst en selecteer een locatie. Selecteer een regio in de buurt van andere services die gaan gebruikmaken van de cache.
    Prijscategorie Open de vervolgkeuzelijst en selecteer een Prijscategorie. De prijscategorie bepaalt de grootte, prestaties en functies die beschikbaar zijn voor de cache. Zie het Azure Cache voor Redis-overzicht voor meer informatie.
  4. Selecteer het tabblad Netwerken of klik op de knop Netwerken onderaan de pagina.

  5. Selecteer uw verbindingsmethode op het tabblad Netwerk.

  6. Selecteer het tabblad Volgende: Geavanceerd of klik op de knop Volgende: Geavanceerd onderaan de pagina.

  7. Selecteer in het tabblad Geavanceerd voor een basic of standard cache-exemplaar de schakeloptie inschakelen als u een niet-TLS-poort wilt inschakelen. U kunt ook selecteren welke Redis-versie u wilt gebruiken: 4 of 6 (preview).

    Redis-versie 4 of 6.

  8. Configureer in het tabblad Geavanceerd voor premium cache-exemplaar de instellingen voor een niet-TLS-poort, clustering en gegevenspersistentie. U kunt ook selecteren welke Redis-versie u wilt gebruiken: 4 of 6 (preview).

  9. Selecteer het tabblad Volgende: Tags of klik op de knop Volgende: Tags onderaan de pagina.

  10. Voer desgewenst in het tabblad Tags de naam en waarde in om de resource te categoriseren.

  11. Selecteer Controleren + maken. Het tabblad Beoordelen + maken wordt weergegeven, waar uw configuratie wordt gevalideerd in Azure.

  12. Selecteer Maken nadat het groene bericht Validatie geslaagd verschijnt.

Het duurt even voor de cache is gemaakt. U kunt de voortgang bekijken op de overzichtspagina van Azure Cache voor Redis. Als u bij Status Wordt uitgevoerd ziet staan, kunt u de cache gebruiken.

Hostnaam, poorten en toegangssleutels ophalen uit Azure Portal

Cache-clients hebben de hostnaam, poorten en sleutels van de cache nodig om verbinding te maken met een Azure Cache for Redis-instantie. Sommige clients kunnen enigszins andere namen gebruiken om naar deze items te verwijzen. U kunt de hostnaam, poorten en toegangssleutels ophalen uit Azure Portal.

  • Als u de toegangssleutels wilt ophalen, selecteert u in de linkernavigatie van de cache de optie Toegangssleutels.

    Sleutels van Azure Cache voor Redis

  • Als u de hostnaam en poorten wilt ophalen, selecteert u in de linkernavigatie van de cache de optie Eigenschappen. De hostnaam heeft de indeling <DNS name>.redis.cache.windows.net.

    Eigenschappen van Azure Cache voor Redis

Redis-py installeren

Redis-py is een Python-interface voor Azure Cache voor Redis. Gebruik het hulpprogramma voor Python-pakketten, pip, om het redis-py-pakket te installeren vanuit een opdrachtprompt.

In het volgende voorbeeld is pip3 voor Python 3 gebruikt om redis-py op Windows 10 te installeren via een opdrachtprompt voor de beheerder.

De Python-interface redis-py installeren in Azure Cache voor Redis

Lezen en schrijven naar de cache

Voer Python uit vanaf de opdrachtregel en test uw cache met behulp van de volgende code. Vervang <Your Host Name> en <Your Access Key> door de waarden van uw Azure Cache voor Redis-instantie. Uw hostnaam heeft de indeling <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'

Belangrijk

Voor Azure Cache voor Redis versie 3.0 of hoger wordt de TLS/SSL certificaatcontrole afgedwongen. ssl_ca_certs moeten expliciet worden ingesteld wanneer u verbinding maakt met Azure Cache voor Redis. Voor RedHat Linux vindt u ssl_ca_certs in de certificaatmodule /etc/pki/tls/certs/ca-bundle.crt.

Een Python-voorbeeldapp maken

Maak een nieuw tekstbestand, voeg het volgende script toe en sla het bestand op als PythonApplication1.py. Vervang <Your Host Name> en <Your Access Key> door de waarden van uw Azure Cache voor Redis-instantie. Uw hostnaam heeft de indeling <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'])

Voer PythonApplication1.py uit met Python. Als het goed is, ziet u resultaten zoals in het volgende voorbeeld:

Python-script uitvoeren om toegang tot de cache te testen

Resources opschonen

Als u klaar bent met de Azure-resourcegroep en -resources die u hebt gemaakt in deze quickstart, kunt u ze verwijderen om kosten te voorkomen.

Belangrijk

Het verwijderen van een resourcegroep kan niet ongedaan worden gemaakt. De resourcegroep en alle bijbehorende resources worden permanent verwijderd. Als u uw Azure Cache voor Redis-exemplaar hebt gemaakt in een bestaande resourcegroep die u wilt behouden, kunt u alleen de cache wissen door Wissen te selecteren op de pagina Overzicht van de cache.

U kunt de resourcegroep en het bijbehorende Redis Cache voor Azure exemplaar als volgt verwijderen:

  1. Zoek en selecteer in Azure Portal de optie Resourcegroepen.

  2. Voer in het tekstvak Filteren op naam de naam in van de resourcegroep met uw cache-exemplaar en selecteer de naam vervolgens in de zoekresultaten.

  3. Selecteer Resourcegroep verwijderen op de pagina van de resourcegroep.

  4. Typ de naam van de resourcegroep en selecteer vervolgens Verwijderen.

    Uw resourcegroep voor Azure Cache voor Redis verwijderen

Volgende stappen