रीजनल एंडपॉइंट के साथ डेटा लोकैलिटी कॉन्फ़िगर करना

इस पेज पर, Cloud Firestore क्लाइंट लाइब्रेरी को कॉन्फ़िगर करने का तरीका बताया गया है, ताकि वे किसी रीजनल या मल्टी-रीजनल एंडपॉइंट का इस्तेमाल कर सकें.

Cloud Firestore क्लाइंट लाइब्रेरी का इस्तेमाल करते समय, इनमें से किसी भी एंडपॉइंट का इस्तेमाल किया जा सकता है:

  • ग्लोबल एंडपॉइंट: डिफ़ॉल्ट रूप से, Cloud Firestore क्लाइंट लाइब्रेरी, एपीआई अनुरोधों को firestore.googleapis.com नाम के ग्लोबल सर्विस एंडपॉइंट पर भेजती हैं. ग्लोबल सर्विस एंडपॉइंट, अनुरोध को आपके डेटाबेस पर भेजता है. राउटिंग के दौरान, अनुरोध किसी ऐसी जगह के सर्वर से होकर गुज़र सकता है जो आपके डेटाबेस की जगह से अलग हो.

  • क्षेत्रीय एंडपॉइंट: क्षेत्रीय एंडपॉइंट, पाबंदियां लागू करता है. इससे यह पक्का किया जाता है कि डेटा को किसी तय Google Cloud क्षेत्र में ट्रांसमिट, स्टोर, और प्रोसेस किया जाए. यह पक्का करने के लिए कि सेवा का एंडपॉइंट, आपके ऐप्लिकेशन के Cloud Firestore अनुरोधों को उसी इलाके में प्रोसेस करे जहां आपका डेटाबेस है, क्लाइंट लाइब्रेरी में क्षेत्रीय एंडपॉइंट तय करें.

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

क्षेत्रीय या एक से ज़्यादा क्षेत्रों के लिए एंडपॉइंट सेट करना

किसी क्षेत्र या एक से ज़्यादा क्षेत्रों के लिए एंडपॉइंट को कॉन्फ़िगर करने का तरीका एक जैसा होता है: क्लाइंट लाइब्रेरी को शुरू करते समय, एंडपॉइंट स्ट्रिंग दी जाती है. यहां दिए गए उदाहरणों में, रीजनल एंडपॉइंट (firestore.us-central1.rep.googleapis.com) का इस्तेमाल करके एंडपॉइंट स्ट्रिंग सेट करने का तरीका बताया गया है. एक से ज़्यादा क्षेत्रों के लिए उपलब्ध एंडपॉइंट का इस्तेमाल करने के लिए, अपने डेटाबेस की जगह के हिसाब से एक से ज़्यादा क्षेत्रों के लिए उपलब्ध एंडपॉइंट स्ट्रिंग दें. उदाहरण के लिए, nam5 के लिए firestore.us.rep.googleapis.com.

Java


import com.google.auth.oauth2.GoogleCredentials;
import com.google.cloud.firestore.Firestore;
import com.google.cloud.firestore.FirestoreOptions;


/**
 * Demonstrate how to set a regional endpoint.
 */
public class RegionalEndpointSnippets {

  /**
   * Create a client with a regional endpoint.
   **/
  public Firestore regionalEndpoint(String projectId, String endpoint) throws Exception {
    FirestoreOptions firestoreOptions =
        FirestoreOptions.newBuilder()
            .setProjectId(projectId)
            .setCredentials(GoogleCredentials.getApplicationDefault())
            // set endpoint like firestore.us-central1.rep.googleapis.com:443
            .setHost(endpoint)
            .build();
    Firestore dbWithEndpoint = firestoreOptions.getService();

    return dbWithEndpoint;
  }

}
RegionalEndpointSnippets.java

Python

ENDPOINT = "firestore.africa-south1.rep.googleapis.com"
client_options = ClientOptions(api_endpoint=ENDPOINT)
db = firestore.Client(client_options=client_options)

cities_query = db.collection("cities").limit(2).get()
for r in cities_query:
    print(r)
snippets.py

रीजनल और मल्टी-रीजनल एंडपॉइंट के सिमैंटिक

क्षेत्रीय एंडपॉइंट (आरईपी):

Cloud Firestore, यहां दी गई जगहों Cloud Firestore जगहों के लिए रीजनल एंडपॉइंट इस्तेमाल करता है.

क्षेत्र के हिसाब से एंडपॉइंट तय करने के लिए, इस फ़ॉर्मैट का इस्तेमाल करें:

Java

  firestore.REGION_NAME.rep.googleapis.com:443

पक्का करें कि एंडपॉइंट के साथ पोर्ट नंबर भी तय किया गया हो.

Python

  firestore.REGION_NAME.rep.googleapis.com

शुरू करें

  firestore.REGION_NAME.rep.googleapis.com:443

पक्का करें कि एंडपॉइंट के साथ पोर्ट नंबर भी तय किया गया हो.

REGION_NAME की जगह, किसी क्षेत्रीय होस्टनेम का नाम डालें.

होस्टनेम के कुछ उदाहरण यहां दिए गए हैं:

  • firestore.us-central1.rep.googleapis.com
  • firestore.europe-west1.rep.googleapis.com

एक से ज़्यादा क्षेत्रों के एंडपॉइंट (एमआरईपी)

कई इलाकों के लिए उपलब्ध कराए जाने वाले एंडपॉइंट के लिए, us nam5 और nam7 का इस्तेमाल करें. साथ ही, eu का इस्तेमाल eur3 के लिए करें (कई इलाकों के लिए उपलब्ध कराई जाने वाली जगह की जानकारी देखें).

Java

  firestore.us.rep.googleapis.com:443
  firestore.eu.rep.googleapis.com:443

पक्का करें कि एंडपॉइंट के साथ पोर्ट नंबर भी तय किया गया हो.

Python

  firestore.us.rep.googleapis.com
  firestore.eu.rep.googleapis.com

शुरू करें

  firestore.us.rep.googleapis.com:443
  firestore.eu.rep.googleapis.com:443

पक्का करें कि एंडपॉइंट के साथ पोर्ट नंबर भी तय किया गया हो.

सीमाएं

जगह के हिसाब से एंडपॉइंट (अब सेवा में नहीं है)

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

Cloud Firestore पहले, जगह के हिसाब से काम करने वाले एंडपॉइंट के साथ काम करता था. इसका फ़ॉर्मैट यह था:

Java

  REGION_NAME-firestore.googleapis.com:443

पक्का करें कि एंडपॉइंट के साथ पोर्ट नंबर भी तय किया गया हो.

Python

  REGION_NAME-firestore.googleapis.com

शुरू करें

  REGION_NAME-firestore.googleapis.com:443

पक्का करें कि एंडपॉइंट के साथ पोर्ट नंबर भी तय किया गया हो.

REGION_NAME को किसी क्षेत्र या एक से ज़्यादा क्षेत्रों के होस्टनेम के नाम से बदलें.

होस्टनेम के कुछ उदाहरण यहां दिए गए हैं:

  • eur3-firestore.googleapis.com
  • nam5-firestore.googleapis.com
  • europe-west6-firestore.googleapis.com
  • asia-northeast2-firestore.googleapis.com

एक से ज़्यादा देशों/इलाकों और किसी देश/इलाके के हिसाब से होस्टनेम की पूरी सूची देखने के लिए, Cloud Firestore जगहें देखें.

ग्लोबल एपीआई एंडपॉइंट के इस्तेमाल पर पाबंदी लगाना

क्षेत्रीय और एक से ज़्यादा क्षेत्रों के एंडपॉइंट के इस्तेमाल को लागू करने के लिए, constraints/gcp.restrictEndpointUsage संगठन की नीति से जुड़ी पाबंदी का इस्तेमाल करें. इससे ग्लोबल एपीआई एंडपॉइंट के अनुरोधों को ब्लॉक किया जा सकता है. ज़्यादा जानकारी के लिए, एंडपॉइंट के इस्तेमाल पर पाबंदी लगाना लेख पढ़ें.