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

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

এই 4 সেপ্টেম্বর, 2025-এর প্লেসেস ইনসাইট-এর রিলিজে প্রাথমিক রিলিজ থেকে নিম্নলিখিত পরিবর্তনগুলি অন্তর্ভুক্ত রয়েছে:

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

• স্থানের অন্তর্দৃষ্টি ডেটাসেটগুলিকে ডেটা ক্লিন রুম থেকে BigQuery ডেটা এক্সচেঞ্জ তালিকায় নিয়ে যায়৷

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

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

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

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

একটি নির্দিষ্ট অঞ্চলে স্থানের অন্তর্দৃষ্টিতে সদস্যতা নিতে, আপনাকে BigQuery শেয়ারিং-এ নতুন তালিকাগুলিতে সদস্যতা নিতে হবে। একবার আপনি নতুন তালিকাগুলিতে সদস্যতা নিলে, আপনাকে আপনার এসকিউএল কোয়েরিগুলি সংশোধন করতে হবে না। তারা এখনও একই কাজ করবে।

• নতুন ব্যবহারকারী: আপনি যদি স্থানের অন্তর্দৃষ্টির একজন নতুন ব্যবহারকারী হন, তাহলে তালিকাগুলিতে অ্যাক্সেসের জন্য আপনার বিকাশের পরিবেশ কনফিগার করতে স্থানগুলির অন্তর্দৃষ্টি সেট আপ করার পদক্ষেপগুলি অনুসরণ করুন৷

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

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

মাইগ্রেশন পদক্ষেপ

তালিকায় স্থানান্তরিত করতে আপনার প্রয়োজন:

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

   দ্রষ্টব্য: যখন আপনি স্থানের অন্তর্দৃষ্টি সেট আপ করেন , তখন আপনার নিজের নামকরণের রীতি ব্যবহার করতে ডেটাসেটের নাম সেট করুন৷ আপনি যদি ডিফল্ট ডেটাসেটের নাম ছেড়ে দেন, তাহলে এটি লিগ্যাসি ডেটা ক্লিন রুমের নামের সাথে দ্বন্দ্ব করবে।

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 ফর্মের সমস্ত ক্ষেত্রে প্রযোজ্য, যেখানে 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";