डेटाबेस बनाना और उन्हें मैनेज करना

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

फ़्री टियर का इस्तेमाल

Cloud Firestore में फ़्री टियर की सुविधा है. इसकी मदद से, बिना किसी शुल्क के शुरुआत की जा सकती है.

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

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

डेटाबेस बनाने से पहले, आपको ये काम करने होंगे:

1. अगर आपने पहले से कोई Firebase प्रोजेक्ट नहीं बनाया है, तो कोई Firebase प्रोजेक्ट बनाएं: Firebase कंसोल में, प्रोजेक्ट जोड़ें पर क्लिक करें. इसके बाद, Firebase प्रोजेक्ट बनाने या किसी मौजूदा Google Cloud प्रोजेक्ट में Firebase की सेवाएं जोड़ने के लिए, स्क्रीन पर दिए गए निर्देशों का पालन करें.

2. अगले सेक्शन में बताए गए तरीके के मुताबिक, पहचान और ऐक्सेस मैनेजमेंट की सही भूमिकाएं असाइन करें.

ज़रूरी भूमिकाएं

डेटाबेस बनाने और मैनेज करने के लिए, आपके पास Owner या Datastore Owner पहचान और ऐक्सेस मैनेजमेंट की भूमिका होनी चाहिए. इन भूमिकाओं से ज़रूरी अनुमतियां मिलती हैं.

ज़रूरी अनुमतियां

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

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

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

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

gcloud firestore databases create \
--database=DATABASE_ID \
--location=LOCATION \
--edition=enterprise \
--enable-firestore-data-access \
--enable-realtime-updates

डेटाबेस आईडी

मान्य डेटाबेस आईडी में, ऐसे आईडी शामिल होते हैं जो इन शर्तों को पूरा करते हैं:

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

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

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

डेटाबेस को गलती से मिटने से बचाने के लिए, मिटाने से रोकने की सुविधा का इस्तेमाल करें. मिटाए जाने से सुरक्षा की सुविधा इस तरह काम करती है:

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

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

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

gcloud firestore databases list

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

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

gcloud firestore databases describe --database=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 को डेटाबेस आईडी से बदलें.

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

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

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

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/example-source-db' \
--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' \
--tags=key1=value1,key2=value2

gcloud firestore databases clone \
--source-database='projects/example-project/databases/example-source-db' \
--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: किसी खास खाते को दिखाने वाला ईमेल पता. उदाहरण के लिए, 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: किसी खास खाते को दिखाने वाला ईमेल पता. उदाहरण के लिए, 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: किसी खास खाते को दिखाने वाला ईमेल पता. उदाहरण के लिए, alice@example.com.

सीमाएं

हर प्रोजेक्ट में ज़्यादा से ज़्यादा 100 डेटाबेस हो सकते हैं. इस सीमा को बढ़ाने का अनुरोध करने के लिए, सहायता टीम से संपर्क करें.

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

• क्विकस्टार्ट: डेटाबेस बनाएं और उससे कनेक्ट करें को चलाएं.
• काम करने के तरीके में अंतर के बारे में जानें.
• Cloud Firestore के लिए Cloud Monitoring मेट्रिक के बारे में जानें.