إضافة التخزين المؤقت لتحسين الأداء في Azure API Management

ينطبق على: المطور | أساسي | الإصدار 2 الأساسي | قياسي | الإصدار 2 القياسي | بريميوم

يمكن تكوين واجهات برمجة التطبيقات والعمليات في API Management مع تخزين مؤقت للاستجابة. التخزين المؤقت للاستجابة يمكن أن يقلل بشكل ملحوظ من زمن الانتقال لمستدعي واجهات برمجة التطبيقات وحمل الخلفية لموفري واجهات برمجة التطبيقات.

هام

تتسم ذاكرة التخزين المؤقت المدمجة بأنها متغيرة وتتم مشاركتها من قِبل كافة الوحدات الموجودة في نفس المنطقة داخل نفس خدمة API Management. بغض النظر عن نوع ذاكرة التخزين المؤقت المستخدمة (الداخلية أو الخارجية)، إذا فشلت العمليات المتعلقة بذاكرة التخزين المؤقت في الاتصال بذاكرة التخزين المؤقت بسبب تقلبات ذاكرة التخزين المؤقت أو أي سبب آخر، فإن استدعاء واجهة برمجة التطبيقات الذي يستخدم العملية المتعلقة بذاكرة التخزين المؤقت لا يثير خطأ، وتكتمل عملية ذاكرة التخزين المؤقت بنجاح. في حالة عملية القراءة، يتم إرجاع قيمة خالية إلى تعبير نهج الاستدعاء. يجب تصميم التعليمات البرمجية للنهج للتأكد من وجود آلية "احتياطية" لاسترداد البيانات غير الموجودة في ذاكرة التخزين المؤقت. للمزيد من المعلومات التفصيلية حول التخزين المؤقت، راجع سياسات APIM للتخزين المؤقت و التخزين المؤقت المخصص في APIM.

نُهج ذاكرات التخزين المؤقت

ستتعلم كيفية:

  • إضافة تخزين مؤقت للاستجابة من أجل واجهة برمجة التطبيقات الخاصة بك
  • التحقق من التخزين المؤقت في أثناء العمل

إشعار

ذاكرة التخزين المؤقت الداخلية غير متوفرة في مستوى الاستهلاك من Azure API Management. ويمكنك استخدام Azure Cache for Redis خارجية بدلاً من ذلك. يمكنك أيضا تكوين ذاكرة تخزين مؤقت خارجية في مستويات خدمة APIM الأخرى.

المتطلبات الأساسية

لإكمال هذا البرنامج التعليمي:

إضافة نهج التخزين المؤقت

مع نُهج التخزين المؤقت الموضحة في هذا المثال، يقوم أول طلب لعملية GetSpeakers بإرجاع استجابة من الخدمة الخلفية. يتم تخزين هذه الاستجابة مؤقتًا، وتمييزها بمفاتيح بواسطة العناوين ومعلمات سلسلة الاستعلام المحددة. وسيتم إرجاع الاستجابة المخزنة مؤقتًا في الاستدعاءات اللاحقة للعملية، مع معلمات مطابقة، حتى تنتهي صلاحية الفاصل الزمني لمدة ذاكرة التخزين المؤقت.

  1. قم بتسجيل الدخول إلى بوابة Azure.

  2. استعرض للوصول إلى مثيل APIM الخاص بك.

  3. حدد علامة التبويب API.

  4. حدد Demo Conference API من قائمة واجهة برمجة التطبيقات الخاصة بك.

  5. حدد "GetSpeakers".

  6. في أعلى الشاشة، حدد علامة التبويب Design.

  7. في قسم Inbound processing، انقر فوق أيقونة </>.

    محرر التعليمات البرمجية

  8. في العنصر الوارد، أضف النهج التالي:

    <cache-lookup vary-by-developer="false" vary-by-developer-groups="false">
        <vary-by-header>Accept</vary-by-header>
        <vary-by-header>Accept-Charset</vary-by-header>
        <vary-by-header>Authorization</vary-by-header>
    </cache-lookup>
    
  9. في العنصر الصادر، أضف النهج التالي:

    <cache-store duration="20" />
    

    تحدد المدة الفاصل الزمني لانتهاء صلاحية الاستجابات المخزنة مؤقتًا. في هذا المثال، الفاصل الزمني هو 20 ثانية.

تلميح

إذا كنت تستخدم ذاكرة تخزين مؤقت خارجية، كما هو موضح في استخدام Azure Cache for Redis خارجية في Azure API Management، فقد تحتاج إلى تحديد سمة caching-type لنُهج التخزين المؤقت. راجع نُهج التخزين المؤقت لـ API Management للحصول على مزيد من التفاصيل.

استدعاء عملية واختبار التخزين المؤقت

لمشاهدة التخزين المؤقت في أثناء العمل، قم باستدعاء العملية من مدخل المطور.

  1. في مدخل Azure، استعرض للوصول إلى مثيل APIM الخاص بك.
  2. حدد علامة التبويب APIs.
  3. حدد واجهة برمجة التطبيقات التي قمت بإضافة نُهج التخزين المؤقت إليها.
  4. حدد عملية GetSpeakers.
  5. انقر فوق علامة التبويب Test في أعلى القائمة اليمنى.
  6. اضغط Send.

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