כשמשתמשים בסוכן עם מנוע תלוי הקשר, הוא יכול ליצור ולהעלות קבוצות הקשר באופן אוטומטי מה-CLI. במאמר הזה מוסבר איך ליצור, לערוך ולמחוק קבוצות של הקשרים ב-Cloud SQL ל-MySQL Studio, כשרוצים להשתמש בממשק חזותי במסוף Google Cloud כדי לנהל קבצים של קבוצות הקשרים. כשיוצרים קבוצת הקשר ב-Cloud SQL Studio, היא נשמרת בקבוצת ההקשרים default של הפרויקט באזור שנבחר, ומקושרת למסד הנתונים הנוכחי. השמות של קבוצות ההקשרים (והמזהים שנגזרים מהם) חייבים להיות ייחודיים בקבוצה default של קבוצות ההקשרים בפרויקט באזור מסוים, בכל מסדי הנתונים והמכונות. ב-Cloud SQL Studio, אם מנסים ליצור קבוצת הקשרים עם שם שהמזהה שנגזר ממנו כבר קיים, האימות נכשל. כדי להחליף את התוכן של קבוצת ההקשרים הקיימת בלי לשנות את השיוך שלה למסד הנתונים, צריך לערוך אותה. אם מעלים ישירות דרך סוכן הנדסת ההקשר או Dataplex API עם מזהה קיים של קבוצת הקשרים, התוכן שלו מוחלף, ואם צוין, גם השיוכים שלו למסד הנתונים.
ברשימה Context sets ב-Cloud SQL Studio מוצגות רק קבוצות ההקשר בקבוצת ההקשר default בכל האזורים הנתמכים שמקושרים למסד הנתונים הנוכחי. קבוצות של הקשרים שנוצרו בשביל מסד נתונים אחר, או שנוצרו באמצעות ה-API בלי לקשר את משאב מסד הנתונים ב-databases (או בקבוצה של קבוצות הקשרים בהתאמה אישית), לא מופיעות ברשימה של Cloud SQL Studio.
לפני שמתחילים
לפני שיוצרים או מעלים קבוצת הקשר, צריך לבצע את הפעולות הבאות.
אפשר ליצור קבוצות הקשר באזורים us-central1, us-east1, europe-west4 ו-asia-southeast1.
הפעלת השירותים הנדרשים
מפעילים את השירותים הבאים בפרויקט:הכנת מכונה של Cloud SQL
- מוודאים שיש לכם גישה למכונה קיימת של Cloud SQL או יוצרים מכונה חדשה. מידע נוסף זמין במאמר יצירת מכונות ל-Cloud SQL.
- חשוב לוודא שאתם יוצרים מסד נתונים במכונה שבה תיצרו את הטבלאות. מידע נוסף זמין במאמר יצירת מסד נתונים במכונה של Cloud SQL.
תפקידים והרשאות נדרשים
- מפעילים אימות של מסד נתונים ב-IAM במכונה על ידי הגדרת הדגל לניהול מסד הנתונים
cloudsql_iam_authenticationלערךon(cloudsql_iam_authentication=on). מידע נוסף זמין במאמר הגדרת מכונות קיימות לאימות של מסד נתונים ב-IAM. - מוסיפים משתמש או חשבון שירות ב-IAM ברמת המכונה. למידע נוסף, קראו את המאמר הוספת קישור למדיניות IAM למשתמש, לחשבון שירות או לקבוצה.
- מקצים את התפקידים
roles/cloudsql.studioUser,roles/cloudsql.instanceUser,roles/serviceusage.serviceUsageConsumerו-roles/geminidataanalytics.queryDataUserלמשתמש או לחשבון השירות ב-IAM ברמת הפרויקט. למידע נוסף, קראו את המאמר הוספת קישור למדיניות IAM בפרויקט. - כדי ליצור, להעלות ולנהל קבוצות של הקשרים, צריך להקצות את התפקיד "עריכה של Dataplex Catalog" (
roles/dataplex.catalogEditor) או "אדמין של Dataplex Catalog" (roles/dataplex.catalogAdmin) למשתמש ה-IAM או לחשבון השירות ברמת הפרויקט. מידע נוסף זמין במאמר הרשאות לקבוצות הקשר. - משתמש עם הרשאות צריך להעניק הרשאות למסד הנתונים למשתמש או לחשבון השירות ב-IAM.
GRANT SELECT ON DATABASE_NAME.* TO 'IAM_USERNAME'@'%';
מחליפים את DATABASE_NAME בשם של מסד הנתונים ואת IAM_USERNAME בשם המשתמש ב-IAM בלי@וסיומת האתר (לדוגמה,user@example.comהופך ל-user, וכתוצאה מכך ל-'user'@'%').
מידע נוסף זמין במאמר הענקת הרשאות למסד הנתונים למשתמש או לחשבון שירות ספציפיים ב-IAM.
מתן הרשאה ל-executesql במכונה של Cloud SQL
כדי לתת את ההרשאה executesql למכונה של Cloud SQL ולהפעיל את Cloud SQL Data API, מריצים את הפקודה הבאה:
gcloud sql instances patch INSTANCE_ID --project=PROJECT_ID --data-api-access=ALLOW_DATA_API
-
PROJECT_ID: מזהה הפרויקט ב- Google Cloud . -
INSTANCE_ID: המזהה של מכונת Cloud SQL.
יצירת קבוצת הקשרים
כדי ליצור קבוצת הקשר:
נכנסים לדף Cloud SQL במסוף Google Cloud .
בוחרים מכונה מהרשימה.
בתפריט הניווט, לוחצים על Cloud SQL Studio.
נכנסים ל-Cloud SQL Studio באמצעות אימות IAM.
בחלונית Explorer, לצד Context sets, לוחצים על View actions.
לוחצים על יצירת קבוצת הקשרים.
בקטע שם קבוצת ההקשר, נותנים שם ייחודי לקבוצת ההקשר. ב-Cloud SQL Studio, השם צריך להיות באורך של 4 עד 30 תווים ולא יכול להתחיל ברווח לבן. Studio יוצר את מזהה קבוצת ההקשרים על ידי המרת השם לאותיות קטנות והחלפת תווים לא אלפאנומריים במקפים (
-). מזהה קבוצת ההקשרים שנוצר צריך להיות ייחודי בקבוצת ההקשריםdefaultשל הפרויקט באזור שנבחר. לדוגמה, למזהה קבוצת ההקשרquerydata-e2e-testיש את שם קבוצת ההקשרquerydata_e2e_test. כשמעלים קבוצת הקשרים ישירות באמצעות סוכן הנדסת ההקשר או Dataplex API, מזהה קבוצת ההקשרים תלוי אותיות רישיות, לא יכול להכיל לוכסנים (/) ולא מוגבל ל-4 עד 30 תווים או לתווים אלפאנומריים, מקפים וקווים תחתונים.זה שינוי אופציונלי. בקטע תיאור של קבוצת ההקשרים, מוסיפים תיאור לקבוצת ההקשרים.
זה שינוי אופציונלי. כדי להעלות קובץ של קבוצת הקשר, לוחצים על עיון בקטע העלאת קובץ של קבוצת הקשר ובוחרים את הקובץ.
זה שינוי אופציונלי. כדי לבחור אזור לקבוצת ההקשר, לוחצים על הצגת אפשרויות מתקדמות ובוחרים אזור בקטע בחירת מיקום (ברירת המחדל היא
us-east1בכל יצירה). אם בוחרים אזור אחר, צריך לבחור אותו לפני שמזינים את שם קבוצת ההקשרים כדי ש-Cloud SQL Studio יוכל לוודא שהשם ייחודי באזור הזה.us-east1לוחצים על יצירה.
יצירת קבוצות הקשרים
אם יצרתם קבוצת הקשר ריקה ב-Studio, או אם אתם רוצים לעדכן קבוצה קיימת, אתם יכולים לפעול לפי השלבים במאמר יצירה ואופטימיזציה של קבוצות הקשר באמצעות סוכן הנדסת ההקשר כדי ליצור קובץ של קבוצת הקשר ולבצע בו אופטימיזציה. סוכן עם מנוע תלוי הקשר יכול ליצור ולהעלות את קבוצת ההקשר ישירות מה-CLI, או שאתם יכולים לערוך את קבוצת ההקשר ב-Studio כדי להעלות את הקובץ של קבוצת ההקשר באופן ידני.
עריכת קבוצת הקשרים
כדי לערוך קבוצת הקשר:
נכנסים לדף Cloud SQL במסוף Google Cloud .
בוחרים מכונה מהרשימה.
בתפריט הניווט, לוחצים על Cloud SQL Studio.
נכנסים ל-Cloud SQL Studio באמצעות אימות IAM.
לוחצים על הצגת פעולות לצד קבוצת ההקשר שרוצים לערוך.
לוחצים על עריכת קבוצת ההקשר.
זה שינוי אופציונלי. עורכים את תיאור קבוצת ההקשרים.
לוחצים על עיון בקטע העלאת קובץ של קבוצת הקשרים ובוחרים את הקובץ של קבוצת ההקשרים.
לוחצים על Save.
מחיקה של קבוצת הקשרים
כדי למחוק קבוצת הקשר, מבצעים את השלבים הבאים:
נכנסים לדף Cloud SQL במסוף Google Cloud .
בוחרים מכונה מהרשימה.
בתפריט הניווט, לוחצים על Cloud SQL Studio.
נכנסים ל-Cloud SQL Studio באמצעות אימות IAM.
לוחצים על הצגת פעולות לצד קבוצת ההקשר שרוצים למחוק.
לוחצים על מחיקת קבוצת ההקשר.
בתיבת הדו-שיח לאישור מחיקת קבוצת ההקשר, מזינים את המזהה של קבוצת ההקשר.
לוחצים על אישור כדי למחוק את קבוצת ההקשרים.
המאמרים הבאים
- מידע נוסף על קבוצות הקשר
- איך בודקים את QueryData ב-Cloud SQL Studio
- איך יוצרים ומבצעים אופטימיזציה של קבוצות הקשרים באמצעות סוכן הנדסת ההקשר
- איך משלבים את QueryData באפליקציה