डेटाबेस मैनेज करना

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

ज़रूरी भूमिकाएं और अनुमतियां

डेटाबेस बनाने और उन्हें मैनेज करने के लिए, आपके पास पहचान और ऐक्सेस मैनेजमेंट की यह भूमिका होनी चाहिए:

• Cloud Datastore का मालिक (roles/datastore.owner)

इस भूमिका से, आपको डेटाबेस बनाने और मैनेज करने के लिए ज़रूरी ये अनुमतियां मिलती हैं:

• डेटाबेस बनाएं: datastore.databases.create
• डेटाबेस कॉन्फ़िगरेशन पढ़ें: datastore.databases.getMetadata
• डेटाबेस कॉन्फ़िगर करें: datastore.databases.update
• डेटाबेस मिटाना: datastore.databases.delete
• डेटाबेस का क्लोन बनाना: datastore.databases.clone

डेटाबेस बनाना

डेटाबेस बनाने के लिए, इनमें से कोई एक तरीका अपनाएं:

firebase firestore:databases:create DATABASE_ID \n--location=LOCATION \n[--edition EDITION] \n[--firestore-data-access FIRESTORE_ACCESS] \n[--realtime-updates REALTIME_UPDATES] \n[--delete-protection DELETE_PROTECTION_ENABLEMENT]

resource "google_firestore_database" "database" {
  project     = "project-id"
  name        = DATABASE_ID
  location_id = LOCATION
  type        = DATABASE_TYPE

  // Optional
  delete_protection_state = DELETE_PROTECTION_STATE
}

डेटाबेस आईडी

मान्य डेटाबेस आईडी को इन नियमों का पालन करना चाहिए:

• इसमें सिर्फ़ अक्षर, संख्याएं, और हाइफ़न (-) शामिल करें.
• अक्षर लोअरकेस में होने चाहिए.
• पहला वर्ण कोई अक्षर होना चाहिए.
• आखिरी वर्ण कोई अक्षर या संख्या होनी चाहिए.
• कम से कम चार वर्ण.
• ज़्यादा से ज़्यादा 63 वर्ण.
• यह यूयूआईडी नहीं होना चाहिए या यूयूआईडी जैसा नहीं दिखना चाहिए. उदाहरण के लिए, f47ac10b-58cc-0372-8567-0e02b2c3d479 जैसे आईडी का इस्तेमाल न करें.

इन नियमों का एक अपवाद है: अगर आपने कोई आईडी नहीं डाला है, तो स्टैंडर्ड वर्शन (default) नाम का डेटाबेस बनाएगा.

ध्यान दें कि किसी डेटाबेस को मिटाने के बाद, उसके आईडी को करीब पांच मिनट तक फिर से इस्तेमाल नहीं किया जा सकता.

सुरक्षा की सेटिंग मिटाना

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

अपने डेटाबेस के लिए Cloud Firestore Security Rules सेट अप करना

अपने हर डेटाबेस में Cloud Firestore Security Rules को डिप्लॉय करने के लिए, Firebase सीएलआई का इस्तेमाल करें. Cloud Firestore Security Rules को मैनेज और डिप्लॉय करने की गाइड देखें.

क्लाइंट लाइब्रेरी की मदद से, नाम वाले डेटाबेस को ऐक्सेस करना

नाम वाले डेटाबेस में, (default) के अलावा कोई भी डेटाबेस शामिल होता है. डिफ़ॉल्ट रूप से, Firebase SDK टूल और Google API क्लाइंट लाइब्रेरी, किसी प्रोजेक्ट में मौजूद (default) Cloud Firestore डेटाबेस से कनेक्ट होती हैं. किसी नाम वाले डेटाबेस से कनेक्ट किया गया क्लाइंट बनाने के लिए, क्लाइंट को इंस्टैंशिएट करते समय डेटाबेस आईडी सेट करें.

डेटाबेस की सूची

अपने डेटाबेस की सूची देखने के लिए, इनमें से कोई एक तरीका अपनाएं:

gcloud firestore databases list

firebase firestore:databases:list

डेटाबेस की जानकारी देखना

किसी एक डेटाबेस की जानकारी देखने के लिए, इनमें से कोई एक तरीका अपनाएं:

gcloud firestore databases describe --database=DATABASE_ID

firebase firestore:databases:get DATABASE_ID

DATABASE_ID को डेटाबेस आईडी से बदलें.

डेटाबेस कॉन्फ़िगरेशन अपडेट करना

किसी डेटाबेस की कॉन्फ़िगरेशन सेटिंग अपडेट करने के लिए, gcloud firestore databases update कमांड का इस्तेमाल करें. मिटाए जाने से सुरक्षा की सुविधा को चालू या बंद करने के लिए, इस निर्देश का इस्तेमाल करें.

मिटाए जाने से बचाने की सेटिंग अपडेट करना

किसी डेटाबेस पर, मिटाए जाने से रोकने की सुविधा चालू करने के लिए, --delete-protection फ़्लैग के साथ gcloud firestore databases update कमांड का इस्तेमाल करें. उदाहरण के लिए:

gcloud firestore databases update --database=DATABASE_ID --delete-protection

DATABASE_ID को डेटाबेस आईडी से बदलें.

किसी डेटाबेस पर, मिटाए जाने से रोकने की सुविधा बंद करने के लिए, --no-delete-protection फ़्लैग के साथ gcloud firestore databases update कमांड का इस्तेमाल करें. उदाहरण के लिए:

gcloud firestore databases update --database=DATABASE_ID --no-delete-protection

DATABASE_ID को डेटाबेस आईडी से बदलें.

कोई डेटाबेस मिटाना

किसी डेटाबेस को मिटाने के लिए, कंसोल या कमांड-लाइन टूल का इस्तेमाल करें.

अगर डेटाबेस में, मिटाए जाने से सुरक्षा की सेटिंग चालू है, तो आपको पहले मिटाए जाने से सुरक्षा की सेटिंग बंद करनी होगी.

अगर डेटाबेस में App Engine खोज डेटा या ब्लॉब इकाइयां मौजूद हैं, तो आपको पहले वह डेटा मिटाना होगा.

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

डेटाबेस मिटाने पर, मिटाने की कार्रवाइयों के लिए शुल्क नहीं लिया जाता.

gcloud firestore databases delete --database=DATABASE_ID

डेटाबेस का क्लोन बनाना

किसी मौजूदा डेटाबेस को चुने गए टाइमस्टैंप पर, नए डेटाबेस में क्लोन किया जा सकता है:

• क्लोन किया गया डेटाबेस एक नया डेटाबेस होता है. इसे सोर्स डेटाबेस की जगह पर ही बनाया जाएगा.

  क्लोन बनाने के लिए, Cloud Firestore सोर्स डेटाबेस के पिछले समय की रिकवरी (पीआईटीआर) डेटा का इस्तेमाल करता है. क्लोन किए गए डेटाबेस में सभी डेटा और इंडेक्स शामिल होते हैं.

• डिफ़ॉल्ट रूप से, क्लोन किए गए डेटाबेस को सोर्स डेटाबेस की तरह ही एन्क्रिप्ट (सुरक्षित) किया जाएगा. इसके लिए, Google के डिफ़ॉल्ट एन्क्रिप्शन या सीएमईके एन्क्रिप्शन का इस्तेमाल किया जाएगा. सीएमईके एन्क्रिप्शन के लिए, एन्क्रिप्शन का कोई दूसरा टाइप तय किया जा सकता है या किसी दूसरी कुंजी का इस्तेमाल किया जा सकता है.

• टाइमस्टैंप में एक मिनट की जानकारी होती है. साथ ही, यह बीते समय के किसी पॉइंट की जानकारी देता है. यह जानकारी, पीआईटीआर विंडो में तय की गई अवधि के हिसाब से दी जाती है:

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

gcloud firestore databases clone \
--source-database='SOURCE_DATABASE' \
--snapshot-time='PITR_TIMESTAMP' \
--destination-database='DESTINATION_DATABASE_ID'

gcloud firestore databases clone \
--source-database='projects/example-project/databases/(default)' \
--snapshot-time='2025-06-01T10:20:00.00Z' \
--destination-database='example-dest-db'

gcloud firestore databases clone \
--source-database='projects/example-project/databases/(default)' \
--snapshot-time='2025-06-01T10:20:00.00Z' \
--destination-database='example-dest-db'

gcloud firestore databases clone \
--source-database='projects/example-project/databases/(default)' \
--snapshot-time='2025-06-01T10:20:00.00Z' \
--destination-database='example-dest-db' \
--encryption-type='customer-managed-encryption' \
--kms-key-name='projects/example-project/locations/us-central1/keyRings/example-key-ring/cryptoKeys/example-key'

firebase firestore:databases:clone \
'SOURCE_DATABASE' \
'DESTINATION_DATABASE' \
--snapshot-time 'PITR_TIMESTAMP'

हर डेटाबेस के लिए ऐक्सेस की अनुमतियां कॉन्फ़िगर करना

हर डेटाबेस के लेवल पर ऐक्सेस की अनुमतियां कॉन्फ़िगर करने के लिए, पहचान और ऐक्सेस मैनेजमेंट की शर्तों का इस्तेमाल किया जा सकता है. यहां दिए गए उदाहरणों में, एक या उससे ज़्यादा डेटाबेस के लिए शर्त के साथ ऐक्सेस असाइन करने के लिए, Google Cloud CLI का इस्तेमाल किया गया है. Google Cloud Console में आईएएम की शर्तें भी तय की जा सकती हैं.

मौजूदा IAM नीतियां देखना

gcloud projects get-iam-policy PROJECT_ID

PROJECT_ID को अपने प्रोजेक्ट आईडी पर सेट करें.

किसी डेटाबेस का ऐक्सेस देना

gcloud projects add-iam-policy-binding PROJECT_ID \
--member='user:EMAIL' \
--role='roles/datastore.user' \
--condition='expression=resource.name=="projects/PROJECT_ID/databases/DATABASE_ID",title=TITLE,description=DESCRIPTION'

ये सेट करें:

• PROJECT_ID: आपका प्रोजेक्ट आईडी
• EMAIL: ऐसा ईमेल पता जो किसी Google खाते से जुड़ा हो. उदाहरण के लिए, alice@example.com.
• DATABASE_ID: डेटाबेस आईडी.
• TITLE: एक्सप्रेशन के लिए वैकल्पिक टाइटल.
• DESCRIPTION: एक्सप्रेशन का ब्यौरा. यह ज़रूरी नहीं है.

एक डेटाबेस को छोड़कर, सभी डेटाबेस का ऐक्सेस देना

gcloud projects add-iam-policy-binding PROJECT_ID \
--member='user:EMAIL' \
--role='roles/datastore.user' \
--condition='expression=resource.name!="projects/PROJECT_ID/databases/DATABASE_ID",title=TITLE,description=DESCRIPTION'

ये सेट करें:

• PROJECT_ID: आपका प्रोजेक्ट आईडी
• EMAIL: ऐसा ईमेल पता जो किसी Google खाते से जुड़ा हो. उदाहरण के लिए, alice@example.com.
• DATABASE_ID: डेटाबेस आईडी.
• TITLE: एक्सप्रेशन के लिए वैकल्पिक टाइटल.
• DESCRIPTION: एक्सप्रेशन का ब्यौरा. यह ज़रूरी नहीं है.

किसी सदस्य और भूमिका के लिए नीतियां हटाना

gcloud projects remove-iam-policy-binding PROJECT_ID \
--member='user:EMAIL' \
--role='roles/datastore.user' --all

ये सेट करें:

• PROJECT_ID: आपका प्रोजेक्ट आईडी
• EMAIL: ऐसा ईमेल पता जो किसी Google खाते से जुड़ा हो. उदाहरण के लिए, alice@example.com.

Cloud Monitoring

Cloud Firestore मेट्रिक को मॉनिटर किए गए दो संसाधनों के तहत रिपोर्ट किया जाता है.

• firestore.googleapis.com/Database
• firestore_instance(लेगसी)

firestore.googleapis.com/Database को देखकर, डेटाबेस लेवल पर एग्रीगेट मेट्रिक की जांच की जा सकती है. firestore_instance में रिपोर्ट की गई मेट्रिक, प्रोजेक्ट लेवल पर एग्रीगेट की जाती हैं.

सीमाएं

• हर प्रोजेक्ट में ज़्यादा से ज़्यादा 100 डेटाबेस हो सकते हैं. इस सीमा को बढ़ाने का अनुरोध करने के लिए, सहायता टीम से संपर्क करें.
• अगर आपके (default) डेटाबेस में GAE सर्च का डेटा मौजूद है, तो उसे मिटाया नहीं जा सकता. GAE Search का डेटा मिटाने के लिए, इंडेक्स मिटाने वाले एपीआई का इस्तेमाल करें. अगर आपने हाल ही में GAE Search का डेटा मिटाया है, तो हो सकता है कि डेटाबेस को मिटाने से पहले आपको कुछ समय इंतज़ार करना पड़े.
• अगर आपके (default) डेटाबेस में कोई ब्लॉब इकाइयां हैं, तो उसे मिटाया नहीं जा सकता. Blobstore का डेटा मिटाने के लिए, Blobstore delete api का इस्तेमाल करें. Google Cloud console में यह GQL क्वेरी चलाकर, यह देखा जा सकता है कि आपके (default) डेटाबेस में Blobstore डेटा है या नहीं: SELECT * FROM __BlobInfo__.
• डेटाबेस आईडी को मिटाने के पांच मिनट बाद तक, उसका फिर से इस्तेमाल नहीं किया जा सकता.
• Cloud Functions v1 में, Firestore के नाम वाले डेटाबेस काम नहीं करते. नाम वाले डेटाबेस के लिए इवेंट कॉन्फ़िगर करने के लिए, Cloud Firestore ट्रिगर (दूसरी जनरेशन) का इस्तेमाल करें.
• डेटाबेस मिटाने के बाद, Firestore फ़ंक्शन ट्रिगर v1 और Firestore इवेंट ट्रिगर काम करना बंद कर सकते हैं. भले ही, उसी नाम से नया डेटाबेस बनाया गया हो.

आगे क्या करना है

• डेटा जोड़ना
• डेटा पाना
• डेटा मिटाना