Quickstart: استخدام Azure Cache لـ Redis في Python
في هذا المقال، يمكنك دمج Azure Cache لـ Redis في تطبيق Python للوصول إلى ذاكرة تخزين مؤقت آمنة ومخصصة يمكن الوصول إليها من أي تطبيق داخل Azure.
انتقل إلى الكود على GitHub
إذا كنت ترغب في التخطي مباشرة إلى التعليمات البرمجية، فراجع التشغيل السريع الخاص بـ Python على GitHub.
المتطلبات الأساسية
- اشتراك Azure - إنشاء اشتراك مجاني
- Python 3
- بالنسبة لنظام التشغيل macOS أو Linux، قم بالتنزيل من python.org.
- بالنسبة إلى Windows 11، استخدم 'متجر Windows'.
إنشاء مثيل Azure Cache لـ Redis
لإنشاء ذاكرة تخزين مؤقت، قم بتسجيل الدخول إلى منصة Azure وحدد إنشاء مورد.
في صفحة بدء الاستخدام ، اكتب ذاكرة التخزين المؤقت Azure ل Redis في مربع البحث. وبعد ذلك، حدد إنشاء.
في صفحة New Redis Cache ، قم بتكوين إعدادات ذاكرة التخزين المؤقت.
الإعدادات اختيار قيمة الوصف الاشتراك اضغط على القائمة المنسدلة وحدد اشتراكك. الاشتراك الذي يتم بموجبه إنشاء مثيل Azure Cache الجديد لـ Redis. مجموعة الموارد حدد مجموعة موارد، أو حدد "إCreate new"، ثم أدخل اسماً فريداً لمجموعة الموارد الجديدة. اسم مجموعة الموارد المراد إنشاء ذاكرة التخزين المؤقت والموارد الأخرى فيها. وعبر وضع جميع موارد التطبيق في مجموعة موارد واحدة، يمكنك إدارتها أو حذفها بسهولة. اسم DNS أدخل اسمًا فريدًا. يجب أن يكون اسم ذاكرة التخزين المؤقت عبارة عن سلسلة بين 1 و63 حرفًا تحتوي فقط على أرقام أو أحرف أو واصلات. لا بد أن يبدأ الاسم وينتهي برقم أو حرف، ولا يمكن أن يحتوي على واصلات متتالية. اسم مضيف مثيل ذاكرة التخزين المؤقت هو <اسم DNS.redis.cache.windows.net>. Location من القائمة المنسدلة، حدد موقعاً. حدد منطقة بالقرب من الخدمات الأخرى التي تستخدم ذاكرة التخزين المؤقت. ذاكرة التخزين المؤقت SKU منسدلة وحدد SKU. تحدد SKU معلمات الحجم والأداء والميزات المتوفرة لذاكرة التخزين المؤقت. لمزيد من المعلومات، راجع Azure Cache من أجل Redis Overview. حجم ذاكرة التخزين المؤقت القائمة المنسدلة وحدد حجم ذاكرة التخزين المؤقت لمزيد من المعلومات، راجع Azure Cache من أجل Redis Overview. حدد علامة التبويب Networking أو انقر فوق زر Networking في أسفل الصفحة.
في علامة التبويب شبكة الاتصال، حدد أسلوب الاتصال.
حدد علامة التبويب Next: Advanced أو حدد الزر Next: Advanced أسفل الصفحة لمشاهدة علامة التبويب Advanced.
- بالنسبة لذاكرة التخزين المؤقت الأساسية أو القياسية، قم بتبديل التحديد لمنفذ غير TLS. يمكنك أيضا تحديد ما إذا كنت تريد تمكين مصادقة Microsoft Entra.
- بالنسبة لذاكرة التخزين المؤقت Premium، قم بتكوين الإعدادات لمنفذ غير TLS والتكتلة والهوية المدارة واستمرارية البيانات. يمكنك أيضا تحديد ما إذا كنت تريد تمكين مصادقة Microsoft Entra.
حدد علامة Next: Tags أو حدد الزر Next: Tags في أسفل الصفحة.
اختياريا، من علامة التبويب أدخل الاسم والقيمة إذا كنت ترغب في تصنيف المورد.
حدد "Review + create". يتم نقلك إلى علامة التبويب Review + create إذ يقوم Azure بالتحقق من صحة التكوين الخاص بك.
بعد ظهور رسالة "التحقق من الصحة" الخضراء، حدد إنشاء.
يستغرق إنشاء ذاكرة التخزين المؤقت بعض الوقت. يمكنك مراقبة التقدم المحرز فيAzure Cache لـصفحة Redis الخاصة بالنظرة العامة. عندما تظهر الحالة ك تشغيل، تكون ذاكرة التخزين المؤقت جاهزة للاستخدام.
استرجع اسم المضيف والمنافذ ومفاتيح الوصول من مدخل Azure
لتوصيل مخزن Azure الخاص بك لخادم Redis، يحتاج العميل المخزن إلى اسم المضيف والمنافذ ومفتاح للتخزين المؤقت. قد يشير بعض العملاء إلى هذه العناصر بأسماء مختلفة قليلًا. يمكنك الحصول على اسم المضيف والمنافذ والمفاتيح من مدخل Microsoft Azure.
للحصول على مفاتيح الوصول، حدد Authentication من قائمة Resource. ثم حدد علامة التبويب مفاتيح الوصول.
للحصول على اسم المضيف والمنافذ لذاكرة التخزين المؤقت، حدد نظرة عامة من قائمة الموارد. اسم المضيف هو من نموذج<DNS name>.redis.cache.windows.net.
تثبيت redis-py
Redis-py هي واجهة Python إلى ذاكرة تخزين Azure المؤقت لـ Redis. استخدم أداة حزم Python، pip، لتثبيت الحزمة redis-py من موجه الأوامر.
المثال التالي المستخدم pip3 ل Python 3 للتثبيت redis-py على Windows 11 من موجه أوامر مسؤول istrator.
القراءة والكتابة إلى ذاكرة التخزين المؤقت
تشغيل Python من سطر الأوامر واختبار ذاكرة التخزين المؤقت باستخدام التعليمات البرمجية التالية. استبدال <Your Host Name> و <Your Access Key> بالقيم من Azure Cache لمثيل Redis. اسم المضيف الخاص بك من النموذج <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'
هام
بالنسبة إلى Azure Cache لـ Redis الإصدار 3.0 أو أعلى، يتم فرض التحقق من شهادة TLS/SSL. ssl_ca_certs يجب تعيينه بشكل صريح عند الاتصال بذاكرة التخزين المؤقت Azure ل Redis. بالنسبة إلى RedHat Linux، ssl_ca_certs توجد في وحدة الشهادة /etc/pki/tls/certs/ca-bundle.crt .
«Create a Python sample app»
أنشئ ملفا نصيا جديدا، وأضف البرنامج النصي التالي، واحفظ الملف باسم PythonApplication1.py. استبدال <Your Host Name> و <Your Access Key> بالقيم من Azure Cache لمثيل Redis. اسم المضيف الخاص بك من النموذج <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']}")
تشغيل PythonApplication1.py مع Python. ينبغي أن ترى نتائج مشابهة للمثال التالي:
تنظيف الموارد
إذا انتهيت من مجموعة موارد Azure والموارد التي أنشأتها في هذه البداية السريعة، فإنه يمكنك حذفها لتجنب المصاريف.
هام
لا يمكن التراجع عن حذف مجموعة الموارد، ويتم حذف مجموعة الموارد وكافة الموارد الموجودة فيها نهائيًا. إذا قمت بإنشاء نمذجة لـAzure Cache لـ Redis في مجموعة موارد موجودة تريد الاحتفاظ بها، يمكنك حذف ذاكرة التخزين المؤقت فقط عن طريق تحديد حذف من صفحة نظرة عامة على ذاكرة التخزين المؤقت.
لحذف مجموعة الموارد وذاكرة التخزين المؤقت الخاصة بـ Redis لمثيل Azure:
من خلال مدخل Azure، ابحث وحدد عن مجموعات الموارد.
في مربع النص تصفية حسب الاسم، أدخل اسم مجموعة الموارد التي تحتوي على مثيل ذاكرة التخزين المؤقت، ثم حدده من نتائج البحث.
في صفحة مجموعة الموارد، حدد حذف مجموعة الموارد.
اكتب اسم مجموعة الموارد، ثم حدد حذف.
