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

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

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

或是使用 SSH：

url: "git@github.com: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 模塊 的合適選項。

以下是遠端依附元件的範例，指定遠端 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"
}