המיקום של נתונים

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

במסמך הזה, המונח מיקום אחסון הנתונים מתייחס ל Google Cloud אזור או למספר אזורים שבהם הנתונים נמצאים, ולמונח הנתונים שלך יש משמעות זהה למונח "נתוני הלקוח" בקטע מיקום הנתונים בתנאים הספציפיים לשירות.

ההתחייבויות לגבי מיקום אחסון הנתונים ב-Conversational Analytics API משתנות בהתאם למקום שאליו הסוכן מתחבר – BigQuery או Looker.

היקף מיקום אחסון הנתונים

‫Conversational Analytics API עוזר לכם לעמוד בדרישות לגבי מיקום אחסון הנתונים, באמצעות אמצעי בקרה על המיקום של נתוני הלקוחות במדינות שונות:

  • נתונים נמצאים במנוחה כשהם מאוחסנים באחסון מתמיד, ולא מעובדים או מועברים באופן פעיל.
  • הנתונים בשימוש כשהם נמצאים בזיכרון, למשל כשמודלים של למידת מכונה (ML) מעבדים נתונים כדי ליצור תשובה או כשהשירות מריץ שאילתה. ב-Conversational Analytics API, ההתחייבויות לגבי מיקום אחסון הנתונים שנמצאים בשימוש הן ספציפיות לעיבוד נתוני למידת מכונה בסמכות השיפוט, ולא מספקות מיקום אחסון מקיף לכל מצבי הנתונים שנמצאים בשימוש.
  • הנתונים נמצאים במעבר כשהם נכנסים או יוצאים מהרשת של Google.

ההתחייבויות לגבי מיקום אחסון הנתונים ב-Conversational Analytics API חלות על משאבי DataAgent (כולל הגדרות של לקוחות, הקשר, הוראות מערכת ושאילתות לדוגמה) ועל משאבי Conversation (כולל תוכן ההודעות והיסטוריית המצבים). ההתחייבויות האלה לא חלות על נתוני שירות, כמו מזהי משאבים ותוויות, או על נתונים במעבר.

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

‫Conversational Analytics API תומך במיקומים גלובליים, אזוריים ובמספר אזורים. כשמשתמשים בנקודת קצה אזורית או במספר אזורים, אתם שולטים במיקום שבו הנתונים מאוחסנים במצב מנוחה.

בטבלאות הבאות, עיבוד נתוני למידת מכונה (ML) בסמכות שיפוטית (מזוהה כבשימוש (בסמכות שיפוטית)) מתייחס להתחייבויות לעיבוד נתוני למידת מכונה (ML) של הנתונים שלכם. כפי שמוגדר בתנאים הספציפיים לשירות, Google מבצעת עיבוד של הנתונים שלכם באמצעות למידת מכונה רק באזור או במספר האזורים שבחרתם.

בקטעים הבאים מפורט מידע על התמיכה במיקום אחסון הנתונים של נציגים ושיחות שמשתמשים במקורות נתונים של BigQuery ו-Looker.

נתונים ב-BigQuery

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

מיקום תיאור המיקום סוג נקודת הקצה כתובת URL של נקודת קצה המיקום של מערך הנתונים תמיכה במיקום אחסון הנתונים
global עולמי עולמי geminidataanalytics.googleapis.com כל אזור או מספר אזורים לא נתמך
eu האיחוד האירופי במספר אזורים geminidataanalytics.eu.rep.googleapis.com כל אזור או מספר אזורים במצב מנוחה, בשימוש (בסמכות שיפוט)
us ארצות הברית במספר אזורים geminidataanalytics.us.rep.googleapis.com כל אזור או מספר אזורים במצב מנוחה, בשימוש (בסמכות שיפוט)
northamerica-northeast1 מונטריאול אזורי geminidataanalytics-northamerica-northeast1.googleapis.com כל אזור או מספר אזורים במצב מנוחה, בשימוש (בסמכות שיפוט)
northamerica-northeast2 טורונטו אזורי geminidataanalytics-northamerica-northeast2.googleapis.com כל אזור או מספר אזורים במצב מנוחה, בשימוש (בסמכות שיפוט)
us-east4 צפון וירג'יניה אזורי geminidataanalytics-us-east4.googleapis.com כל אזור או מספר אזורים במצב מנוחה, בשימוש (בסמכות שיפוט)

נתוני Looker

בסוכני נתונים שמתחברים ל-Looker, נקודות קצה אזוריות ונקודות קצה במספר אזורים תומכות במיקום אחסון הנתונים לנתונים באחסון. לא משנה מה מיקום נקודת הקצה שציינתם, הסוכן יכול להתחבר למקורות נתונים בכל מיקום או שילוב של מיקומים:

מיקום תיאור המיקום סוג נקודת הקצה כתובת URL של נקודת קצה המיקום של מערך הנתונים תמיכה במיקום אחסון הנתונים
global עולמי עולמי geminidataanalytics.googleapis.com כל אזור או מספר אזורים לא נתמך
eu האיחוד האירופי במספר אזורים geminidataanalytics.eu.rep.googleapis.com כל אזור או מספר אזורים במנוחה
us ארצות הברית במספר אזורים geminidataanalytics.us.rep.googleapis.com כל אזור או מספר אזורים במנוחה
us-east4 צפון וירג'יניה אזורי geminidataanalytics-us-east4.googleapis.com כל אזור או מספר אזורים במנוחה

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

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

כדי לאכוף את מיקום אחסון הנתונים של המשאבים ב-DataAgent וב-Conversation, צריך להשתמש בנקודת קצה אזורית כשיוצרים אותם וניגשים אליהם. כששולחים קריאה לנקודות קצה אזוריות, המיקום בנתיב הבקשה או בבקשת ההורה חייב להתאים למיקום של נקודת הקצה שאליה שולחים את הקריאה. לדוגמה, אם קוראים לנקודת הקצה geminidataanalytics.us.rep.googleapis.com, צריך לציין את us בנתיב הבקשה או בבקשת ההורה (כמו /locations/us או projects/PROJECT_ID/locations/us).

נקודות הקצה של השירות ב-Conversational Analytics API משתמשות בפורמטים הבאים, בהתאם לסוג המיקום:

  • גלובלי: geminidataanalytics.googleapis.com
  • במספר אזורים: geminidataanalytics.LOCATION.rep.googleapis.com
  • אזורי: geminidataanalytics-LOCATION.googleapis.com

מחליפים את ה-placeholder LOCATION באזור נתמך או במספר אזורים נתמכים למקור הנתונים. פרטים נוספים זמינים במאמר מיקומי נתונים נתמכים.

בדוגמאות הבאות מוסבר איך להגדיר נקודת קצה אזורית לבקשות HTTP ו-Python SDK:

HTTP

כדי להשתמש בנקודת קצה אזורית עם HTTP, צריך ליצור את כתובת ה-URL של הבקשה עם כתובת ה-URL הבסיסית האזורית. קודם כל, מגדירים את base_url כך שישתמש בנקודת הקצה האזורית שבחרתם, כמו בדוגמה הבאה מהגדרת הגדרות ראשוניות ואימות:

project_id = "PROJECT_ID"
location = "LOCATION"

# Set the base URL based on location.
if not location or location == "global":
  base_url = "https://geminidataanalytics.googleapis.com"
elif "-" in location:
  # Regional endpoints
  base_url = f"https://geminidataanalytics-{location}.googleapis.com"
else:
  # Multi-regional endpoints
  base_url = f"https://geminidataanalytics.{location}.rep.googleapis.com"

אחר כך, משתמשים במשתנה base_url כשיוצרים כתובות URL לבקשות API, כמו בדוגמה הזו משאלת שאלות באמצעות צ'אט עם שמירת מצב וללא שמירת מצב:

# Example API request URL construction using base_url:
chat_url = f"{base_url}/v1beta/projects/{project_id}/locations/{location}:chat"

Python SDK

כדי להשתמש בנקודת קצה אזורית עם Python SDK, מעבירים את client_options עם הפרמטר האזורי api_endpoint כשמאתחלים לקוחות API, כמו שמוצג בדוגמה הבאה מתוך קביעת הגדרות ואתחול לקוחות.

from google.cloud import geminidataanalytics
from google.api_core import client_options

project_id = "PROJECT_ID"
location = "LOCATION"

# Set client options based on location.
if not location or location == "global":
  endpoint = "geminidataanalytics.googleapis.com"
elif "-" in location:
  # Regional endpoints
  endpoint = f"geminidataanalytics-{location}.googleapis.com"
else:
  # Multi-regional endpoints
  endpoint = f"geminidataanalytics.{location}.rep.googleapis.com"
opts = client_options.ClientOptions(api_endpoint=endpoint)

# Use client options when initializing API clients.
data_agent_client = geminidataanalytics.DataAgentServiceClient(client_options=opts)
data_chat_client = geminidataanalytics.DataChatServiceClient(client_options=opts)

# Use clients to make API requests. For example:
# response = data_chat_client.chat(request=request)

מחליפים את ערכי הדוגמה באופן הבא:

  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
  • ‫LOCATION: האזור או מספר האזורים שבהם רוצים ליצור את המשאבים. כדי לראות את המיקומים שכל מקור נתונים תומך בהם, עיינו בקטע מיקומי נתונים נתמכים.

מגבלות

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

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