データポータル レポートで Looker Explore データを理解する

Looker をレポートのデータソースとして設定したら、Looker Explore のデータに基づいたフィールド、グラフ、フィルタをレポートに追加できます。

Looker データソースのフィールドとフィルタは LookML パラメータで定義されるため、データポータルの他のデータソースのフィールドやフィルタとは表示や動作が異なる場合があります。また、Looker での表示とも異なる場合があります。このページでは、こうした細かな違いと、Looker データソースのフィールドとフィルタを使用する方法について説明します。

レポートにデータを追加する方法とレポートのフィールドを編集する方法の詳細もご覧ください。

データポータル レポートでの Looker Explore の表示

Looker データソースを使用すると、データポータル レポートで Looker Explore データを分析できます。

Explore のデータ（ビュー、ディメンション、ディメンション グループ、メジャー（データポータルでは「指標」と呼びます）、結合など）は、データポータル レポートのユーザー インターフェースのさまざまな部分（次の領域など）に表示されます。

  • データソース エディタ
  • レポート エディタ:
    • データパネルのフィールド リスト
    • プロパティ パネル: ディメンション セクション、指標セクション、ブレンド セクション、フィルタ セクション
    • レポート キャンバスのビジュアリゼーションとツールチップ
    • レポートのフィルタ

Looker Explore のフィールド ピッカーとデータポータル レポートのフィールド ピッカーでは、ともにフィールドが Explore の名前またはラベルの下で、タイプ（ディメンション、メジャーまたは指標の順）ごとにアルファベット順で表示されます。どちらも、ビューごとにフィールドをさらにグループ化します。

フィールドまたはビューにカーソルを合わせると、Looker Explore の基になる LookML で定義されているメタデータが表示されます。データポータルには、次のフィールドまたはビューのメタデータが表示されます。

  • ビュー名: フィールドのビュー名（ビュー LookML パラメータで定義されているもの）
  • ディメンション グループ: 該当する場合、dimension_group LookML パラメータで定義された、時間ベースまたは期間ベースのディメンションのグループの名前
  • 説明: description LookML パラメータで定義されているフィールドまたはビューの説明
  • タイプ: type LookML パラメータで定義されたフィールド タイプ（メジャーの type またはディメンション、フィルタ、パラメータの type を参照）
  • デフォルトの集計: フィールドで使用される集計方法
  • SQL: フィールドの SQL 式（sql LookML パラメータで定義されているもの）

データポータル レポートでの Looker Explore の動作

データポータルの Looker データソースは、Looker モデルの LookML で定義された Looker Explore に基づいています。Looker デベロッパーは LookML を使用して、組織の SQL データベース内のディメンション、集計、計算、データの関係を記述します。一部の LookML パラメータは Looker データソースで適用されますが、データポータルでは表示されません。以降のセクションでは、Looker データソースで適用され、データポータルで操作できる LookML パラメータについて説明します。

LookML パラメータの drill_fields と link で定義されたドリル フィールドとリンクは、データポータル レポートの閲覧者がデータポータルの表グラフの [ドリルダウン] メニューで使用できます。

データポータルでドリルダウン機能を使用する方法について詳しくは、データをドリルダウンするをご覧ください。

データポータルのドリルダウン機能に関する注意事項

Looker データソースでドリルダウン（ドリルダウン フィールドとリンク）を使用する場合は、次の点に注意してください。

  • ドリルダウンは、表グラフでのみサポートされています。
  • ドリルダウンは、Looker のディメンションとディメンション グループでのみサポートされています。
  • Looker からインポートされたドリルダウンは読み取り専用です。インポートされたドリルダウンに変更を加えるには、Looker で基となる LookML モデルを編集します。

フィルタ

レポートの編集者は、Looker データソースのフィールドに基づいて、データポータル レポートで永続的なフィルタ（グラフ、グループ、ページ、レポート単位）、クイック フィルタ、コントロールを定義できます。

データポータルでは、Looker データソースの基になる LookML に定義されている、フィルタまたはフィルタ限定のフィールドも示されます。また、[次と等しい（=）] 条件と [次に含まれる] 条件が使用されている場合、データソースの LookML の suggest_dimension と suggest_explore の定義に基づいて、フィルタ値の候補も表示されます。フィルタ値の候補を表示するには、フィルタ エディタで [入力中に候補値を表示する] を有効にします。事前定義されたデフォルト値があらかじめ選択されます。

閲覧者は、レポートの [その他のオプション] メニューをクリックし、[適用したフィルタを表示] を選択すると、レポートの編集可能なフィルタにアクセスしてフィルタを変更できます。

Looker データソースを使用するレポートでは、LookML パラメータで定義されたフィルタは、次の表に示すように、データポータルで参照されます。

LookML の定義 データポータルの場所 データポータルのリファレンス
conditionally_filter レポート エディタ: [プロパティの設定フィルタ] セクション 条件付き必須
フィルタ マネージャー: [タイプ] 列 条件付きでフィルタ
レポート エディタ: [グループのプロパティ] 条件付き必須
レポート エディタ: [現在のページの設定] 他のフィルタタイプと区別されない
レポート エディタ: [レポート設定] 条件付き必須
データソース エディタ: [データソース フィルタ] セクション 条件付きでフィルタ
フィルタバー（クイック フィルタ） 他のフィルタタイプと区別されない
always_filter レポート エディタ: [プロパティ] > [設定] > [フィルタ] セクション 常に必須
フィルタ マネージャー: [タイプ] 列 常にフィルタ
レポート エディタ: [ グループのプロパティ] 常に必須
レポート エディタ: [ 現在のページの設定] 他のフィルタタイプと区別されない

レポート エディタ: [レポート設定]

常に必須
データソース エディタ : [データソース フィルタ] セクション 常にフィルタ
フィルタバー（クイック フィルタ） 他のフィルタタイプと区別されない
parameter、

filter		 レポート エディタ: [プロパティ] > [設定] > [フィルタ] 他のフィルタタイプと区別されない
レポート エディタ: [データ] > [Explore 名] > [フィルタ限定フィールド] フィールド グループ フィルタ限定のフィールド
フィルタ マネージャー: [タイプ] 列 他のフィルタタイプと区別されない
レポート エディタ: [グループのプロパティ] 他のフィルタタイプと区別されない
レポート エディタ: [現在のページの設定] 他のフィルタタイプと区別されない
レポート エディタ: [レポート設定] 他のフィルタタイプと区別されない
データソース エディタ: [フィルタ限定フィールド] セクション フィルタ限定のフィールド
フィルタバー（クイック フィルタ） 他のフィルタタイプと区別されない

レポートのコントロール

 なし

基となる LookML モデルに、sql_always_where、sql_always_having、または access_filter パラメータが含まれている場合、それらはデータソースに適用されますが、データポータルには表示されません。

常に必須のフィルタまたは条件付きで必須のフィルタに関する詳細

条件付きの LookML フィルタを使用する場合は、次の点に注意してください。

  • 条件付きで必須のフィルタや常に必須のフィルタは、グラフから削除できません。
  • レポートの編集者は、フィルタ句の条件または値に変更を加えることはできますが、データポータルのフィルタ フィールドを変更することはできません。インポートされた LookML フィルタに変更を加えるには、Looker で基となる LookML モデルを編集します。
  • 数値フィルタタイプは、ユーザーが入力した null 以外の値のみで、一致（詳細）条件をサポートします。
  • [一致（詳細）] 条件は、データポータルと Looker で動作が若干異なります。Looker の Explore では、ユーザーの入力に基づいて、一致（高度）条件がより適切な条件に変換されることがあります。データポータルでは、ユーザーの入力がデータポータルでサポートされている他のフィルタ条件に適していない場合、包括的な条件として [一致（詳細）] オプションが使用されますが、条件は変換されません。[次に一致する（高度）] 条件で使用できるフィルタ値の詳細については、Looker のフィルタ式のドキュメント ページをご覧ください。
  • データポータルでは、すべての Looker フィルタ条件がサポートされているわけではありません。データポータルでサポートされていないフィルタ条件を使用した conditionally_filter パラメータまたは always_filter パラメータを LookML モデルで定義すると、データポータルにフィルタ条件「null である」が表示されます。レポートの編集者は、フィルタ条件と値を手動で更新する必要があります。次の表に、Looker Explore に表示される Looker フィルタ条件と、それに対応する データポータルのフィルタ条件を示します。
フィルタ式の種類 サポートされている Looker のフィルタ条件 同等のデータポータルのフィルタ条件
文字列またはテキスト is 次に等しい（=）
文字列またはテキスト is any value 次のいずれか
文字列またはテキスト is null Is Null
文字列またはテキスト 一致（高度） 一致（高度）
日時 当日 次に等しい（=）
日時 is any time 次のいずれか
日時 一致（高度） 一致（高度）
ブール値 is（値が Yes または yes） 正しい
ブール値 TRUE または is yes 正しい
ブール値 is No（値が No または no） 間違い
ブール値 FALSE 間違い
ブール値 is any value 次のいずれか
数値 is 次に等しい（=）
数値 is any value 次のいずれか
数値 is null Is Null
数値 一致（高度） 一致（高度）

フィルタ限定のフィールドに関する詳細

  • インポートされたフィルタ限定のフィールドに変更を加える（ユーザーが入力できる値の指定など）には、Looker で基となる LookML モデルを編集します。
  • レポートの編集者は、フィルタ限定のフィールドを使用するフィルタを編集する場合は AND 演算子を使用する必要があり、同じフィルタ限定のフィールドを含めることはできません。使用可能な値は、Looker データソースの基になる LookML で定義されます。
  • 高度なフィルタ オプションは、基となる LookML で使用できる値が定義されているフィルタ限定フィールドには使用できません。
  • データポータルでは、フィルタ限定のフィールドのすべての型と値がサポートされているわけではありません。サポートされていない型を使用した parameter または filter パラメータを LookML モデルで定義すると、データポータルにフィルタ条件「null である」が表示されます。レポートの編集者は、フィルタ条件と値を手動で更新する必要があります。サポートされているフィルタ限定のフィールドの型を次の表に示します。
LookML パラメータ フィールド タイプ データポータルのフィルタ条件 サポートされる入力値
parameter string すべて ユーザー入力値、または定義済みの値のみ
unquoted すべて ユーザー入力値、または定義済みの値のみ
date_time 次に等しい（=） YYYY-MM-DD または YYYY/MM/DD 形式のユーザー入力日付
yesno 次に等しい（=） 定義済みのブール値
filter string すべて ユーザー入力値
number すべて ユーザー入力の数値形式の値
yesno 次に等しい（=） 定義済みのブール値
date_time 次に等しい（=） YYYY-MM-DD または YYYY/MM/DD 形式のユーザー入力日付
date 次に等しい（=） YYYY-MM-DD または YYYY/MM/DD 形式のユーザー入力日付