डेटा माइग्रेट करने से जुड़ी गाइड

अहम जानकारी: यह गाइड, प्रीव्यू के शुरुआती वर्शन से माइग्रेट करने वाले उपयोगकर्ताओं के लिए है. अन्य सभी उपयोगकर्ता पहले से ही लिस्टिंग का इस्तेमाल करते हैं और उन्हें माइग्रेट करने की ज़रूरत नहीं है.

जगह की अहम जानकारी की इस रिलीज़ में, शुरुआती रिलीज़ के मुकाबले ये बदलाव किए गए हैं:

• इससे, अपनी पसंद की BigQuery लोकेशन में Places Insights की सदस्यता ली जा सकती है.

• इस सुविधा की मदद से, जगहों की अहम जानकारी वाले डेटासेट को डेटा क्लीन रूम से BigQuery डेटा एक्सचेंज की लिस्टिंग में ले जाया जाता है.

• डेटासेट स्कीमा में मौजूद पते वाले फ़ील्ड, id और name फ़ील्ड को अलग-अलग स्ट्रिंग या स्ट्रिंग ऐरे फ़ील्ड में बांटते हैं.

ध्यान दें: पते के नए फ़ील्ड का फ़ायदा पाने के लिए, आपको लिस्टिंग पर माइग्रेट करना होगा. अगर आपको लिस्टिंग पर माइग्रेट नहीं करना है और डेटा क्लीन रूम का इस्तेमाल जारी रखना है, तो पते वाले फ़ील्ड और डेटासेट स्कीमा का इस्तेमाल जारी रखें. ये फ़ील्ड और स्कीमा, शुरुआती रिलीज़ में उपलब्ध थे.

लिस्टिंग पर माइग्रेट करना

Places Insights की शुरुआती प्रीव्यू रिलीज़ में, BigQuery के डेटा क्लीन रूम में डेटा डिप्लॉय किया गया था. 4 सितंबर, 2025 को रिलीज़ हुए वर्शन में, हमने डेटासेट को BigQuery लिस्टिंग में ट्रांसफ़र कर दिया है. इससे आपको किसी BigQuery क्षेत्र में डेटासेट की सदस्यता लेने की सुविधा मिलती है. इस बदलाव का असर, प्रॉडक्ट की सुविधाओं और Places Insights के इस्तेमाल पर नहीं पड़ेगा.

किसी खास इलाके में Places Insights की सदस्यता लेने के लिए, आपको BigQuery Sharing में नई लिस्टिंग की सदस्यता लेनी होगी. नई लिस्टिंग की सदस्यता लेने के बाद, आपको अपनी एसक्यूएल क्वेरी में बदलाव करने की ज़रूरत नहीं है. हालांकि, ये अब भी पहले की तरह ही काम करेंगे.

• नए उपयोगकर्ता: अगर आप Places Insights के नए उपयोगकर्ता हैं, तो लिस्टिंग का ऐक्सेस पाने के लिए, Places Insights सेट अप करें में दिया गया तरीका अपनाएं. इससे आपको डेवलपमेंट एनवायरमेंट को कॉन्फ़िगर करने में मदद मिलेगी.

• मौजूदा उपयोगकर्ता: इस्तेमाल की जा सकने वाली लिस्टिंग पर माइग्रेट करने के लिए, यह तरीका अपनाएं

ध्यान दें: अगर आप मौजूदा ग्राहक हैं, तो आपको पूर्वावलोकन के दौरान लिस्टिंग पर माइग्रेट करने की ज़रूरत नहीं है. हालांकि, GA में Places Insights के उपलब्ध होने के बाद, यह सुविधा सिर्फ़ लिस्टिंग के लिए काम करेगी.

माइग्रेशन के चरण

लिस्टिंग पर माइग्रेट करने के लिए, आपको ये काम करने होंगे:

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 की वैल्यू 1 से 7 तक होती है.

ध्यान दें: सभी administrative_area_level_N फ़ील्ड, हर देश में उपलब्ध नहीं हैं. आपके देश के लिए उपलब्ध फ़ील्ड की सूची देखने के लिए, देश के हिसाब से स्कीमा का रेफ़रंस देखें.

नए फ़ील्ड का इस्तेमाल करने का उदाहरण

जगहों के बारे में अहम जानकारी की शुरुआती रिलीज़ में, नतीजों को फ़िल्टर करने के लिए 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";