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

כדי להשבית את התכונות של 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 מופעלת.

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

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

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

מגבלות

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