כתיבת SQL בעזרת Gemini

במאמר הזה מוסבר איך להשתמש ב-Gemini, כלי מבוסס-AI ב-Cloud de Confiance by S3NS, כדי לבצע את הפעולות הבאות ב-Cloud SQL Studio:

• יצירת שאילתות SQL באמצעות הנחיות בשפה טבעית
• הסבר על שאילתות SQL בעורך השאילתות

איך Gemini for Cloud de Confiance ‎ משתמש בנתונים שלכם, ובאילו מקרים.

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

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

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

3. אופציונלי: כדי לעקוב אחרי הדוגמאות במסמך הזה, צרו טבלת Singers באמצעות הסכימה הבאה:

   CREATE TABLE
   Singers (
     SingerId   BIGINT PRIMARY KEY,
     FirstName  VARCHAR(1024),
     LastName   VARCHAR(1024),
     SingerInfo BYTEA,
     BirthDate  TIMESTAMPTZ
   );
   

   אחרי שיוצרים את הטבלה Singers, לוחצים על רענוןRefresh כדי לעדכן את הסכימה של מסד הנתונים.

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

כדי לקבל את ההרשאות שנדרשות לביצוע המשימות שמפורטות במסמך הזה, צריך לבקש מהאדמין להקצות לכם את התפקיד אדמין של Cloud SQL (roles/cloudsql.admin) ב-IAM בפרויקט. כדי לקרוא הסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

יכול להיות שאפשר לקבל את ההרשאות הנדרשות גם באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש.

אתם צריכים גם את ההרשאות הבאות:

• הרשאות serviceusage.services.list או serviceusage.services.get ליכולות קריאה
• cloudaicompanion.companions.generateChat כדי להשתמש בהסבר על הצהרות SQL בעורך השאילתות
• הרשאה ל-cloudaicompanion.companions.generateCode להשתמש בעזרה בתכנות

יצירת שאילתות SQL באמצעות הנחיות בשפה טבעית

אתם יכולים לתת ל-Gemini הערות בשפה טבעית (או הנחיות) כדי ליצור שאילתות שמבוססות על הסכימה שלכם. לדוגמה, אתם יכולים לבקש מ-Gemini ליצור SQL בתגובה להנחיות הבאות:

• "תוסיף עמודת תאריך בשם "יום הולדת" לטבלה "זמרים"."
• "How many singers were born in the 90s?‎"

אם הסכימה משתנה, למשל אם מוסיפים טבלה או עמודה חדשה, לוחצים על סמל הרענוןRefresh כדי לעדכן את הסכימה לפני שמשתמשים ב-Gemini.

כדי ליצור SQL ב-Cloud SQL בעזרת Gemini:

1. נכנסים לדף Cloud SQL במסוף Cloud de Confiance .

   כניסה ל-Cloud SQL

2. בוחרים מכונה מהרשימה.

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

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

5. בסרגל המשימות, לוחצים על settings_suggestionarrow_drop_downGemini כדי לראות את התכונות של Gemini ב-Cloud SQL.

6. מוודאים שהאפשרות Comment-to-query generation מופעלת.

7. כדי לשלוח שאילתה למסד הנתונים, לוחצים על addNew SQL editor tab.

8. כדי ליצור SQL, מקלידים תגובה בעורך השאילתות שמתחילה ב--- ואחריה תגובה בשורה אחת, ואז לוחצים על Return או על Enter.

   לדוגמה, מזינים את ההנחיה הבאה:

   -- add a row to table singers
   

   לוחצים על Return או על Enter. ‫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'
   
   

9. בודקים את הצעת ה-SQL ומבצעים אחת מהפעולות הבאות:

   • כדי לראות את האפשרויות לאישור ה-SQL שנוצר על ידי Gemini, מעבירים את הסמן מעל השאילתה. האפשרויות הבאות מוצגות:
     • אישור: כדי לאשר את השאילתה המוצעת, לוחצים על Tab ואז על Run.
     • אישור מילה: כדי לאשר את השאילתה המוצעת באופן חלקי, לוחצים על Control+Right arrow (או על Command+Right arrow ב-macOS) ואז על Run.
   • כדי לערוך את ה-SQL המקורי, לוחצים על Tab, עורכים את ה-SQL ואז לוחצים על Run.
   • כדי לדחות את ההצעה, לוחצים על Esc או ממשיכים להקליד.

הכלי "עזרה בתכנות"

כדי להשתמש בכלי עזרה בתכנות:

1. נכנסים לדף Cloud SQL במסוף Cloud de Confiance .

   כניסה ל-Cloud SQL

2. בוחרים מכונה מהרשימה.

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

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

5. כדי לשלוח שאילתה למסד הנתונים, לוחצים על add New tab.

6. לוחצים על settings_suggestionעזרה בתכנות ליד עורך השאילתות.

7. בחלון עזרה בתכנות, כותבים הנחיה. לדוגמה, add a row to table singers, ואז לוחצים על יצירה.

   ‫Gemini יוצר קוד SQL שדומה לקוד הבא:

   INSERT INTO Singers (SingerId, FirstName, LastName, BirthDate)
   VALUES (1, Alex, 'M.', '1977-10-16');
   

8. בודקים את ה-SQL שנוצר ומבצעים אחת מהפעולות הבאות:

   • כדי לאשר את ה-SQL שנוצר על ידי Gemini, לוחצים על Insert כדי להוסיף את ההצהרה לעורך השאילתות. לוחצים על Run כדי להריץ את ה-SQL המוצע.
   • כדי לבקש מ-Gemini ליצור שאילתה חדשה, לוחצים על Edit. אחרי שערכתם את ההנחיה, לחצו על עדכון. אחר כך אתם יכולים להחליט אם לאשר את ההצהרה החדשה שנוצרה או לדחות את ההצעה.
   • כדי לסגור את ההצעה, סוגרים את החלון עזרה בתכנות.

הסבר על הצהרות SQL בעורך השאילתות

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

1. נכנסים לדף Cloud SQL במסוף Cloud de Confiance .

   כניסה ל-Cloud SQL

2. בוחרים מכונה מהרשימה.

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

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

5. כדי לשלוח שאילתה למסד הנתונים, לוחצים על add New tab.

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

7. מדגישים את השאילתה שרוצים ש-Gemini יסביר ולוחצים על astrophotography_mode Explain this selected query.

   ההסבר על ה-SQL מופיע בחלונית של Gemini Cloud Assist.

שימוש ב-Gemini לתיקון שגיאות בשאילתות

‫Gemini מציע עכשיו יכולת מורחבת שעוזרת לתקן שגיאות בשאילתות SQL של Cloud בלי לצאת מ-Cloud SQL Studio.

היכולות מבוססות ה-AI של Gemini משולבות ב-Cloud SQL Studio כדי לספק את היתרונות הבאים:

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

ההרשאות הנדרשות

לפני שמתחילים, צריך לוודא שיש לכם את ההרשאות הבאות:

• ההרשאות שמפורטות בקטע הרשאות נדרשות.
• ההרשאה ל-Gemini for Google Cloud API,‏ cloudaicompanion.googleapis.com/instances.generateCode.

תיקון השאילתה באמצעות Gemini ו-Cloud SQL Studio

כדי להשתמש ביכולות של Gemini לתיקון שגיאות מסוימות בשאילתה ב-Cloud SQL Studio:

1. נכנסים לדף Cloud SQL במסוף Cloud de Confiance .

   כניסה ל-Cloud SQL

2. בוחרים מכונה מהרשימה.

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

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

5. בסרגל המשימות, לוחצים על settings_suggestionarrow_drop_downGemini כדי לראות את התכונות של Gemini ב-Cloud SQL.

6. כדי לשלוח שאילתה למסד הנתונים, לוחצים על add New tab.

7. בעורך השאילתות, מזינים שאילתה שיכול להיות שהיא שגויה או לא מלאה.

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

   אם יש בעיה בשאילתה, תוחזר שגיאה.

   לדוגמה, ההודעה שמוחזרת יכולה להיות שגיאת אימות בכרטיסייה Run או הודעת שגיאה בכרטיסייה Results.

9. לוחצים על תיקון.

10. בחלון השאילתה, בכרטיסייה נפתח כלי לעריכת הבדלים (diff editor) שבו מוצגת השוואה בין השאילתה הקיימת לבין השינויים המומלצים, שורה אחר שורה. בעורך השאילתות מופיע גם סיכום של הצעות העריכה. בודקים את השינויים שהוצעו לשאילתה ומעדכנים לפי הצורך. אחר כך מאשרים ומריצים את השאילתה החדשה:

    לוחצים על אישור והפעלה.

מגבלות

• היכולת הזו נגישה רק ב-Cloud SQL Studio במסוףCloud de Confiance .
• המגבלות הנוכחיות של חלון ההקשר של Gemini חלות.

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

• סקירה כללית על Gemini for Cloud de Confiance
• איך Gemini משתמש בנתונים שלכם
• איך משתמשים בניתוח נתונים באמצעות שיחה עם Gemini כדי לנתח את הנתונים