মাইগ্রেশন গাইড

গুরুত্বপূর্ণ: এই নির্দেশিকাটি প্রাথমিক প্রিভিউ রিলিজ থেকে মাইগ্রেট করা ব্যবহারকারীদের জন্য তৈরি। অন্যান্য সমস্ত ব্যবহারকারী ইতিমধ্যেই তালিকা ব্যবহার করেন এবং তাদের মাইগ্রেট করার প্রয়োজন নেই।

৪ সেপ্টেম্বর, ২০২৫ তারিখে প্রকাশিত প্লেসেস ইনসাইটস-এ প্রাথমিক প্রকাশের থেকে নিম্নলিখিত পরিবর্তনগুলি অন্তর্ভুক্ত রয়েছে:

• আপনার পছন্দের BigQuery অবস্থানে Places Insights-এ সাবস্ক্রাইব করার ক্ষমতা সমর্থন করে।

• ডেটা ক্লিন রুম থেকে প্লেসেস ইনসাইটস ডেটাসেটগুলিকে BigQuery ডেটা এক্সচেঞ্জ তালিকাতে স্থানান্তর করে।

• ডেটাসেট স্কিমার ঠিকানা ক্ষেত্রগুলি id এবং name ক্ষেত্রগুলিকে পৃথক স্ট্রিং বা স্ট্রিং অ্যারে ক্ষেত্রগুলিতে পৃথক করে।

দ্রষ্টব্য: নতুন ঠিকানা ক্ষেত্রগুলির সুবিধা নিতে, আপনাকে তালিকাগুলিতে স্থানান্তর করতে হবে। যদি আপনি তালিকাগুলিতে স্থানান্তর না করার সিদ্ধান্ত নেন এবং পরিবর্তে ডেটা ক্লিন রুম ব্যবহার চালিয়ে যান, তাহলে প্রাথমিক প্রকাশ থেকে ঠিকানা ক্ষেত্র এবং ডেটাসেট স্কিমা ব্যবহার চালিয়ে যান।

তালিকায় স্থানান্তর করুন

Places Insights-এর প্রাথমিক প্রিভিউ রিলিজ BigQuery ডেটা ক্লিন রুমে ডেটা স্থাপন করেছে। ৪ সেপ্টেম্বর, ২০২৫-এ রিলিজের মাধ্যমে, আমরা ডেটাসেটগুলিকে BigQuery তালিকাগুলিতে স্থানান্তরিত করেছি যাতে আপনি একটি নির্দিষ্ট BigQuery অঞ্চলে ডেটাসেটে সাবস্ক্রাইব করতে পারেন। এই পরিবর্তনের ফলে পণ্যের বৈশিষ্ট্য এবং Places Insights-এর ব্যবহারযোগ্যতার উপর কোনও প্রভাব পড়ে না।

একটি নির্দিষ্ট অঞ্চলে Places Insights-এ সাবস্ক্রাইব করার জন্য, আপনাকে BigQuery Sharing-এ নতুন তালিকাগুলিতে সাবস্ক্রাইব করতে হবে। একবার আপনি নতুন তালিকাগুলিতে সাবস্ক্রাইব করার পরে, আপনার SQL কোয়েরিগুলি পরিবর্তন করার প্রয়োজন নেই। সেগুলি এখনও একইভাবে কাজ করবে।

• নতুন ব্যবহারকারী: আপনি যদি প্লেস ইনসাইটসের নতুন ব্যবহারকারী হন, তাহলে তালিকাগুলিতে অ্যাক্সেসের জন্য আপনার ডেভেলপমেন্ট পরিবেশ কনফিগার করতে সেট আপ প্লেস ইনসাইটস-এর ধাপগুলি অনুসরণ করুন।

• বিদ্যমান ব্যবহারকারী: ব্যবহারের তালিকায় স্থানান্তরিত হতে নিচের ধাপগুলি অনুসরণ করুন।

দ্রষ্টব্য: আপনি যদি একজন বিদ্যমান গ্রাহক হন, তাহলে প্রিভিউ চলাকালীন আপনাকে তালিকাগুলিতে স্থানান্তর করতে হবে না। তবে, যখন Places Insights GA-তে যাবে, তখন এটি শুধুমাত্র তালিকাগুলিকে সমর্থন করবে।

মাইগ্রেশনের ধাপগুলি

তালিকায় মাইগ্রেট করতে আপনার যা করতে হবে:

1. আপনার নির্বাচিত শহর এবং দেশের তালিকায় সাবস্ক্রাইব করুন। নির্দেশাবলীর জন্য, স্থান অন্তর্দৃষ্টি সেট আপ করুন দেখুন।

   দ্রষ্টব্য: যখন আপনি Places Insights সেট আপ করেন , তখন আপনার নিজস্ব নামকরণের রীতি ব্যবহার করে ডেটাসেটের নাম সেট করুন। যদি আপনি ডিফল্ট ডেটাসেটের নামটি রেখে যান, তাহলে এটি লিগ্যাসি ডেটা ক্লিন রুমের নামের সাথে সাংঘর্ষিক হবে।

2. আপনার কোয়েরি বা ফাংশনে ডেটাসেটের নামটি উপরে আপনার বেছে নেওয়া ডেটাসেটের নামে আপডেট করুন।

3. যদি আপনি পূর্বে ফাংশন ব্যবহার করে থাকেন, তাহলে ডেটা ক্লিন রুমের সাথে ব্যবহৃত প্রকল্পের নামটি সরিয়ে ফেলুন ( maps-platform-analytics-hub )।

4. আপনার প্রকল্পের নাম (ঐচ্ছিক) এবং নতুন ঠিকানা ক্ষেত্রগুলি অন্তর্ভুক্ত করার জন্য আপনার বিদ্যমান প্রশ্ন বা ফাংশনগুলি পরিবর্তন করুন।

তালিকা উল্লেখ করার সময় আপনার প্রকল্পের নাম অন্তর্ভুক্ত করুন (ঐচ্ছিক)

তালিকার সাহায্যে, আপনি কোয়েরিতে আপনার প্রকল্পের নাম অন্তর্ভুক্ত করতে পারেন। যদি আপনি কোনও প্রকল্পের নাম নির্দিষ্ট না করেন, তাহলে আপনার কোয়েরিটি সক্রিয় প্রকল্পে ডিফল্ট হবে।

যদি আপনি বিভিন্ন প্রকল্পে একই নামের ডেটাসেট লিঙ্ক করে থাকেন, অথবা যদি আপনি সক্রিয় প্রকল্পের বাইরে কোনও টেবিল অনুসন্ধান করেন, তাহলে আপনি আপনার প্রকল্পের নাম অন্তর্ভুক্ত করতে চাইতে পারেন।

প্রকল্প এবং ডেটাসেটের নাম সহ আপডেট করা কোয়েরির উদাহরণ

এই কোয়েরিতে একটি প্রকল্পের নাম রয়েছে এবং ডেটাসেটের নাম my_dataset_name ব্যবহার করা হয়েছে:

SELECT WITH AGGREGATION_THRESHOLD
COUNT(*) AS count
FROM `PROJECT_NAME.my_dataset_name.places`

নতুন ঠিকানার ক্ষেত্রগুলিতে স্থানান্তর করুন

Places Insights-এর প্রাথমিক প্রকাশনায়, ডেটাসেট স্কিমা একটি ঠিকানা ক্ষেত্রকে একটি STRUCT বা RECORD হিসেবে উপস্থাপন করেছিল যেখানে একটি id এবং name সাবফিল্ড ছিল। এই প্রকাশটি id এবং name এর জন্য পৃথক, শীর্ষ-স্তরের ক্ষেত্রগুলি সংজ্ঞায়িত করার জন্য স্কিমাটিকে সমতল করে। নতুন ক্ষেত্রগুলি হয় স্ট্রিং অথবা স্ট্রিং অ্যারে ক্ষেত্র।

দ্রষ্টব্য: নতুন ঠিকানা ক্ষেত্রগুলির সুবিধা নিতে, আপনাকে ডেটা ক্লিন রুম থেকে তালিকাগুলিতে স্থানান্তর করতে হবে। যদি আপনি তালিকাগুলিতে স্থানান্তর না করার সিদ্ধান্ত নেন, তাহলে প্রাথমিক প্রকাশ থেকে ঠিকানা ক্ষেত্রগুলি ব্যবহার চালিয়ে যান।

উদাহরণস্বরূপ, প্রাথমিক রিলিজের জন্য লোকালিটি অ্যাড্রেস কম্পোনেন্টের স্কিমা নিচে দেখানো হল:

locality		STRUCT
	locality.id	STRING
	locality.name	STRING

এই রিলিজে, ডেটাসেটে এখন দুটি শীর্ষ-স্তরের স্ট্রিং অ্যারে ক্ষেত্র রয়েছে। উদাহরণস্বরূপ, আপডেট করা লোকালিটি ডেটা স্কিমা নীচে দেখানো হয়েছে:

locality_ids	ARRAY<string>
locality_names	ARRAY<string>

সম্পূর্ণ স্কিমের রেফারেন্স দেখুন।

দ্রষ্টব্য: সব দেশে সব ফিল্ড পাওয়া যায় না। আপনার দেশের জন্য উপলব্ধ ফিল্ডের নির্দিষ্ট তালিকার জন্য, দেশ-নির্দিষ্ট স্কিমা রেফারেন্স দেখুন।

নন-অ্যারে ক্ষেত্র

এই রিলিজে, id এবং name ক্ষেত্রগুলি এখন নন-অ্যারে ঠিকানা ক্ষেত্রগুলির জন্য শীর্ষ-স্তরের STRING ক্ষেত্র:

administrative_area_level_1_id	STRING
administrative_area_level_1_name	STRING

এই নতুন ফর্ম্যাটটি administrative_area_level_N ফর্মের সমস্ত ক্ষেত্রে প্রযোজ্য, যেখানে N হল 1 থেকে 7।

দ্রষ্টব্য: সব দেশেই সকল administrative_area_level_N ক্ষেত্র উপলব্ধ নেই। আপনার দেশের জন্য উপলব্ধ ক্ষেত্রগুলির নির্দিষ্ট তালিকার জন্য, দেশ-নির্দিষ্ট স্কিমা রেফারেন্স দেখুন।

নতুন ক্ষেত্র ব্যবহারের উদাহরণ

Places Insights-এর প্রাথমিক প্রকাশে, আপনি ফলাফল ফিল্টার করার জন্য WHERE ধারায় administrative_area_level_1.name ক্ষেত্রটি ব্যবহার করেছিলেন:

SELECT WITH AGGREGATION_THRESHOLD
COUNT(*) AS count
FROM `PROJECT_NAME.places_insights___us.places`
WHERE administrative_area_level_1.name = "New York";

নতুন ক্ষেত্রগুলির সাথে, আপনি administrative_area_level_1_name ক্ষেত্রটি ব্যবহার করে কোয়েরিটি লিখবেন:

SELECT WITH AGGREGATION_THRESHOLD
COUNT(*) AS count
FROM `PROJECT_NAME.places_insights___us.places`
WHERE administrative_area_level_1_name = "New York";