חיבור ל-Spanner

במאמר הזה מוסבר איך ליצור מאגר נתונים שמקושר לנתונים ב-Spanner. אתם יכולים לקשר את מאגר הנתונים הזה לאפליקציית Gemini Enterprise כדי לאפשר לסוכנים לנתח את הנתונים שלכם.

כדי להתחבר לנתונים ב-Spanner באמצעות מאגר נתונים ב-Gemini Enterprise, אתם יכולים להשתמש באחד מהמצבים הבאים:

• שאילתה לכמה מסדי נתונים (מומלץ) [גרסת טרום-השקה (Preview)]: התחברות לנתונים ב-Spanner בלי עלויות של תעבורת נתונים יוצאת על העתקה והעברה של הנתונים. שאילתה לכמה מסדי נתונים שולחת את השאילתה ישירות ל-Spanner, לכל מסדי הנתונים והטבלאות שלזהות שלכם יש הרשאה לגשת אליהם באמצעות ניהול זהויות והרשאות גישה (IAM). זה יעיל יותר לשאילתות של ניתוח נתונים. כשמשתמשים במצב שאילתה לכמה מסדי נתונים, Knowledge Catalog מופעל באופן אוטומטי בכרטיסייה Assistant באפליקציית Gemini Enterprise, כדי לתת לסוכן כלים לחיפוש נתונים שלמשתמש יש גישה אליהם ולחיפוש הקשר.

  זהירות: שאילתות למסדי נתונים ברמת דיוק גבוהה: מצב שאילתה לכמה מסדי נתונים מספק גישה רחבה לכל מסדי הנתונים והטבלאות שהמשתמש יכול לגשת אליהם, אבל רמת הדיוק של השאילתה יכולה להשתנות בסכימות טרנזקציות מורכבות. לעומסי עבודה שדורשים רמת דיוק גבוהה, היקף טבלה דטרמיניסטי ושאילתות מאומתות (golden SQL), צריך ליצור סוכן לאינטראקציה עם נתונים ממוקד ב-Spanner ולפרסם אותו ב-Gemini Enterprise.

• הטמעת נתונים: העתקת נתונים מטבלה ספציפית ב-Spanner למאגר הנתונים של Gemini Enterprise. צריך לרענן את הנתונים באופן ידני כדי שהשינויים בטבלה ב-Spanner יופיעו. במצב הזה יש עלויות של תעבורת נתונים יוצאת (egress) על העברת נתונים למיקום חדש, והרשאות IAM קיימות לא משוכפלות למאגר הנתונים.

לפני שמתחילים

כדי ליצור מאגר נתונים של Spanner ב-Gemini Enterprise, צריך את התפקיד אדמין ב-Gemini Enterprise (roles/discoveryengine.agentspaceAdmin) או אדמין ב-Discovery Engine (roles/discoveryengine.admin). מידע נוסף על מתן הרשאות לאדמינים

אם הפרויקט שלכם מוגן על ידי היקף של VPC Service Controls או אם מופעלת בו אכיפה של מדיניות הארגון, ודאו שמדיניות הארגון מאפשרת את המחבר:

• מוסיפים את spanner לפרמטר allowedDataSources באילוץ המנוהל discoveryengine.managed.allowedDataSources (הגבלת מקורות הנתונים המותרים למחברי נתונים). מידע נוסף זמין במאמרים סקירה כללית של אילוצים במדיניות מנוהלת והגדרת מקורות נתונים מותרים.

בנוסף, צריך להגדיר את הרשאות ה-IAM הנדרשות של Spanner למצב המחבר שבו אתם מתכוונים להשתמש:

שאילתה לכמה מסדי נתונים

תצוגה מקדימה

השימוש במוצר או בתכונה כפוף לתנאי השימוש במוצרים בשלב טרום-GA, בחלק "תנאים כלליים לשירות" של התנאים הספציפיים לשירות. השימוש בתכונות ובמוצרים בגרסת טרום-GA הוא "כפי שהם" (As is), ויכול להיות שהתמיכה בהם תהיה מוגבלת. אתם יכולים לקרוא מידע נוסף בקטע תיאור שלבי ההשקה.

כדי להתחבר ל-Spanner באמצעות מצב שאילתה לכמה מסדי נתונים, צריך להקצות את תפקידי ה-IAM הבאים למשתמשים שמבצעים שאילתות או פעולות דרך המחבר בGoogle Cloud פרויקט שמכיל את מסד הנתונים של Spanner:

• גישה למסד הנתונים:
  • קורא מסדי נתונים של Cloud Spanner‏ (roles/spanner.databaseReader) לשאילתות ולכלים לקריאה בלבד.
  • משתמש במסד נתונים של Cloud Spanner‏ (roles/spanner.databaseUser) או אדמין של מסד נתונים ב-Cloud Spanner‏ (roles/spanner.databaseAdmin), אם מופעלות פעולות כתיבה או DDL.
• גישה לכלי MCP:
  • משתמש בכלי MCP‏ (roles/mcp.toolUser) בפרויקט שבו נמצא מסד הנתונים של Spanner, כדי להפעיל את כלי ה-MCP של Spanner.

הטמעת נתונים

כדי להטמיע נתונים מפרויקט מקור ב- Google Cloud ששונה מהפרויקט ב- Google Cloud שמכיל את מאגר הנתונים של Gemini Enterprise שאתם יוצרים, צריך להקצות את אחד מתפקידי ה-IAM הבאים בפרויקט המקור ב-Spanner לחשבון השירות [e-mail] (כאשר PROJECT_NUMBER הוא מספר הפרויקט ב-Google Cloud שמכיל את מאגר הנתונים של Gemini Enterprise):

• בלי Data Boost: קורא מסדי נתונים ב-Cloud Spanner‏ (roles/spanner.databaseReader)
• עם Data Boost: אדמין של מסד נתונים ב-Cloud Spanner‏ (roles/spanner.databaseAdmin), או תפקיד בהתאמה אישית עם ההרשאות של קורא של מסד נתונים ב-Cloud Spanner ו-spanner.databases.useDataBoost. מידע נוסף זמין במאמר סקירה כללית על Data Boost.

זהירות: אם בוחרים להטמיע נתונים מ-Spanner במאגר נתונים של Gemini Enterprise, ההרשאות של Spanner לא מיובאות עם הנתונים. אחרי הייבוא, כל משתמש עם הרשאות מתאימות ב-Gemini Enterprise יכול לראות את הנתונים, גם אם אין לו הרשאה לראות את הנתונים ב-Spanner.

יצירת מאגר נתונים ב-Spanner

כדי ליצור מאגר נתונים שמקשר בין נתונים מ-Spanner ל-Gemini Enterprise:

1. נכנסים לדף Gemini Enterprise במסוף Google Cloud .

   Gemini Enterprise

2. נכנסים לדף Data stores.

3. לוחצים על Create data store.

4. בדף Source, בוחרים מקור נתונים למאגר הנתונים. בשדה החיפוש Select a data source, מחפשים את Spanner או מאתרים אותו ברשימה First-party data sources. לוחצים על הוספה של מקור נתונים.

5. בדף נתונים, בוחרים את מצב המחבר כדי להתחבר לנתונים. בוחרים באחת מהכרטיסיות הבאות כדי לקבל הוראות נוספות בהתאם למצב שבחרתם.

   שאילתה לכמה מסדי נתונים

   תצוגה מקדימה

   השימוש במוצר או בתכונה כפוף לתנאי השימוש במוצרים בשלב טרום-GA, בחלק "תנאים כלליים לשירות" של התנאים הספציפיים לשירות. השימוש בתכונות ובמוצרים בגרסת טרום-GA הוא "כפי שהם" (As is), ויכול להיות שהתמיכה בהם תהיה מוגבלת. אתם יכולים לקרוא מידע נוסף בקטע תיאור שלבי ההשקה.

   1. בוחרים באפשרות שאילתה לכמה מסדי נתונים (מומלץ). לוחצים על Continue.
   2. בדף Actions, בוחרים את הפעולות של Spanner שרוצים להפעיל במאגר הנתונים. אפשר לערוך את ההגדרות האלה מאוחר יותר. לוחצים על המשך.

   הטמעת נתונים

   1. בוחרים באפשרות הטמעת נתונים.

   2. מציינים פרטים על הנתונים שרוצים לייבא. בקטע ייבוא נתונים מהטבלה ב-Spanner, מציינים את הפרטים הבאים:

      • מזהה פרויקט: הפרויקט ב- Google Cloud שמכיל את הטבלה של Spanner. זהו שדה חובה.
      • ‫Instance ID: מזהה המכונה של Spanner שמכילה את הנתונים שרוצים לייבא. זהו שדה חובה.
      • ‫Database ID: מזהה מסד הנתונים ב-Spanner שמכיל את הנתונים שרוצים לייבא. זהו שדה חובה.
      • ‫Table ID: מזהה הטבלה ב-Spanner שמכילה את הנתונים שרוצים לייבא. זהו שדה חובה.

      אם רוצים, בוחרים באפשרות Enable Data Boost כדי להשתמש ב-Spanner Data Boost לשאילתות מהירות יותר. הפעלת Data Boost כרוכה בעלות נוספת. התמחור של Spanner Data Boost

   3. לוחצים על Continue.

6. בדף Configuration, קובעים את ההגדרות של מאגר הנתונים.

   • מיקום מחבר הנתונים: בוחרים אזור שבו יאוחסנו המטא-נתונים של מאגר הנתונים. אי אפשר לשנות את המיקום אחרי שיוצרים את מאגר הנתונים. מידע חשוב על מספר אזורים זמין במאמר מיקומים של Gemini Enterprise.
   • שם מחבר הנתונים: בשדה שם מחבר הנתונים, מזינים שם למחבר הנתונים. אי אפשר לשנות את השם אחרי שיוצרים את החיבור לנתונים. כשמזינים שם, נוצר מזהה ייחודי למחבר הנתונים. בשדה Tag (optional), אפשר להזין תג למחבר הנתונים, שמשמש כמזהה יציב של המחבר בכל הגרסאות.
   • מדיניות הגנה על מידע אישי רגיש: בוחרים מדיניות הגנה על מידע אישי רגיש למאגר הנתונים. הפורמט צריך להיות: projects/{project}/locations/{location}/contentPolicies/{policy}. אפשר לשנות את ההגדרה הזו מאוחר יותר.

7. לוחצים על יצירה.

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

השלבים הבאים

• כדי לצרף את מאגר הנתונים לאפליקציה, יוצרים אפליקציה ובוחרים את מאגר הנתונים לפי השלבים שמפורטים במאמר יצירת אפליקציה ב-Gemini Enterprise.

• איך Knowledge Catalog פועל עם מחברי Data Cloud (מופעל באופן אוטומטי כשמשתמשים במצב שאילתה לכמה מסדי נתונים) כדי לעזור לנציג לחפש נתונים שלמשתמש יש גישה אליהם ולחפש הקשר ארגוני.

• כדי ליצור סוכן לאינטראקציה עם נתונים מדויק וממוקד עם שאילתות מאומתות, קראו את המאמר פרסום סוכן נתונים של Spanner ב-Gemini Enterprise.