ניהול סוכני נתונים ב-AlloyDB Studio

במסמך הזה מוסבר איך ליצור סוכן נתונים ב-AlloyDB ל-PostgreSQL Studio באמצעות קובץ הקשר של הסוכן. סוכן נתונים משויך לקובץ הקשר של סוכן יחיד.

מידע נוסף על סוכני נתונים זמין במאמר סקירה כללית על סוכני נתונים.

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

לפני שיוצרים סוכן, צריך לוודא שמתקיימים התנאים המוקדמים הבאים.

הפעלת שירותים נדרשים

מפעילים את השירותים הבאים בפרויקט:

הכנת אשכול ומכונה של AlloyDB ל-PostgreSQL

מוודאים שיש לכם גישה לאשכול ולמופע קיימים של AlloyDB או יוצרים חדשים.

תפקידים והרשאות נדרשים

  • מוסיפים משתמש או חשבון שירות לניהול זהויות והרשאות גישה (IAM) לאשכול ברמת מסד הנתונים. מידע נוסף זמין במאמר בנושא ניהול משתמשי מסד נתונים.
  • נותנים למשתמש IAM את התפקיד alloydb.databaseUser ואת ההרשאה serviceusage.serviceUsageConsumer ברמת הפרויקט. מידע נוסף זמין במאמר הוספת קשירת מדיניות IAM לפרויקט.

מתן הרשאה ל-executesql למכונת AlloyDB ל-PostgreSQL

כדי להעניק את ההרשאה executesql למכונת AlloyDB ל-PostgreSQL ולהגדיר את ההגדרה של המכונה data_api_access לערך ALLOW_DATA_API, משתמשים בפקודה curl הבאה : 
   curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     https://alloydb.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/clusters/CLUSTER_ID/instances/INSTANCE_ID?updateMask=dataApiAccess \
     -d '{
       "dataApiAccess": "ENABLED",
     }'
מחליפים את מה שכתוב בשדות הבאים:
  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
  • ‫LOCATION: האזור שבו נמצא אשכול AlloyDB.
  • ‫CLUSTER_ID: המזהה של אשכול AlloyDB.
  • ‫INSTANCE_ID: המזהה של מופע AlloyDB.
כדי לבצע את השלבים במדריך הזה, צריך להיכנס אל Google Cloud ולאמת את מסד הנתונים באמצעות אימות IAM.

יצירת סוכן נתונים

כדי ליצור סוכן נתונים, פועלים לפי השלבים הבאים:

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

    מעבר אל AlloyDB

  2. בוחרים אשכול מהרשימה.

  3. בתפריט הניווט, לוחצים על AlloyDB Studio.

  4. נכנסים ל-Studio באמצעות אימות של ניהול זהויות והרשאות גישה (IAM).

  5. בחלונית Explorer, לצד סוכני נתונים, לוחצים על הצגת פעולות.

  6. לוחצים על יצירת סוכן.

  7. בשדה שם הסוכן, מזינים שם ייחודי לסוכן. שם הסוכן תלוי באותיות רישיות וקטנות, ויכול להכיל אותיות, מספרים, מקפים וקווים תחתונים.

  8. זה שינוי אופציונלי. בקטע תיאור הסוכן, מוסיפים תיאור לסוכן.

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

    • us-central1
    • us-east1
    • europe-west4
    • asia-southeast1

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

יצירת הקשר של הסוכן

אחרי שיוצרים סוכן, פועלים לפי השלבים במאמר יצירת קובצי הקשר של סוכנים באמצעות Gemini CLI כדי ליצור קובץ הקשר של הסוכן. אחר כך תוכלו לערוך את הסוכן כדי להעלות את קובץ ההקשר.

עריכת סוכן

כדי לערוך סוכן נתונים, פועלים לפי השלבים הבאים:

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

    מעבר אל AlloyDB

  2. בוחרים אשכול מהרשימה.

  3. בתפריט הניווט, לוחצים על AlloyDB Studio.

  4. נכנסים ל-Studio באמצעות אימות של ניהול זהויות והרשאות גישה (IAM).

  5. בחלונית Explorer, לצד סוכני נתונים, לוחצים על הצגת פעולות.

  6. לוחצים על עריכת סוכן.

  7. אופציונלי: עורכים את תיאור הסוכן.

  8. בקטע העלאת קובץ הקשר של הסוכן, לוחצים על עיון ובוחרים את קובץ ההקשר של הסוכן.

  9. לוחצים על Save.

מחיקה של סוכן נתונים

כדי למחוק סוכן נתונים:

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

    מעבר אל AlloyDB

  2. בוחרים אשכול מהרשימה.

  3. בתפריט הניווט, לוחצים על AlloyDB Studio.

  4. נכנסים ל-Studio באמצעות אימות של ניהול זהויות והרשאות גישה (IAM).

  5. בחלונית Explorer, לצד סוכני נתונים, לוחצים על הצגת פעולות.

  6. לוחצים על מחיקת הנציג.

  7. בתיבת הדו-שיח לאישור מחיקת נציג, מזינים את שם הנציג.

  8. לוחצים על אישור כדי למחוק את הסוכן.

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