remote_dependency

用途

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

階層 マニフェスト ファイル remote_dependency

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

定義

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

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

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

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

• url
• ref
• override_constant

url

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

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

または、SSH を使用します。

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

ref

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

• Git ブランチ: Looker でリモート プロジェクトからそのブランチの新しい commit を自動的に検出する場合は、Git ブランチを指定できます。詳細については、他のプロジェクトからファイルをインポートするのドキュメント ページをご覧ください。
• Git リリースタグ: Looker でリモート プロジェクトからそのタグの新しい commit を自動的に検出する場合は、Git リリースタグを指定できます。詳細については、他のプロジェクトからファイルをインポートするのドキュメント ページをご覧ください。
• Git commit SHA: 静的なバージョニングが必要な場合は、commit SHA を指定できます。これにより、インポートしたプロジェクトでの変更はプロジェクトに自動的に反映されません。通常は最新のコミットですが、必須ではありません。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: "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"
}