Looker 22.16 のドキュメントを表示しています。最新のドキュメントはこちらをご覧ください。

remote_dependency

使用状況

remote_dependency: public_project{
url: "https://github.com/llooker/google_ga360"
ref: "07a20007b6876d349ccbcacccdc400f668fd8147f1"
ant

階層

マニフェストファイル

remote_dependency

デフォルト値

なし

許可

Git リポジトリの URL を含む url サブパラメータ
Git リポジトリ内の Git ブランチ、Git リリースタグ、または commit の SHA を指定する ref サブパラメータ
override_constant サブパラメータ。別のプロジェクトからインポートされた定数の値をオーバーライドするために使用します。

定義

remote_dependency パラメータには、このプロジェクトで使用するファイルを含む LookML プロジェクトを含む外部 Git リポジトリの詳細を指定します。マニフェストファイルに複数の remote_dependency ステートメントを含めると、複数のプロジェクトをインポートできます。

remote_dependency パラメータは、プロジェクトのマニフェストファイルに含めます。プロジェクトにマニフェストファイルがない場合は、マニフェストファイルを作成できます。

remote_dependency パラメータは名前を使用します。任意の名前にできます。この名前は、LookML プロジェクトでインポートされたファイルを参照するために include ステートメントで使用します。この名前は、Looker IDE の imported_projects フォルダ内のフォルダ名としても使用されます。

また、remote_dependency パラメータには次のサブパラメータがあります。

url
ref
override_constant

`url`

url サブパラメータは、外部 Git リポジトリのアドレスを指定します。リポジトリのメイン URL を使用します。たとえば、HTTPS を使用する場合は次のようになります。

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

SSH:

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

`ref`

ref サブパラメータは、Looker が Looker プロジェクトに取り込む必要があるリモートプロジェクトの Git リポジトリの Git ブランチ、Git リリースタグ、または commit SHA を指定します。

Git ブランチ: リモートプロジェクトからそのブランチの新しい commit を Looker が自動的に検出するようにする場合は、Git ブランチを指定できます。詳細については、他のプロジェクトからファイルをインポートするのドキュメントをご覧ください。
Git リリースタグ: Looker がリモートプロジェクトからそのタグの新しい commit を自動的に検出する場合は、Git リリースタグを指定できます。詳細については、他のプロジェクトからファイルをインポートするのドキュメントをご覧ください。
Git commit SHA: 静的バージョニングが必要な場合は、commit SHA を指定できます。これにより、インポートされたプロジェクトに変更が自動的にプロジェクトに反映されなくなります。通常、これは最新の commit ですが、必須ではありません。commit SHA は commit 履歴を閲覧できる場所で見ることができます。通常、Git サービスプロバイダは SHA を明示してコピーできるようにします。これは Looker Blocks の最適なオプションです。

リモートの Git プロジェクトの commit 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: "master"
}

指定した ref のタイプに関係なく、プロジェクトに remote_dependency を追加して LookML を検証すると、IDE に [Update Dependencies] ボタンが表示されます。このボタンをクリックすると、リモートプロジェクトファイルが表示されます。プロジェクトに初めてリモートプロジェクトを追加した場合、依存関係を更新すると、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"
}