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

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

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

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

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

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

  • צור טבלה שעוקבת אחרי תוצאות של סקר שביעות רצון הלקוחות.
  • "תוסיף עמודת תאריך בשם 'יום הולדת' לטבלה 'זמרים'".
  • "כמה זמרים נולדו בשנות ה-90?"

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

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

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

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

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

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

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

    כניסה ל-AlloyDB

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

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

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

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

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

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

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

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

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

    כניסה ל-AlloyDB

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

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

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

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

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

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

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

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

איך משתמשים ב-Gemini כדי לתקן שגיאות בשאילתות

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

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

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

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

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

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

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

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

    כניסה ל-AlloyDB

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

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

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

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

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

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

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

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

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

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

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

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

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

מגבלות

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