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

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

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

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

היקף מיקום הנתונים

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

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

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

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

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

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

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

נתונים ב-BigQuery

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

מיקום תיאור המיקום סוג נקודת הקצה כתובת URL של נקודת קצה מיקום מערך הנתונים תמיכה במיקום הנתונים
global עולמי עולמי geminidataanalytics.googleapis.com כל אזור או אזור מרובה לא נתמך
eu האיחוד האירופי במספר אזורים geminidataanalytics.eu.rep.googleapis.com כל אזור או אזור מרובה במצב מנוחה, בשימוש (בסמכות שיפוט)
us ארצות הברית במספר אזורים geminidataanalytics.us.rep.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, צריך להשתמש בנקודת קצה אזורית כשיוצרים אותם וניגשים אליהם. נקודות הקצה של השירות ב-Conversational Analytics API משתמשות בפורמטים הבאים, בהתאם לסוג המיקום:

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

מחליפים את הפלייס הולדר LOCATION באזור יחיד או במספר אזורים נתמכים, כמו eu, ‏ us או us-east4.

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

HTTP

כדי להשתמש בנקודת קצה אזורית עם HTTP, צריך ליצור את כתובת ה-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: האזור או האזור המרובה שבו רוצים ליצור את המשאבים. כדי להשתמש באחת מנקודות הקצה האזוריות, מציינים eu, us או us-east4.

מגבלות

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

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