このページでは、
exploreパラメータについて説明します。これは モデルの一部です。
exploreは、ダッシュボード パラメータのドキュメント ページで説明されているように、ダッシュボード フィルタの一部としても使用できます。
exploreは、ダッシュボードの要素の一部としても使用できます。その使用法の代表的な例が、LookML ダッシュボードの縦棒グラフ パラメータのドキュメント ページで提供されています。
用途
explore: explore_name { . . . }
|
階層
explore |
デフォルト値
なし
許可
既存のビューの名前、または explore を使用する場合の from の名前
特別なルール
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] メニューに [Events] というオプションを追加します。
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 で measure of
type: countを使用する場合、可視化された値には、「Count」という単語ではなく、ビュー名でラベルが付けられます。混乱を避けるために、ビュー名は複数形で設定することを推奨します。ビジュアリゼーション設定の [シリーズ] で [完全なフィールド名を表示] を選択するか、ビュー名を複数形にしたview_labelを使用します。
知っておくべきこと
explore は通常、追加のパラメータとともに使用されます
追加のパラメータを使用せずに explore を単独で使用することもできます。実際には、explore は通常、追加のオプションとともに使用されます。たとえば、追加のビューを Explore に join することは非常に一般的です。
explore に関連付けられている追加のパラメータはすべて、Explore parameters ページに表示されます。Explore 内の join に使用できるパラメータは、結合パラメータ ページに表示されます。