سياسة LookupCache

أنت تعرض مستندات Apigee Edge.
انتقل إلى مستندات Apigee X. معلومات

تحدِّد هذه السياسة طريقة استرداد القيم المخزَّنة مؤقتًا في وقت التشغيل.

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

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

مرجع العنصر

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

<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> في إعدادات السياسة هذه.

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

<LookupCache> السمات

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

<DisplayName> عنصر

استخدِمه مع السمة 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 المقابلة لها سياسات Badatecache) تستخدم ذاكرة التخزين المؤقت المشتركة المضمنة.

<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__deployedRevisionNumber__proxy|TargetName__ [ serializedCacheKey ].

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

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

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

apifactory__test__weatherapi__16__default__apiAccessToken

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

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

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

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

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

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

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

رموز الخطأ

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

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

لا ينطبق

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

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

أخطاء النشر

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

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

لا ينطبق

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

لا ينطبق