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

כשמשתמשים בסוכן עם מנוע תלוי הקשר, הוא יכול ליצור ולהעלות קבוצות הקשר באופן אוטומטי מה-CLI. במאמר הזה מוסבר איך ליצור, לערוך ולמחוק קבוצות הקשר ב-Spanner Studio כשרוצים להשתמש בממשק חזותי במסוף Google Cloud כדי לנהל קובצי קבוצות הקשר. כשיוצרים קבוצת הקשר ב-Spanner Studio, היא נשמרת בקבוצת ההקשרים default של הפרויקט באזור שנבחר, ומקושרת למסד הנתונים הנוכחי. השמות של קבוצות ההקשרים (והמזהים שנגזרים מהם) חייבים להיות ייחודיים בקבוצה default של קבוצות ההקשרים בפרויקט באזור מסוים, בכל מסדי הנתונים והמכונות. ב-Spanner Studio, אם מנסים ליצור קבוצת הקשרים עם שם שהמזהה שנגזר ממנו כבר קיים, האימות נכשל. כדי להחליף את התוכן של קבוצת ההקשרים הקיימת בלי לשנות את השיוך שלה למסד הנתונים, צריך לערוך אותה. אם מעלים ישירות דרך סוכן הנדסת ההקשר או Dataplex API עם מזהה קיים של קבוצת הקשרים, התוכן שלו מוחלף, ואם צוין, גם השיוכים שלו למסד הנתונים.

הרשימה Context sets ב-Spanner Studio מציגה רק קבוצות הקשר בקבוצת ההקשר default בכל האזורים הנתמכים שמקושרים למסד הנתונים הנוכחי. קבוצות הקשר שנוצרו למסד נתונים אחר, או שנוצרו דרך ה-API בלי לקשר את משאב מסד הנתונים ב-databases (או בקבוצה מותאמת אישית של קבוצות הקשר), לא מופיעות ברשימה של Spanner Studio.

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

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

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

אפשר ליצור קבוצות הקשר באזורים us-central1,‏ us-east1,‏ europe-west4 ו-asia-southeast1.

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

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

הכנת מכונה של Spanner

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

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

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

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

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

    כניסה ל-Spanner

  2. בוחרים מכונה מהרשימה ואז בוחרים מסד נתונים.

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

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

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

  6. בקטע שם קבוצת ההקשר, נותנים שם ייחודי לקבוצת ההקשר. ב-Spanner Studio, השם צריך להיות באורך של 4 עד 30 תווים ולא יכול להתחיל ברווח לבן. Studio יוצר את מזהה קבוצת ההקשרים על ידי המרת השם לאותיות קטנות והחלפת תווים לא אלפאנומריים במקפים (-). מזהה קבוצת ההקשרים שנוצר צריך להיות ייחודי בקבוצת ההקשרים default של הפרויקט באזור שנבחר. לדוגמה, למזהה קבוצת ההקשר querydata-e2e-test יש את השם querydata_e2e_test. כשמעלים קבוצת הקשרים ישירות באמצעות סוכן הנדסת ההקשר או Dataplex API, מזהה קבוצת ההקשרים תלוי אותיות רישיות, לא יכול להכיל לוכסנים (/) ולא מוגבל ל-4 עד 30 תווים או לתווים אלפאנומריים, מקפים וקווים תחתונים.

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

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

  9. זה שינוי אופציונלי. כדי לבחור אזור לקבוצת ההקשר, לוחצים על הצגת אפשרויות מתקדמות ובוחרים אזור בקטע בחירת מיקום (ברירת המחדל היא us-east1 בכל יצירה). אם בוחרים אזור אחר, צריך לבחור אותו לפני שמזינים את שם קבוצת ההקשר כדי ש-Spanner Studio יוכל לוודא שהשם ייחודי באזור הזה.us-east1

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

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

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

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

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

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

    כניסה ל-Spanner

  2. בוחרים מכונה מהרשימה ואז בוחרים מסד נתונים.

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

  4. לוחצים על הצגת פעולות לצד קבוצת ההקשר שרוצים לערוך.

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

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

  7. לוחצים על עיון בקטע העלאת קובץ של קבוצת הקשרים ובוחרים את הקובץ של קבוצת ההקשרים.

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

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

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

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

    כניסה ל-Spanner

  2. בוחרים מכונה מהרשימה ואז בוחרים מסד נתונים.

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

  4. לוחצים על הצגת פעולות לצד קבוצת ההקשר שרוצים למחוק.

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

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

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

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