explore

このページでは、モデルの一部である explore パラメータについて説明します。

explore は、ダッシュボード パラメータのドキュメント ページで説明されているように、ダッシュボード フィルタの一部として使用することもできます。

explore は、ダッシュボード要素の一部としても使用できます。使用例については、LookML ダッシュボードの縦棒グラフ パラメータのドキュメント ページをご覧ください。

用途

explore: explore_name { . . . }
階層
explore
デフォルト値
なし

許可
既存のビューの名前。または、from を使用する場合の explore の名前

特別なルール
explore 名は、特定のモデル内で一意である必要があります

定義

Explore 名の前にプラス記号(+)がある場合(explore: +orders など)、それは Explore の絞り込みです。詳細については、LookML の絞り込みのドキュメント ページをご覧ください。

explore は、LookML の用語とコンセプトのドキュメント ページで説明されているように、既存のビューを Looker の Explore メニューに追加します。ベスト プラクティスとして、Explore はモデルファイル内で定義する必要があります。

通常、Explore の名前は既存のビューにちなんで付けられます。ただし、同じビューに基づいて複数の Explore を作成する場合は、Explore に from パラメータを追加できます。その場合、Explore には任意の有効な名前を付けることができます。有効な名前には、英小文字(a ~ z)、数字(0 ~ 9)、アンダースコアのみを使用できます。

explore は、Looker が生成する SQL で重要な役割を果たします。ユーザーが [Explore] メニューから [Customers] を選択してクエリを実行したとします。この customers Explore は、データベース テーブルに関連付けられた customers というビューに基づいています。このテーブルは、ユーザーの SQL クエリの FROM 句に配置されます。

explore には、表示とフィルタの動作に影響し、Explore の結合の追加を指定する多くの子パラメータを設定できます。Explore に 1 つ以上の結合が含まれている場合、それらの結合には、優先する結合動作を指定する結合パラメータを設定できます。

users というビューに基づいて、[Explore] メニューにオプションを追加します。

explore: users {
  # additional explore parameters go here
}

user_events というビューに基づいて、[イベント] というオプションを Explore メニューに追加します。

explore: events {
  from: user_events
}

一般的な課題

explore は既存のビュー名を参照する必要があります

explore パラメータを使用して、ビューの一部であるデータベース テーブル、ディメンション、メジャー、その他のフィールドを定義することはできません。代わりに、まず view パラメータを使用してビューを定義する必要があります。その後、explore でそのビューの名前を参照できます。

explore はファイル名ではなくビュー名を参照する必要があります

通常、ビューの名前は、ビューが定義されているビューファイルと同じです。これは必須ではありません。ビュー名とビュー ファイル名は異なってもかまいません。

たとえば、company_users というファイル内で users というビューが定義されているとします。ビューファイル company_users は次のようになります。

view: users { ... }

次に、次のコードを使用して users ビューを [Explore] メニューに追加します。

explore: users { ... }

users ビューは company_users というファイル内にありますが、ファイルの名前は重要ではありません。view パラメータのビューの名前のみが重要です。

Explore で type: countmeasure を使用する場合、可視化された値には、「Count」という単語ではなく、ビュー名でラベルが付けられます。混乱を避けるために、ビュー名は複数形で設定することを推奨します。ビジュアリゼーション設定の [シリーズ] で [完全なフィールド名を表示] を選択するか、ビュー名を複数形にした view_label を使用します。

知っておくべきこと

explore は通常、追加のパラメータとともに使用されます

explore は、追加のパラメータなしで単独で使用できます。実際には、explore は通常、追加のオプションとともに使用されます。たとえば、Explore に追加のビューを join することはごく一般的です。

explore に関連付けられている追加のパラメータはすべて、[Explore パラメータ] ページに表示されます。Explore 内の join で使用できるパラメータについては、結合パラメータのページをご覧ください。