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

این صفحه نحوه پیکربندی کتابخانه‌های کارخواه 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;
  }

}

پایتون

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)

معناشناسی نقطه پایانی منطقه‌ای و چندمنطقه‌ای

پایانه‌های منطقه‌ای (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 مراجعه کنید.

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

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