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 ファイル ブラウザでインポートされたプロジェクト フォルダにあるオブジェクトをクリックすると、インポートされたファイルに関するメタデータが表示されます。