使用状況
url: "https://github.com/llooker/google_ga360"
ref: "07a20007b6876d349ccbcacccdc400f668fd8147f1"
ant
階層
remote_dependency |
デフォルト値
なし許可
|
定義
remote_dependency
パラメータには、このプロジェクトで使用するファイルを含む LookML プロジェクトを含む外部 Git リポジトリの詳細を指定します。マニフェスト ファイルに複数の remote_dependency
ステートメントを含めると、複数のプロジェクトをインポートできます。
remote_dependency
パラメータは、プロジェクトのマニフェスト ファイルに含めます。プロジェクトにマニフェスト ファイルがない場合は、マニフェスト ファイルを作成できます。
remote_dependency
パラメータは名前を使用します。任意の名前にできます。この名前は、LookML プロジェクトでインポートされたファイルを参照するために include
ステートメントで使用します。この名前は、Looker IDE の imported_projects
フォルダ内のフォルダ名としても使用されます。
また、remote_dependency
パラメータには次のサブパラメータがあります。
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"
}