התחברות ל-Cloud SQL

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

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

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

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

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

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

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

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

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

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

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

תצוגה מקדימה

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

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

1. מפעילים את Data API במכונה של Cloud SQL:

   gcloud sql instances patch <var>INSTANCE_NAME</var> \
       --project=<var>PROJECT_ID</var> \
       --data-api-access=ALLOW_DATA_API
   

2. הקצאת הרשאות IAM: מקצים את תפקידי ה-IAM הבאים בפרויקט ב- Google Cloud שמכיל את המכונה של Cloud SQL למשתמשים ששולחים שאילתות או מבצעים פעולות באמצעות המחבר:

   • גישה למכונה ולמסד הנתונים:
     • צפייה ב-Cloud SQL‏ (roles/cloudsql.viewer) ולקוח Cloud SQL‏ (roles/cloudsql.client) (או משתמש במכונה של Cloud SQL‏ (roles/cloudsql.instanceUser) עם אימות של מסד נתונים ב-IAM) לשאילתות ולכלים לקריאה בלבד.
     • עריכת Cloud SQL‏ (roles/cloudsql.editor) או ניהול Cloud SQL‏ (roles/cloudsql.admin), אם מופעלות פעולות כתיבה או ניהול.
   • גישה לכלי MCP:
     • משתמש בכלי MCP‏ (roles/mcp.toolUser) בפרויקט שבו נמצאת מכונת Cloud SQL, כדי להפעיל את כלי ה-MCP.

הטמעת נתונים

כדי להטמיע נתונים מ-Cloud SQL, צריך להגדיר את הרשאות ה-IAM הבאות:

• גישה לקטגוריית ה-Staging: כשמטמיעים נתונים מ-Cloud SQL, הנתונים מועברים קודם לקטגוריה של Cloud Storage. מקצים את התפקיד אדמין של Storage‏ (roles/storage.admin) בקטגוריה של Cloud Storage לחשבון השירות של מכונת Cloud SQL (לדוגמה, p9876-abcd33f@gcp-sa-cloud-sql.).
• גישה ל-Cloud SQL בפרויקטים שונים: אם אתם מייבאים נתונים מפרויקט מקור ב- Google Cloud ששונה מהפרויקט ב- Google Cloud שמכיל את מאגר הנתונים ב-Gemini Enterprise שאתם יוצרים, צריך להקצות את התפקיד צפייה ב-Cloud SQL‏ (roles/cloudsql.viewer) בפרויקט המקור ב-Cloud SQL לחשבון השירות service-PROJECT_NUMBER@gcp-sa-discoveryengine. (כאשר PROJECT_NUMBER הוא מספר הפרויקט ב-Google Cloud שמכיל את מאגר הנתונים ב-Gemini Enterprise).

חשוב לדעת: אם בוחרים להטמיע נתונים מ-Cloud SQL במאגר נתונים של Gemini Enterprise, ההרשאות של Cloud SQL לא מיובאות עם הנתונים. אחרי הייבוא, כל משתמש עם הרשאות מספיקות ב-Gemini Enterprise יכול לראות את הנתונים, גם אם אין לו הרשאה לראות את הנתונים ב-Cloud SQL.

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

כדי ליצור מאגר נתונים שמקשר בין נתונים מ-Cloud SQL ל-Gemini Enterprise, פועלים לפי השלבים הבאים:

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

   Gemini Enterprise

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

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

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

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

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

   תצוגה מקדימה

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

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

   הטמעת נתונים

   1. בוחרים באפשרות הטמעת נתונים.
   2. מציינים פרטים על הנתונים שרוצים לייבא. בקטע ייבוא נתונים מהטבלה ב-Cloud SQL, מציינים את הפרטים הבאים:
      • ‫Project ID: הפרויקט ב- Google Cloud שמכיל את הטבלה של Cloud SQL. זהו שדה חובה.
      • ‫Instance ID: מזהה המכונה של Cloud SQL שמכילה את הנתונים שרוצים לייבא. זהו שדה חובה.
      • מזהה מסד הנתונים: המזהה של מסד הנתונים ב-Cloud SQL שמכיל את הנתונים שרוצים לייבא. זהו שדה חובה.
      • מזהה הטבלה: מזהה הטבלה ב-Cloud SQL שמכילה את הנתונים שרוצים לייבא. זהו שדה חובה.
      • מזינים את המיקום של הקטגוריה של Cloud Storage ב-Google Cloud Storage שבה נמצאים הנתונים. חובה למלא את השדה הזה. אם רוצים להשתמש בייצוא ללא שרת (serverless) של Cloud SQL, בוחרים באפשרות Enable serverless export. הפעלת ייצוא ללא שרת (serverless) כרוכה בעלות נוספת. התמחור של ייצוא ללא שרת (serverless) ב-Cloud SQL
   3. לוחצים על Continue.

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

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

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

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

השלבים הבאים

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

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

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