مكتبات عميل Azure Managed Redis

تساعدك هذه المقالة في اختيار واستخدام أفضل مكتبات العملاء ل Azure Managed Redis. تتعلم أي المكتبات تستخدمها للغة البرمجة، وكيفية التعامل مع سياسات التجميع، وتتجنب مشاكل الاتصال الشائعة.

يستند Azure Managed Redis إلى مخزن البيانات الشائع في الذاكرة، Redis. يمكن لعملاء Redis للعديد من لغات البرمجة الوصول إلى Azure Managed Redis. تحتوي كل مكتبة عميل على واجهة برمجة تطبيقات خاصة بها تجري مكالمات إلى خادم Redis باستخدام أوامر Redis، ولكن تم إنشاء مكتبات العميل للتحدث إلى أي خادم Redis.

تحتفظ كل مكتبة عميل بالوثائق المرجعية الخاصة بها. توفر المكتبات أيضا ارتباطات للحصول على الدعم من خلال مجتمع مطوري مكتبة العميل. لا يمتلك فريق Azure Managed Redis التطوير أو الدعم لأي مكتبات عميل.

تستند التوصيات التالية إلى الشعبية وما إذا كان هناك مجتمع نشط عبر الإنترنت لدعم أسئلتك والإجابة عليها. نوصي فقط باستخدام أحدث إصدار متوفر، والترقية بانتظام مع توفر الإصدارات الجديدة. هذه المكتبات قيد التطوير النشط وغالبًا ما تصدر إصدارات جديدة مع تحسينات على الموثوقية والأداء.

مكتبة العميل لغة مستودع GitHub الوثائق
StackExchange.Redis C#/.NET StackExchange.Redis GitHub مستندات StackExchange.Redis
خس جاوة خس GitHub توثيق الخس
Jedis جاوة جيديز GitHub توثيق الجيداي
node_redis Node.js node_redis GitHub node_redis الوثائق
ioredis Node.js ioredis GitHub مرجع IOREDIS API

ملاحظة

يمكن لتطبيقك استخدام أي مكتبة عميل متوافقة مع Redis مفتوح المصدر للاتصال بمثيل Azure Managed Redis الخاص بك.

اختيار مكتبة العميل المناسبة استنادا إلى نهج التجميع الخاص بك

يدعم Azure Managed Redis نهج تجميع المؤسسات ونهج تجميع OSS. راجع المزيد من المعلومات هنا (إضافة ارتباط إلى معلومات نهج التجميع).

تعمل جميع مكتبات العميل مع مثيل Redis الخاص بك مع نهج تجميع المؤسسات. ومع ذلك، إذا كنت تستخدم سياسة تجميع OSS، تأكد من أن مكتبة العميل المحددة تدعم الاتصال بمثيلات Redis المجمعة.

الأوامر المحظورة

تدير Microsoft تكوين وإدارة مثيلات Azure Managed Redis، والتي تعطل الأوامر التالية بشكل افتراضي. لمزيد من المعلومات حول الأوامر المحظورة، راجع توافق أوامر إدارة نظام المجموعة

أوامر متعددة المفاتيح

نظرا لأن مثيلات AMR تستخدم تكوينا متفاوت المسافات، فقد ترى CROSSSLOT استثناءات على الأوامر التي تعمل على مفاتيح متعددة. يختلف السلوك اعتمادا على نهج التجميع المستخدم. إذا كنت تستخدم نهج تجميع OSS، تتطلب الأوامر متعددة المفاتيح تعيين جميع المفاتيح إلى نفس فتحة التجزئة.

قد ترى CROSSSLOT أيضا أخطاء في نهج تجميع المؤسسات. يسمح فقط بالأوامر متعددة المفاتيح التالية عبر الفتحات مع تجميع المؤسسة: DELوMSETMGETEXISTSUNLINK.TOUCH

في قواعد البيانات Active-Active، يمكن تشغيل أوامر الكتابة متعددة المفاتيح (DEL، ، MSETUNLINK) فقط على المفاتيح الموجودة في نفس الفتحة. ومع ذلك، يسمح بالأوامر متعددة المفاتيح التالية عبر الفتحات في قواعد البيانات Active-Active: MGETو EXISTSو TOUCH. لمزيد من المعلومات، راجع تجميع قاعدة البيانات.

الأوامر المحظورة لنهج تجميع المؤسسات

  • معلومات نظام المجموعة
  • تعليمات نظام المجموعة
  • فتحة مفاتيح العنقود
  • عقد نظام المجموعة
  • فتحات نظام المجموعة

الأوامر المحظورة للنسخ المتماثل الجغرافي النشط

  • FLUSHALL
  • FLUSHDB

إرشادات خاصة بمكتبة العميل

اختر لغة البرمجة الخاصة بك للحصول على أفضل الممارسات التفصيلية وإرشادات الاتصال:

كيفية استخدام مكتبات العميل

بالإضافة إلى الوثائق المرجعية، يمكنك العثور على برامج تعليمية توضح كيفية بدء استخدام Azure Managed Redis باستخدام لغات مختلفة وعملاء ذاكرة التخزين المؤقت.

لمزيد من المعلومات حول استخدام بعض مكتبات العملاء هذه في البرامج التعليمية، راجع المقالات التالية:

الخطوات التالية