המדיניות של 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 כדי להוסיף תווית למדיניות עורך proxy של ממשק משתמש לניהול עם שם אחר בשפה טבעית.

<DisplayName>Policy Display Name</DisplayName>

<AssignTo> רכיב

מציין את המשתנה שאליו מוקצית רשומת המטמון אחרי שהיא אוחזרת מה של Google. המשתנה חייב להיות ניתן לכתיבה. אם חיפוש המטמון לא מאחזר ערך, המשתנה לא יוגדרו.

<AssignTo>variable_to_receive_cached_value</AssignTo>

<CacheKey> רכיב

המדיניות הזו מגדירה את המיקום של מצביע ייחודי לפי חלק של נתונים ששמור במטמון.

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

<CacheKey> בונה את השם של כל פיסת נתונים המאוחסן של Google.

בזמן הריצה, הערכים של <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__deployedRevisionNumber__proxy|TargetName__ [ serializedCacheKey ].

אם רכיב <Prefix> קיים ב-<CacheKey>, הוא מחליפה ערך של רכיב <Scope>. הערכים החוקיים כוללים את המספרים שלמטה.

משתמשים ברכיב <Scope> בשילוב עם <CacheKey> וגם <Prefix> למידע נוסף, ראו עבודה עם מפתחות מטמון.

ערכים קבילים

apifactory__test__weatherapi__16__default__apiAccessToken

הערות שימוש

המדיניות הזו מאפשרת לשמור במטמון לשימוש כללי. בזמן הריצה, המדיניות LookupCache מאחזרת מהמטמון, ומקצים את הערך למשתנה שציינתם באמצעות הרכיב AssignTo (אם לא יאוחזר ערך, לא יוגדר משתנה). הוא מחפש את הערך לפי מטמון מפתח שנוצר באמצעות הגדרה שמשלבת את הרכיבים CacheKey ו-Scope. במילים אחרות, כדי לאחזר ערך מסוים שנוסף למטמון באמצעות מדיניות Populatecache, חייבים להגדיר במדיניות את הרכיבים שקשורים למפתח במטמון, באותו אופן שבו מגדירים את ה-PopulateCache המדיניות בנושא

שמירה במטמון למטרה כללית באמצעות מדיניות אכלוס המטמון, המדיניות LookupCache ומדיניות InvalidateCache משתמשת ב- מטמון שאתם מגדירים או מטמון משותף שכלול כברירת מחדל. ברוב המקרים, הפרמטר המטמון המשותף הבסיסי צריך לענות על הצרכים שלכם. כדי להשתמש במטמון ברירת המחדל צריך פשוט להשמיט הרכיב <CacheResource>.

למידע נוסף על הגדרת מטמון, ראו יצירה ועריכה של סביבה מטמון. למידע נוסף על מאגר הנתונים הבסיסי, ראו מטמון פנימי.

משתני זרימה

ניתן להשתמש במשתני זרימה כדי להגדיר התנהגות דינמית של סביבת זמן ריצה למדיניות ולתהליכים, בכותרות HTTP או בתוכן הודעה, או בהקשר שזמין בזרימה. אפשר לקבל מידע נוסף מידע על משתני זרימה, ראו משתנים .

משתני ה-flow המוגדרים מראש הבאים זמינים אחרי התאמה אישית של ההתנהגות של את המטמון שמגדירים במדיניות LookupCache.

קודי שגיאה

בקטע הזה מתוארות הודעות השגיאה ומשתני הזרימה שמוגדרים כשהמדיניות הזו גורמת לשגיאה. חשוב לדעת אם מפתחים כללים לתקלה בשרת proxy. מידע נוסף זמין במאמר מה צריך לדעת על שגיאות מדיניות ועל טיפול בפגמים.

קידומת קוד שגיאה

לא רלוונטי

שגיאות בזמן ריצה

המדיניות הזו לא גורמת לשגיאות זמן ריצה.

שגיאות בפריסה

השגיאות האלה יכולות להתרחש כשפורסים שרת proxy שכולל את המדיניות הזו.

משתני שבר

לא רלוונטי

דוגמה לשגיאה

לא רלוונטי