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

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

למידע ולמידה על קבוצות הקשר, ראה סקירה כללית על קבוצות הקשר.

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

לפני שיוצרים נציג, צריך לבצע את הפעולות הבאות.

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

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

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

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

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

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

מתן הרשאה ל-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. בשדה שם קבוצת ההקשרים, מזינים שם ייחודי לקבוצת ההקשרים. השם של קבוצת ההקשר תלוי אותיות רישיות (case-sensitive) ויכול להכיל אותיות, מספרים, מקפים וקווים תחתונים.

  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. לוחצים על אישור כדי למחוק את קבוצת ההקשרים.

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