sql_table_name (לניתוחים)

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

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

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

Usage

explore: explore_name {
  sql_table_name: table_name ;;
}

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

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

הגדרה

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

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

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

דוגמאות

בדוגמה הזו, ה-Explore customers מסתמך על הטבלה customer_1 ממסד הנתונים או מהסכימה שמוגדרים כברירת מחדל:

explore: customers {
  sql_table_name: customer_1 ;;
}

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

explore: customers {
  sql_table_name: analytics.customer_1 ;;
}

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

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

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

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

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

כדי לתת ל-view שם שונה מזה של הטבלה הבסיסית, צריך להחיל sql_table_name ברמה של view

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

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

במילים אחרות, במקום זה:

קובץ מודל

explore: customers {
  sql_table_name: customer_1 ;;
}

כך עושים זאת:

קובץ מודל

explore: customers { ... }

הצגת הקובץ

view: customers {
  sql_table_name: customer_1 ;;
}