קישור ל-AlloyDB ל-PostgreSQL

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

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

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

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

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

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

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

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

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

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

שאילתה מאוחדת

תצוגה מקדימה

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

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

• גישה לאשכול ולמסד הנתונים:
  • ‫Cloud AlloyDB Viewer (roles/alloydb.viewer) ו-Cloud AlloyDB Client (roles/alloydb.client) (או Cloud AlloyDB Database User (roles/alloydb.databaseUser) עם אימות מסד נתונים של IAM) לשאילתות וכלים לקריאה בלבד.
  • ‫Cloud AlloyDB Admin ‏ (roles/alloydb.admin) אם מופעלות פעולות של כתיבה או ניהול אשכולות (כמו יצירת אשכולות, מכונות או גיבויים, או ביצוע כתיבות ב-SQL).
• גישה לכלי MCP:
  • הרשאת MCP Tool User (roles/mcp.toolUser) בפרויקט Google Cloud שבו נמצא אשכול AlloyDB ל-PostgreSQL, כדי להפעיל את כלי MCP.

הטמעת נתונים

כדי להטמיע נתונים מפרויקט Google Cloud מקור ששונה מהפרויקט Google Cloud שמכיל את מאגר הנתונים של Gemini Enterprise שאתם יוצרים, צריך להקצות את התפקיד אדמין של Cloud AlloyDB ‏ (roles/alloydb.admin) בפרויקט המקור של AlloyDB ל-PostgreSQL לחשבון השירות [e-mail] (כאשר PROJECT_NUMBER הוא מספר הפרויקט שלGoogle Cloud הפרויקט שמכיל את מאגר הנתונים של Gemini Enterprise).

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

יצירת מאגר נתונים של AlloyDB ל-PostgreSQL

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

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

   ‫Gemini Enterprise

2. עוברים לדף מאגרי נתונים.

3. לוחצים על יצירת מאגר נתונים.

4. בדף מקור, בוחרים מקור נתונים למאגר הנתונים. מחפשים את האפשרות AlloyDB ל-PostgreSQL בשדה החיפוש בחירת מקור נתונים, או מוצאים את AlloyDB ל-PostgreSQL ברשימה מקורות נתונים מצד ראשון. לוחצים על הוספה של מקור נתונים.

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

   שאילתה מאוחדת

   תצוגה מקדימה

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

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

   הטמעת נתונים

   1. לוחצים על העברת נתונים.
   2. מציינים פרטים על הנתונים שרוצים לייבא. בקטע ייבוא נתונים מהטבלה שלכם ב-AlloyDB ל-PostgreSQL, מציינים את הפרטים הבאים:
      • ‫מזהה פרויקט: Google Cloud הפרויקט שמכיל את הטבלה של AlloyDB ל-PostgreSQL. זהו שדה חובה.
      • מזהה מיקום: מזהה המיקום של AlloyDB ל-PostgreSQL שמכיל את הנתונים שרוצים לייבא. זהו שדה חובה.
      • ‫Cluster ID (מזהה האשכול): מזהה האשכול ב-AlloyDB ל-PostgreSQL שמכיל את הנתונים שרוצים לייבא. זהו שדה חובה.
      • מזהה מסד הנתונים: מזהה מסד הנתונים של AlloyDB ל-PostgreSQL שמכיל את הנתונים שרוצים לייבא. זהו שדה חובה.
      • ‫Table ID: מזהה הטבלה ב-AlloyDB ל-PostgreSQL שמכילה את הנתונים שרוצים לייבא. זהו שדה חובה.
   3. לוחצים על Continue.

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

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

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

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

השלבים הבאים

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

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

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