שימוש בגיליונות מקושרים ל-Looker

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

הפעלת גיליונות מקושרים

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

  • ב-Looker (המקורית), האדמין ב-Looker צריך להפעיל את הלקוח המוגדר מראש של גיליונות מקושרים מהכרטיסייה Application Library בדף Manage OAuth Clients (Admin > Authentication > Manage OAuth clients), או להפעיל את המתג All Looker BI Connectors או את המתג Google Sheets בחלונית BI Connectors בקטע Platform בתפריט Admin של Looker. ב-Looker (ליבה של Google Cloud), האפשרויות האלה מופעלות כברירת מחדל.
  • המכונה של Looker (המקורית) צריכה להתארח ב-Looker.
  • אם במכונה של Looker (original) מוגדרת רשימת היתרים של כתובות IP, צריך להשבית את רשימת ההיתרים של כתובות ה-IP כדי להשתמש בגיליונות מקושרים. אין רשימה סטטית ספציפית או מותאמת אישית של כתובות IP של Google Sheets שאפשר להוסיף לרשימת ההיתרים.
  • ב-Looker (Google Cloud core), גיליונות מקושרים מופעלים כברירת מחדל. עם זאת, אם אתם משתמשים במכונה של Looker (Google Cloud core) שמוגדרת בה רשימת כתובות IP מותרות, צריך לסמן את תיבת הסימון Link Google services with this instance בכרטיסייה Details בדף Instance של המכונה במסוף Google Cloud כדי להתחבר לגיליונות מקושרים.
  • כל משתמש שרוצה להתחבר למכונה של Looker מ-Google Sheets צריך להשתמש באותה כתובת אימייל בחשבון המשתמש שלו ב-Looker כמו בחשבון Google Workspace שלו. אם כתובות האימייל של חשבונות Google Workspace ו-Looker שונות, תוצג שגיאה כשהם ינסו להתחבר ל-Looker מ-Sheets.
  • צריך להפעיל את הגישה לשירותים שלא מוגדר להם פקד נפרד במסוף Google Workspace Admin. האפשרות הזו בדרך כלל מופעלת כברירת מחדל. מידע נוסף זמין במאמר העזרה בנושא ניהול הגישה לשירותים שאין להם מתג נפרד.

חיבור ל-Look מ-Google Sheets

ב-Looker, ‏Look הוא שאילתה אחת שנשמרה בעבר. אתם יכולים להוסיף את התוצאות של Look לגיליון, ואז לבצע פעולות על הפלט של Look ב-Sheets.

  1. בתפריט נתונים ב-Google Sheets, בוחרים באפשרות מחברי נתונים ואז באפשרות התחברות ל-Looker.

  2. בתיבת הדו-שיח Connect to Looker, מזינים את השם של המכונה ב-Looker או בוחרים את השם של המכונה שהתחברתם אליה לאחרונה, ולוחצים על Connect to Look.

  3. בתיבת הדו-שיח הבאה, בוחרים את טבלת ה-Look שרוצים להוסיף ל-Google Sheets, ואז בוחרים באפשרות Connect. אפשר להשתמש בשדה Search for a Look כדי לחפש Look שמור לפי שם או לפי מזהה Look, או לסנן את רשימת ה-Looks שמוצגים בתיבת הדו-שיח על ידי הזנת מחרוזת משנה שכלולה בשם ה-Look.

  4. בתיבת הדו-שיח חיבור לטבלת Look, בוחרים אם ליצור גיליון חדש לפלט של Look או להוסיף את הפלט של Look לגיליון קיים, ולוחצים על יצירה.

אחרי ש-Sheets יתחבר למופע שלכם ב-Looker, הפלט של ה-Look שבחרתם יתווסף ל-Sheets.

אי אפשר לערוך טבלאות Look ב-Sheets, אבל אפשר לרענן את הנתונים של טבלת Look בכל שלב בלחיצה על רענון. אפשר ללחוץ על כתובת ה-URL של ה-Look כדי לפתוח את ה-Look ב-Looker. אפשר גם לראות את השם, המזהה וכתובת ה-URL של טבלת Look בסרגל הצד של טבלת Look.

התחברות ל-Explore ב-Looker מ-Google Sheets

Explore היא נקודת ההתחלה של שאילתות. ב-Explore מוצגת קבוצה מסוימת של שדות מקובץ התצוגה המשויך, ואפשר לבחור את השדות האלה כדי ליצור שאילתה בגיליון.

  1. בתפריט נתונים ב-Google Sheets, בוחרים באפשרות מחברי נתונים ואז באפשרות התחברות ל-Looker.

  2. בתיבת הדו-שיח Connect to Looker, מזינים את השם של המכונה ב-Looker או בוחרים את השם של מכונה שהתחברתם אליה לאחרונה, ולוחצים על Connect to Explore.

  3. בתיבות הדו-שיח הבאות, בוחרים את המודל ואת ה-Explore של Looker שבהם רוצים להשתמש בשאילתה, ולוחצים על Connect.

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

יצירת שאילתות ב-Looker באמצעות Google Sheets

שאילתות Looker נוצרות באמצעות טבלת צירים ב-Sheets. כדי להוסיף נתוני Looker לגיליון:

  1. בגיליון שבו מוצג הניתוח, בוחרים באפשרות טבלת צירים.

  2. בוחרים אם להוסיף טבלת צירים חדשה בגיליון חדש או בגיליון קיים, ולוחצים על יצירה.

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

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

    • השורות מקבילות למאפיינים ב-Looker.
    • העמודות מקבילות למאפיינים מסובבים ב-Looker.
    • הערכים מקבילים למדדים ב-Looker. כדי ליצור מדד בהתאמה אישית, בוחרים מאפיין ב-Looker ופונקציה של סיכום לפי ב-Sheets.
    • המסננים מקבילים למסננים של Looker.

    בעורך טבלת הצירים מוצגת גם רשימה של התצוגות שכלולות ב-Explore. אתם יכולים לבחור תצוגה כדי להציג את המאפיינים והמדדים שכלולים בה.

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

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

אחרי שמוסיפים את הנתונים מ-Looker לטבלת צירים, אפשר להשתמש ב-Google Sheets כדי לעצב את הנתונים או ליצור נוסחאות חדשות ב-Sheets על סמך הנתונים מ-Looker.

אפשרויות סינון

מאז ההשקה הראשונית של "גיליונות מקושרים" ל-Looker, נוספו אפשרויות סינון חדשות.

סינון לפי ערכים

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

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

ייפתח סרגל צד, ו-Sheets יאחזר מ-Looker את 500 הערכים שמופיעים בתדירות הגבוהה ביותר.

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

מסננים שמשתמשים בביטויי סינון ב-Looker

אתם יכולים להחיל מסנני תאריכים יחסיים, וגם הרבה מסננים מתקדמים אחרים, בגיליונות מקושרים באמצעות ביטויי סינון של Looker. לדוגמה, אתם יכולים להחיל מסננים כמו "ב-30 הדקות האחרונות" או "ב-10 הימים האחרונים" בגיליונות מקושרים.

כדי להשתמש בביטויי סינון ב-Looker:

  1. מוסיפים שדה לקטע המסננים של טבלת הצירים.

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

  3. מזינים ביטוי סינון של Looker בשדה Value.

    לדוגמה, כדי לסנן לפי 7 הימים האחרונים, אפשר לכתוב "7 ימים" או "7 הימים האחרונים".

  4. לוחצים על OK.

בנוסף לסינון לפי תאריך יחסי, אפשר עכשיו לסנן גם לפי:

  • מחרוזת שלא מתחילה ב: -FOO%
  • טווח מספרי כולל ובלעדי: (12, 20]

כדי לראות את כל ביטויי הסינון הזמינים, עיינו בדף התיעוד בנושא ביטויי סינון ב-Looker.

איך משתמשים בפרמטרים ובשדות של סינון בלבד של Looker

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

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

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

רענון הנתונים ב-Google Sheets

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

גם בטבלת הצירים וגם בגיליון שבו מוצג ה-Look או ה-Explore מופיע הזמן שבו הם רועננו לאחרונה.

לוחצים על רענון כדי לעדכן את הנתונים בטבלת הצירים.

תזמון זמני רענון קבועים

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

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

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

מעקב אחרי גיליונות מקושרים

אדמינים ב-Looker יכולים לראות את השימוש בגיליונות מקושרים באמצעות קבוצת השדות Query API Client Properties ב-System Activity History Explore. בכל פעם שמריצים שאילתה חדשה, נוצרת רשומה ב-Explore History.

בקבוצת השדות מאפייני לקוח API של Query, יש שלושה שדות חדשים לגיליונות מקושרים:

  • שם לקוח ה-API – בשדה הזה תמיד יוצג הערך Connected Sheets כדי לזהות רשומות של גיליונות מקושרים.
  • מזהה הגיליון האלקטרוני בגיליונות מקושרים – השדה הזה מציג את מזהה הגיליון, שנכלל בכתובת ה-URL של הגיליון ב-Google Sheets.
  • טריגר של גיליונות מקושרים – השדה הזה מראה אם השאילתה הופעלה על ידי משתמש שלחץ על הלחצן רענון ב-Sheets או על ידי רענון מתוזמן.

בהמשך מופיעה דוגמה לכתובת URL של פעילות במערכת שמציגה את השימוש בגיליונות מקושרים. מחליפים את <instance_name.looker.com> בכתובת ה-URL של המכונה.

https://<instance_name.looker.com>/explore/system__activity/history?fields=query_api_client_context.name,query_api_client_context.cs_spreadsheet_id,query_api_client_context.cs_trigger,user.name,history.created_date,history.created_time_of_day&f[query_api_client_context.cs_spreadsheet_id]=-NULL&sorts=history.created_time_of_day+desc&limit=5000

תמיכה ב-Sheets API של גיליונות מקושרים

אפשר לגשת לתמיכה ב-API בגיליונות מקושרים ל-Looker דרך AppsScript ו-Google Sheets API.

הנה כמה דוגמאות לפעולות שאפשר לבצע באופן פרוגרמטי באמצעות תמיכה ב-API:

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

כדי לציין את Looker כמקור נתונים באמצעות Google Sheets API, משתמשים באובייקט looker עם המשאב DataSourceSpec ב-REST.

חשוב לדעת

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

מגבלות על שורות ונתונים בגיליונות מקושרים

הגבול המקסימלי של שאילתות שנוצרות באמצעות גיליונות מקושרים הוא 100,000 שורות. אם תוצאת השאילתה מכילה יותר שורות, תוצג למשתמש שגיאה ב-Sheets. אם למשתמש אין את ההרשאה download_without_limit, התוצאה תיחתך ל-5,000 שורות לכל היותר, בלי קשר למגבלה של Sheets.

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

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

פתרון בעיות בגיליונות מקושרים

יכול להיות שתיתקלו בבעיות מסוימות כשתנסו להתחבר ל-Looker מ-Google Sheets. בקטע הזה אנחנו מתארים את הבעיות האלה ומסבירים איך לתקן אותן.

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

יכולות להיות כמה סיבות לשגיאה הזו:

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

שגיאה: המופע ב-Looker לא מוגדר לשימוש בתכונה הזו. צריך לפנות לאדמין של Looker כדי לוודא שהוא עומד בדרישות.

יכולות להיות כמה סיבות לשגיאה הזו:

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

לא מופיעים מודלים אחרי ההתחברות למופע של Looker

זה מצביע על כך שאין לכם את ההרשאות הנדרשות כדי להציג מודלים במכונה שלכם.

למשתמש ב-Looker עם תפקיד צפייה אין מספיק הרשאות כדי ליצור חיבורים ב-Sheets, בדיוק כמו שאין לו מספיק הרשאות כדי להשתמש בממשק המשתמש של Explore ב-Looker. אם המשתמש רוצה להשתמש בגיליונות מקושרים ל-Looker, הוא צריך את ההרשאה explore. התפקידים "אדמין", "מפתח" ו"משתמש" כוללים את ההרשאה explore. אדמין ב-Looker יכול לתת למשתמש את ההרשאה explore, וכך לאפשר לו לראות מודלים במכונה.

שגיאה: כתובת האימייל של חשבון Looker המקושר שונה מכתובת האימייל בחשבון Google שלך.

זה אומר שכתובת האימייל של החשבון שלכם ב-Looker לא תואמת לכתובת האימייל של חשבון Google שלכם. מוודאים שאתם מחוברים לחשבון Google עם כתובת אימייל שזהה לזו של חשבון Looker. לחלופין, אדמין ב-Looker יכול ליצור חשבון משתמש חדש ב-Looker שמשתמש בכתובת האימייל הנוכחית שלך ב-Google.

שגיאה: בקשה שגויה: לא נמצא לקוח פעיל.

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

שגיאה: 403 אסור

אם במופע של Looker מוגדרת רשימת היתרים של כתובות IP, הרשימה הזו יכולה למנוע מ-Sheets להתחבר ל-Looker API. כדי לבדוק אם רשימת ההיתרים היא הסיבה, נסו לעבור לכתובת ה-URL של המכונה של Looker ולראות אם מופיעה השגיאה IP Address Not on Allowlist.