sql_table_name (לצירופים)

בדף הזה יש התייחסות לפרמטר sql_table_name שהוא חלק מצירוף.

אפשר להשתמש ב-sql_table_name גם כחלק מתצוגה, כמו שמתואר בדף התיעוד של הפרמטר sql_table_name (לתצוגות).

אפשר להשתמש ב-sql_table_name גם כחלק מניתוח, כמו שמתואר בדף התיעוד של הפרמטר sql_table_name (לניתוחים).

Usage

explore: view_name {
  join: view_name {
    sql_table_name: table_name ;;
  }
}

היררכיה קובץ מודל explore join sql_table_name

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

הגדרה

בדרך כלל, התצוגה שעליה מבוסס join מגדירה את הטבלה שעליה מתבצעת השאילתה.

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

הגדרת היקף לשמות של טבלאות

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

אם אתם צריכים להפנות לטבלה במסד נתונים ובסכימה אחרים שלא נמצאים בנתיב החיפוש שמוגדר כברירת מחדל למשתמש במסד הנתונים, אתם יכולים להגדיר את היקף השם של הטבלה באמצעות הפורמט <database_name>.<schema_name>.<table_name> כדי להפנות למסד נתונים או לסכימה אחרים:

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

בחיבור ל-Google BigQuery, אפשר להפנות לטבלה בפרויקט ובמערך נתונים אחרים על ידי הגדרת היקף לשם הטבלה בפורמט <project_name>.<dataset_name>.<table_name>. מידע נוסף זמין בדף התיעוד של חיבור BigQuery של Google.

הערות:

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

דוגמאות

בדוגמה הזו, ההצטרפות של customers מסתמכת על הטבלה customer_1 מהסכימה שמוגדרת כברירת מחדל:

explore: orders {
  join: customers {
    sql_table_name: customer_1 ;;
    sql_on: ${order.customer_id} = ${customer.id} ;;
  }
}

בדוגמה הזו, הצירוף customers מסתמך על הטבלה customer_1 מהסכימה analytics על ידי הגדרת היקף של שם הטבלה כך שיכלול את שם הסכימה (בפורמט <schema_name>.<table_name>):

explore: orders {
  join: customers {
    sql_table_name: analytics.customer_1 ;;
    sql_on: ${order.customer_id} = ${customer.id} ;;
  }
}

דברים שכדאי לקחת בחשבון

צריך להיות אפשר לגשת לטבלאות שאליהן מתייחסים ב-sql_table_name מהחיבור הנוכחי

כשמשתמשים בפרמטר sql_table_name באובייקט join, האובייקט join מוגדר באובייקט explore, שנכלל בתורו באובייקט model. (ההיררכיה בדף הזה מציגה את שרשרת הקשרים הזו). באובייקט המודל מוגדר מסד נתונים connection. כשמפנים לטבלת מסד נתונים בפרמטר sql_table_name, צריך לוודא שיש גישה לטבלה בחיבור המשויך שצוין בקובץ המודל.

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

כדי לתת לjoin שם שונה מזה של הטבלה הבסיסית, צריך להחיל את sql_table_name ברמת התצוגה המפורטת

שימוש ב-sql_table_name ברמה של join, כפי שמתואר בדף הזה, הוא לא נפוץ. השימוש בה צריך להתבצע רק כשאותו תצוגה יכולה לתאר כמה טבלאות.

השיטה הנפוצה יותר היא להשתמש ב-sql_table_name ברמת התצוגה כדי לתת לתצוגה שם שונה משם הטבלה הבסיסית.

במקום זה:

קובץ מודל

explore: orders {
  join: customers {
    sql_table_name: customer_1 ;;
    sql_on: ${order.customer_id} = ${customer.id} ;;
  }
}}

כך עושים זאת:

קובץ מודל

explore: orders {
  join: customers {
    sql_on: ${order.customer_id} = ${customer.id} ;;
  }
}

הצגת הקובץ

view: customers {
  sql_table_name: customer_1 ;;
}