הגדרות אדמין – שאילתות

בדף Queries בקטע Database בתפריט Admin מופיע מידע על 50 השאילתות האחרונות ש-Looker שלח למסד הנתונים. מידע על שאילתות שהן ישנות יותר מ-50 השאילתות האחרונות זמין בקטע שימוש ב-Looker.

מידע בסיסי על שאילתה

עמודה הגדרה
שעה שעת ההתחלה של השאילתה, שמוצגת באזור הזמן של האפליקציה.
סטטוס סטטוס השאילתה, שיכול לכלול:
  • מטמון: Looker החזיר את התוצאות מהמטמון שלו במקום להריץ שאילתה כפולה מול מסד הנתונים.
  • הושלם: השאילתה הושלמה בהצלחה.
  • שגיאה: השאילתה לא הושלמה בהצלחה מכיוון שאירעה שגיאה, שאת פרטיה ניתן למצוא על ידי לחיצה על כפתור פרטים.
  • בוטלה: השאילתה בוטלה על ידי Looker או על ידי המשתמש.
  • בהמתנה ל-PDT: השאילתה צריכה להמתין עד שייבנה טבלת נתונים נגזרת מתמשכת לפני שניתן יהיה להריץ אותה.
  • יצירת PDT: מתבצע תהליך של יצירת טבלה נגזרת מתמידה.
  • בתור: השאילתה ממתינה להרצה כי כבר יש יותר מדי שאילתות בתהליך (יכול להיות ש-Looker יגביל את מספר השאילתות בהגדרת החיבור או במסד הנתונים).
  • פועלת: השאילתה נמצאת בתהליך של הפעלה.
  • לא ידוע: Looker לא הצליח לקבוע מה קרה עם השאילתה הזו.
חיבור החיבור ל-Looker שדרכו הופעלה השאילתה.
משתמש המשתמש שהריץ את השאילתה הזו, אם אפשר לקבוע זאת. יש שאילתות שלא מופעלות על ידי משתמש ספציפי, למשל כש-Looker יוצר טבלה נגזרת מתמידה (PDT) או כשמשתמש לא ידוע ניגש לטבלת Look ציבורית.
מקור המקור של השאילתה ב-Looker, כמו הדף 'ניתוח נתונים' או SQL Runner. אם אפשר, מוצג גם קישור לטבלת Look שנשמרה, או מזהה השאילתה יחד עם שם המודל וה-Explore. לשאילתות מסוימות אין מידע נוסף, למשל שאילתות שמופעלות ב-SQL Runner. שאילתות שמופקות מ-Open SQL Interface כוללות ערך Source של Sql_interface.
זמן ריצה משך הזמן שנדרש להרצת השאילתה. הזמן הזה כולל את בניית השאילתה, את הזמן שהשאילתה שהתה בתור, את ההעברה אל מסד הנתונים וממנו ואת ההרצה של השאילתה במסד הנתונים.

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

הלחצן 'פרטים'

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

  • מקטע מידע הכולל פרטים על השאילתה (ראו את הטבלה הבאה).
  • קטע SQL שבו מוצג ה-SQL הגולמי שהופעל על מסד הנתונים. הערות לגבי ההקשר לא יופיעו בפרטי השאילתה. כדי למנוע מתגובות להשפיע על שמירת השאילתות במטמון, Looker מוסיף את תגובות ההקשר לפקודות SQL יוצאות, ממש לפני שה-SQL נשלח למסד הנתונים.
  • קטע SQL Interface query שמופיע כששאילתה מופקת דרך Open SQL Interface. בקטע הזה מוצגת שאילתת ה-SQL שנשלחה אל Looker מכלי ה-BI החיצוני, והוא יכול לעזור בפתרון בעיות ובשחזור שלהן.
  • קישור Open in SQL Runner (פתיחה ב-SQL Runner) שיפתח את השאילתה ב-SQL Runner.

הקטע מידע כולל את המידע הבא:

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

ביטול שאילתה

בניבים שתומכים בהפסקת שאילתות, Looker יכול להפסיק את ההרצה של שאילתות בדרכים הבאות:

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

הפסקה של כמה שאילתות יחד

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

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

  1. ב-Looker, עוברים לדף Queries בתפריט Admin.
  2. בסרגל הכתובות של הדפדפן, הוסף ?cleanup=true לסוף כתובת ה-URL ולאחר מכן לחץ על Enter. לדוגמה:

    https://INSTANCE_NAME.cloud.looker.com/admin/queries?cleanup=true
    
  3. הקטע ניקוי שאילתות חירום מופיע מעל טבלת השאילתות.

  4. מבצעים אחת מהפעולות הבאות:

    • עצור את כל השאילתות הפועלות ברחבי המופע: לחץ על הפסק את כל השאילתות הפועלות.
    • הפסקת כל השאילתות הפעילות לחיבור ספציפי: בוחרים חיבור למסד נתונים מהתפריט הנפתח חיבור ואז לוחצים על הפסקת שאילתות בחיבור.
  5. בתיבת הדו-שיח לאישור, מאשרים שרוצים להפסיק את השאילתות הפעילות.

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

ניבים נתמכים להפסקת שאילתות

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

דיאלקט נתמך?
Actian Avalanche
Amazon Athena
Amazon Aurora MySQL
Amazon Redshift
Amazon Redshift 2.1+
Amazon Redshift Serverless 2.1+
Apache Druid
Apache Druid 0.13.x - 0.17.x
Apache Druid 0.18+
Apache Hive 2.3+
Apache Hive 3.1.2+
Apache Spark 3+
ClickHouse
Cloudera Impala 3.1+
Cloudera Impala 3.1+ with Native Driver
Cloudera Impala with Native Driver
DataVirtuality
Databricks
Denodo 7
Denodo 8 & 9
Dremio
Dremio 11+
Exasol
Google BigQuery Legacy SQL
Google BigQuery Standard SQL
Google Cloud AlloyDB for PostgreSQL
Google Cloud PostgreSQL
Google Cloud SQL
Google Spanner
Greenplum
HyperSQL
IBM Netezza
MariaDB
Microsoft Azure PostgreSQL
Microsoft Azure SQL Database
Microsoft Azure Synapse Analytics
Microsoft SQL Server 2008+
Microsoft SQL Server 2012+
Microsoft SQL Server 2016
Microsoft SQL Server 2017+
MongoBI
MongoSQL
MySQL
MySQL 8.0.12+
Oracle
Oracle ADWC
PostgreSQL 9.5+
PostgreSQL pre-9.5
PrestoDB
PrestoSQL
SAP HANA
SAP HANA 2+
SingleStore
SingleStore 7+
Snowflake
Teradata
Trino
Vector
Vertica

זמן קצוב לתפוגה של שאילתה והוספה לתור

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

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

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

    • האפשרות להפעלה per-user-query-limit. זוהי הגדרה כלל-מופעית שקובעת את ברירת המחדל עבור חיבורים במופע שלך. אפשרות ההפעלה per-user-query-limit מגבילה את מספר השאילתות המקבילות לכל משתמש, לכל חיבור ולכל צומת במופע Looker. מספר השאילתות המקבילות המקסימלי שמוגדר כברירת מחדל (15) חל על כל חיבור תקין, ואם מופעל אשכול במופע Looker, על כל צומת באשכול. כברירת מחדל, כל משתמש יכול להריץ עד 15 שאילתות בו-זמניות לכל חיבור, לכל צומת, עם פסק זמן של 600 שניות. לדוגמה, אם יש לך אשכול של 5 צמתים עם per-user-query-limit של 15, כל צומת יאפשר 15 שאילתות בו-זמניות לכל משתמש עבור חיבור זה, בסך הכל 75 שאילתות בכל הצמתים (15 * 5 = 75).

    ניתן לשנות את מגבלת השאילתות לכל משתמש עבור חיבור על ידי שימוש בהגדרה מספר שאילתות בו-זמני מקסימלי לכל משתמש עבור חיבור זה בדף הגדרות חיבור של החיבור. אם מופע Looker שלכם באירוח בצד הלקוח, אתם יכולים לשנות את מספר השאילתות המקסימלי שמוגדר כברירת מחדל לכל משתמש בו-זמנית על ידי הגדרת אפשרות ההפעלה --per-user-query-limit, ואתם יכולים להגדיר את הזמן הקצוב לתפוגה של התור באמצעות אפשרות ההפעלה --per-user-query-timeout.

    • האפשרות מספר מקסימלי של שאילתות בו-זמניות לכל משתמש בחיבור הזה בהגדרות החיבור של חיבור. ההגדרה מספר מקסימלי של שאילתות מקבילות לכל משתמש בחיבור הזה מוגדרת כברירת מחדל ל-25, והיא חלה על כל משתמש וכל חיבור, אבל לא על כל צומת. לדוגמה, אם יש לך אשכול של 5 צמתים ואתה מגדיר ערך זה ל-15, כל צומת יאפשר 3 שאילתות בו-זמניות לכל משתמש עבור חיבור זה (15 / 5 = 3), בסך הכל 15 שאילתות בכל הצמתים. בחיבור, אם מספקים ערך להגדרה מספר מקסימלי של שאילתות מקבילות לכל משתמש בחיבור הזה, הערך הזה יחליף את אפשרות ההפעלה per-user-query-limit של החיבור.
  • מגבלת שאילתות ומגבלת זמן קצוב לתזמון: כדי למנוע עומס יתר על תהליך התזמון של Looker, מופע Looker יכול להריץ עד 10 שאילתות מתוזמנות בו-זמנית, והזמן הקצוב לתפוגה של שאילתות בתור לתזמון הוא 1,200 שניות. אם מופע Looker שלכם באירוח בצד הלקוח, אתם יכולים לשנות את ברירות המחדל האלה על ידי הגדרת אפשרויות ההפעלה --scheduler-query-limit ו---scheduler-query-timeout.

  • מגבלת שאילתות של מנוע הרינדור וזמן קצוב לתפוגה: כדי למנוע עומס יתר על תהליך הרינדור של Looker, מכונת Looker יכולה לרנדר מקסימום 2 הורדות בו-זמניות שמבוססות על תמונות, כמו פורמטים של PDF ו-PNG. אם מופע Looker שלכם באירוח בצד הלקוח, אתם יכולים לשנות את ברירת המחדל הזו על ידי הגדרת --concurrent-render-jobs אפשרות ההפעלה.

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

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