ضبط موضع البيانات باستخدام نقاط نهاية إقليمية

توضّح هذه الصفحة كيفية ضبط مكتبات برامج Cloud Firestore لاستخدام نقطة نهاية إقليمية أو متعددة المناطق.

عند استخدام مكتبات عملاء Cloud Firestore، يمكنك استخدام أي من نقاط النهاية التالية:

• نقطة النهاية العامة: ترسل مكتبات عملاء Cloud Firestore تلقائيًا طلبات البيانات من واجهة برمجة التطبيقات إلى نقطة نهاية خدمة عامة باسم firestore.googleapis.com. توجّه نقطة نهاية الخدمة العامة الطلب إلى قاعدة بياناتك. أثناء التوجيه، قد يمر الطلب عبر خادم في موقع جغرافي مختلف عن موقع قاعدة البيانات.

• نقطة النهاية الإقليمية: تفرض نقطة النهاية الإقليمية قيودًا تضمن نقل البيانات وتخزينها ومعالجتها في منطقة Google Cloud محدّدة. لضمان أن تعالج نقطة نهاية الخدمة طلبات Cloud Firestore الخاصة بتطبيقك في المنطقة نفسها التي توجد بها قاعدة بياناتك، حدِّد نقطة نهاية إقليمية في مكتبة البرامج.

• نقطة نهاية متعددة المناطق: تفرض نقطة النهاية المتعددة المناطق قيودًا تضمن تخزين البيانات ومعالجتها في منطقة متعددة محدّدة. لضمان أنّ نقطة نهاية الخدمة تعالج طلبات Cloud Firestore الخاصة بتطبيقك في المنطقة المتعدّدة نفسها التي توجد بها قاعدة بياناتك، حدِّد نقطة نهاية متعدّدة المناطق في مكتبة البرامج.

ضبط نقطة نهاية إقليمية أو متعددة المناطق

طريقة ضبط نقطة نهاية إقليمية أو متعددة المناطق هي نفسها: عليك تقديم سلسلة نقطة النهاية عند إعداد مكتبة العميل. توضّح الأمثلة التالية كيفية ضبط سلسلة نقطة النهاية باستخدام نقطة نهاية إقليمية (firestore.us-central1.rep.googleapis.com). لاستخدام نقطة نهاية متعددة المناطق، يجب تقديم سلسلة نقطة نهاية متعددة المناطق تتوافق مع موقع قاعدة البيانات (على سبيل المثال، firestore.us.rep.googleapis.com لـ nam5).

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

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

دلالات نقاط النهاية الإقليمية والمتعددة المناطق

نقاط النهاية الإقليمية (REP):

تتيح Cloud Firestore نقاط النهاية الإقليمية للمواقع الجغرافية الإقليمية المدرَجة هنا مواقع Cloud Firestore الجغرافية.

استخدِم التنسيق التالي لتحديد نقاط النهاية الإقليمية:

  firestore.REGION_NAME.rep.googleapis.com:443

  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

نقاط النهاية المتعدّدة المناطق (MREP)

بالنسبة إلى نقاط النهاية المتعددة المناطق، استخدِم us للموقعَين الجغرافيَين nam5 وnam7، وeu للموقع الجغرافي eur3 (يُرجى الاطّلاع على المواقع الجغرافية المتعددة المناطق).

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

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

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

القيود

• لا تتيح نقاط النهاية الإقليمية والمتعددة المناطق استخدام أدوات الاستماع في الوقت الفعلي.

نقاط النهاية المستندة إلى الموقع الجغرافي (متوقّفة نهائيًا)

تم إيقاف نقاط النهاية المستندة إلى الموقع الجغرافي نهائيًا. استخدِم نقاط النهاية الإقليمية أو المتعددة المناطق بدلاً من ذلك.

في السابق، كانت واجهة برمجة التطبيقات Cloud Firestore تتيح استخدام نقاط النهاية المستندة إلى الموقع الجغرافي بالتنسيق التالي:

  REGION_NAME-firestore.googleapis.com:443

  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 لحظر الطلبات الموجَّهة إلى نقطة نهاية واجهة برمجة التطبيقات العالمية. لمزيد من المعلومات، يُرجى الاطّلاع على تقييد استخدام نقاط النهاية.