डेटा एक्सपोर्ट और इंपोर्ट करना

Cloud Firestore की मैनेज की गई एक्सपोर्ट और इंपोर्ट सेवा का इस्तेमाल करके, गलती से मिटाए गए डेटा को वापस लाया जा सकता है. साथ ही, ऑफ़लाइन प्रोसेसिंग के लिए डेटा एक्सपोर्ट किया जा सकता है. सभी दस्तावेज़ या सिर्फ़ कुछ कलेक्शन ग्रुप एक्सपोर्ट किए जा सकते हैं. इसी तरह, एक्सपोर्ट किए गए सभी डेटा या सिर्फ़ कुछ कलेक्शन ग्रुप को इंपोर्ट किया जा सकता है. एक Cloud Firestore डेटाबेस से एक्सपोर्ट किए गए डेटा को दूसरे Cloud Firestore डेटाबेस में इंपोर्ट किया जा सकता है. आपके पास BigQuery में Cloud Firestore एक्सपोर्ट लोड करने का विकल्प भी है.

इस पेज पर, मैनेज की जा रही एक्सपोर्ट और इंपोर्ट सेवा और Cloud Storage का इस्तेमाल करके, Cloud Firestore दस्तावेज़ों को एक्सपोर्ट और इंपोर्ट करने का तरीका बताया गया है. Cloud Firestore की मैनेज की गई एक्सपोर्ट और इंपोर्ट सेवा, gcloud कमांड-लाइन टूल और Cloud Firestore एपीआई (REST, RPC) के ज़रिए उपलब्ध है.

शुरू करने से पहले

मैनेज की गई एक्सपोर्ट और इंपोर्ट सेवा का इस्तेमाल करने से पहले, आपको ये टास्क पूरे करने होंगे:

1. अपने Google Cloud प्रोजेक्ट के लिए बिलिंग की सुविधा चालू करें. सिर्फ़ उन Google Cloud प्रोजेक्ट के लिए एक्सपोर्ट और इंपोर्ट की सुविधा का इस्तेमाल किया जा सकता है जिनमें बिलिंग की सुविधा चालू है.
2. अपने Cloud Firestore डेटाबेस की जगह के आस-पास की जगह में, अपने प्रोजेक्ट के लिए Cloud Storage बकेट बनाएं. एक्सपोर्ट और इंपोर्ट करने के लिए, अनुरोध करने वाले से शुल्क लेने वाली बकेट या रैपिड बकेट का इस्तेमाल नहीं किया जा सकता.

3. पक्का करें कि आपके खाते के पास Cloud Firestore और Cloud Storage के लिए ज़रूरी अनुमतियां हों. अगर आप प्रोजेक्ट के मालिक हैं, तो आपके खाते के पास ज़रूरी अनुमतियां हैं. इसके अलावा, यहां दी गई भूमिकाएं, एक्सपोर्ट और इंपोर्ट करने के लिए ज़रूरी अनुमतियां देती हैं. साथ ही, Cloud Storage को ऐक्सेस करने की अनुमति भी देती हैं:

   • Cloud Firestore की भूमिकाएं: Owner, Cloud Datastore Owner या Cloud Datastore Import Export Admin

   • Cloud Storage भूमिकाएं: Owner या Storage Admin

सर्विस एजेंट के लिए अनुमतियां

एक्सपोर्ट और इंपोर्ट की कार्रवाइयां, Cloud Storage कार्रवाइयों को अनुमति देने के लिए, Cloud Firestore सर्विस एजेंट का इस्तेमाल करती हैं. Cloud Firestore सर्विस एजेंट, नाम रखने के लिए इस फ़ॉर्मैट का इस्तेमाल करता है:

Cloud Firestore सर्विस एजेंट

service-PROJECT_NUMBER@gcp-sa-firestore.iam.gserviceaccount.com

सर्विस एजेंट के बारे में ज़्यादा जानने के लिए, सर्विस एजेंट देखें.

Cloud Firestore सर्विस एजेंट को, एक्सपोर्ट या इंपोर्ट ऑपरेशन में इस्तेमाल की गई Cloud Storage बकेट का ऐक्सेस चाहिए. अगर आपकी Cloud Storage बकेट उसी प्रोजेक्ट में है जिसमें आपका Cloud Firestore डेटाबेस है, तो Cloud Firestore सर्विस एजेंट डिफ़ॉल्ट रूप से बकेट को ऐक्सेस कर सकता है.

अगर Cloud Storage बकेट किसी दूसरे प्रोजेक्ट में है, तो आपको Cloud Firestore सर्विस एजेंट को Cloud Storage बकेट का ऐक्सेस देना होगा.

सर्विस एजेंट को भूमिकाएं असाइन करना

gsutil कमांड-लाइन टूल का इस्तेमाल करके, इनमें से कोई एक भूमिका असाइन की जा सकती है. उदाहरण के लिए, Cloud Firestore सर्विस एजेंट को स्टोरेज एडमिन की भूमिका असाइन करने के लिए, यह कमांड चलाएं:

gsutil iam ch serviceAccount:service-PROJECT_NUMBER@gcp-sa-firestore.iam.gserviceaccount.com:roles/storage.admin \
    gs://[BUCKET_NAME]

PROJECT_NUMBER को अपने प्रोजेक्ट नंबर से बदलें. इसका इस्तेमाल, आपके Cloud Firestore सर्विस एजेंट को नाम देने के लिए किया जाता है. सर्विस एजेंट का नाम देखने के लिए, सर्विस एजेंट का नाम देखना लेख पढ़ें.

इसके अलावा, Google Cloud Console का इस्तेमाल करके भी यह भूमिका असाइन की जा सकती है.

सर्विस एजेंट का नाम देखना

Google Cloud Console में इंपोर्ट/एक्सपोर्ट पेज पर जाकर, वह खाता देखा जा सकता है जिसका इस्तेमाल आपके इंपोर्ट और एक्सपोर्ट के अनुरोधों को अनुमति देने के लिए किया जाता है. यह भी देखा जा सकता है कि आपका डेटाबेस, Cloud Firestore सर्विस एजेंट का इस्तेमाल करता है या लेगसी App Engine सेवा खाते का.

1. इंपोर्ट/एक्सपोर्ट जॉब को इस तौर पर चलाएं लेबल के बगल में, अनुमति वाला खाता देखें.

एक्सपोर्ट या इंपोर्ट करने के लिए, सर्विस एजेंट के पास Cloud Storage बकेट के लिए Storage Admin की भूमिका होनी चाहिए.

अपने प्रोजेक्ट के लिए gcloud सेट अप करना

Google Cloud Console या gcloud कमांड-लाइन टूल की मदद से, डेटा इंपोर्ट और एक्सपोर्ट करने की प्रोसेस शुरू की जा सकती है. gcloud का इस्तेमाल करने के लिए, कमांड-लाइन टूल सेट अप करें और इनमें से किसी एक तरीके से अपने प्रोजेक्ट से कनेक्ट करें:

• Cloud Shell का इस्तेमाल करके, Google Cloud Console से gcloud को ऐक्सेस करें.

  Cloud Shell शुरू करें

  पक्का करें कि gcloud को सही प्रोजेक्ट के लिए कॉन्फ़िगर किया गया हो:

  gcloud config set project [PROJECT_ID]
  

• Google Cloud SDK टूल को इंस्टॉल और शुरू करें.

डेटा एक्सपोर्ट करें

एक्सपोर्ट करने की प्रोसेस, आपके डेटाबेस में मौजूद दस्तावेज़ों को Cloud Storage बकेट में मौजूद फ़ाइलों के सेट में कॉपी करती है. ध्यान दें कि एक्सपोर्ट किया गया डेटा, एक्सपोर्ट शुरू होने के समय लिए गए डेटाबेस स्नैपशॉट से पूरी तरह मेल नहीं खाता. एक्सपोर्ट में, कार्रवाई के दौरान किए गए बदलाव शामिल हो सकते हैं.

सभी दस्तावेज़ एक्सपोर्ट करना

  gcloud firestore export gs://[BUCKET_NAME] \
  --database=[DATABASE]

किसी खास कलेक्शन ग्रुप को एक्सपोर्ट करना

gcloud firestore export gs://[BUCKET_NAME] \
--collection-ids=[COLLECTION_GROUP_ID_1],[COLLECTION_GROUP_ID_2] \
--database=[DATABASE]

gcloud firestore export gs://[BUCKET_NAME] \
--collection-ids=reviews \
--database='cymbal'

पीआईटीआर टाइमस्टैंप से एक्सपोर्ट करना

पीआईटीआर डेटा से, अपने डेटाबेस को Cloud Storage में एक्सपोर्ट किया जा सकता है. पीआईटीआर डेटा को एक्सपोर्ट किया जा सकता है. इसके लिए, पिछले सात दिनों के दौरान का कोई भी टाइमस्टैंप चुना जा सकता है. हालांकि, यह टाइमस्टैंप earliestVersionTime से पहले का नहीं होना चाहिए. अगर तय किए गए टाइमस्टैंप पर डेटा मौजूद नहीं है, तो एक्सपोर्ट की प्रोसेस पूरी नहीं हो पाती.

पीआईटीआर एक्सपोर्ट की सुविधा, सभी फ़िल्टर के साथ काम करती है. इसमें सभी दस्तावेज़ों को एक्सपोर्ट करना और चुनिंदा कलेक्शन ग्रुप को एक्सपोर्ट करना शामिल है.

पीआईटीआर डेटा एक्सपोर्ट करने से पहले, इन बातों का ध्यान रखें:

• आरएफ़सी 3339 फ़ॉर्मैट में टाइमस्टैंप डालें. उदाहरण के लिए, 2023-05-26T10:20:00.00Z.
• पक्का करें कि आपने जो टाइमस्टैंप तय किया है वह पिछले सात दिनों के अंदर का हो. हालांकि, वह earliestVersionTime से पहले का नहीं होना चाहिए. अगर तय किए गए टाइमस्टैंप पर डेटा मौजूद नहीं है, तो गड़बड़ी का मैसेज जनरेट होता है.
• पीआईटीआर एक्सपोर्ट पूरा न होने पर, आपसे कोई शुल्क नहीं लिया जाता.

gcloud firestore export gs://[BUCKET_NAME_PATH] \
    --snapshot-time=[PITR_TIMESTAMP]

डेटा इंपोर्ट करना

Cloud Storage में फ़ाइलें एक्सपोर्ट करने के बाद, उन फ़ाइलों में मौजूद दस्तावेज़ों को अपने प्रोजेक्ट या किसी दूसरे प्रोजेक्ट में वापस इंपोर्ट किया जा सकता है. इंपोर्ट करने की प्रोसेस के बारे में इन बातों का ध्यान रखें:

• डेटा इंपोर्ट करने पर, आपके डेटाबेस की मौजूदा इंडेक्स डेफ़िनिशन का इस्तेमाल करके, ज़रूरी इंडेक्स अपडेट किए जाते हैं. एक्सपोर्ट किए गए डेटा में इंडेक्स की परिभाषाएं शामिल नहीं होती हैं.

• इंपोर्ट करने पर, नए दस्तावेज़ आईडी असाइन नहीं किए जाते. इंपोर्ट के लिए, एक्सपोर्ट के समय कैप्चर किए गए आईडी का इस्तेमाल किया जाता है. दस्तावेज़ इंपोर्ट होने के दौरान, उसका आईडी रिज़र्व कर लिया जाता है, ताकि आईडी आपस में न टकराएं. अगर उसी आईडी वाला कोई दस्तावेज़ पहले से मौजूद है, तो इंपोर्ट करने पर मौजूदा दस्तावेज़ को ओवरराइट कर दिया जाता है.

• अगर आपके डेटाबेस में मौजूद किसी दस्तावेज़ पर इंपोर्ट का असर नहीं पड़ता है, तो वह इंपोर्ट के बाद भी आपके डेटाबेस में मौजूद रहेगा.

• इंपोर्ट करने की कार्रवाइयां, Cloud Functions को ट्रिगर नहीं करती हैं. स्नैपशॉट लिसनर को इंपोर्ट से जुड़े अपडेट मिलते हैं.

• आपको ऐसे नए Cloud Firestore दस्तावेज़ नहीं जोड़ने चाहिए जो एक्सपोर्ट की गई ओरिजनल आउटपुट फ़ाइलों में मौजूद नहीं थे. इसके अलावा, इंपोर्ट करने से पहले GCS फ़ाइलों से किसी भी मौजूदा दस्तावेज़ को नहीं हटाना चाहिए. ऐसा करने पर, इंपोर्ट नहीं हो पाएगा.

• .overall_export_metadata फ़ाइल नाम, उसके पैरंट फ़ोल्डर के नाम से मेल खाना चाहिए:

  gs://BUCKET_NAME/OPTIONAL_NAMESPACE_PATH/PARENT_FOLDER_NAME/PARENT_FOLDER_NAME.overall_export_metadata

  अगर एक्सपोर्ट की गई आउटपुट फ़ाइलों को किसी दूसरी जगह ले जाया जाता है या कॉपी किया जाता है, तो PARENT_FOLDER_NAME और .overall_export_metadata फ़ाइल का नाम एक जैसा रखें.

एक्सपोर्ट की गई सभी फ़ाइलों को इंपोर्ट करना

gcloud firestore import gs://[BUCKET_NAME]/[EXPORT_PREFIX]/ --database=[DATABASE]

gcloud firestore import gs://my-bucket/2017-05-25T23:54:39_76544/ --database='cymbal'

खास कलेक्शन ग्रुप इंपोर्ट करना

  gcloud firestore import gs://[BUCKET_NAME]/[EXPORT_PREFIX]/ \
  --collection-ids=[COLLECTION_GROUP_ID_1],[COLLECTION_GROUP_ID_2] \
  --database=[DATABASE]

पीआईटीआर एक्सपोर्ट को इंपोर्ट करना

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

एक्सपोर्ट और इंपोर्ट की प्रोसेस मैनेज करना

एक्सपोर्ट या इंपोर्ट की प्रोसेस शुरू होने के बाद, Cloud Firestore उस प्रोसेस को एक यूनीक नाम असाइन करता है. ऑपरेशन के नाम का इस्तेमाल करके, ऑपरेशन को मिटाया या रद्द किया जा सकता है. इसके अलावा, ऑपरेशन का स्टेटस भी देखा जा सकता है.

कार्रवाइयों के नाम से पहले projects/[PROJECT_ID]/databases/(default)/operations/ लगाया जाता है. उदाहरण के लिए:

projects/my-project/databases/(default)/operations/ASA1MTAwNDQxNAgadGx1YWZlZAcSeWx0aGdpbi1zYm9qLW5pbWRhEgopEg

हालांकि, describe, cancel, और deleteकमांड के लिए, ऑपरेशन का नाम तय करते समय प्रीफ़िक्स को छोड़ा जा सकता है.

एक्सपोर्ट और इंपोर्ट की सभी कार्रवाइयों की सूची देखना

gcloud firestore operations list

कार्रवाई की स्थिति देखना

gcloud firestore operations describe [OPERATION_NAME]

पूरा होने में लगने वाले समय का अनुमान लगाना

लंबे समय तक चलने वाली कार्रवाई की स्थिति के अनुरोध से, मेट्रिक workEstimated और workCompleted मिलती हैं. इनमें से हर मेट्रिक, बाइट की संख्या और इकाइयों की संख्या, दोनों में दिखाई जाती है:

• workEstimated से पता चलता है कि किसी कार्रवाई के दौरान, अनुमानित तौर पर कितने बाइट और दस्तावेज़ प्रोसेस किए जाएंगे. अगर Cloud Firestore अनुमान नहीं लगा पाता है, तो वह इस मेट्रिक को छोड़ सकता है.

• workCompleted से पता चलता है कि अब तक कितने बाइट और दस्तावेज़ प्रोसेस किए गए हैं. ऑपरेशन पूरा होने के बाद, वैल्यू में प्रोसेस किए गए बाइट और दस्तावेज़ों की कुल संख्या दिखती है. यह संख्या, workEstimated की वैल्यू से ज़्यादा हो सकती है.

प्रोग्रेस का अनुमान लगाने के लिए, workCompleted को workEstimated से विभाजित करें. यह अनुमान गलत हो सकता है, क्योंकि यह आंकड़ों को इकट्ठा करने में हुई देरी पर निर्भर करता है.

किसी कार्रवाई को रद्द करना

gcloud firestore operations cancel [OPERATION_NAME]

चल रही किसी कार्रवाई को रद्द करने से, वह कार्रवाई पहले जैसी नहीं होती. एक्सपोर्ट की प्रोसेस रद्द करने पर, Cloud Storage में पहले से एक्सपोर्ट किए गए दस्तावेज़ों पर कोई असर नहीं पड़ेगा. इसी तरह, इंपोर्ट की प्रोसेस रद्द करने पर, आपके डेटाबेस में पहले से किए गए अपडेट पर कोई असर नहीं पड़ेगा. अधूरे एक्सपोर्ट को इंपोर्ट नहीं किया जा सकता.

किसी कार्रवाई को मिटाना

हाल ही में की गई कार्रवाइयों की सूची से किसी कार्रवाई को हटाने के लिए, gcloud firestore operations delete कमांड का इस्तेमाल करें. इस निर्देश से, Cloud Storage से एक्सपोर्ट की गई फ़ाइलें नहीं मिटेंगी.

gcloud firestore operations delete [OPERATION_NAME]

एक्सपोर्ट और इंपोर्ट की प्रोसेस के लिए बिलिंग और कीमत

मैनेज की जाने वाली एक्सपोर्ट और इंपोर्ट सेवा का इस्तेमाल करने से पहले, आपको अपने Google Cloud प्रोजेक्ट के लिए बिलिंग की सुविधा चालू करनी होगी.

डेटा एक्सपोर्ट और इंपोर्ट करने के लिए, दस्तावेज़ों को पढ़ने और लिखने के शुल्क के हिसाब से पैसे लिए जाते हैं. यह शुल्क, Cloud Firestore की कीमत में बताया गया है. एक्सपोर्ट किए गए हर दस्तावेज़ के लिए, एक्सपोर्ट ऑपरेशन में एक रीड ऑपरेशन शामिल होता है. इंपोर्ट की कार्रवाइयों में, इंपोर्ट किए गए हर दस्तावेज़ के लिए, डेटा लिखने की एक कार्रवाई होती है.

Cloud Storage में सेव की गई आउटपुट फ़ाइलों को Cloud Storage डेटा स्टोरेज की लागत में गिना जाता है.

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

एक्सपोर्ट और इंपोर्ट की लागत देखना

एक्सपोर्ट और इंपोर्ट ऑपरेशन, बिल किए गए ऑपरेशन पर goog-firestoremanaged:exportimport लेबल लागू करते हैं. क्लाउड बिलिंग रिपोर्ट पेज पर, इस लेबल का इस्तेमाल करके इंपोर्ट और एक्सपोर्ट से जुड़े शुल्क देखे जा सकते हैं:

BigQuery में एक्सपोर्ट करना

Cloud Firestore एक्सपोर्ट से BigQuery में डेटा लोड किया जा सकता है. हालांकि, ऐसा सिर्फ़ तब किया जा सकता है, जब आपने collection-ids फ़िल्टर तय किया हो. Cloud Firestore एक्सपोर्ट से डेटा लोड किया जा रहा है देखें.

BigQuery कॉलम की सीमा

BigQuery में हर टेबल में ज़्यादा से ज़्यादा 10,000 कॉलम हो सकते हैं. Cloud Firestore एक्सपोर्ट ऑपरेशन, हर कलेक्शन ग्रुप के लिए एक BigQuery टेबल स्कीमा जनरेट करते हैं. इस स्कीमा में, कलेक्शन ग्रुप में मौजूद हर यूनीक फ़ील्ड का नाम, स्कीमा कॉलम बन जाता है. अगर किसी कलेक्शन ग्रुप के BigQuery स्कीमा में 10,000 से ज़्यादा कॉलम हैं, तो Cloud Firestore एक्सपोर्ट ऑपरेशन, मैप फ़ील्ड को बाइट के तौर पर इस्तेमाल करके, कॉलम की सीमा के अंदर रहने की कोशिश करता है. अगर इस कन्वर्ज़न से कॉलम की संख्या 10,000 से कम हो जाती है, तो डेटा को BigQuery में लोड किया जा सकता है. हालांकि, मैप फ़ील्ड में मौजूद सबफ़ील्ड के लिए क्वेरी नहीं की जा सकती. अगर कॉलम की संख्या अब भी 10,000 से ज़्यादा है, तो एक्सपोर्ट की प्रोसेस से कलेक्शन ग्रुप के लिए BigQuery स्कीमा जनरेट नहीं होता. साथ ही, उसका डेटा BigQuery में लोड नहीं किया जा सकता.

एक्सपोर्ट फ़ॉर्मैट और मेटाडेटा फ़ाइलें

मैनेज किए गए एक्सपोर्ट का आउटपुट, LevelDB लॉग फ़ॉर्मैट का इस्तेमाल करता है.

मेटाडेटा फ़ाइलें

एक्सपोर्ट की प्रोसेस, आपके तय किए गए हर कलेक्शन ग्रुप के लिए एक मेटाडेटा फ़ाइल बनाती है. मेटाडेटा फ़ाइलों का नाम आम तौर पर ALL_NAMESPACES_KIND_[COLLECTION_GROUP_ID].export_metadata होता है.

मेटाडेटा फ़ाइलें, प्रोटोकॉल बफ़र होती हैं. इन्हें protoc प्रोटोकॉल कंपाइलर की मदद से डिकोड किया जा सकता है. उदाहरण के लिए, मेटाडेटा फ़ाइल को डिकोड करके यह पता लगाया जा सकता है कि एक्सपोर्ट की गई फ़ाइलों में कौनसे कलेक्शन ग्रुप शामिल हैं:

protoc --decode_raw < export0.export_metadata

सर्विस एजेंट का माइग्रेशन

Cloud Firestore, इंपोर्ट और एक्सपोर्ट की कार्रवाइयों को अनुमति देने के लिए, App Engine सेवा खाते के बजाय Cloud Firestore सर्विस एजेंट का इस्तेमाल करता है. सर्विस एजेंट और सेवा खाते के लिए, नाम रखने के इन तरीकों का इस्तेमाल किया जाता है:

Cloud Firestore सर्विस एजेंट

service-PROJECT_NUMBER@gcp-sa-firestore.iam.gserviceaccount.com

Cloud Firestore पहले Cloud Firestore सर्विस एजेंट के बजाय, App Engine डिफ़ॉल्ट सेवा खाते का इस्तेमाल करता था. अगर आपका डेटाबेस, डेटा इंपोर्ट या एक्सपोर्ट करने के लिए अब भी App Engine सेवा खाते का इस्तेमाल करता है, तो हमारा सुझाव है कि आप इस सेक्शन में दिए गए निर्देशों का पालन करके, Cloud Firestore सेवा एजेंट पर माइग्रेट करें.

App Engine सेवा खाता

PROJECT_ID@appspot.gserviceaccount.com

Cloud Firestore सर्विस एजेंट को प्राथमिकता दी जाती है, क्योंकि यह खास तौर पर Cloud Firestore के लिए है. App Engine सेवा खाते को एक से ज़्यादा सेवाओं के साथ शेयर किया गया है.

अनुमति देने वाला खाता देखना

Google Cloud Console में इंपोर्ट/एक्सपोर्ट पेज पर जाकर, यह देखा जा सकता है कि इंपोर्ट और एक्सपोर्ट की कार्रवाइयों के लिए, किस खाते का इस्तेमाल किया जाता है. यह भी देखा जा सकता है कि आपका डेटाबेस पहले से ही Cloud Firestore सर्विस एजेंट का इस्तेमाल कर रहा है या नहीं.

1. Google Cloud console में, डेटाबेस पेज पर जाएं.

   डेटाबेस पर जाएं

2. डेटाबेस की सूची से वह डेटाबेस चुनें जिसकी ज़रूरत हो.

3. नेविगेशन मेन्यू में, इंपोर्ट/एक्सपोर्ट करें पर क्लिक करें.

4. इंपोर्ट/एक्सपोर्ट जॉब को इस तौर पर चलाएं लेबल के बगल में, अनुमति वाला खाता देखें.

अगर आपका प्रोजेक्ट Cloud Firestore सर्विस एजेंट का इस्तेमाल नहीं करता है, तो इनमें से किसी भी तरीके का इस्तेमाल करके, Cloud Firestore सर्विस एजेंट पर माइग्रेट किया जा सकता है:

• Cloud Storage बकेट की अनुमतियों की जांच करके और उन्हें अपडेट करके, किसी प्रोजेक्ट को माइग्रेट करें (सुझाया गया तरीका).
• संगठन के लिए नीति से जुड़ी ऐसी पाबंदी जोड़ें जो संगठन के सभी प्रोजेक्ट पर लागू हो.

इनमें से पहली तकनीक को प्राथमिकता दी जाती है, क्योंकि यह असर के दायरे को एक Cloud Firestore प्रोजेक्ट तक सीमित कर देती है. दूसरी तकनीक को प्राथमिकता नहीं दी जाती, क्योंकि यह मौजूदा Cloud Storage बकेट की अनुमतियों को माइग्रेट नहीं करती. हालांकि, यह संगठन के लेवल पर सुरक्षा से जुड़ी नीतियों का पालन करने की सुविधा देता है.

Cloud Storage बकेट की अनुमतियों की जांच करके और उन्हें अपडेट करके माइग्रेट करना

माइग्रेशन की प्रोसेस के दो चरण हैं:

1. Cloud Storage बकेट की अनुमतियां अपडेट करें. ज़्यादा जानकारी के लिए, यहां मौजूद सेक्शन देखें.
2. Cloud Firestore के सर्विस एजेंट पर माइग्रेट करने की पुष्टि करें.

सर्विस एजेंट बकेट की अनुमतियां

किसी दूसरे प्रोजेक्ट में मौजूद Cloud Storage बकेट का इस्तेमाल करने वाले किसी भी एक्सपोर्ट या इंपोर्ट ऑपरेशन के लिए, आपको उस बकेट के लिए Cloud Firestore सर्विस एजेंट को अनुमतियां देनी होंगी. उदाहरण के लिए, डेटा को किसी दूसरे प्रोजेक्ट में ट्रांसफ़र करने वाले ऑपरेशन को उस दूसरे प्रोजेक्ट में मौजूद बकेट को ऐक्सेस करना होगा. ऐसा न करने पर, Cloud Firestore सर्विस एजेंट पर माइग्रेट करने के बाद, ये कार्रवाइयां पूरी नहीं हो पाएंगी.

एक ही प्रोजेक्ट में इंपोर्ट और एक्सपोर्ट किए जाने वाले वर्कफ़्लो के लिए, अनुमतियों में बदलाव करने की ज़रूरत नहीं होती. Cloud Firestore सेवा एजेंट, डिफ़ॉल्ट रूप से उसी प्रोजेक्ट में मौजूद बकेट को ऐक्सेस कर सकता है.

service-PROJECT_NUMBER@gcp-sa-firestore.iam.gserviceaccount.com सर्विस एजेंट को ऐक्सेस देने के लिए, अन्य प्रोजेक्ट की Cloud Storage बकेट की अनुमतियां अपडेट करें. सर्विस एजेंट को Firestore Service Agent की भूमिका असाइन करें.

Firestore Service Agent भूमिका, Cloud Storage बकेट में मौजूद डेटा को पढ़ने और उसमें बदलाव करने की अनुमतियां देती है. अगर आपको सिर्फ़ पढ़ने या सिर्फ़ लिखने की अनुमति देनी है, तो कस्टम भूमिका का इस्तेमाल करें.

यहां दिए गए सेक्शन में, माइग्रेशन की प्रोसेस के बारे में बताया गया है. इससे आपको उन Cloud Storage बकेट की पहचान करने में मदद मिलती है जिनके लिए अनुमति अपडेट करने की ज़रूरत पड़ सकती है.

किसी प्रोजेक्ट को Firestore सर्विस एजेंट पर माइग्रेट करना

App Engine सेवा खाते से Cloud Firestore सेवा एजेंट पर माइग्रेट करने के लिए, यह तरीका अपनाएं. माइग्रेशन पूरा होने के बाद, उसे पहले जैसा नहीं किया जा सकता.

1. Google Cloud console में, डेटाबेस पेज पर जाएं.

   डेटाबेस पर जाएं

2. डेटाबेस की सूची से वह डेटाबेस चुनें जिसकी ज़रूरत हो.

3. नेविगेशन मेन्यू में, इंपोर्ट/एक्सपोर्ट करें पर क्लिक करें.

4. अगर आपका प्रोजेक्ट अब तक Cloud Firestore सर्विस एजेंट पर माइग्रेट नहीं हुआ है, तो आपको माइग्रेशन के बारे में बताने वाला एक बैनर और बकेट का स्टेटस देखें बटन दिखेगा. अगले चरण में, आपको अनुमति से जुड़ी संभावित गड़बड़ियों की पहचान करने और उन्हें ठीक करने में मदद मिलेगी.

   बकेट का स्टेटस देखें पर क्लिक करें.

   इसके बाद, एक मेन्यू दिखेगा. इसमें माइग्रेशन पूरा करने का विकल्प और Cloud Storage बकेट की सूची दिखेगी. सूची को लोड होने में कुछ मिनट लग सकते हैं.

   इस सूची में ऐसी बकेट शामिल हैं जिनका इस्तेमाल हाल ही में डेटा इंपोर्ट और एक्सपोर्ट करने के लिए किया गया था. हालांकि, फ़िलहाल Cloud Firestore सर्विस एजेंट के पास इन बकेट में मौजूद डेटा को पढ़ने और फ़ाइल या एंट्री में बदलाव करने की अनुमति नहीं है.

5. अपने प्रोजेक्ट के Cloud Firestore सर्विस एजेंट के प्रिंसिपल नेम को नोट करें. सर्विस एजेंट का नाम, ऐक्सेस देने के लिए सर्विस एजेंट लेबल के नीचे दिखता है.

6. सूची में मौजूद किसी भी बकेट के लिए, जिसका इस्तेमाल आने वाले समय में इंपोर्ट या एक्सपोर्ट करने के लिए किया जाएगा, यह तरीका अपनाएं:

   1. इस बकेट की टेबल लाइन में, ठीक करें पर क्लिक करें. इससे उस बकेट की अनुमतियों वाला पेज नए टैब में खुलता है.

   2. जोड़ें पर क्लिक करें.
   3. नए प्रिंसिपल फ़ील्ड में, अपने Cloud Firestore सेवा एजेंट का नाम डालें.
   4. कोई भूमिका चुनें फ़ील्ड में, सर्विस एजेंट > Firestore सर्विस एजेंट चुनें.
   5. सेव करें पर क्लिक करें.
   6. Cloud Firestore के इंपोर्ट/एक्सपोर्ट पेज वाले टैब पर वापस जाएं.
   7. सूची में मौजूद अन्य बकेट के लिए, यह तरीका दोहराएं. सूची के सभी पेज ज़रूर देखें.

7. Firestore सर्विस एजेंट पर माइग्रेट करें पर क्लिक करें. अगर आपके पास अब भी ऐसी बकेट हैं जिनकी अनुमति की जांच नहीं हो पाई है, तो आपको माइग्रेट करें पर क्लिक करके, माइग्रेशन की पुष्टि करनी होगी.

   माइग्रेशन पूरा होने पर आपको सूचना दी जाएगी. माइग्रेशन को पहले जैसा नहीं किया जा सकता.

माइग्रेशन का स्टेटस देखना

अपने प्रोजेक्ट के माइग्रेशन की स्थिति की पुष्टि करने के लिए:

1. Google Cloud console में, डेटाबेस पेज पर जाएं.

   डेटाबेस पर जाएं

2. डेटाबेस की सूची से वह डेटाबेस चुनें जिसकी ज़रूरत हो.

3. नेविगेशन मेन्यू में, इंपोर्ट/एक्सपोर्ट करें पर क्लिक करें.

4. इंपोर्ट/एक्सपोर्ट जॉब को इस रूप में चलाएं लेबल के बगल में मौजूद प्रिंसिपल को देखें.

   अगर प्रिंसिपल service-PROJECT_NUMBER@gcp-sa-firestore.iam.gserviceaccount.com है, तो इसका मतलब है कि आपका प्रोजेक्ट पहले ही Cloud Firestore सर्विस एजेंट पर माइग्रेट हो चुका है. माइग्रेशन को पहले जैसा नहीं किया जा सकता.

   अगर प्रोजेक्ट को माइग्रेट नहीं किया गया है, तो पेज के सबसे ऊपर एक बैनर दिखेगा. इसमें बकेट का स्टेटस देखें बटन होगा. माइग्रेशन पूरा करने के लिए, Firestore सर्विस एजेंट पर माइग्रेट करें लेख पढ़ें.

पूरे संगठन के लिए नीति से जुड़ी पाबंदी जोड़ना

• अपने संगठन की नीति में यह शर्त सेट करें:

  इंपोर्ट/एक्सपोर्ट करने के लिए, Firestore सर्विस एजेंट की ज़रूरत होती है (firestore.requireP4SAforImportExport).

  इस पाबंदी के तहत, इंपोर्ट और एक्सपोर्ट की कार्रवाइयों के लिए, Cloud Firestore सेवा एजेंट का इस्तेमाल करना ज़रूरी है, ताकि अनुरोधों को अनुमति दी जा सके. इस पाबंदी को सेट करने के लिए, संगठन की नीतियां बनाना और उन्हें मैनेज करना लेख पढ़ें.

संगठन की नीति से जुड़ी इस पाबंदी को लागू करने से, Cloud Firestore सेवा एजेंट को Cloud Storage बकेट की ज़रूरी अनुमतियां अपने-आप नहीं मिलती हैं.

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