مشاركة عبر


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

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

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

هام

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

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

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

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

إشعار

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

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

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

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

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

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

  2. استعرض للوصول إلى مثيل إدارة واجهة برمجة التطبيقات.

  3. حدد واجهات برمجة التطبيقات APIs> من القائمة على اليسار.

  4. حدد واجهة برمجة التطبيقات التي تريد تكوين التخزين المؤقت لها.

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

  6. في قسم Inbound processing، حدد أيقونة </>. لقطة شاشة لمحرر نهج إدارة واجهة برمجة التطبيقات في المدخل.

  7. في inbound العنصر ، أضف النهج التالي:

    <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>
    
  8. في outbound العنصر ، أضف النهج التالي:

    <cache-store duration="20" />
    

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

تلميح

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

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

لمشاهدة التخزين المؤقت قيد التنفيذ، قم باستدعاء عملية من المدخل.

  1. في مدخل Microsoft Azure، استعرض للوصول إلى مثيل APIM.
  2. حدد واجهات برمجة التطبيقات APIs> من القائمة على اليسار.
  3. حدد واجهة برمجة التطبيقات التي قمت بإضافة نُهج التخزين المؤقت إليها.
  4. حدد عملية لاختبارها.
  5. حدد علامة التبويب Test في القائمة العلوية اليسرى.
  6. حدد تتبع مرتين أو ثلاث مرات في تتابع سريع.
  7. ضمن استجابة HTTP، حدد علامة التبويب تتبع.
  8. انتقل إلى القسم الوارد وقم بالتمرير إلى النهج cache-lookup . يجب أن تشاهد رسالة مشابهة لرسالة في لقطة الشاشة التالية، تشير إلى وصول ذاكرة التخزين المؤقت: لقطة شاشة للبحث عن ذاكرة التخزين المؤقت عند اختبار واجهة برمجة تطبيقات في المدخل.