remote_dependency

用量

remote_dependency:  public_project {
  url:  "https://github.com/llooker/google_ga360"
  ref:  "07a20007b6876d349ccbcacccdc400f668fd8147f1"
  override_constant: constant_name {
    value: "string"
  }
}

階層 資訊清單檔案 remote_dependency

預設值 無 接受 url 子參數，包含 Git 存放區的網址 ref 子參數，用於指定 Git 分支版本、Git 發布標記或 Git 存放區中某次提交的 SHA override_constant 子參數，用於覆寫從其他專案匯入的常數值

定義

remote_dependency 參數提供外部 Git 存放區的詳細資料，其中包含 LookML 專案，以及您想在此專案中使用的檔案。您可以在資訊清單檔案中加入多個 remote_dependency 陳述式，匯入多個專案。

remote_dependency 參數會放在專案的資訊清單檔案中。如果專案沒有資訊清單檔案，請建立資訊清單檔案。

remote_dependency 參數會採用名稱，您可以視需要任意命名。您會在 include 陳述式中使用這個名稱，在 LookML 專案中參照匯入的檔案。 這個名稱也會用來做為 Looker IDE imported_projects 資料夾下的資料夾名稱。

此外，remote_dependency 參數包含下列子參數：

• url
• ref
• override_constant

url

url 子參數會指定外部 Git 存放區的位址。請使用存放區的主要網址。舉例來說，使用 HTTPS：

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

或是使用 SSH：

url: "[e-mail]:llooker/google_ga360.git"

ref

ref 子參數會指定遠端專案 Git 存放區的 Git 分支版本、Git 發布標記或修訂版本 SHA，Looker 應將這些項目帶入 Looker 專案：

• Git 分支版本：如要讓 Looker 自動偵測遠端專案中該分支版本的新修訂版本，可以指定 Git 分支版本。詳情請參閱「從其他專案匯入檔案」說明文件頁面。
• Git 發布標記：如果您希望 Looker 自動偵測遠端專案中該標記的新提交內容，可以指定 Git 發布標記。詳情請參閱「從其他專案匯入檔案」說明文件頁面。
• Git 修訂版本 SHA：如要使用靜態版本控管，可以指定修訂版本 SHA，這樣匯入專案的變更就不會自動反映在專案中。通常這是指最近一次的提交，但並非必要條件。您可以在任何可瀏覽提交記錄的位置找到提交 SHA。Git 服務供應商通常會清楚顯示 SHA，並提供複製功能。這個選項很適合 Looker Blocks。

以下是遠端依附元件的範例，指定遠端 Git 專案中的修訂版本 SHA：

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，IDE 就會顯示「更新依附元件」按鈕。按一下按鈕即可匯入遠端專案檔案。如果這是您新增至專案的第一個遠端專案，更新依附元件時，Looker 也會提示您建立資訊清單鎖定檔案。Looker 會使用資訊清單鎖定檔案追蹤遠端專案的版本。詳情請參閱「從其他專案匯入檔案」說明頁面的「自動偵測遠端專案的新版本」一節。

override_constant

override_constant 參數可讓您覆寫匯入專案中定義的常數值。

override_constant 參數也可以與 local_dependency 參數搭配使用，匯入本機專案。

將檔案從一個專案匯入另一個專案時，您可以覆寫匯入專案資訊清單檔案中定義的常數值。覆寫常數值後，參照該常數的匯入檔案會使用匯入專案中提供的新值。

如果將 export 參數設為 override_required 或 override_optional，系統會使用 local_dependency 的 override_constant 子參數，為匯入專案中定義的常數提供新值。舉例來說，假設您在匯入專案的資訊清單檔案中定義了常數 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"
  }
}

如需更多資訊，以及在匯入專案時覆寫常數的另一個範例，請參閱「從其他專案匯入檔案」說明文件頁面。

範例

在資訊清單檔案中，將「Google GA 360」Git 存放區新增為匯入檔案的來源：

project_name: "thelook"

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