এই পৃষ্ঠাটি Cloud Translation API অনুবাদ করেছে।

ক্যাশে কী দিয়ে কাজ করা

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

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

<CacheKey> / <KeyFragment> , <Scope> , এবং <Prefix> -- এই কনফিগারেশন উপাদানগুলোর মান একত্রিত করে একটি আইডেন্টিফায়ার তৈরি করা হয়, যা আপনার ক্যাশে রাখা মানের সাথে যুক্ত থাকে। এই একই কনফিগারেশন ব্যবহার করেই আপনি মানটি পুনরুদ্ধার করেন।

নিম্নলিখিত ক্যাশ পলিসি কনফিগারেশন উপাদানগুলির সাহায্যে আপনি একটি ক্যাশ কী তৈরি করতে পারেন:

ক্যাশে কনফিগারেশন উপাদান বর্ণনা

<CacheKey> / <KeyFragment> ক্যাশ এন্ট্রিগুলির জন্য একটি অনন্য শনাক্তকারী নির্দিষ্ট করতে <CacheKey> <KeyFragment> উপাদানগুলি একত্রে ব্যবহার করুন। KeyFragment-এর মানগুলি স্ট্যাটিক লিটারেল হতে পারে অথবা ভেরিয়েবল থেকে সেট করা যেতে পারে।

<Scope> অথবা <Prefix> নেমস্পেস ক্যাশে কী-গুলোকে আরও বিস্তৃত করতে <Scope> বা <Prefix> এলিমেন্ট ব্যবহার করুন। <Scope> পূর্বনির্ধারিত মানগুলির একটি তালিকা প্রদর্শন করে। <Prefix> এলিমেন্টটি আপনার নিজের পছন্দের একটি মান দিয়ে <Scope> কে ওভাররাইড করে।

ক্যাশে কনফিগারেশন উপাদান	বর্ণনা
`<CacheKey>` / `<KeyFragment>`	ক্যাশ এন্ট্রিগুলির জন্য একটি অনন্য শনাক্তকারী নির্দিষ্ট করতে `<CacheKey>` `<KeyFragment>` উপাদানগুলি একত্রে ব্যবহার করুন। KeyFragment-এর মানগুলি স্ট্যাটিক লিটারেল হতে পারে অথবা ভেরিয়েবল থেকে সেট করা যেতে পারে।
`<Scope>` অথবা `<Prefix>`	নেমস্পেস ক্যাশে কী-গুলোকে আরও বিস্তৃত করতে `<Scope>` বা `<Prefix>` এলিমেন্ট ব্যবহার করুন। `<Scope>` পূর্বনির্ধারিত মানগুলির একটি তালিকা প্রদর্শন করে। `<Prefix>` এলিমেন্টটি আপনার নিজের পছন্দের একটি মান দিয়ে `<Scope>` কে ওভাররাইড করে।

এই মানগুলি নিম্নলিখিত আকারে সংযুক্ত করা হয়, যেখানে <Scope> বা <Prefix> মানগুলি KeyFragment মান থেকে ডাবল-আন্ডারস্কোর দ্বারা পৃথক করা হয়। একাধিক KeyFragment মানও ডাবল-আন্ডারস্কোর দ্বারা পৃথক করা হয়।

স্কোপ | প্রিফিক্স__কীফ্র্যাগমেন্ট [ __কীফ্র্যাগমেন্ট ]

রেসপন্স ক্যাশ পলিসির মাধ্যমে, আপনি ঐচ্ছিকভাবে রেসপন্স অ্যাকসেপ্ট হেডার থেকে ভ্যালুগুলো দিয়ে এই ক্যাশ কী-টি যুক্ত করতে পারেন।

<CacheKey> ব্যবহার করে

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

<CacheKey> এলিমেন্টে একাধিক <KeyFragment> এলিমেন্ট অন্তর্ভুক্ত থাকতে পারে। রানটাইমে, <KeyFragment> এলিমেন্ট দ্বারা নির্দিষ্ট করা মানগুলো দুটি আন্ডারস্কোর দিয়ে সংযুক্ত করে ক্যাশ কী-এর একটি অংশ তৈরি করা হয়।

উদাহরণস্বরূপ, নিম্নলিখিত কনফিগারেশনটি ক্যাশ কী-তে ব্যবহারের জন্য hello__world নামে একটি ভ্যালু তৈরি করে:

<CacheKey>
    <KeyFragment>hello</KeyFragment>
    <KeyFragment>world</KeyFragment>
<CacheKey>

আপনি একটি <KeyFragment> এলিমেন্টে ভেরিয়েবলটিকে রেফারেন্স করার মাধ্যমেও ক্যাশে কী-তে ভেরিয়েবলের মান ব্যবহার করতে পারেন, যেমনটি এখানে দেখানো হয়েছে:

<KeyFragment ref="variable_name"/>

উদাহরণস্বরূপ, রিকোয়েস্ট মেসেজের Content-Type-কে ক্যাশ কী ভ্যালুতে অন্তর্ভুক্ত করতে, আপনাকে নিম্নরূপভাবে করতে হবে:

<KeyFragment ref="request.header.Content-Type"/>

নিম্নলিখিত কনফিগারেশনে, request.header.Content-Type ভেরিয়েবলটির মান application/json ।

<CacheKey>
  <KeyFragment>apiAccessToken</KeyFragment>
  <KeyFragment ref="request.header.Content-Type" />
  <KeyFragment>bar</KeyFragment>
</CacheKey>

এর ফলে একটি ক্যাশে কী তৈরি হয় যা apiAccessToken__application/json__bar দিয়ে শেষ হয়।

আপনি যে ভেরিয়েবলগুলো ব্যবহার করতে পারবেন তার তালিকার জন্য, ভেরিয়েবল রেফারেন্স দেখুন।

কোয়েরি প্যারামিটার থেকে প্রাপ্ত ক্যাশে কী

request.queryparam.<queryparam_name> এবং request.querystring-এর মতো ভ্যারিয়েবল ব্যবহার করে, আপনি একটি ক্যাশ কী কনফিগার করতে পারেন যাতে কী-টি একটি রিকোয়েস্টের কোয়েরি স্ট্রিং-এর অংশবিশেষ অন্তর্ভুক্ত করে। উদাহরণস্বরূপ, নিম্নলিখিত URL-টিতে দুটি কোয়েরি প্যারামিটার ব্যবহৃত হয়েছে — param1 এবং param2 — যা আপনি আপনার ক্যাশ কী-তে ব্যবহার করতে পারেন:

http://myaccount.apigee.net/mydata?param1=value1&param2=value2

আপনার <CacheKey> এলিমেন্টটি নিম্নলিখিত কনফিগারেশনের মাধ্যমে এই মানগুলি অন্তর্ভুক্ত করতে পারে:

<CacheKey>
    <KeyFragment ref="request.queryparam.param1" />
    <KeyFragment ref="request.queryparam.param2" />
<CacheKey>

রানটাইমে, ক্যাশ কী-তে প্যারামিটার মানগুলো সংযুক্ত অবস্থায় থাকবে, যেমনটি নিচে দেখানো হয়েছে:

অন্যান্য_মূল_অংশ __মান১__মান২

মনে রাখবেন যে, যখন আপনি প্যারামিটার থেকে মান ঢোকানোর জন্য ভেরিয়েবল ব্যবহার করেন, তখন মানগুলো <KeyFragment> এলিমেন্টের ক্রম অনুসারে সংযুক্ত হবে। আরও মনে রাখবেন যে, Edge শুধুমাত্র সেই মানগুলোই ব্যবহার করবে যেগুলো আপনি <KeyFragment> এলিমেন্ট দিয়ে বিশেষভাবে উল্লেখ করেছেন। যদি আপনার অনুরোধের কোয়েরি প্যারামিটার তালিকা ভিন্ন হয়, তবে সেই ভিন্নতাগুলো ক্যাশ কী-তে অন্তর্ভুক্ত করা হবে না।

এর একটি বিকল্প হলো request.querystring ভেরিয়েবলটি ব্যবহার করা, যা প্যারামিটারগুলোর সম্পূর্ণ স্ট্রিংটিকে আক্ষরিকভাবে ক্যাশ কী-এর অংশ হিসেবে যুক্ত করে। মনে রাখবেন যে, যদিও এই পদ্ধতিটি সমস্ত প্যারামিটারকে অন্তর্ভুক্ত করে, কিন্তু যদি এক রিকোয়েস্ট থেকে অন্য রিকোয়েস্টে প্যারামিটারগুলোর ক্রম পরিবর্তিত হয়, তাহলে কী-টিও ভিন্ন হবে। অন্য কথায়, param1=value1&param2=value2 এবং param2=value2&param1=value1 এর ফলে একই ক্যাশ কী ভ্যালু পাওয়া যায় না।

<Scope> এবং <Prefix> ব্যবহার করে

<Scope> এবং <Prefix> এলিমেন্টগুলো একটি নেমস্পেস প্রিফিক্স দিয়ে কী-কে বর্ধিত করার একটি উপায় প্রদান করে। এগুলোর দ্বারা উপস্থাপিত মানগুলো আপনার ক্যাশ কী-এর শুরুতে যুক্ত করা হয়।

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

উদাহরণস্বরূপ, <Scope> ভ্যালু "Global" — যা সবচেয়ে বিস্তৃত স্কোপ — অর্গানাইজেশন এবং এনভায়রনমেন্টের নাম নির্দেশ করে। সুতরাং, যদি আপনার প্রক্সি 'mycompany' নামক একটি অর্গানাইজেশন এবং 'prod' নামক একটি এনভায়রনমেন্টে ডেপ্লয় করা থাকে, তাহলে এর ফলে প্রিপ্রেন্ডেড ভ্যালুটি হবে নিম্নরূপ:

কনফিগারেশন	ফলাফল
`<Scope>Global</Scope>`	`mycompany__prod__` .

আপনি যদি উপরে সংজ্ঞায়িত ক্যাশ কী সহ গ্লোবাল স্কোপ ব্যবহার করেন, তাহলে ফলাফলটি নিম্নরূপ হবে:

কনফিগারেশন	ফলাফল
<Scope>Global</Scope> <CacheKey> <KeyFragment>hello</KeyFragment> <KeyFragment>world</KeyFragment> <CacheKey>	`mycompany__prod__hello__world` .

লুকআপক্যাশ পলিসিতে বর্ণিত অনুযায়ী, স্কোপটিকে গ্লোবাল থেকে এক্সক্লুসিভ পর্যন্ত ক্রমবর্ধমান সুনির্দিষ্টতার জন্য কনফিগার করা যেতে পারে। একটি এক্সক্লুসিভ স্কোপ হলো সবচেয়ে সুনির্দিষ্ট, এবং তাই এটি একটি নির্দিষ্ট ক্যাশের মধ্যে নেমস্পেস সংঘর্ষের ঝুঁকি সর্বনিম্ন রাখে। এক্সক্লুসিভ স্কোপযুক্ত প্রতিটি ক্যাশ এন্ট্রির শুরুতে নিম্নলিখিত আকারে একটি প্রিফিক্স যুক্ত করা হয়:

orgName__envName__apiProxyName__deployedRevisionNumber__proxy|TargetName__[serializedCacheKey]

উদাহরণস্বরূপ, <Scope> এর জন্য Exclusive ভ্যালু ব্যবহার করে তৈরি করা একটি ক্যাশ কী দেখতে নিম্নলিখিতের মতো হবে:

apifactory__test__weatherapi__16__default__apiAccessToken