سياسة LookupCache

أنت تطّلع على مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. info

يضبط كيفية استرداد القيم المخزّنة مؤقتًا في وقت التشغيل.

صُمّمت هذه السياسة للاستخدام في التخزين المؤقت قصير الأمد للأغراض العامة. ويتم استخدامه مع سياسة ملء ذاكرة التخزين المؤقت (لكتابة الإدخالات) وسياسة إلغاء صلاحية ذاكرة التخزين المؤقت (لإلغاء صلاحية الإدخالات).

لتخزين الردود من موارد الخلفية، يُرجى الاطّلاع على سياسة ذاكرة التخزين المؤقت للردود.

مرجع العنصر

في ما يلي قائمة بالعناصر التي يمكنك ضبطها في هذه السياسة.

<LookupCache async="false" continueOnError="false" enabled="true" name="Lookup-Cache-1">
    <DisplayName>Lookup Cache 1</DisplayName>
    <Properties/>
    <CacheKey>
        <Prefix/>
        <KeyFragment ref=""/>
    </CacheKey>
    <!-- Omit this element if you're using the included shared cache. -->
    <CacheResource/>
    <CacheLookupTimeoutInSeconds/>
    <Scope>Exclusive</Scope>
    <AssignTo>flowVar</AssignTo>
</LookupCache>

يتم تضمين ذاكرة تخزين مؤقت مشتركة تلقائيًا. لاستخدام ذاكرة التخزين المؤقت المشتركة، احذف العنصر <CacheResource> في إعدادات هذه السياسة.

لمزيد من المعلومات عن "مخزّن البيانات الأساسي"، يُرجى الاطّلاع على الجانب الداخلي لذاكرة التخزين المؤقت. لمزيد من المعلومات عن ضبط ملفّات cache، يُرجى الاطّلاع على إنشاء ملف cache لبيئة وتعديله.

سمات <LookupCache>

يصف الجدول التالي السمات المشتركة بين جميع العناصر الرئيسية للسياسة:

&lt;DisplayName&gt; عنصر

استخدِمه مع السمة name لتصنيف السياسة في إدارة خادم وكيل لواجهة المستخدم باسم مختلف بلغة طبيعية.

<DisplayName>Policy Display Name</DisplayName>

عنصر <AssignTo>

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

<AssignTo>variable_to_receive_cached_value</AssignTo>

عنصر <CacheKey>

لضبط مؤشر فريد لجزء من البيانات المخزّنة في ذاكرة التخزين المؤقت

<CacheKey>
    <Prefix>string</Prefix>
    <KeyFragment ref="variable_name" />
    <KeyFragment>literal_string</KeyFragment>
</CacheKey>

<CacheKey> ينشئ اسم كل جزء من البيانات المخزّنة في ذاكرة التخزين المؤقت.

أثناء التشغيل، يتمّ وضع قيمة <KeyFragment> في بداية القيمة إما <Scope> أو قيمة <Prefix>. على سبيل المثال، يؤدي الرمز التالي إلى إنشاء مفتاح ذاكرة التخزين المؤقت التالي: UserToken__apiAccessToken__<value_of_client_id>:

<CacheKey>
    <Prefix>UserToken</Prefix>
    <KeyFragment>apiAccessToken</KeyFragment>
    <KeyFragment ref="request.queryparam.client_id" />
</CacheKey>

استخدام العنصر <CacheKey> مع <Prefix> و<Scope> لمزيد من المعلومات، يُرجى الاطّلاع على العمل مع مفاتيح ذاكرة التخزين المؤقت.

عنصر <CacheLookupTimeoutInSeconds>

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

<CacheLookupTimeoutInSeconds>30</CacheLookupTimeoutInSeconds>

العنصر<CacheResource>

تُحدِّد ذاكرة التخزين المؤقت التي يجب تخزين الرسائل فيها.

وزِل هذا العنصر بالكامل إذا كانت هذه السياسة (وسياسةَا PopulateCache و InvalidateCache المقابلة) تستخدما ذاكرة التخزين المؤقت المشترَكة المضمّنة.

<CacheResource>cache_to_use</CacheResource>

لمزيد من المعلومات عن ضبط ذاكرات التخزين المؤقت، يُرجى الاطّلاع على مقالة إنشاء ذاكرة تخزين مؤقت للبيئة وتعديلها.

عنصر <CacheKey>/<KeyFragment>

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

<KeyFragment ref="variable_name"/>
<KeyFragment>literal_string</KeyFragment>

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

<KeyFragment>apiAccessToken</KeyFragment>
<KeyFragment ref="request.queryparam.client_id" />

استخدام العنصر <KeyFragment> مع <Prefix> و<Scope> لمزيد من المعلومات، يُرجى الاطّلاع على العمل مع مفاتيح ذاكرة التخزين المؤقت.

السمات

عنصر <CacheKey>/<Prefix>

تُحدِّد قيمة لاستخدامها كبادئة لمفتاح ذاكرة التخزين المؤقت.

<Prefix>prefix_string</Prefix>

استخدِم هذه القيمة بدلاً من <Scope> عندما تريد تحديد قيمة خاصة بك بدلاً من قيمة مُدرَجة في <Scope>. في حال تحديده، تُضاف قيمة مفتاح ذاكرة التخزين المؤقت إلى <Prefix> في بداية الإدخالات التي يتم كتابتها في ذاكرة التخزين المؤقت. تلغي قيمة <Prefix> قيمة <Scope>.

استخدام العنصر <Prefix> مع <CacheKey> و<Scope> لمزيد من المعلومات، يُرجى الاطّلاع على العمل مع مفاتيح ذاكرة التخزين المؤقت.

عنصر <Scope>

قائمة تستخدم لإنشاء بادئة لمفتاح ذاكرة التخزين المؤقت في حال عدم توفّر عنصر <Prefix> في عنصر <CacheKey>.

<Scope>scope_enumeration</Scope>

يحدِّد الإعداد <Scope> مفتاح ذاكرة التخزين المؤقت الذي يتمّ إضافته في المقدّمة وفقًا لقيمة <Scope>. على سبيل المثال، سيأخذ مفتاح ذاكرة التخزين المؤقت الشكل التالي عند ضبط النطاق على Exclusive : orgName__envName__applicationName__proxy|TargetName__ [ serializedCacheKey ].

إذا كان عنصر <Prefix> متوفّرًا في <CacheKey>، فإنه سيحلّ محلّ قيمة عنصر <Scope>. تشمل القيم الصالحة التعدادات التالية: .

استخدام العنصر <Scope> مع <CacheKey> و<Prefix> لمزيد من المعلومات، يُرجى الاطّلاع على العمل مع مفاتيح ذاكرة التخزين المؤقت.

القِيم المقبولة

apifactory__test__weatherapi__16__default__apiAccessToken

ملاحظات الاستخدام

استخدِم هذه السياسة لتخزين مؤقت للأغراض العامة. في وقت التشغيل، تسترجع سياسة LookupCache قيمة من ذاكرة التخزين المؤقت، وتخصّص القيمة للمتغيّر الذي تحدّده باستخدام عنصر AssignTo (إذا لم يتم استرداد أي قيمة، لن يتم ضبط المتغيّر). ويبحث عن القيمة استنادًا إلى مفتاح ملف التخزين المؤقت الذي تم إنشاؤه من خلال الإعدادات التي تجمع بين عنصرَي CacheKey وScope. بعبارة أخرى، لاسترداد قيمة معيّنة تمت إضافتها إلى ذاكرة التخزين المؤقت من خلال سياسة PopulateCache، يجب أن تتضمّن سياسة LookupCache عناصر ذات صلة بمفتاح ذاكرة التخزين المؤقت تم ضبطها بالطريقة نفسها التي تم ضبط سياسة PopulateCache بها.

إنّ ميزة التخزين المؤقت للأغراض العامة باستخدام سياسة تعبئة ذاكرة التخزين المؤقت، وسياسة LookupCache، وسياسة InvalidateCache تستخدم إما ذاكرة تخزين مؤقت تضبطها أو ذاكرة تخزين مؤقت مشتركة يتم تضمينها تلقائيًا. في معظم الحالات، يجب أن تلبي ذاكرة التخزين المؤقت المشتركة الأساسية احتياجاتك. لاستخدام ذاكرة التخزين المؤقت التلقائية، ما عليك سوى حذف العنصر <CacheResource>.

لمزيد من المعلومات عن ضبط ذاكرات التخزين المؤقت، يُرجى الاطّلاع على مقالة إنشاء ذاكرة تخزين مؤقت للبيئة وتعديلها. لمزيد من المعلومات عن "مخزّن البيانات الأساسي"، يُرجى الاطّلاع على الجانب الداخلي لذاكرة التخزين المؤقت.

متغيّرات التدفق

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

تتوفّر متغيّرات Flow المحدّدة مسبقًا التالية بعد تخصيص سلوك ملف التخزين المؤقت الذي تحدّده في سياسة LookupCache.

رموز الخطأ

يوضِّح هذا القسم رسائل الخطأ ومتغيّرات التدفق التي يتم تحديدها عندما تؤدي هذه السياسة إلى ظهور خطأ. هذه المعلومات مهمة لمعرفة ما إذا كنت تعمل على تطوير قواعد خطأ لخادم وكيل. لمزيد من المعلومات، يمكنك الاطّلاع على المعلومات التي يجب معرفتها عن الأخطاء المتعلقة بالسياسات وأخطاء المعالجة.

بادئة رمز الخطأ

لا ينطبق

أخطاء في وقت التشغيل

لا تؤدي هذه السياسة إلى حدوث أي أخطاء في وقت التشغيل.

أخطاء النشر

يمكن أن تحدث هذه الأخطاء عند نشر خادم وكيل يحتوي على هذه السياسة.

متغيرات الخطأ

لا ينطبق

مثال على الردّ على الخطأ

لا ينطبق