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 ですが、必須ではありません。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"
}