תצוגה מקדימה של שאילתות SQL

במאמר הזה מוסבר איך לראות תצוגה מקדימה של הפלט של שאילתת SQL בסביבת עבודה של Dataform לפני שמריצים את השאילתה ב-BigQuery.

מידע על תצוגה מקדימה של שאילתות ב-Dataform

כשמפתחים שאילתה בקובץ SQLX או JavaScript באמצעות Dataform core, המערכת של Dataform מהדרת את השאילתה ל-SQL בזמן אמת. כדי לבדוק את הפלט של שאילתת ה-SQL שעברה קומפילציה לפני שמריצים אותה ב-BigQuery, אפשר לראות תצוגה מקדימה של השאילתה בסביבת העבודה של Dataform.

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

הצגת תצוגה מקדימה של שאילתה ב-Dataform כרוכה בחיוב ב-BigQuery. מידע נוסף על התמחור של BigQuery זמין במאמר תמחור ב-BigQuery.

במהלך תצוגה מקדימה של שאילתה, Dataform משתמש בהרשאות המשתמש של חשבון Google שלכם כדי להריץ עבודות ב-BigQuery. במהלך ההפעלה של תהליך העבודה, מצב פעולה כמורשה (act-as) מחמיר מחייב את Dataform להשתמש בחשבון שירות מותאם אישית או בפרטי כניסה של משתמש בחשבון Google כדי ליצור או לעדכן נכסים ב-BigQuery.

ב-Dataform, התוצאות של כל השאילתות שמוצגת להן תצוגה מקדימה במהלך סשן הדפדפן הנוכחי מוצגות בחלונית Query results בסביבת העבודה. בחלונית תוצאות השאילתה אפשר לראות את הפרטים הבאים לגבי כל תצוגה מקדימה של שאילתה במהלך סשן הדפדפן הנוכחי:

  • פרטי המשרה
    • מזהה משימה ב-BigQuery
    • המשתמש שמפעיל את התצוגה המקדימה
    • המיקום שבו העבודה מופעלת, שנלקח מקובץ הגדרות זרימת העבודה
    • שעות היצירה, ההתחלה והסיום של משימת BigQuery
    • משך הזמן של משימת BigQuery
    • בייטים שעובדו
    • חיוב לפי בייט ב-BigQuery
    • עדיפות המשרה
    • שימוש ב-SQL מדור קודם בשאילתה
    • טבלת יעד זמנית של השאילתה
  • תוצאות השאילתה
  • ייצוג ב-JSON של פלט השאילתה

בנוסף, בחלונית Query results אפשר לעבור לקובץ המקור של כל שאילתה בתצוגה המקדימה, ולעבור אל BigQuery Studio כדי לראות את עבודת התצוגה המקדימה.

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

  1. נכנסים לדף Dataform במסוף Google Cloud .

    מעבר אל Dataform

  2. בוחרים מאגר או יוצרים מאגר.

  3. בוחרים או יוצרים סביבת עבודה לפיתוח.

  4. יוצרים שאילתת SQL, לדוגמה, create a table.

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

כדי לקבל את ההרשאות שדרושות לתצוגה מקדימה של שאילתות, אתם צריכים לבקש מהאדמין להקצות לכם את תפקידי ה-IAM הבאים:

להסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

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

תצוגה מקדימה של שאילתה

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

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

כדי לראות תצוגה מקדימה של שאילתת SQL ולצפות בתוצאות השאילתה בסביבת עבודה של Dataform, פועלים לפי השלבים הבאים:

  1. בחלונית Files, מרחיבים את definitions/.
  2. בוחרים קובץ SQLX או JavaScript.

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

    1. אם הקובץ מכיל כמה שאילתות, בתפריט בוחרים את השאילתה שרוצים לראות בתצוגה מקדימה.

  4. בודקים את התוצאות של התצוגה המקדימה בחלונית תוצאות השאילתה.

    1. כדי לבדוק את פרטי המשרה, בוחרים בכרטיסייה פרטי המשרה.
    2. כדי לבדוק את תוצאות השאילתה, בוחרים בכרטיסייה תוצאות.
    3. כדי לראות את פלט ה-JSON של השאילתה, בוחרים בכרטיסייה JSON.
    4. כדי לראות את משימת התצוגה המקדימה בסביבת העבודה של SQL, לוחצים על התפריט More (עוד) > View job in SQL workspace (הצגת המשימה בסביבת העבודה של SQL).

תצוגה מקדימה של טבלה עם הצהרות

בקובץ הגדרת טבלה ב-SQLX עם הצהרות, אפשר לראות תצוגה מקדימה של שאילתת יצירת הטבלה ושל שאילתות ההצהרות המוגדרות.

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

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

  1. בחלונית Files, מרחיבים את definitions/.
  2. בוחרים קובץ הגדרה של טבלה עם טענות.
  3. הפעלת תצוגה מקדימה:
    • כדי לראות תצוגה מקדימה של השאילתה ליצירת הטבלה, לוחצים על הפעלה.
    • כדי לראות תצוגה מקדימה של שאילתת טענה, לוחצים על סמל התפריט הנפתח לצד Run ובוחרים את השאילתה שרוצים לראות בתצוגה מקדימה.
  4. בודקים את התוצאות של התצוגה המקדימה בחלונית תוצאות השאילתה.
    1. כדי לבדוק את פרטי המשרה, בוחרים בכרטיסייה פרטי המשרה.
    2. כדי לבדוק את תוצאות השאילתה, בוחרים בכרטיסייה תוצאות.
    3. כדי לראות את פלט ה-JSON של השאילתה, בוחרים בכרטיסייה JSON.
    4. כדי לראות את התצוגה המקדימה של העבודה בסביבת העבודה של SQL, לוחצים על התפריט More (עוד) > View job in SQL workspace (הצגת העבודה בסביבת העבודה של SQL).

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