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

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

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

डेटाबेस बनाने और मैनेज करने के लिए, आपके पास यह Identity and Access Management भूमिका होनी चाहिए:

• 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 जैसे आईडी का इस्तेमाल न करें.

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

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

सुरक्षा की सुविधा बंद करना

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

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

Firebase CLI का इस्तेमाल करके, अपने हर डेटाबेस में Cloud Firestore Security Rules को डिप्लॉय करें. 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 को किसी डेटाबेस आईडी से बदलें.

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

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 के डिफ़ॉल्ट एन्क्रिप्शन या CMEK एन्क्रिप्शन का इस्तेमाल किया जाएगा. CMEK एन्क्रिप्शन के लिए, एन्क्रिप्शन का कोई दूसरा टाइप तय किया जा सकता है या किसी दूसरी कुंजी का इस्तेमाल किया जा सकता है.

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

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

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(Legacy)

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

सीमाएं

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

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

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