הגדרת מיקום נתונים באמצעות נקודות קצה אזוריות

בדף הזה מוסבר איך להגדיר את ספריות הלקוח של Firestore במצב Datastore כדי להשתמש בנקודת קצה אזורית או בנקודת קצה שמנוהלת במספר אזורים.

כשמשתמשים בספריות לקוח של Firestore במצב Datastore, אפשר להשתמש בכל אחת מנקודות הקצה הבאות:

  • נקודת קצה גלובלית: כברירת מחדל, ספריות הלקוח של Firestore במצב Datastore שולחות בקשות API לנקודת קצה גלובלית של שירות בשם datastore.googleapis.com. נקודת הקצה הגלובלית של השירות מנתבת את הבקשה למסד הנתונים שלכם. במהלך הניתוב, יכול להיות שהבקשה תעבור דרך שרת במיקום ששונה ממיקום מסד הנתונים.

  • נקודת קצה אזורית: נקודת קצה אזורית אוכפת הגבלות כדי להבטיח שהנתונים ישודרו, יאוחסנו ויעובדו באזור Google Cloud מסוים. כדי לוודא שנקודת הקצה של השירות מעבדת את הבקשות של האפליקציה ל-Firestore במצב Datastore באותו אזור שבו נמצאת מסד הנתונים, צריך לציין נקודת קצה אזורית בספריית הלקוח.

  • נקודת קצה מרובת אזורים: נקודת קצה מרובת אזורים אוכפת הגבלות כדי להבטיח שהנתונים ישודרו, יאוחסנו ויעובדו ב Google Cloud מספר אזורים שצוינו. כדי לוודא שנקודת הקצה של השירות מעבדת את הבקשות של האפליקציה ל-Firestore במצב Datastore באותו אזור מרובה כמו מסד הנתונים, צריך לציין נקודת קצה מרובת אזורים בספריית הלקוח.

הגדרת נקודת קצה אזורית או רב-אזורית

השיטה להגדרת נקודת קצה אזורית או עם מספר אזורים זהה: צריך לספק את מחרוזת נקודת הקצה כשמפעילים את ספריית הלקוח. בדוגמאות הבאות מוצג איך להגדיר את מחרוזת נקודת הקצה באמצעות נקודת קצה אזורית (datastore.us-central1.rep.googleapis.com). כדי להשתמש בנקודת קצה עם מספר אזורים, צריך לספק מחרוזת של נקודת קצה עם מספר אזורים שתואמת למיקום של מסד הנתונים (לדוגמה, datastore.us.rep.googleapis.com עבור nam5).

Java

מידע על התקנת ספריית הלקוח למצב Datastore ושימוש בה מופיע במאמר ספריות הלקוח של מצב Datastore. מידע נוסף מופיע במאמרי העזרה של Datastore mode Java API.

כדי לבצע אימות במצב Datastore, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית. 


import com.google.cloud.datastore.Datastore;
import com.google.cloud.datastore.DatastoreOptions;

public class RegionalEndpoint {

  public Datastore createClient() throws Exception {
    // Instantiates a client
    DatastoreOptions options =
        DatastoreOptions.newBuilder().setHost("https://datastore.us-central1.rep.googleapis.com").build();
    Datastore datastore = options.getService();
    return datastore;
  }
}

Python

מידע על התקנת ספריית הלקוח למצב Datastore ושימוש בה מופיע במאמר ספריות הלקוח של מצב Datastore. מידע נוסף מופיע במאמרי העזרה של Datastore mode Python API.

כדי לבצע אימות במצב Datastore, צריך להגדיר את Application Default Credentials. מידע נוסף זמין במאמר הגדרת אימות לסביבת פיתוח מקומית. 

from google.cloud import datastore
from google.api_core.client_options import ClientOptions

ENDPOINT = "https://datastore.africa-south1.rep.googleapis.com"
client_options = ClientOptions(api_endpoint=ENDPOINT)
client = datastore.Client(client_options=client_options)

query = client.query(kind="Task")
results = list(query.fetch())
for r in results:
    print(r)

סמנטיקה של נקודות קצה אזוריות ורב-אזוריות

נקודות קצה אזוריות

‫Firestore במצב Datastore תומך בנקודות קצה אזוריות למיקומים אזוריים שמפורטים כאן: מיקומים של Firestore במצב Datastore.

כדי להגדיר נקודות קצה אזוריות, צריך להשתמש בפורמט הבא:

Java

    datastore.REGION_NAME.rep.googleapis.com:443

מוודאים שמספר היציאה מוגדר יחד עם נקודת הקצה.

Python

    datastore.REGION_NAME.rep.googleapis.com

המשך

    datastore.REGION_NAME.rep.googleapis.com:443

מוודאים שמספר היציאה מוגדר יחד עם נקודת הקצה.

מחליפים את REGION_NAME בשם של מארח אזורי.

דוגמאות לשמות מארחים:

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

נקודות קצה במספר אזורים

לנקודות קצה במספר אזורים, משתמשים ב-us למיקומים nam5 ו-nam7, וב-eu למיקום eur3 (ראו מיקומים במספר אזורים).

Java

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

מוודאים שמספר היציאה מוגדר יחד עם נקודת הקצה.

Python

    datastore.us.rep.googleapis.com
    datastore.eu.rep.googleapis.com

המשך

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

מוודאים שמספר היציאה מוגדר יחד עם נקודת הקצה.

נקודות קצה למיקום (הוצא משימוש)

נקודות קצה למיקום הוצאו משימוש. במקום זאת, השתמשו בנקודות קצה אזוריות או בנקודות קצה עם מספר אזורים.

בעבר, מערכת Firestore במצב Datastore תמכה בנקודות קצה לפי מיקום בפורמט הבא:

Java

  https://REGION_NAME-datastore.googleapis.com:443

חשוב לוודא שמשתמשים בכתובת ה-URL המלאה https ושמספר היציאה מוגדר יחד עם נקודת הקצה.

Python

  https://REGION_NAME-datastore.googleapis.com

מוודאים שכתובת ה-URL המלאה https מוגדרת כנקודת הקצה של המיקום.

המשך

  REGION_NAME-datastore.googleapis.com:443

מוודאים שמספר היציאה מוגדר יחד עם נקודת הקצה.

מחליפים את REGION_NAME בשם של מארח אזורי או רב-אזורי.

דוגמאות לשמות מארחים:

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

רשימה מלאה של שמות מארחים אזוריים ורב-אזוריים זמינה במאמר מיקומים של Firestore במצב Datastore.

הגבלת השימוש בנקודת קצה ל-API גלובלית

כדי לאכוף את השימוש בנקודות קצה אזוריות ורב-אזוריות, אפשר להשתמש במגבלת מדיניות הארגון constraints/gcp.restrictEndpointUsage כדי לחסום בקשות לנקודת הקצה הגלובלית של ה-API. מידע נוסף מופיע במאמר בנושא הגבלת השימוש בנקודות קצה.

המאמרים הבאים