このページでは、モデルの一部である
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: countの measure を使用する場合、可視化された値には、「Count」という単語ではなく、ビュー名でラベルが付けられます。混乱を避けるために、ビュー名は複数形で設定することを推奨します。ビジュアリゼーション設定の [シリーズ] で [完全なフィールド名を表示] を選択するか、ビュー名を複数形にしたview_labelを使用します。
知っておくべきこと
explore は通常、追加のパラメータとともに使用されます
explore は、追加のパラメータなしで単独で使用できます。実際には、explore は通常、追加のオプションとともに使用されます。たとえば、Explore に追加のビューを join することはごく一般的です。
explore に関連付けられている追加のパラメータはすべて、[Explore パラメータ] ページに表示されます。Explore 内の join で使用できるパラメータについては、結合パラメータのページをご覧ください。