پیکربندی محلی بودن داده‌ها با نقاط پایانی منطقه‌ای

این صفحه نحوه پیکربندی کتابخانه‌های مشتری Cloud Firestore را برای استفاده از نقطه پایانی منطقه‌ای یا چندمنطقه‌ای شرح می‌دهد.

وقتی از کتابخانه‌های مشتری Cloud Firestore استفاده می‌کنید، می‌توانید از هریک از نقاط پایانی زیر استفاده کنید:

• نقطه پایانی جهانی: به‌طور پیش‌فرض، کتابخانه‌های کارخواه Cloud Firestore درخواست‌های API را به نقطه پایانی سرویس جهانی به‌نام 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

Multi-regional Endpoints (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 مکان‌ها مراجعه کنید.

محدود کردن استفاده از نقطه پایان API جهانی

برای کمک به اجرای استفاده از نقاط پایانی منطقه‌ای و چندمنطقه‌ای، از محدودیت خط‌مشی سازمانی constraints/gcp.restrictEndpointUsage برای مسدود کردن درخواست‌ها به نقطه پایانی میانای برنامه‌سازی کاربردی جهانی استفاده کنید. برای اطلاعات بیشتر، به محدود کردن استفاده از نقطه پایانی مراجعه کنید.