ניהול קבוצות של הקשרים ב-AlloyDB Studio

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

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

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

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

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

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

הכנת אשכול, מכונה ומסד נתונים של AlloyDB ל-PostgreSQL

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

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

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

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

כדי להעניק את ההרשאה executesql למכונת AlloyDB ל-PostgreSQL ולהגדיר את הגדרת המכונה data_api_access לערך ALLOW_DATA_API, משתמשים בפקודה curl הבאה : 
   curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth application-default 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, ליד Context sets, לוחצים על View actions.

  6. לוחצים על יצירת קבוצת הקשרים.

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

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

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

יצירת קבוצות של הקשרים

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

עריכת קבוצת ההקשרים

כדי לערוך קבוצת הקשרים:

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

    מעבר אל AlloyDB

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

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

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

  5. בחלונית Explorer, ליד Context sets, לוחצים על View actions.

  6. לוחצים על עריכת קבוצת ההקשרים.

  7. אופציונלי: עורכים את תיאור קבוצת ההקשרים.

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

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

מחיקה של קבוצת הקשרים

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

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

    מעבר אל AlloyDB

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

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

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

  5. בחלונית Explorer, ליד Context sets, לוחצים על View actions.

  6. לוחצים על מחיקת קבוצת ההקשרים.

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

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

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