autogenerate_primary_keys

Usage

  autogenerate_primary_keys: yes
היררכיה
autogenerate_primary_keys

- או -

autogenerate_primary_keys
ערך ברירת המחדל
לא

כללים מיוחדים

הגדרה

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

הפרמטר autogenerate_primary_keys נתמך גם בתצוגות וגם בניתוחים:

  • בתצוגות, אם מגדירים את התצוגה באמצעות autogenerate_primary_keys: yes, ‏ Looker יוצר מפתח ראשי לשאילתות בתצוגה שבה נדרש מפתח ראשי כדי למנוע כפילות של שורות. אם מוסיפים את autogenerate_primary_keys: yes לתצוגה שכבר מוגדר בה שדה כמפתח ראשי, מוצגת באזור Looker IDE אזהרה לגבי אימות LookML.
  • ב-Explores, אם מגדירים את ה-Explore באמצעות autogenerate_primary_keys: yes, ‏ Looker יוצר מפתח ראשי לכל התצוגות של ה-Explore שנדרשות לשאילתת Explore שבה נדרש מפתח ראשי כדי למנוע כפילויות בשורות:

    • ‫Looker יוצר מפתחות ראשיים רק לתצוגות ב'ניתוח נתונים' שלא הוגדר בהן שדה עם primary_key: yes. אם לתצוגה יש שדה שמוגדר עם primary_key: yes, ‏ Looker משתמש במפתח הראשי של התצוגה.
    • ‫Looker יוצר מפתח ראשי לתצוגה של ניתוח רק כשמבצעים שאילתה בתצוגה דרך הניתוח הזה. אם מתבצעת שאילתה על אותו תצוגה דרך Explore אחר שלא הוגדר עם autogenerate_primary_keys: yes, והתצוגה עצמה לא הוגדרה עם autogenerate_primary_keys: yes, ‏ Looker לא ייצור מפתח ראשי לתצוגה.

דוגמה

הנה orders ניתוח ב-Explore שמשולב בתצוגה order_items. התכונה 'חיפוש בעזרת AI' מוגדרת עם autogenerate_primary_keys: yes:

explore: orders {
  autogenerate_primary_keys: yes
  join: order_items {
    sql_on: ${orders.id} = ${order_items.order_id} ;;
    relationship: one_to_many
  }
}

לשאילתות ב-orders Explore שדורשות צבירות סימטריות או חישובים שבהם יכול להיות ששורות מתצוגה ישוכפלו, Looker יוצר באופן אוטומטי מפתח ייחודי לתצוגות orders או order_items.

חשוב לדעת

חשוב לזכור את הפרטים הבאים לגבי השימוש ב-autogenerate_primary_keys: yes:

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

תמיכה בניבים של autogenerate_primary_keys

האפשרות להשתמש ב-autogenerate_primary_keys תלויה בדיאלקט של מסד הנתונים שבו משתמש החיבור שלכם ל-Looker. בגרסה האחרונה של Looker, הניבים הבאים תומכים ב-autogenerate_primary_keys:

  • ‫SQL סטנדרטי של Google BigQuery
  • Amazon Redshift
  • ‫Amazon Redshift 2.1 ואילך
  • ‫Amazon Redshift Serverless 2.1+‎
  • Google Cloud PostgreSQL
  • Greenplum
  • Microsoft Azure PostgreSQL
  • ‫MySQL 8.0.12 ואילך
  • ‫PostgreSQL מגרסה קודמת ל-9.5