יכול להיות שחלק מהמידע בדף הזה או כולו לא רלוונטי ל-Cloud de Confiance by S3NS. פרטים נוספים מופיעים במאמר מה ההבדל מ-Google Cloud.

‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

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

בדף הזה מוסבר איך משתמשים בנקודות קצה אזוריות של Private Service Connect כדי לגשת למשאבים ב-BigQuery. נקודות קצה אזוריות מאפשרות להריץ את עומסי העבודה באופן שתואם לדרישות של מיקום אחסון הנתונים וריבונות הנתונים, שבהן תנועת הבקשות מנותבת ישירות לאזור שצוין בנקודת הקצה.

סקירה כללית

נקודות קצה אזוריות הן נקודות קצה של בקשות, שמאפשרות לשלוח בקשה רק אם המשאב המושפע נמצא במיקום שצוין בנקודת הקצה. לדוגמה, אם אתם משתמשים בנקודת הקצה https://bigquery.us-central1.rep.googleapis.com בבקשה למחיקת מערך נתונים, הבקשה תתבצע רק אם מערך הנתונים נמצא ב-US-CENTRAL1.

בניגוד לנקודות קצה גלובליות, שבהן הבקשות יכולות להיות מנותבות דרך מיקום שונה מזה שבו נמצא המשאב, נקודות קצה אזוריות יכולות לעזור להגביל את הבקשות למיקום שצוין בנקודת הקצה שבה נמצא המשאב. נקודות קצה אזוריות מסיימות סשנים של TLS במיקום שצוין על ידי נקודת הקצה לבקשות שהתקבלו מהאינטרנט, ממשאבים אחרים שלCloud de Confiance by S3NS (כמו מכונות וירטואליות של Compute Engine), משירותים מקומיים שמשתמשים ב-VPN או ב-Interconnect ומעננים וירטואליים פרטיים (VPC).

נקודות קצה אזוריות עוזרות להבטיח את מיקום אחסון הנתונים, כי הן שומרות את נתוני הטבלה במצב מנוחה ובמצב העברה במיקום שצוין על ידי נקודת הקצה. ההגדרה הזו לא כוללת מטא-נתונים של משאבים, כמו שמות של מערכי נתונים ומדיניות IAM. מידע נוסף זמין בקטע הערה לגבי נתוני שירות.

‫BigQuery כולל כמה ממשקי API. אפשר להשתמש בממשקי ה-API הבאים עם נקודת קצה אזורית:

API	כתובת URL	חומרי עזר
BigQuery API	`bigquery.LOCATION.rep.googleapis.com`	REST
BigQuery Storage API	`bigquerystorage.LOCATION.rep.googleapis.com`	RPC
BigQuery Reservations API	`bigqueryreservation.LOCATION.rep.googleapis.com`	‫RPC ו-REST
BigQuery Migration API	`bigquerymigration.LOCATION.rep.googleapis.com`	REST
BigQuery Data Transfer Service API	`bigquerydatatransfer.LOCATION.rep.googleapis.com`	‫RPC ו-REST

מיקומים נתמכים

אתם יכולים להשתמש בנקודות קצה אזוריות כדי לשמור את הנתונים במיקומים הבאים:

אסיה-פסיפיק
- דלהי asia-south2
- מומבאי asia-south1
אירופה
- בלגיה europe-west1
- ברלין europe-west10
- פרנקפורט europe-west3
- לונדון europe-west2
- מילאנו europe-west8
- הולנד europe-west4
- פריז europe-west9
- ציריך europe-west6
המזרח התיכון
- דמאם me-central2
אמריקה
- קולומבוס, אוהיו us-east5
- דאלאס us-south1
- איווה us-central1
- לאס וגאס us-west4
- לוס אנג'לס us-west2
- מונטריאול northamerica-northeast1
- צפון וירג'יניה us-east4
- אורגון us-west1
- סולט לייק סיטי us-west3
- קרוליינה הדרומית us-east1
- טורונטו northamerica-northeast2

פעולות נתמכות

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

לדוגמה, כשמשתמשים בנקודת הקצה האזורית https://bigquery.us-central1.rep.googleapis.com, אפשר לקרוא טבלאות במערכי נתונים שנמצאים ב-US-CENTRAL1, ולהעתיק טבלה ממערך נתונים של מקור למערך נתונים של יעד רק כששני מערכי הנתונים נמצאים ב-US-CENTRAL1. אם תנסו לקרוא או להעתיק טבלה מחוץ ל-US-CENTRAL1, תופיע הודעת שגיאה.

מגבלות והגבלות

אי אפשר להשתמש בנקודות קצה אזוריות כדי לבצע את הפעולות הבאות:

פעולות שניגשות למשאבים או משנות משאבים מחוץ למיקום שצוין בנקודת הקצה
העתקה, שכפול או שכתוב של משאבים ממיקום אחד לאחר.

כשמשתמשים בנקודות קצה אזוריות, חשוב לזכור את ההגבלות הבאות:

נקודות קצה אזוריות לא תומכות ב-Transport Layer Security (mTLS) הדדי.
שימוש בנקודת קצה אזורית לא יגביל את יצירת המשאבים מחוץ לאזור של נקודת הקצה. כדי להגביל את יצירת המשאבים, משתמשים באילוץ על מיקומי המשאבים של שירות מדיניות הארגון.
הגנה על נקודות קצה לא מגבילה את השכפול של מערכי נתונים באזורים שונים ואת ההעתקה של טבלאות באזורים שונים.
בנקודות קצה אזוריות אי אפשר להריץ שאילתות עם אחזור נתונים גלובלי.

כלים לשימוש בנקודות קצה אזוריות

המסוף

כדי לגשת למשאבי BigQuery באופן שתואם לדרישות של מיקום אחסון הנתונים או ריבונות הנתונים, צריך להשתמש בכתובות ה-URL של המסוףCloud de Confiance בהתאם לסמכות השיפוט:

משאב	כתובת URL
רשימת מערכי נתונים לפרויקט	`https://console.JURISDICTION.cloud.google.com/bigquery?project=PROJECT_ID`
רשימת הטבלאות של מערך נתונים	`https://console.JURISDICTION.cloud.google.com/bigquery/projects/PROJECT_ID/datasets/DATASET_NAME/tables`
פרטי הטבלה	`https://console.JURISDICTION.cloud.google.com/bigquery/projects/PROJECT_ID/datasets/DATASET_NAME/tables/TABLE_NAME`

מחליפים את JURISDICTION באחד מהערכים הבאים:

‫eu אם המשאב נמצא באיחוד האירופי
sa אם המשאב נמצא בערב הסעודית
‫us אם המשאב נמצא בארצות הברית

שורת הפקודה

כדי להגדיר את Google Cloud CLI לשימוש עם נקודות קצה אזוריות:

אתם צריכים לוודא שאתם משתמשים בגרסה 402.0.0 ואילך של Google Cloud CLI.
מגדירים את המאפיין api_endpoint_overrides/bigquery לנקודת הקצה האזורית שבה רוצים להשתמש:
```
gcloud config set api_endpoint_overrides/bigquery https://bigquery.LOCATION.rep.googleapis.com/bigquery/v2/
```
לחלופין, אתם יכולים להגדיר את משתנה הסביבה CLOUDSDK_API_ENDPOINT_OVERRIDES_BIGQUERY לנקודת הקצה:
```
CLOUDSDK_API_ENDPOINT_OVERRIDES_BIGQUERY=https://bigquery.LOCATION.rep.googleapis.com/bigquery/v2/ gcloud  alpha bq  datasets list
```

ממשקי API בארכיטקטורת REST

ב-API בארכיטקטורת REST, במקום לשלוח בקשת REST לנקודת קצה של שירות, שולחים את הבקשה לנקודת הקצה האזורית בפורמט הבא: https://bigquery.LOCATION.rep.googleapis.com.

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

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