Rychlý start: Použití Azure Cache for Redis v Pythonu
V tomto článku zahrnete Azure Cache for Redis do aplikace v Pythonu, abyste měli přístup k zabezpečené vyhrazené mezipaměti, která je přístupná z libovolné aplikace v Azure.
Přeskočit na kód na GitHubu
Pokud chcete přeskočit přímo ke kódu, přečtěte si rychlý start Pythonu na GitHubu.
Požadavky
- Předplatné Azure – vytvoření bezplatného předplatného
- Python 3
- Pro macOS nebo Linux si stáhněte python.org.
- Pro Windows 11 použijte Windows Store.
Vytvoření instance Azure Cache for Redis
Pokud chcete vytvořit mezipaměť, přihlaste se k webu Azure Portal a vyberte Vytvořit prostředek.
Na stránce Nový vyberte Databáze a pak vyberte Azure Cache for Redis.
Na stránce New Redis Cache nakonfigurujte nastavení pro novou mezipaměť.
Nastavení Zvolit hodnotu Popis Předplatné Rozevírací seznam a vyberte své předplatné. Předplatné, ve kterém se má tato nová instance Azure Cache for Redis vytvořit. Skupina prostředků Rozevírací seznam a vyberte skupinu prostředků nebo vyberte Vytvořit novou a zadejte nový název skupiny prostředků. Název skupiny prostředků, ve které chcete vytvořit mezipaměť a další prostředky. Když umístíte všechny prostředky aplikace do jedné skupiny prostředků, můžete je snadno spravovat nebo odstraňovat společně. Název DNS Zadejte jedinečný název. Název mezipaměti musí být řetězec mezi 1 a 63 znaky, který obsahuje pouze číslice, písmena nebo pomlčky. Název musí začínat a končit číslicí nebo písmenem a nesmí obsahovat po sobě jdoucí pomlčky. Název hostitele vaší instance mezipaměti je< NÁZEV> DNS.redis.cache.windows.net. Místo Rozevírací seznam a výběr umístění Vyberte oblast poblíž jiných služeb, které používají vaši mezipaměť. Typ mezipaměti Rozevírací seznam a výběr úrovně Úroveň určuje velikost, výkon a funkce, které jsou k dispozici pro mezipaměť. Další informace najdete v tématu Přehled služby Azure Cache for Redis. Vyberte kartu Sítě nebo vyberte tlačítko Sítě v dolní části stránky.
Na kartě Sítě vyberte metodu připojení.
Vyberte kartu Další: Upřesnit nebo vyberte tlačítko Další: Upřesnit v dolní části stránky a zobrazte kartu Upřesnit.
- U mezipamětí Basic nebo Standard přepněte výběr pro port, který není tls. Můžete také vybrat, jestli chcete povolit ověřování Microsoft Entra.
- Pro mezipaměť Premium nakonfigurujte nastavení pro port bez protokolu TLS, clustering, spravovanou identitu a trvalost dat. Můžete také vybrat, jestli chcete povolit ověřování Microsoft Entra.
Vyberte kartu Další: Značky nebo vyberte tlačítko Další: Značky v dolní části stránky.
Volitelně můžete na kartě Značky zadat název a hodnotu, pokud chcete prostředek zařadit do kategorií.
Vyberte Zkontrolovat a vytvořit. Přejdete na kartu Zkontrolovat a vytvořit, kde Azure ověří vaši konfiguraci.
Jakmile se zobrazí zelená zpráva o úspěšném ověření, vyberte Vytvořit.
Vytvoření mezipaměti chvíli trvá. Průběh můžete sledovat na stránce Přehled služby Azure Cache for Redis. Když se stav zobrazí jako Spuštěno, je mezipaměť připravená k použití.
Načtení názvu hostitele, portů a přístupových klíčů z webu Azure Portal
K připojení serveru Azure Cache for Redis potřebuje klient mezipaměti název hostitele, porty a klíč pro mezipaměť. Někteří klienti mohou tyto položky označovat trochu odlišnými názvy. Název hostitele, porty a klíče můžete získat z webu Azure Portal.
Přístupové klíče získáte tak, že v levém navigačním panelu mezipaměti vyberete Přístupové klíče.
Pokud chcete získat název hostitele a porty, v levém navigačním panelu mezipaměti vyberte Vlastnosti. Název hostitele je ve formátu DNS name.redis.cache.windows.net>.<
Instalace redis-py
Redis-py je rozhraní Pythonu pro Azure Cache for Redis. Pomocí nástroje pipBalíčky Pythonu redis-py nainstalujte balíček z příkazového řádku.
Následující příklad použitý pip3 pro Python 3 k instalaci redis-py do Windows 11 z příkazového řádku Správa istrator.
Čtení z mezipaměti a zápis do mezipaměti
Spusťte Python z příkazového řádku a otestujte mezipaměť pomocí následujícího kódu. Nahraďte <Your Host Name> hodnoty z vaší instance Azure Cache for Redis a <Your Access Key> nahraďte je. Název vašeho hostitele je ve formuláři <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'
Důležité
U služby Azure Cache for Redis verze 3.0 nebo vyšší se vynucuje kontrola certifikátu TLS/SSL. ssl_ca_certs při připojování ke službě Azure Cache for Redis musí být explicitně nastavená. Pro RedHat Linux ssl_ca_certs se nachází v /etc/pki/tls/certs/ca-bundle.crt modulu certifikátů.
Vytvoření ukázkové aplikace v Pythonu
Vytvořte nový textový soubor, přidejte následující skript a uložte ho jako PythonApplication1.py. Nahraďte <Your Host Name> hodnoty z vaší instance Azure Cache for Redis a <Your Access Key> nahraďte je. Název vašeho hostitele je ve formuláři <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']}")
Spusťte PythonApplication1.py s Pythonem. Měli byste vidět výsledky jako v následujícím příkladu:
Vyčištění prostředků
Pokud jste dokončili skupinu prostředků Azure a prostředky, které jste vytvořili v tomto rychlém startu, můžete je odstranit, abyste se vyhnuli poplatkům.
Důležité
Odstranění skupiny prostředků je nevratné a skupina prostředků a všechny prostředky v ní se trvale odstraní. Pokud jste instanci Azure Cache for Redis vytvořili v existující skupině prostředků, kterou chcete zachovat, můžete odstranit pouze mezipaměť výběrem možnosti Odstranit ze stránky Přehled mezipaměti.
Odstranění skupiny prostředků a její instance Redis Cache pro Azure:
Na webu Azure Portal vyhledejte a vyberte skupiny prostředků.
Do textového pole Filtrovat podle názvu zadejte název skupiny prostředků, která obsahuje instanci mezipaměti, a pak ji vyberte z výsledků hledání.
Na stránce skupiny prostředků vyberte Odstranit skupinu prostředků.
Zadejte název skupiny prostředků a pak vyberte Odstranit.
