במאמר הזה מוסבר איך אפשר להשתמש ב-Gemini Code Assist כדי לקבל עזרה מבוססת-AI בפעולות הבאות ב-Spanner:
איך Gemini for Google Cloud משתמש בנתונים שלכם, ובאילו מקרים.
המסמך הזה מיועד לאדמינים של מסדי נתונים ולמהנדסי נתונים שמכירים את Spanner, SQL וניתוח נתונים. אם אתם חדשים ב-Spanner, כדאי לעיין במאמר יצירה של מסד נתונים והפעלת שאילתות בו באמצעות מסוף Google Cloud .
לפני שמתחילים
אופציונלי: מגדירים את Gemini Code Assist.
כדי להשלים את המשימות שמתוארות במסמך הזה, צריך לוודא שיש לכם את ההרשאות הנדרשות לניהול זהויות והרשאות גישה (IAM).
נכנסים לדף Spanner במסוף Google Cloud .
בוחרים מופע מהרשימה.
בוחרים מסד נתונים.
בתפריט הניווט, לוחצים על Spanner Studio.
ב-Spanner Studio, לוחצים על הלחצן settings_suggestion Gemini Code Assist כדי לראות את התכונות של Gemini ב-Spanner.
בוחרים את התכונות של Gemini שרוצים להפעיל – לדוגמה, יצירת שאילתות על סמך הערות. אתם יכולים לבחור תכונות ולנסות אותן בעצמכם בלי להשפיע על אנשים אחרים שעובדים בפרויקט.
אופציונלי: כדי לפעול לפי הדוגמאות במסמך הזה, צריך קודם ליצור את הטבלה
Singersכמו שמתואר במאמר יצירת סכימה למסד הנתונים.
כדי להשבית את התכונות של Gemini ב-Spanner, חוזרים על השלבים האלה ומבטלים את הבחירה בתכונות של Gemini שרוצים להשבית.
התפקידים הנדרשים
כדי לקבל את ההרשאות שנדרשות להשלמת המשימות שמתוארות במסמך הזה, צריך לבקש מהאדמין להקצות לכם את התפקיד ב-IAM Gemini for Google Cloud User (roles/cloudaicompanion.user) בפרויקט.
להסבר על מתן תפקידים, קראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.
יכול להיות שאפשר לקבל את ההרשאות הנדרשות גם באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש.
יצירת שאילתות SQL באמצעות הנחיות בשפה טבעית
אתם יכולים לתת ל-Gemini הערות בשפה טבעית (או הנחיות) כדי ליצור שאילתות שמבוססות על הסכימה שלכם. לדוגמה, אפשר להנחות את Gemini ליצור SQL בתגובה להנחיות הבאות:
- "צור טבלה למעקב אחר תוצאות סקר שביעות רצון הלקוחות".
- "Add a date column called birthday to the Singers table".
- "How many singers were born in the 90s?"
כדי ליצור SQL ב-Spanner בעזרת Gemini, פועלים לפי השלבים הבאים:
נכנסים לדף Spanner במסוף Google Cloud .
בוחרים מופע מהרשימה.
בוחרים מסד נתונים.
בחלונית הניווט, לוחצים על Spanner Studio. בחלונית Explorer מוצגת רשימה של אובייקטים במסד הנתונים.
כדי לשלוח שאילתה למסד הנתונים, לוחצים על כרטיסייה חדשה. מוודאים שיצירת SQL מופעלת.
כדי ליצור SQL, מקלידים תגובה בעורך השאילתות שמתחילה ב-
--ואחריה תגובה בשורה אחת, ואז לוחצים עלReturn.לדוגמה, אם מזינים את ההנחיה
-- add a row to table singersולוחצים עלReturn, Gemini יוצר SQL שדומה לזה:INSERT INTO Singers (SingerId, FirstName, LastName, BirthDate) VALUES (1, Alex, 'M.', '1977-10-16');כדי להמשיך את הדוגמה באמצעות הטבלה
Singers, אם מזינים את ההנחיה-- show all singers born in the 70s, Gemini יוצר SQL שדומה לזה:SELECT * FROM Singers WHERE Singers.BirthDate BETWEEN '1970-01-01' AND '1979-12-31'בודקים את ה-SQL שנוצר ומבצעים אחת מהפעולות הבאות:
- כדי לאשר קוד SQL שנוצר על ידי Gemini, מקישים על
Tabואז לוחצים על Run כדי להריץ את קוד ה-SQL המוצע. - כדי לערוך את ה-SQL שנוצר על ידי Gemini, לוחצים על
Tab, עורכים את ה-SQL ואז לוחצים על הפעלה. - כדי לסגור את ההצעה, לוחצים על
Escאו ממשיכים להקליד.
- כדי לאשר קוד SQL שנוצר על ידי Gemini, מקישים על
הסבר על הצהרות SQL בעורך השאילתות
אתם יכולים להשתמש ב-Gemini ב-Spanner כדי להסביר שאילתות SQL בשפה טבעית. ההסבר הזה יכול לעזור לכם להבין את התחביר, את הסכימה הבסיסית ואת ההקשר העסקי של שאילתות מורכבות או ארוכות.
נכנסים לדף Spanner במסוף Google Cloud .
בוחרים מופע מהרשימה.
בוחרים מסד נתונים.
בחלונית הניווט, לוחצים על Spanner Studio.
כדי לשלוח שאילתה למסד הנתונים, לוחצים על כרטיסייה חדשה.
בעורך השאילתות, מדביקים את השאילתה.
מדגישים את השאילתה שרוצים ש-Gemini יסביר, ואז לוחצים על astrophotography_mode הסבר על השאילתה הנבחרת.
ההסבר על ה-SQL מופיע בחלונית של Gemini Cloud Assist.
שימוש ב-Gemini לתיקון שגיאות בשאילתות
Gemini מציע יכולת מורחבת שעוזרת לכם לתקן שגיאות בשאילתות Spanner בלי לצאת מכלי העריכה של השאילתות.
יכולות מבוססות-AI של Gemini משולבות ב-Spanner Studio כדי לספק את היתרונות הבאים:
- הכלי מספק השוואה שורה אחר שורה של השאילתה המקורית לצד שאילתה חדשה עם שינויים מומלצים באמצעות הכלי לעריכת שאילתות.
- הכלי מדגיש פלחים בשאילתה המקורית שעשויים לגרום לבעיה ומספק סיכום של השינויים בשפה טבעית.
- הוא מתייחס להודעת השגיאה המדויקת ולמידע על הסכימה שמשויכים לשאילתה, כדי לספק תיקונים מדויקים ורלוונטיים.
- השימוש ב-Gemini מבטל את הצורך להסתמך על מודלים גדולים של שפה (LLM) למטרות כלליות של צד שלישי, שעשויים לספק עזרה פחות מדויקת וגם לחשוף את הנתונים שלכם לסיכוני אבטחה פוטנציאליים.
- הכלי מספק פתרון בעיות מהיר ויעיל יותר לבעיות נפוצות כמו שגיאות בתחביר, בסכימה ובזמן הריצה.
ההרשאות הנדרשות
לפני שמתחילים, חשוב לוודא שיש לכם את ההרשאות הבאות:
- התפקידים שמפורטים בקטע התפקידים הנדרשים.
- ההרשאה Gemini for Google Cloud API,
cloudaicompanion.googleapis.com/instances.generateCode.
תיקון השאילתה באמצעות Gemini
כדי להשתמש ביכולות של Gemini לתיקון שגיאות מסוימות בשאילתה:
מריצים את השאילתה בעורך השאילתות.
אם השאילתה מכילה שגיאה, תוצג הודעת שגיאה בבאנר שגיאה בתחתית העורך.
לוחצים על תיקון.
בחלון השאילתה, בכרטיסייה נפתח כלי להשוואת הבדלים (diff editor), שבו מוצגת השוואה שורה אחר שורה של השאילתה הקיימת עם השינויים המומלצים. עורך השאילתות מספק גם סיכום של העריכות המוצעות.
בודקים את השינויים שהוצעו בשאילתה ומעדכנים אותה לפי הצורך.
כדי לאשר את השינויים ולהריץ את השאילתה החדשה, לוחצים על אישור והרצה.
מגבלות
- היכולת הזו זמינה רק בכלי לעריכת שאילתות ב-Spanner Studio ב-Google Cloud Console.
- מגבלות חלון ההקשר של Gemini חלות.