LookML オブジェクトのメタデータ

develop 権限を持つユーザーは、Looker IDE メタデータ パネルで、オブジェクトに関するコンテキスト関連情報を表示できます。

Looker IDE でメタデータ パネルを表示するには:

  1. プロジェクト ファイルに移動します
  2. クイックヘルプ パネルを開くには、[クイックヘルプ] アイコン を選択します。
  3. LookML コードエディタで、メタデータ パネルでコンテキストの詳細を確認するオブジェクトにカーソルを合わせます。
  4. クイックヘルプ パネルで、[メタデータ] タブを選択してメタデータ パネルを開きます。

メタデータ パネルでは、名前とオブジェクトの種類を表すアイコンでオブジェクトを識別します(使用可能なすべてのオブジェクトの種類のアイコンについては、オブジェクト ブラウザパネルを使用したプロジェクトの操作ページをご覧ください)。

LookML オブジェクトが複数のモデルで使用されている場合、メタデータ パネルにはプルダウン メニューが表示され、メタデータを表示するモデルを選択できます。

メタデータ パネルに表示される情報は、選択した LookML オブジェクトのタイプと、プロジェクトでの選択したオブジェクトの使用方法によって異なります。メタデータを使用すると、次のセクションで説明するように、プロジェクトのさまざまな側面をより深く理解できます。

モデルのメタデータ

モデルファイルを選択すると、メタデータ パネルに次のセクションが表示されます。

  • ダッシュボード: モデルに含まれる LookML ダッシュボードのリストと、LookML プロジェクト内の定義へのリンクが表示されます。
  • Explore: モデルに含まれる Explore を一覧表示し、LookML プロジェクト内の定義へのリンクを表示します。
  • ビュー: モデルに含まれるビューを一覧表示し、LookML プロジェクト内の定義へのリンクを表示します。

各セクションのタイトル欄には、各タイプのオブジェクトの数も表示されます。

ビューのメタデータ

ビュー パラメータを選択すると、プロジェクトでそのビューがどのように使用されているかを示すメタデータ パネルが表示されます。

  1. ビューの名前と詳細: ビュー名とビューのオブジェクト タイプを表すアイコン(使用可能なすべてのオブジェクト タイプ アイコンについては、オブジェクト ブラウザパネルを使用したプロジェクトの操作ドキュメント ページをご覧ください)。また、メタデータ パネルには、ビューがファイルの LookML で定義されているファイル名と行番号(およびプロジェクトのビューへのリンク)が表示されます。
  2. [数値] 個のモデルで使用中メニュー: このビューを含むモデルのリストが表示されます。[数値] は、ビューを含むモデルの数を表します。たとえば、ビューが 2 つのモデル内で使用されている場合、メタデータ パネルには「2 個のモデルで使用中」というテキストが表示されます。
  3. 主キー: ビューの主キー
  4. 次のベースビュー: このビューをベースビューとして使用する Explore。
  5. 結合先: このビューが結合されている Explore。

ビューに拡張機能または絞り込みがある場合、それらもメタデータ パネルに表示されます。

Explore のメタデータ

explore パラメータを選択すると、プロジェクトでその Explore がどのように使用されているかを示すメタデータ パネルが表示されます。

  1. Explore の名前と詳細: Explore の名前とオブジェクト タイプを表すアイコン(使用可能なすべてのオブジェクト タイプ アイコンについては、オブジェクト ブラウザパネルを使用したプロジェクトの操作ドキュメント ページをご覧ください)。また、メタデータ パネルには、Explore がファイルの LookML で定義されているファイル名と行番号(およびプロジェクトの Explore へのリンク)が表示されます。
  2. ベースビュー: Explore のベースビュー(Explore 作成の出発点として使用されるビュー)。
  3. 結合ビュー: ベースビューに結合されている他のビュー。

Explore に拡張機能または絞り込みがある場合、これらもメタデータ パネルに表示されます。

フィールドのメタデータ

フィールドを選択すると、プロジェクトでそのフィールドがどのように使用されているかを示すメタデータ パネルが表示されます。

  1. フィールド名と詳細: フィールド名とオブジェクト タイプを表すアイコン(使用可能なすべてのオブジェクト タイプ アイコンについては、オブジェクト ブラウザパネルを使用したプロジェクトの操作ドキュメント ページをご覧ください)。メタデータ パネルにはフィールドの型も表示され、ファイルの LookML で定義されるファイル名と行番号(およびプロジェクトのフィールドへのリンク)も参照できます。
  2. [数値] 個のモデルで使用中メニュー: このフィールドのビューを含むモデルのリストが表示されます。
  3. ビューに存在します: このフィールドを使用するビュー。

拡張機能のメタデータ

LookML コードエディタで view または explore パラメータを選択すると、メタデータ パネルの [拡張の実行者] セクションに、そのオブジェクトの拡張機能が表示されます。

たとえば、aircraft_extended Explore が aircraft Explore を拡張するモデルファイルの次のサンプル LookML コードについて考えてみます。

explore: aircraft {
  view_name: aircraft
  join: aircraft_types {
    type: left_outer
    sql_on: ${aircraft.aircraft_type_id} = ${aircraft_types.aircraft_type_id} ;;
    relationship: many_to_one
  }

  join: aircraft_engine_types {
    type: left_outer
    sql_on: ${aircraft.aircraft_engine_type_id} = ${aircraft_engine_types.aircraft_engine_type_id} ;;
    relationship: many_to_one
  }
}

explore: aircraft_extended {
  extends: [aircraft]
  label: "Aircraft Extended"
}

aircraft Explore の LookML 定義を選択すると、メタデータ パネルの [拡張の実行者] セクションに aircraft_extended が表示されます。[拡張の実行者] セクションのリンクをクリックすると、aircraft_extended が定義されている LookML に直接移動します。

aircraft_extended Explore の定義をクリックすると、メタデータ パネルに拡張された aircraft Explore に関する次の情報が表示されます。

  • 結合されたビュー: aircraft Explore に結合されているビューが一覧表示されます。
  • 拡張: 選択した Explore が拡張するオブジェクトを一覧表示します。この場合、これは aircraft Explore です。

以下の例では、拡張および拡張後の explore パラメータは同じファイル内で隣接していますが、そうではない場合もあります。拡張されたオブジェクトと拡張するオブジェクトが異なる LookML ファイルにある可能性があるため、パラメータを見ただけでは、そのパラメータが拡張されているかどうかはわかりません。メタデータ パネルには、オブジェクトがどこで定義されているかに関係なく、関連オブジェクトに関するコンテキストが表示されます。

絞り込みのメタデータ

メタデータ パネルを使用すると、ビューまたは Explore にオブジェクトに追加された絞り込みがある場合を簡単に確認できます。メタデータパネルの [絞り込み] セクションには、オブジェクトに追加された絞り込みの数が表示されます。リンクを使用して、各絞り込みの LookML に移動できます。

拡張機能と同様に、LookML を見るだけでもオブジェクトが絞り込みされているかどうかはわかりません。特に、絞り込み LookML は別のファイルにある可能性があるためです。メタデータ パネルでは、オブジェクトが絞り込まれているかどうかを確認できます。絞り込まれている場合は、絞り込みの LookML に直接移動できます。

インポートされたプロジェクトのメタデータ

メタデータ パネルには、インポートされたプロジェクトのオブジェクトに関する情報(オブジェクトが定義されているインポート ファイルに移動するリンクなど)が表示されます。たとえば、インポートされたビューファイルに基づく Explore の LookML を選択すると、インポートされたビューファイルの情報がメタデータ パネルに表示されます。

メタデータパネルからリンクをクリックすると、オブジェクトが定義されているインポート ファイルに移動できます。

また、IDE ファイル ブラウザの imported projects フォルダにあるオブジェクトをクリックすると、インポートされたファイルに関するメタデータが表示されます。