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

במאמר הזה נסביר איך להשתמש ב-Gemini, כלי מבוסס-AI ב-Google Cloud, כדי לבצע את הפעולות הבאות ב-AlloyDB ל-PostgreSQL:

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

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

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

  1. מוודאים ש-Gemini Cloud Assist מוגדר לחשבון המשתמש ולפרויקט. Google Cloud

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

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

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

כדי להשבית את התכונות של Gemini ב-AlloyDB, חוזרים על השלב הזה ומבטלים את הבחירה בתכונות של Gemini שרוצים להשבית.

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

כדי להשתמש ב-Gemini עם AlloyDB, אתם צריכים את ההרשאות הבאות:

  • alloydb.clusters.get
  • alloydb.databases.list
  • alloydb.instances.executeSql
  • alloydb.instances.list
  • alloydb.users.list
  • cloudaicompanion.companions.generateCode
  • cloudaicompanion.instances.generateCode
  • serviceusage.services.get או serviceusage.services.list

אפשר לקבל את ההרשאה הזו באמצעות התפקיד roles/alloydb.admin. אם לא הוקצה לכם התפקיד הזה, פנו לאדמין הארגוני כדי לבקש גישה. יכול להיות שאפשר לקבל את ההרשאות הנדרשות גם באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש אחרים.

בנוסף, חשוב לוודא שיש לכם הרשאות ברמת מסד הנתונים למסד הנתונים שבו אתם משתמשים לאימות.

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

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

  • "צור טבלה למעקב אחר תוצאות סקר שביעות רצון הלקוחות".
  • ‫"Add a date column called birthday to the Singers table".
  • ‫"How many singers were born in the 90s?‎"

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

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

  1. במסוף Google Cloud , פותחים את הדף AlloyDB.

    מעבר אל AlloyDB

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

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

  4. בוחרים מסד נתונים ומשתמש, ומזינים את הסיסמה של המשתמש.

  5. לוחצים על אימות. בחלונית Explorer מוצגת רשימה של האובייקטים במסד הנתונים.

  6. כדי לשלוח שאילתה למסד הנתונים, לוחצים על New SQL editor tab (כרטיסייה חדשה של עורך SQL). מוודאים שיצירת SQL מופעלת.

  7. כדי ליצור 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'

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

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

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

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

  1. במסוף Google Cloud , פותחים את הדף AlloyDB.

    מעבר אל AlloyDB

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

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

  4. בוחרים מסד נתונים ומשתמש, ומזינים את הסיסמה של המשתמש.

  5. לוחצים על אימות. בחלונית Explorer מוצגת רשימה של האובייקטים במסד הנתונים.

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

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

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

    ‫Gemini יוצר SQL שדומה לזה:

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

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

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

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

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

  1. במסוף Google Cloud , פותחים את הדף AlloyDB.

    מעבר אל AlloyDB

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

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

  4. בוחרים מסד נתונים ומשתמש, ומזינים את הסיסמה של המשתמש.

  5. לוחצים על אימות. בחלונית Explorer מוצגת רשימה של האובייקטים במסד הנתונים.

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

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

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

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

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

‫Gemini מציע יכולת מורחבת שעוזרת לכם לתקן שגיאות בשאילתות AlloyDB בלי לצאת מכלי העריכה של השאילתות.

היכולות של Gemini שמבוססות על AI משולבות בעורך השאילתות כדי לספק את היתרונות הבאים:

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

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

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

תיקון השאילתה באמצעות Gemini

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

  1. במסוף Google Cloud , פותחים את הדף AlloyDB ל-PostgreSQL.

    מעבר אל AlloyDB

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

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

  4. בוחרים מסד נתונים ומשתמש, ומזינים את הסיסמה של המשתמש.

  5. לוחצים על אימות. בחלונית Explorer מוצגת רשימה של האובייקטים במסד הנתונים.

  6. בסרגל המשימות, לוחצים על settings_suggestionGemini כדי לראות את התכונות של Gemini ב-AlloyDB.

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

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

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

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

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

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

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

  12. כדי לאשר את השינויים ולהריץ את השאילתה החדשה, לוחצים על אישור והרצה.

מגבלות

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