データポータル レポートで 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 パラメータについて説明します。

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

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

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

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 フィルタ式のド/3}キュメント ページをご覧ください。
  • データポータルでは、すべての Looker フィルタ条件がサポートされているわけではありません。LookML モデルで、データポータルでサポートされていないフィルタ条件を使用する conditionally_filter パラメータまたは always_filter パラメータを定義すると、データポータルにフィルタ条件「null である 」が表示されます。レポートの編集者は、フィルタ条件と値を手動で更新する必要があります。データポータルでサポートされている Looker フィルタ条件を次の表に示します。Looker フィルタ条件は Looker Explore に表示される形式で記述し、対応する データポータルのフィルタ条件も示しています。
フィルタ式の種類 サポートされている Looker フィルタ条件 対応するデータポータルのフィルタ条件
文字列またはテキスト は である 次に等しい（=）
文字列またはテキスト は任意の値である 任意
文字列またはテキスト は null である null である
文字列またはテキスト 一致（詳細） 一致（詳細）
日時 は 日である 次に等しい（=）
日時 は全期間である 任意
日時 一致（詳細） 一致（詳細）
ブール値 は である （値が Yes または yes の場合） 正しい
ブール値 TRUE または は yes である 正しい
ブール値 は No である （値が No または no の場合） 間違い
ブール値 FALSE 間違い
ブール値 は任意の値である 任意
数値 は である 次に等しい（=）
数値 は任意の値である 任意
数値 は null である 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 形式のユーザー入力日付