כתיבת 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, לוחצים על רענוןרענון כדי לעדכן את סכימת מסד הנתונים.

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

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

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

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

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

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

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

• ‫"Add a date column called birthday to the Singers table.
• "How many singers were born in the 90s?‎"

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

כדי ליצור SQL ב-Cloud SQL בעזרת Gemini, פועלים לפי השלבים הבאים:

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

   מעבר אל Cloud SQL

2. בוחרים מופע מהרשימה.

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

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

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

6. מוודאים שהאפשרות יצירת שאילתות מהערות מופעלת.

7. כדי להריץ שאילתה במסד הנתונים, לוחצים על add New 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 ואז לוחצים על הפעלה.
     • אישור מילה: כדי לאשר חלקית את השאילתה המוצעת, מקישים על Control+Right arrow (או על Command+Right arrow ב-macOS) ואז לוחצים על הפעלה.
   • כדי לערוך את ה-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 כרטיסייה חדשה.

6. לצד עורך השאילתות, לוחצים על pen_spark עזרה בכתיבת קוד.

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, לוחצים על הוספה כדי להוסיף את ההצהרה לעורך השאילתות. לוחצים על Run כדי להריץ את ה-SQL המוצע.
   • כדי לבקש מ-Gemini ליצור שאילתה חדשה, לוחצים על עריכה. אחרי שערכתם את ההנחיה, לוחצים על עדכון. אחרי כן תוכלו לאשר את ההצהרה החדשה שנוצרה או לדחות את ההצעה.
   • כדי להתעלם מההצעה, סוגרים את החלון עזרה בכתיבת קוד.

הסבר על הצהרות 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 כרטיסייה חדשה.

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

7. מדגישים את השאילתה שרוצים ש-Gemini יסביר, ואז לוחצים על סמל הנצנוץ הסבר על השאילתה הזו.

   ההסבר לשאילתת ה-SQL יופיע בחלון הצ'אט של Gemini.

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

עכשיו Gemini מציע יכולת מורחבת שעוזרת לכם לתקן שגיאות בשאילתות Cloud SQL בלי לצאת מ-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. בסרגל המשימות, לוחצים על pen_sparkarrow_drop_downGemini כדי להציג את התכונות של Gemini ב-Cloud SQL.

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

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

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

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

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

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

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

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

מגבלות

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

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

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