הגדרות אדמין – חיבורים

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

צפייה בחיבורים

בדף Connections (חיבורים), אפשר לראות את החיבורים למסד הנתונים ואת כתובות ה-IP שנדרשות כדי לאפשר תנועה ברשת. אם האפשרות ליצור מסד נתונים חדש הופעלה במופע שלכם, תוכלו גם להוסיף חיבור חדש.

הכרטיסייה 'מסדי נתונים'

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

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

בטבלה הבאה מתוארים הרכיבים בכרטיסייה Databases:

עמודה תיאור
שם השם של החיבור, שבחרתם, שמשמש בפרמטר LookML‏ connection. כשבודקים את החיבור, Looker מציג את רשימת בדיקות הסטטוס מתחת לשם החיבור.
מסד נתונים השם של מסד הנתונים ש-Looker ישלח אליו שאילתה כשהחיבור הזה יהיה בשימוש.
היקף האם אפשר להשתמש בחיבור בכל הפרויקטים או רק בפרויקט ספציפי אחד.
שרת SSH השם של הגדרת שרת ה-SSH שמשמשת ליצירת מנהרת SSH למסד הנתונים. העמודה הזו מוצגת רק אם הכרטיסייה SSH Servers מופעלת במופע Looker שלכם.
SSL האם אתם משתמשים בהצפנת SSL כדי להגן על הנתונים שעוברים בין Looker לבין מסד הנתונים שלכם (יש אפשרויות מאובטחות אחרות מלבד SSL).
סוג ניב ה-SQL של חיבור מסד הנתונים.
פעולות פעולות שאפשר לבצע בחיבור: בדיקת חיבור, עריכת חיבור, הצגת מידע נוסף על חיבור, מעבר לרשימת קישורים לניתוחים של החיבור או מחיקת חיבור. אם האפשרות ליצור מסד נתונים חדש הופעלה במופע שלכם, תוכלו גם להוסיף נתונים ממקור נתונים נוסף לכל החיבורים שמנוהלים על ידי Looker.

הכרטיסייה SSH Servers (שרתי SSH)

הכרטיסייה SSH Servers לא זמינה במופעים של Looker ‏ (Google Cloud Core).

האפשרות SSH Server זמינה אם מופעלת ב-Looker (original) תשתית Kubernetes, ורק אם הופעלה האפשרות להוסיף פרטי הגדרה של שרת SSH למופע Looker. אם האפשרות הזו לא מופעלת במכונה של Looker ואתם רוצים להפעיל אותה, צרו קשר עם Google Cloud מומחה מכירות או פתחו בקשת תמיכה.

‫Looker בוחר באופן אוטומטי את יציאת ה-localhost בשבילכם כשיוצרים מנהרות SSH, ואי אפשר לציין את יציאת ה-localhost.

יכול להיות שיידרשו הגדרות נוספות במסדי נתונים של PrestoDB או Trino כדי ליצור חיבורי SSH. כש-SSL מופעל, מסד הנתונים של PrestoDB או Trino מוגדר כברירת מחדל להאזנה ביציאה 443. כדי ליצור את מנהרת ה-SSH, ‏ Looker צריך להגדיר את יציאת ה-localhost ל-443, שכבר נמצאת בשימוש על ידי Looker. הפעולה הזו תגרום לכך שהגדרת מנהרת ה-SSH תיכשל. כדי לפתור את הבעיה, צריך להגדיר את מסד הנתונים של PrestoDB או Trino להאזנה ליציאה אחרת מלבד יציאה 443 כש-SSL מופעל.

בכרטיסייה SSH Servers מפורטות ההגדרות של שרתי ה-SSH שהוספתם, מצוין הסטטוס של החיבורים לשרתי ה-SSH ומפורטים חיבורי מסד הנתונים באמצעות כל שרת SSH. בכרטיסייה SSH Servers אפשר גם test a connection to an SSH server וגם add or edit SSH server configurations.

בטבלה הבאה מפורטים הרכיבים בכרטיסייה SSH Servers:

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

הוספה או עריכה של הגדרת שרת SSH

כדי להוסיף הגדרה חדשה של שרת SSH:

  1. בכרטיסייה SSH Server (שרת SSH), לוחצים על Add Server (הוספת שרת).
  2. בשדה Unnamed Server (שרת ללא שם) בפינה השמאלית העליונה, מזינים שם להגדרת שרת ה-SSH.
  3. לוחצים על Download Key (הורדת מפתח) כדי להוריד את המפתח הציבורי לקובץ טקסט. חשוב לשמור את הקובץ הזה לשימוש מאוחר יותר.
  4. בשדה Server Username (שם משתמש בשרת), מזינים את שם המשתמש ש-Looker ישתמש בו כדי להתחבר לשרת ה-SSH.
  5. בשדה Server IP Address or Hostname (כתובת ה-IP או שם המארח של השרת), מזינים את כתובת ה-IP או את שם המארח של שרת ה-SSH.
  6. בשדה יציאת השרת, מזינים את מספר היציאה שמשמש לחיבור לשרת ה-SSH.
  7. מוסיפים את המפתח הציבורי שהורדתם לקובץ המפתחות המורשים בשרת ה-SSH. מידע נוסף ודוגמה זמינים בדף שימוש בשרת SSH.
  8. מוודאים שכתובות ה-IP המתאימות של Looker נוספו לרשימת ההיתרים בשרת ה-SSH, כדי ש-Looker יוכל להתחבר לשרת ה-SSH.
  9. לוחצים על בדיקה ובקשת טביעת אצבע כדי לאמת את החיבור לשרת ה-SSH.
  10. צופים בהגדרת ה-SSH החדשה. במסך הזה אפשר גם להוריד או לראות את המפתח הציבורי, ולראות את טביעת האצבע הייחודית של הגדרת שרת ה-SSH.

כדי לערוך הגדרת שרת SSH קיימת, לוחצים על סמל האפשרויות הנוספות (3 נקודות) Options בשורה של שרת ה-SSH שנבחר, ובוחרים באפשרות Server Details (פרטי השרת).

בדיקת החיבורים לשרת SSH

כדי לבדוק את כל החיבורים למסד נתונים לשרת SSH:

  1. לוחצים על תפריט האפשרויות (3 נקודות) בשורה של שרת ה-SSH שנבחר.
  2. בוחרים באפשרות בדיקת חיבורים.

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

הוספת חיבור למסד נתונים לשרת SSH

כדי להוסיף חיבור חדש למסד נתונים באמצעות שרת SSH:

  1. לוחצים על תפריט האפשרויות (3 נקודות) בשורה של שרת ה-SSH שנבחר.
  2. לוחצים על הוספת חיבור.

בדף Connection Settings ב-Looker מופיע שרת ה-SSH בשדה SSH Server.

מחיקה של הגדרת שרת SSH

כדי למחוק הגדרה של שרת SSH:

  1. לוחצים על תפריט האפשרויות (3 נקודות) בשורה של שרת ה-SSH שרוצים למחוק.
  2. בוחרים באפשרות מחיקת השרת.

בדיקת החיבורים

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

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

בעיות פוטנציאליות מוצגות בצהוב, ושגיאות מוצגות באדום. אם הקישור 'עובר', הוא מופיע בירוק.

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

אפשר לבדוק את הסטטוס של:

  • חיבור יחיד על ידי לחיצה על בדיקה בקצה השמאלי של החיבור הזה
  • כל החיבורים על ידי לחיצה על הלחצן בדיקת כל החיבורים בחלק העליון של הדף

יש שתי בדיקות שגורמות לרוב לבלבול:

  • אפשר למצוא סכימה זמנית
  • יכולים להשתמש בטבלאות נגזרות מתמידות (PDT)

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

הוספת חיבורים

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

עריכת קישורים

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

פעולות שזמינות לכל החיבורים

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

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

פעולות שזמינות לחלק מהחיבורים

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

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

מחיקה בטוחה של חיבור למסד נתונים

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

  1. זיהוי תלות: במצב פיתוח, משתמשים בחיפוש פרויקט של connection: CONNECTION_NAME כדי למצוא את כל קובצי המודל של LookML שמפנים לחיבור.
  2. הסרת יחסי תלות: מעדכנים את הפרמטר connection בקובצי המודל האלה כך שיצביע על חיבור תקין, או מוחקים את המודלים התלויים אם הם כבר לא נחוצים.
  3. אימות תוכן: מריצים את כלי לאימות התוכן כדי לזהות ולתקן לוחות בקרה או טבלאות Look שהסתמכו על המודלים באמצעות החיבור.
  4. פריסת שינויים: ביצוע Commit ופריסה של שינויי LookML האלה בהסתעפות הייצור.
  5. מחיקת החיבור: אחרי שמסירים את כל ההפניות מענף הייצור, עוברים אל אדמין > מסד נתונים > חיבורים ומוחקים את החיבור.