LookupCache নীতি

আপনি Apigee Edge-এর ডকুমেন্টেশন দেখছেন।
Apigee X ডকুমেন্টেশন .info- তে যান।

রানটাইমে ক্যাশ করা মানগুলো কীভাবে পুনরুদ্ধার করা হবে তা নির্ধারণ করে।

এই পলিসিটি সাধারণ স্বল্পমেয়াদী ক্যাশিং-এর জন্য ব্যবহৃত হয়। এটি Populate Cache পলিসি (এন্ট্রি লেখার জন্য) এবং Invalidate Cache পলিসি (এন্ট্রি বাতিল করার জন্য) এর সাথে একত্রে ব্যবহৃত হয়।

ব্যাকএন্ড রিসোর্সগুলির প্রতিক্রিয়া ক্যাশ করার জন্য, রেসপন্স ক্যাশ পলিসি দেখুন।

উপাদান রেফারেন্স

এই পলিসিতে আপনি যে উপাদানগুলো কনফিগার করতে পারেন, তার তালিকা নিচে দেওয়া হলো।

<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> এলিমেন্টটি বাদ দিন।

অন্তর্নিহিত ডেটা স্টোর সম্পর্কে আরও জানতে, ক্যাশ ইন্টারনালস দেখুন। ক্যাশ কনফিগার করা সম্পর্কে আরও জানতে, এনভায়রনমেন্ট ক্যাশ তৈরি এবং সম্পাদনা দেখুন।

<লুকআপক্যাশ> অ্যাট্রিবিউট

নিম্নলিখিত সারণী সমস্ত নীতির মূল উপাদানগুলির জন্য সাধারণ বৈশিষ্ট্যগুলি বর্ণনা করে:

<DisplayName> উপাদান

ম্যানেজমেন্ট UI প্রক্সি এডিটরে নীতিটিকে একটি ভিন্ন, প্রাকৃতিক-ভাষা নামের সাথে লেবেল করতে name বৈশিষ্ট্য ছাড়াও ব্যবহার করুন।

<DisplayName>Policy Display Name</DisplayName>

<AssignTo> উপাদান

ক্যাশ থেকে ক্যাশ এন্ট্রি পুনরুদ্ধার করার পর যে ভেরিয়েবলে তা বরাদ্দ করা হবে, তা নির্দিষ্ট করে। ভেরিয়েবলটি অবশ্যই রাইটেবল (writable) হতে হবে। যদি ক্যাশ লুকআপ কোনো মান পুনরুদ্ধার না করে, তাহলে ভেরিয়েবলটি সেট করা হবে না।

<AssignTo>variable_to_receive_cached_value</AssignTo>

<ক্যাশকী> উপাদান

ক্যাশে সংরক্ষিত কোনো ডেটার জন্য একটি অনন্য পয়েন্টার কনফিগার করে।

<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>

<ক্যাশরিসোর্স> উপাদান

বার্তাগুলো কোন ক্যাশেতে সংরক্ষণ করা হবে তা নির্দিষ্ট করে।

এই পলিসি (এবং আপনার সংশ্লিষ্ট 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> এর সাথে একত্রে ব্যবহার করেন। আরও তথ্যের জন্য, “ক্যাশ কী নিয়ে কাজ করা” দেখুন।

বৈশিষ্ট্য

<ক্যাশকী>/<প্রিফিক্স> উপাদান

ক্যাশ কী প্রিফিক্স হিসেবে ব্যবহার করার জন্য একটি মান নির্দিষ্ট করে।

<Prefix>prefix_string</Prefix>

যখন আপনি <Scope> দ্বারা তালিকাভুক্ত কোনো মানের পরিবর্তে আপনার নিজস্ব মান নির্দিষ্ট করতে চান, তখন <Scope> -এর বদলে এই মানটি ব্যবহার করুন। যদি সংজ্ঞায়িত করা থাকে, তাহলে <Prefix> ক্যাশে লেখা এন্ট্রিগুলির শুরুতে ক্যাশে কী-এর মান যুক্ত করে। একটি <Prefix> এলিমেন্টের মান একটি <Scope> এলিমেন্টের মানকে ওভাররাইড করে।

আপনি <Prefix> এলিমেন্টটি <CacheKey> এবং <Scope> এর সাথে একত্রে ব্যবহার করেন। আরও তথ্যের জন্য, “Working with cache keys” দেখুন।

<Scope> উপাদান

যখন <CacheKey> এলিমেন্টে কোনো <Prefix> এলিমেন্ট প্রদান করা হয় না, তখন ক্যাশ কী-এর জন্য একটি প্রিফিক্স তৈরি করতে এই এনুমারেশনটি ব্যবহৃত হয়।

<Scope>scope_enumeration</Scope>

<Scope> সেটিংটি একটি ক্যাশ কী নির্ধারণ করে, যা <Scope> ভ্যালু অনুযায়ী শুরুতে যুক্ত হয়। উদাহরণস্বরূপ, যখন স্কোপ Exclusive এ সেট করা থাকে, তখন একটি ক্যাশ কী-এর রূপটি হবে নিম্নরূপ: orgName__envName__ application Name__proxy|TargetName__ [ serializedCacheKey ]।

<CacheKey> তে যদি একটি <Prefix> এলিমেন্ট থাকে, তবে তা <Scope> এলিমেন্টের মানকে বাতিল করে দেয়। বৈধ মানগুলোর মধ্যে নিচের এনুমারেশনগুলো অন্তর্ভুক্ত।

আপনি <Scope> এলিমেন্টটি <CacheKey> এবং <Prefix> এর সাথে একত্রে ব্যবহার করেন। আরও তথ্যের জন্য, “Working with cache keys” দেখুন।

গ্রহণযোগ্য মান

apifactory__test__weatherapi__16__default__apiAccessToken

ব্যবহারের নির্দেশাবলী

সাধারণ ক্যাশিংয়ের জন্য এই পলিসিটি ব্যবহার করুন। রানটাইমে, LookupCache পলিসিটি ক্যাশ থেকে একটি ভ্যালু পুনরুদ্ধার করে এবং AssignTo এলিমেন্টের মাধ্যমে আপনার নির্দিষ্ট করা ভেরিয়েবলে সেই ভ্যালুটি অ্যাসাইন করে (যদি কোনো ভ্যালু পুনরুদ্ধার না করা হয়, তাহলে ভেরিয়েবলটি সেট করা হবে না)। এটি CacheKey এবং Scope এলিমেন্টগুলোকে একত্রিত করে কনফিগারেশনের মাধ্যমে তৈরি একটি ক্যাশ কী-এর উপর ভিত্তি করে ভ্যালুটি খোঁজে। অন্য কথায়, PopulateCache পলিসি দ্বারা ক্যাশে যোগ করা একটি নির্দিষ্ট ভ্যালু পুনরুদ্ধার করতে হলে, আপনার LookupCache পলিসিতে অবশ্যই PopulateCache পলিসির মতোই ক্যাশ কী-সম্পর্কিত এলিমেন্টগুলো কনফিগার করা থাকতে হবে।

Populate Cache পলিসি , LookupCache পলিসি এবং InvalidateCache পলিসির সাথে সাধারণ ক্যাশিং-এর জন্য হয় আপনার কনফিগার করা কোনো ক্যাশ অথবা ডিফল্টভাবে অন্তর্ভুক্ত কোনো শেয়ার্ড ক্যাশ ব্যবহার করা হয়। বেশিরভাগ ক্ষেত্রে, অন্তর্নিহিত শেয়ার্ড ক্যাশটিই আপনার প্রয়োজন মেটানোর জন্য যথেষ্ট হওয়া উচিত। ডিফল্ট ক্যাশ ব্যবহার করার জন্য, কেবল <CacheResource> এলিমেন্টটি বাদ দিন।

ক্যাশে কনফিগার করার বিষয়ে আরও জানতে, “একটি এনভায়রনমেন্ট ক্যাশে তৈরি এবং সম্পাদনা করা” দেখুন। অন্তর্নিহিত ডেটা স্টোর সম্পর্কে আরও জানতে, “ক্যাশের অভ্যন্তরীণ বিষয়াবলী” দেখুন।

প্রবাহ পরিবর্তনশীল

HTTP হেডার বা মেসেজের বিষয়বস্তু, অথবা ফ্লো-তে উপলব্ধ কনটেক্সটের উপর ভিত্তি করে পলিসি এবং ফ্লো-এর জন্য ডাইনামিক রানটাইম আচরণ কনফিগার করতে ফ্লো ভেরিয়েবল ব্যবহার করা যেতে পারে। ফ্লো ভেরিয়েবল সম্পর্কে আরও তথ্যের জন্য, ভেরিয়েবল রেফারেন্স দেখুন।

একটি LookupCache পলিসিতে আপনার সংজ্ঞায়িত ক্যাশের আচরণ কাস্টমাইজ করার পর নিম্নলিখিত পূর্বনির্ধারিত ফ্লো ভেরিয়েবলগুলো উপলব্ধ হয়।

ত্রুটি কোড

এই বিভাগে ত্রুটির বার্তা এবং ফ্লো ভেরিয়েবলগুলি বর্ণনা করে যেগুলি সেট করা হয় যখন এই নীতিটি একটি ত্রুটি ট্রিগার করে৷ আপনি একটি প্রক্সির জন্য ত্রুটির নিয়ম তৈরি করছেন কিনা তা জানার জন্য এই তথ্যটি গুরুত্বপূর্ণ৷ আরও জানতে, নীতিগত ত্রুটি এবং হ্যান্ডলিং ফল্ট সম্পর্কে আপনার যা জানা দরকার তা দেখুন৷

ত্রুটি কোড উপসর্গ

N/A

রানটাইম ত্রুটি

এই নীতি কোনো রানটাইম ত্রুটি নিক্ষেপ না.

স্থাপনার ত্রুটি

আপনি যখন এই নীতি সম্বলিত একটি প্রক্সি স্থাপন করেন তখন এই ত্রুটিগুলি ঘটতে পারে৷

ফল্ট ভেরিয়েবল

N/A

উদাহরণ ত্রুটি প্রতিক্রিয়া

N/A