נקודות קצה אזוריות וגלובליות
בדף הזה מתוארות נקודות הקצה של Bigtable, מוסבר מה צריך להביא בחשבון לפני שמשתמשים בהן ומוצג איך להגדיר נקודת קצה באמצעות ה-CLI של cbt.
כדי לשלוח בקשות ל-Bigtable, אתם יכולים להשתמש בנקודת קצה גלובלית או אזורית של השירות. נקודות קצה אזוריות ב-Bigtable מבטיחות שמיקום אחסון הנתונים של המכונה מאוחסן ומעובד באזור של Bigtable שבו הנתונים נמצאים. יכול להיות שתצטרכו להשתמש בנקודות קצה אזוריות של Bigtable באזור גיאוגרפי מסוים, כדי לתמוך בדרישות האבטחה והתאימות של הפרויקט.
לפני שאתם קוראים את המסמך הזה, כדאי שתכירו את המושגים מכונות, אשכולות וצמתים ופרופילי אפליקציות.
המושגים העיקריים כוללים:
נקודת קצה של שירות: כתובת URL בסיסית שמציינת את כתובת הרשת של שירות API. ל-Bigtable יש נקודות קצה גלובליות ואזוריות.
נקודת קצה גלובלית: מאפשרת ל-Bigtable לאחסן את הנתונים במכונה של Bigtable ולנתב אותם לכל אזור שמכיל אחד מהאשכולות של המכונה. נקודת הקצה הגלובלית של Cloud Bigtable API (Data API) היא
bigtable.googleapis.com. נקודת הקצה שמוגדרת כברירת מחדל ל-Data API ניגשת לנקודת הקצה הגלובלית.נקודת קצה אזורית: אוכפת הגבלות אזוריות, כדי להבטיח ש-Bigtable מאחסן ומעבד נתונים באזור מסוים. אפשר להשתמש בנקודות קצה אזוריות רק עם Cloud Bigtable API (Data API). ב-Bigtable אין תמיכה בנקודות קצה אזוריות ל-Cloud Bigtable Admin API.
מתי כדאי להשתמש בנקודות קצה אזוריות
היתרון של שימוש בנקודת קצה אזורית של Bigtable על פני נקודת קצה גלובלית הוא שנקודת הקצה האזורית מספקת בידוד והגנה אזוריים כדי לעמוד בדרישות האבטחה, התאימות והרגולציה.
עם זאת, נקודות קצה אזוריות לא תומכות ב-Data Boost או ב-Cloud Bigtable Admin API. בנוסף, אי אפשר להגדיר את Bigtable כך שיגיע לזמן פעולה תקינה חודשי של >=99.999% כשמשתמשים בנקודות קצה אזוריות. למידע נוסף, קראו את הקטע שיקולים לשימוש בנקודת קצה אזורית במסמך הזה.
מתי כדאי להשתמש בנקודות קצה גלובליות
כדאי להשתמש בנקודת קצה גלובלית במקרים הבאים:
- אין לכם דרישות להגבלה אזורית שמחייבות שימוש בנקודת קצה אזורית.
- אתם צריכים להשתמש ב-Data Boost.
- אתם צריכים להשתמש ב-Cloud Bigtable Admin API.
- אתם צריכים אחוז זמן פעולה תקינה חודשי של 99.999% לפחות.
שיקולים לשימוש בנקודת קצה אזורית
אם אתם משתמשים בנקודת קצה אזורית, חשוב לשים לב לדברים הבאים:
מיקומי אשכולות
כדי להשתמש בנקודת קצה אזורית, צריך ליצור מכונה עם אשכול אחד לפחות באזור שבו רוצים לבודד את הנתונים. נקודות קצה אזוריות של Bigtable זמינות באזורים נבחרים של Bigtable. כאן תוכלו למצוא רשימה של האזורים הזמינים.
אפשר להשתמש רק בנקודת קצה אזורית ששייכת לאזור שבו רוצים לבודד את הנתונים. לדוגמה, אם האשכול נמצא באזור us-central1, אי אפשר להשתמש ב-bigtable.us-west1.rep.googleapis.com כדי להציג בקשות.
אם תנסו להשתמש בנקודת קצה אזורית כדי לגשת לאשכול שנמצא באזור אחר, Bigtable ידחה את הבקשה עם הודעת השגיאה FAILED_PRECONDITION, שבה מצוין שאי אפשר לגשת לאשכולות באמצעות האשכול ונקודת הקצה שצוינו. למידע נוסף על הודעת השגיאה הזו, ראו קודי סטטוס של Bigtable.
פרופילי אפליקציות
אחרי שמגדירים נקודת קצה אזורית, צריך להשתמש בפרופיל אפליקציה שמוגדר לנתב בקשות לאשכול באזור של נקודת הקצה.
אם תנסו להשתמש בפרופיל אפליקציה שמוגדר לשלוח פעולות כתיבה רק לאשכול (באמצעות ניתוב לאשכול יחיד) או לאשכולות באזור שונה מנקודת הקצה (באמצעות ניתוב למספר אשכולות), תופיע הודעת השגיאה FAILED_PRECONDITION. מידע נוסף על ניתוב אשכולות זמין במאמר מדיניות ניתוב.
אם אתם משתמשים בפרופיל אפליקציה שמוגדר לניתוב לכל אשכול במכונה לזמינות גבוהה (HA), ומשתמשים גם בנקודת קצה אזורית, נקודת הקצה האזורית מבטיחה שכל הבקשות ינותבו רק לאשכולות באזור שלה, גם אם למכונה יש אשכולות באזורים אחרים. יתירות כשל אוטומטית מוגבלת, כך שהבקשות מטופלות רק על ידי אשכולות באזור של נקודת הקצה.
לדוגמה, נניח שאתם שולחים בקשות באמצעות פרופיל אפליקציה שמוגדר לניתוב בכמה אשכולות, למכונה שיש לה אשכולות ב-us-west1-a (אורגון), ב-us-west1-b (אורגון) וב-us-central1-a (איווה). אם תשלחו את הבקשות האלה לנקודת הקצה האזורית bigtable.us-central1.rep.googleapis.com, כל הבקשות יטופלו על ידי us-central1-a גם אם לא תגדירו מחדש את פרופיל האפליקציה. בקשות שלא ניתן להגיש באמצעות us-central1-a נכשלות.
רפליקציה
נקודות קצה אזוריות לא משפיעות על הרפליקציה ולא מונעות אותה. אם מגדירים נקודת קצה אזורית באזור א', ואז מוסיפים אשכול למכונה באזור ב', הנתונים משוכפלים לאזור ב' בדיוק כמו בשימוש בנקודת קצה גלובלית.
כדי להימנע מרפליקציה של נתונים לאזור אחר, צריך ליצור אשכולות רק באזור הרצוי.
כדי למנוע ממשתמשים בארגון להוסיף אשכולות מחוץ לאזור נקודת הקצה, אתם יכולים להגדיר מדיניות ארגונית שמשתמשת באילוצי מיקום.
זמינות
כשמשתמשים בנקודות קצה אזוריות, אי אפשר להגדיר את Bigtable כך שיגיע לאחוז זמן פעולה תקינה חודשי של >=99.999%. כדי להגיע לזמן פעולה תקינה חודשי של >=99.999%, צריך להגדיר מעבר אוטומטי לגיבוי בעת כשל של בקשות מעבר לגבולות האזור. נקודת קצה אזורית מונעת מעבר אוטומטי למקרה של כשל, כי היא מגבילה את כל הבקשות לאזור אחד. למידע נוסף על אחוזי זמן הפעולה התקינה החודשיים, קראו את הסכם רמת השירות (SLA) של Bigtable.
סמנטיקה של נקודות קצה אזוריות
נקודת קצה אזורית מופיעה בפורמט bigtable.REGION.rep.googleapis.com, כאשר REGION הוא שם של אזור ב- Google Cloud , כמו northamerica-northeast2.
לדוגמה, אם רוצים לבודד את הנתונים באזור איווה, שם האזור של איווה הוא us-central1, ולכן כתובת ה-URL של נקודת הקצה האזורית של אזור איווה היא bigtable.us-central1.rep.googleapis.com.
ציון נקודת קצה אזורית
אפשר לציין נקודת קצה אזורית של Bigtable באמצעות ה-CLI של cbt או ספריות הלקוח של Cloud Bigtable.
cbt
כדי לציין נקודת קצה אזורית ולבטל את נקודת הקצה הגלובלית באמצעות ה-CLI של cbt, אתם יכולים להשתמש באפשרות --data-endpoint בבקשה, או להוסיף את הקוד הבא לקובץ ~/.cbtrc. למידע נוסף על יצירת קובץ ~/.cbtrc, קראו את המסמך בנושא CLI של cbt.
data-endpoint = https://bigtable.REGION.rep.googleapis.com/
מחליפים את REGION באזור שבו רוצים להגדיר נקודת קצה אזורית, כמו us-central1 או europe-west1.
לדוגמה, כדי להגדיר את נקודת הקצה האזורית בתור us-central1, מוסיפים את הקוד הבא לקובץ ~/.cbtrc:
data-endpoint = https://bigtable.us-central1.rep.googleapis.com/
מציינים את נקודת הקצה הגלובלית
cbt
כדי לציין את נקודת הקצה הגלובלית, שולחים את הבקשה בלי להשתמש באפשרות --data-endpoint. אם הוספתם בעבר שורה של data-endpoint לקובץ ~/.cbtrc, מחקו אותה.
הגבלת השימוש בנקודת קצה גלובלית ל-API
כדי לאכוף את השימוש בנקודות קצה אזוריות, אתם יכולים להשתמש באילוץ מדיניות הארגון constraints/gcp.restrictEndpointUsage כדי לחסום בקשות לנקודת הקצה הגלובלית של ה-API. מידע נוסף מופיע במאמר הגבלת השימוש בנקודות קצה (endpoints).