כשמשתמשים בסוכן עם מנוע תלוי הקשר, הוא יכול ליצור ולהעלות קבוצות הקשר באופן אוטומטי מה-CLI. מסמך זה מתאר איך ליצור, לערוך ולמחוק קבוצות הקשר ב-AlloyDB ל-PostgreSQL Studio כשרוצים להשתמש בממשק חזותי במסוף Google Cloud כדי לנהל קובצי קבוצות הקשר. כשיוצרים קבוצת הקשר ב-AlloyDB Studio, היא נשמרת בקבוצת ההקשר default של הפרויקט באזור שנבחר, ומקושרת למסד הנתונים הנוכחי. השמות של קבוצות ההקשרים (והמזהים שנגזרים מהם) חייבים להיות ייחודיים בקבוצה default של קבוצות ההקשרים בפרויקט באזור מסוים, בכל מסדי הנתונים והמכונות. ב-AlloyDB Studio, אם יוצרים קבוצת הקשר עם שם שהמזהה שנגזר ממנו כבר קיים, האימות נכשל. כדי להחליף את התוכן של קבוצת ההקשר תוך שמירה על השיוך שלה למסד הנתונים, צריך לערוך את קבוצת ההקשר הקיימת. אם מעלים ישירות דרך סוכן הנדסת ההקשר או Dataplex API עם מזהה קיים של קבוצת הקשרים, התוכן שלו מוחלף, ואם צוין, גם השיוכים שלו למסד הנתונים.
ברשימה Context sets ב-AlloyDB Studio מוצגות רק קבוצות ההקשר בקבוצת ההקשר default בכל האזורים הנתמכים שמקושרים למסד הנתונים הנוכחי. קבוצות הקשר שנוצרו למסד נתונים אחר, או שנוצרו דרך ה-API בלי לקשר את משאב מסד הנתונים ב-databases (או בקבוצה מותאמת אישית של קבוצות הקשר), לא מופיעות ברשימה של AlloyDB Studio.
לפני שמתחילים
לפני שיוצרים או מעלים קבוצת הקשר, צריך לבצע את הפעולות הבאות.
אפשר ליצור קבוצות הקשר באזורים us-central1, us-east1, europe-west4 ו-asia-southeast1.
הפעלת השירותים הנדרשים
מפעילים את השירותים הבאים בפרויקט:הכנת אשכול, מכונה ומסד נתונים של AlloyDB ל-PostgreSQL
מוודאים שיש לכם גישה לאשכול ולמכונה קיימים של AlloyDB, או יוצרים חדשים.כדי לבצע את השלבים במדריך הזה, צריך שיהיה מסד נתונים במכונה של AlloyDB. מידע נוסף זמין במאמר יצירת מסד נתונים.
תפקידים והרשאות נדרשים
- מפעילים אימות של מסד הנתונים באמצעות ניהול זהויות והרשאות גישה (IAM) במכונה, על ידי הגדרת הדגל לניהול מסד הנתונים
alloydb.iam_authenticationלערךon(alloydb.iam_authentication=on). מידע נוסף זמין במאמר הפעלה והשבתה של אימות IAM. - מוסיפים לאשכול חשבון משתמש או חשבון שירות ב-IAM ברמת מסד הנתונים. מידע נוסף מופיע במאמר ניהול אימות IAM.
- מקצים למשתמש ה-IAM את התפקידים
roles/alloydb.databaseUser,roles/serviceusage.serviceUsageConsumerו-roles/geminidataanalytics.queryDataUserברמת הפרויקט. למידע נוסף, קראו את המאמר הוספת קישור למדיניות IAM בפרויקט. - כדי ליצור, להעלות ולנהל קבוצות של הקשרים, צריך להקצות למשתמש ה-IAM את התפקיד "עריכה של Dataplex Catalog" (
roles/dataplex.catalogEditor) או "אדמין של Dataplex Catalog" (roles/dataplex.catalogAdmin) ברמת הפרויקט. מידע נוסף זמין במאמר הרשאות לקבוצות הקשר. - צריך גם להעניק הרשאות קריאה בלבד למסד הנתונים למשתמש או לחשבון השירות ב-IAM.
GRANT SELECT ON ALL TABLES IN SCHEMA public TO "USER_NAME";
מחליפים את USER_NAME בכתובת האימייל של המשתמש או בכתובת של חשבון השירות בלי הסיומת.(לדוגמה,my-sa@my-project.iam). צריך להשתמש במירכאות סביב המזהה כי הוא מכיל תווים מיוחדים (@ ו-.).
מידע נוסף זמין במאמר הענקת הרשאות מתאימות למסד הנתונים למשתמשי IAM.
הענקת הרשאת executesql למכונה של AlloyDB ל-PostgreSQL
כדי לתת את ההרשאה executesql למכונה של AlloyDB ל-PostgreSQL ולהגדיר את השדה dataApiAccess של המכונה לערך ENABLED (נדרש ל-QueryData, למרות שברירת המחדל מאפשרת כמה שירותי Google Cloud פנימיים כמו AlloyDB Studio), משתמשים בפקודה הבאה של curl:
curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json" \
-H "x-goog-user-project: PROJECT_ID" \
https://alloydb.googleapis.com/v1beta/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.
יצירת קבוצת הקשרים
כדי ליצור קבוצת הקשר:
נכנסים לדף AlloyDB במסוף Google Cloud .
בוחרים אשכול מהרשימה.
בתפריט הניווט, לוחצים על AlloyDB Studio.
נכנסים ל-AlloyDB Studio באמצעות אימות IAM.
בחלונית Explorer, לצד Context sets, לוחצים על View actions.
לוחצים על יצירת קבוצת הקשרים.
בקטע שם קבוצת ההקשר, נותנים שם ייחודי לקבוצת ההקשר. ב-AlloyDB Studio, השם צריך להיות באורך של 4 עד 30 תווים ולא יכול להתחיל ברווח לבן. Studio יוצר את מזהה קבוצת ההקשר על ידי המרת השם לאותיות קטנות והחלפת תווים לא אלפאנומריים במקפים (
-). מזהה קבוצת ההקשר שנוצר צריך להיות ייחודי בקבוצת ההקשרdefaultשל הפרויקט באזור שנבחר. לדוגמה, למזהה קבוצת ההקשרquerydata-e2e-testיש את שם קבוצת ההקשרquerydata_e2e_test. כשמעלים קבוצת הקשרים ישירות באמצעות סוכן הנדסת ההקשר או Dataplex API, מזהה קבוצת ההקשרים תלוי אותיות רישיות, לא יכול להכיל לוכסנים (/) ולא מוגבל ל-4 עד 30 תווים או לתווים אלפאנומריים, מקפים וקווים תחתונים.זה שינוי אופציונלי. בקטע תיאור של קבוצת ההקשרים, מוסיפים תיאור לקבוצת ההקשרים.
זה שינוי אופציונלי. כדי להעלות קובץ של קבוצת הקשר, לוחצים על עיון בקטע העלאת קובץ של קבוצת הקשר ובוחרים את הקובץ.
זה שינוי אופציונלי. כדי לבחור אזור לקבוצת ההקשר, לוחצים על הצגת אפשרויות מתקדמות ובוחרים אזור בקטע בחירת מיקום (ברירת המחדל היא
us-east1בכל יצירה). אם בוחרים אזור אחר, צריך לבחור אותו לפני שמזינים את שם קבוצת ההקשר כדי ש-AlloyDB Studio יוכל לאמת שהשם ייחודי באזור הזה.us-east1לוחצים על יצירה.
יצירת קבוצות הקשרים
אם יצרתם קבוצת הקשר ריקה ב-Studio, או אם אתם רוצים לעדכן קבוצה קיימת, אתם יכולים לפעול לפי השלבים במאמר יצירה ואופטימיזציה של קבוצות הקשר באמצעות סוכן הנדסת ההקשר כדי ליצור קובץ של קבוצת הקשר ולבצע בו אופטימיזציה. סוכן עם מנוע תלוי הקשר יכול ליצור ולהעלות את קבוצת ההקשר ישירות מה-CLI, או שאתם יכולים לערוך את קבוצת ההקשר ב-Studio כדי להעלות את הקובץ של קבוצת ההקשר באופן ידני.
עריכת קבוצת הקשרים
כדי לערוך קבוצת הקשר:
נכנסים לדף AlloyDB במסוף Google Cloud .
בוחרים אשכול מהרשימה.
בתפריט הניווט, לוחצים על AlloyDB Studio.
נכנסים ל-AlloyDB Studio באמצעות אימות IAM.
לוחצים על הצגת פעולות לצד קבוצת ההקשר שרוצים לערוך.
לוחצים על עריכת קבוצת ההקשר.
זה שינוי אופציונלי. עורכים את תיאור קבוצת ההקשרים.
לוחצים על עיון בקטע העלאת קובץ של קבוצת הקשרים ובוחרים את הקובץ של קבוצת ההקשרים.
לוחצים על Save.
מחיקה של קבוצת הקשרים
כדי למחוק קבוצת הקשר, מבצעים את השלבים הבאים:
נכנסים לדף AlloyDB במסוף Google Cloud .
בוחרים אשכול מהרשימה.
בתפריט הניווט, לוחצים על AlloyDB Studio.
נכנסים ל-AlloyDB Studio באמצעות אימות IAM.
לוחצים על הצגת פעולות לצד קבוצת ההקשר שרוצים למחוק.
לוחצים על מחיקת קבוצת ההקשר.
בתיבת הדו-שיח לאישור מחיקת קבוצת ההקשר, מזינים את המזהה של קבוצת ההקשר.
לוחצים על אישור כדי למחוק את קבוצת ההקשרים.