remote_dependency

Usage

remote_dependency:  public_project {
  url:  "https://github.com/llooker/google_ga360"
  ref:  "07a20007b6876d349ccbcacccdc400f668fd8147f1"
  override_constant: constant_name {
    value: "string"
  }
}
היררכיה
remote_dependency
ערך ברירת המחדל
ללא

אישור
  • תת-פרמטר url שכולל את כתובת ה-URL של מאגר Git
  • ref תת-פרמטר שמציין ענף Git, תג גרסה של Git או את ה-SHA של שמירה במאגר Git
  • תת-פרמטר override_constant, שמשמש לביטול הערך של קבוע שיובא מפרויקט אחר

הגדרה

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

הפרמטר remote_dependency מופיע בקובץ המניפסט של הפרויקט. אם אין פרויקט, אפשר ליצור קובץ מניפסט.

הפרמטר remote_dependency מקבל שם, שיכול להיות כל שם שרוצים. זה השם שבו משתמשים בהצהרות include כדי להפנות לקבצים המיובאים בפרויקטים של LookML. השם משמש גם כשם התיקייה בתיקייה imported_projects של Looker IDE.

בנוסף, הפרמטר remote_dependency כולל את הפרמטרים המשניים הבאים:

url

פרמטר המשנה url מציין את הכתובת של מאגר Git חיצוני. משתמשים בכתובת ה-URL הראשית של המאגר. לדוגמה, שימוש ב-HTTPS:

url: "https://github.com/llooker/google_ga360"

או באמצעות SSH:

url: "git@github.com:llooker/google_ga360.git"

ref

פרמטר המשנה ref מציין ענף Git, תג גרסת Git או SHA של קומיט במאגר Git של הפרויקט המרוחק, ש-Looker צריך להוסיף לפרויקט Looker שלכם:

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

דוגמה לתלות מרחוק שמציינת SHA של קומיט מפרויקט Git מרחוק:

remote_dependency: ga_360 {
  url: "https://github.com/llooker/google_ga360"
  ref: "f99720c597f524d0756b8194990342efa11b3813"
  }

זוהי דוגמה לתלות מרחוק שמציינת את הענף הראשי בפרויקט Git מרחוק:

remote_dependency: ga_360 {
  url: "https://github.com/llooker/google_ga360"
  ref: "main"
}

לא משנה איזה סוג של ref תציינו, כשתוסיפו remote_dependency לפרויקט ותאמתו את LookML, בסביבת הפיתוח המשולבת יופיע הלחצן Update Dependencies (עדכון יחסי תלות). לוחצים על הכפתור כדי להוסיף את קובצי הפרויקט המרוחק. אם זה הפרויקט המרוחק הראשון שהוספתם לפרויקט, עדכון התלויות יגרום גם ל-Looker ליצור קובץ נעילה של המניפסט. ‫Looker משתמש בקובץ הנעילה של המניפסט כדי לעקוב אחרי הגרסה של הפרויקטים המרוחקים. מידע נוסף זמין בקטע זיהוי אוטומטי של גרסאות חדשות של פרויקט מרוחק בדף התיעוד ייבוא קבצים מפרויקטים אחרים.

override_constant

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

אפשר להשתמש בפרמטר override_constant גם עם הפרמטר local_dependency לייבוא פרויקט מקומי.

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

אם הפרמטר export מוגדר לערך override_required או override_optional עבור קבוע שהוגדר בפרויקט המיובא, אפשר להשתמש בתת-הפרמטר override_constant של local_dependency כדי לספק ערך חדש לקבוע הזה. לדוגמה, נניח שיש לכם קבוע connection שמוגדר בקובץ המניפסט של הפרויקט המיובא:


constant: connection {
  value: "imported_project_connection"
  export: override_required
}

בדוגמה הזו, מכיוון שהפרמטר export מוגדר לערך override_required, צריך לבטל את ההגדרה שלו בקובץ המניפסט של הפרויקט המייבא:


project_name: "importing_project"

remote_dependency: public_project {
  url: "https://github.com/llooker/project"
  ref: "07a20007b6876d349ccbcacccdc400f668fd8147f1"
  override_constant: connection {
    value: "importing_project_connection"
  }
}

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

דוגמה

בקובץ מניפסט, מוסיפים את מאגר ה-Git ‏Google GA 360 כמקור לייבוא קבצים ממנו:

project_name: "thelook"

remote_dependency: ga_360 {
  url: "https://github.com/llooker/google_ga360"
  ref: "6a95679c92efa56243c17fb4d66c820cd4a8db03"
}