ניהול סוכני נתונים ב-Cloud SQL ל-MySQL Studio

‫MySQL | PostgreSQL | SQL Server

גרסת טרום-השקה — Data agents

השימוש בתכונה הזו כפוף לתנאי השימוש במוצרים בגרסת טרום-GA, שמפורטים בחלק "תנאים כלליים לשירות" של התנאים הספציפיים לשירות, ושל התנאים הנוספים למוצרי AI גנרטיבי בגרסת טרום-GA. השימוש בתכונות בגרסת טרום-GA הוא "כפי שהן" (As is), ויכול להיות שהתמיכה בהן תהיה מוגבלת. אתם יכולים לקרוא מידע נוסף בקטע תיאור שלבי ההשקה.

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

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

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

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

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

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

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

הכנת מכונה של Cloud SQL

מוודאים שיש לכם גישה למופע קיים של Cloud SQL או יוצרים מופע חדש. מידע נוסף זמין במאמר יצירת מופעים ל-Cloud SQL.
מוודאים שיוצרים מסד נתונים במופע שבו ייצרו את הטבלאות. מידע נוסף זמין במאמר יצירת מסד נתונים במכונת Cloud SQL

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

מוסיפים משתמש IAM או חשבון שירות ברמת המופע. מידע נוסף זמין במאמר בנושא הוספת קשר בין כללי מדיניות של IAM למשתמש, לחשבון שירות או לקבוצה.
מקצים למשתמש IAM את התפקידים cloudsql.studioUser ו-cloudsql.instanceUser ברמת הפרויקט. מידע נוסף זמין במאמר הוספת קשירת מדיניות IAM לפרויקט.
בנוסף, צריך להעניק הרשאות למסד הנתונים למשתמש IAM או לחשבון שירות. כדי לעשות זאת, צריך להתחבר למסד הנתונים כמשתמש שמבוסס על סיסמה.

GRANT ALL PRIVILEGES ON * TO "IAM_USERNAME";.

מידע נוסף זמין במאמר איך מעניקים הרשאות למסד נתונים למשתמש יחיד ב-IAM או לחשבון שירות.

מתן הרשאה ל-`executesql` למופע Cloud SQL

כדי להעניק את ההרשאה executesql למכונת Cloud SQL ולהפעיל את Cloud SQL Data API, מריצים את הפקודה הבאה:

‫

gcloud components update
gcloud beta sql instances patch INSTANCE_ID --data-api-access=ALLOW_DATA_API

מחליפים את INSTANCE_ID במזהה של מופע Cloud SQL.

כדי לבצע את השלבים במדריך הזה, צריך להיכנס אל Google Cloud ולאמת את מסד הנתונים באמצעות אימות IAM.

יצירת סוכן נתונים

כדי ליצור סוכן נתונים, פועלים לפי השלבים הבאים:

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

מעבר אל Cloud SQL
בוחרים מופע מהרשימה.
בתפריט הניווט, לוחצים על Cloud SQL Studio.
נכנסים ל-Studio באמצעות אימות של ניהול זהויות והרשאות גישה (IAM).
בחלונית Explorer, לצד סוכני נתונים, לוחצים על הצגת פעולות.
לוחצים על יצירת סוכן.
בשדה שם הסוכן, מזינים שם ייחודי לסוכן. שם הסוכן תלוי באותיות רישיות וקטנות, ויכול להכיל אותיות, מספרים, מקפים וקווים תחתונים.
זה שינוי אופציונלי. בקטע תיאור הסוכן, מוסיפים תיאור לסוכן.
זה שינוי אופציונלי. לוחצים על הצגת אפשרויות מתקדמות ובקטע בחירת מיקום בוחרים אזור לאחסון ההקשר של הסוכן. אפשר לבחור מתוך רשימת האזורים הנתמכים הבאה:
- us-central1
- us-east1
- europe-west4
- asia-southeast1
לוחצים על יצירה.

יצירת הקשר של הסוכן

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

עריכת סוכן

כדי לערוך סוכן נתונים, פועלים לפי השלבים הבאים:

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

מעבר אל Cloud SQL
בוחרים מופע מהרשימה.
בתפריט הניווט, לוחצים על Cloud SQL Studio.
נכנסים ל-Studio באמצעות אימות של ניהול זהויות והרשאות גישה (IAM).
בחלונית Explorer, לצד סוכני נתונים, לוחצים על הצגת פעולות.
לוחצים על עריכת סוכן.
אופציונלי: עורכים את תיאור הסוכן.
בקטע העלאת קובץ הקשר של הסוכן, לוחצים על עיון ובוחרים את קובץ ההקשר של הסוכן.
לוחצים על Save.

מחיקה של סוכן נתונים

כדי למחוק סוכן נתונים:

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

מעבר אל Cloud SQL
בוחרים מופע מהרשימה.
בתפריט הניווט, לוחצים על Cloud SQL Studio.
נכנסים ל-Studio באמצעות אימות של ניהול זהויות והרשאות גישה (IAM).
בחלונית Explorer, לצד סוכני נתונים, לוחצים על הצגת פעולות.
לוחצים על מחיקת הנציג.
בתיבת הדו-שיח לאישור מחיקת נציג, מזינים את שם הנציג.
לוחצים על אישור כדי למחוק את הסוכן.