שימוש ב-SQL Runner ליצירת טבלאות נגזרות

כלי SQL Runner מספק גישה ישירה למסד הנתונים, שבה אפשר להשתמש כדי ליצור טבלאות נגזרות ולנפות בהן באגים בפרויקטים של LookML. אתם יכולים להשתמש ב-SQL Runner כדי להגדיר טבלאות נגזרות חדשות ולפתור בעיות בטבלאות קיימות, וכך לוודא שהנתונים מדויקים ולשפר את תהליך הפיתוח. במדריך הזה מוסבר איך להשתמש ב-SQL Runner כדי לבצע את המשימות האלה.

בדף הזה מוסבר איך ליצור טבלה נגזרת באמצעות SQL Runner ואיך להשתמש ב-SQL Runner כדי לנפות באגים בטבלאות נגזרות. מידע נוסף זמין במאמרי העזרה הבאים:

הוספת שאילתה של SQL Runner לפרויקט LookML

‫SQL Runner הוא מקום מצוין לבדיקת SQL לשימוש כטבלה נגזרת בפרויקט LookML. אתם יכולים אפילו לקבל שאילתת SQL מכלי אחר, לבדוק אותה ב-SQL Runner ואז להוסיף אותה לפרויקט LookML.

אחרי שיצרתם שאילתת SQL ב-SQL Runner, אתם יכולים ליצור טבלה נגזרת מהשאילתה באמצעות האפשרות Add to Project או האפשרות Get Derived Table LookML. שתי האפשרויות האלה מאפשרות לכם לקחת שאילתה ב-SQL Runner ולהוסיף אותה לפרויקט LookML. מידע נוסף מופיע בקטעים הבאים.

הוספה לפרויקט

הדרך הכי קלה להוסיף שאילתת SQL Runner לפרויקט היא באמצעות האפשרות Add to Project (הוספה לפרויקט):

דף SQL Runner עם תפריט גלגל השיניים פתוח והקישור Add to Project (הוספה לפרויקט) מודגש.

האפשרות הוספה לפרויקט מאפשרת לבחור פרויקט של LookML, ואז Looker יוצר באופן אוטומטי קובץ תצוגה עם השאילתה בפרויקט שבחרתם. אם אתם מעדיפים ליצור ידנית את קובץ התצוגה ולהוסיף את ה-LookML של השאילתה בעצמכם, אתם יכולים להשתמש באפשרות Get Derived Table LookML.

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

  1. משתמשים ב-SQL Runner כדי ליצור שאילתת SQL שרוצים להשתמש בה לטבלה נגזרת.
  2. לוחצים על הוספה לפרויקט בתפריט ההגדרות בפינה השמאלית העליונה.
  3. בוחרים את הפרויקט שאליו רוצים להוסיף את הטבלה הנגזרת.
  4. מזינים שם לתצוגה של הטבלה הנגזרת.
  5. לוחצים על הוספה כדי להוסיף את השאילתה כטבלה נגזרת בפרויקט. אם Looker לא נמצא כבר במצב פיתוח, הוא יעבור למצב הזה, ייצור קובץ תצוגה חדש עם LookML מהשאילתה של SQL Runner, ואז יפתח את דפדפן קבצי ה-IDE לקובץ התצוגה החדש.
  6. מעבירים את הקובץ למקום שמתאים לארגון הקבצים של הפרויקט.
  7. מאמתים את ה-LookML ופורסים את השינויים בסביבת הייצור.

קבלת LookML של טבלה נגזרת

דרך נוספת ליצור טבלה נגזרת משאילתת SQL Runner היא באמצעות האפשרות Get Derived Table LookML (קבלת LookML של טבלה נגזרת) מתפריט האפשרויות (סמל גלגל השיניים) של SQL Runner. בדומה לאפשרות הוספה לפרויקט, ‏ Looker יספק את קוד ה-LookML שנדרש כדי להפוך את שאילתת ה-SQL לטבלה נגזרת. משם אפשר להעתיק את קוד ה-LookML ולהדביק אותו בפרויקט, וזה שימושי אם רוצים להחליף טבלת נתונים נגזרת קיימת.

כדי ליצור טבלה נגזרת משאילתה ב-SQL Runner:

  1. משתמשים ב-SQL Runner כדי ליצור שאילתת SQL שרוצים להשתמש בה לטבלה נגזרת.
  2. לוחצים על תפריט גלגל השיניים ובוחרים באפשרות קבלת LookML של טבלה נגזרת.
  3. בחלון הקופץ Get Derived Table LookML (קבלת קוד LookML של טבלה נגזרת), לוחצים על הקישור add it to your project (הוספה לפרויקט).

  4. משתמשים ברשימה הנפתחת פרויקט כדי לבחור את הפרויקט שאליו רוצים להוסיף את הטבלה הנגזרת.

  5. מזינים שם לתצוגה החדשה בשדה שם התצוגה. במאמר ניהול קבצים ותיקיות של LookML מוסבר על כללי מתן שמות לקבצים.

  6. לוחצים על הלחצן הוספה. אם Looker לא נמצא כבר במצב פיתוח, הוא יעבור למצב הזה, ייצור קובץ תצוגה חדש עם LookML מהשאילתה של SQL Runner, ואז יפתח את דפדפן קבצי ה-IDE לקובץ התצוגה החדש.

  7. מעבירים את הקובץ למקום שמתאים לארגון הקבצים של הפרויקט.

  8. מאמתים את ה-LookML ופורסים את השינויים בסביבת הייצור.

ניפוי באגים באמצעות SQL Runner

כלי נוסף שימושי לבדיקת שגיאות SQL בהגדרה של טבלה נגזרת הוא SQL Runner.

הדגשת שגיאות ב-SQL Runner

כלי SQL Runner מדגיש את המיקום של השגיאות בפקודת ה-SQL וכולל את מיקום השגיאה בהודעת השגיאה.

המידע על המיקום משתנה בהתאם לניב של מסד הנתונים. לדוגמה, ב-MySQL מצוין מספר השורה שבה מופיעה השגיאה, וב-Redshift מצוין מיקום התו של השגיאה. יכול להיות שבניבים אחרים של מסדי נתונים יש התנהגויות כאלה או אחרות.

בנוסף, SQL Runner מדגיש את המיקום של שגיאת התחביר הראשונה בפקודת ה-SQL באמצעות קו תחתון אדום וסימון השורה באות x. כדי לראות מידע נוסף על השגיאה, מעבירים את העכבר מעל הסמל 'X'. אחרי שמתקנים את הבעיה, לוחצים על הפעלה כדי לבדוק אם יש עוד שגיאות בשאילתה.

שימוש ב-SQL Runner לבדיקת טבלאות נגזרות

אם מופיעה שגיאה מטבלת נתונים נגזרת, אפשר להעתיק את הצהרת ה-SQL אל SQL Runner ולבדוק חלקים שונים של ה-SQL כדי לצמצם את מיקום השגיאה. מידע נוסף זמין בפוסט בקהילת Looker בנושא שימוש ב-SQL Runner לבדיקת טבלאות נגזרות.