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

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

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

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

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

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

  • הנתונים נמצאים במנוחה כשהם מאוחסנים באחסון קבוע, ולא כשהם מעובדים או מועברים באופן פעיל.
  • הנתונים בשימוש כשהם בזיכרון, למשל כשמודלים של למידת מכונה (ML) מעבדים נתונים כדי ליצור תשובה או כשהשירות מבצע שאילתה. ב-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, צריך להשתמש בנקודת קצה אזורית כשיוצרים אותם וניגשים אליהם. כשמתקשרים לנקודות קצה אזוריות, המיקום בנתיב הבקשה או בבקשת האב חייב להיות זהה למיקום של נקודת הקצה שאליה מתקשרים. לדוגמה, אם מתקשרים אל נקודת הקצה 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

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

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

מגבלות

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

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