drill_fields（フィールドの場合）

このページでは、ディメンションまたは指標の一部である drill_fields パラメータについて説明します。

drill_fields は、drill_fields（ビュー用）パラメータのドキュメント ページで説明されているように、ビューの一部としても使用できます。

用途

view: view_name {
  dimension: field_name {
    drill_fields: [field_or_set, field_or_set, …]
  }
}
階層
view
フィールド タイプ
drill_fields
使用可能なフィールドタイプ
ディメンション、ディメンション グループ内のディメンション、メジャー

許可
フィールド名またはセット名の角かっこで囲まれたリスト

定義

drill_fields パラメータは、ユーザーがデータを探索中にテーブルのセルの値をクリックしたときの動作を制御します。ユーザーがこの操作を行うと、データがドリルダウンされ、そのセルを構成する個々のレコードを確認したり、クエリをセルの値に制限したり、関連する方法でデータをスライスしたりできます。

drill_fields パラメータには、フィールドのリスト、セットのリスト、またはフィールドとセットの組み合わせを指定できます。

指標で drill_fields パラメータが使用されている場合、ビューレベルで設定されたドリル フィールドは、その指標には適用されません。

場合によっては、ドリルダウンを無効にできます。

ユーザーがドリルダウン フィールドをクリックすると、ドリルダウン オーバーレイが表示されます。オーバーレイのデータは、デフォルトで次の優先順位に基づいて並べ替えられます。

  1. 最初の日付Dimension（降順）
  2. 日付ディメンションが存在しない場合、最初のメジャー（降順）
  3. Measureが存在しない場合、最初の追加Dimension（昇順）

ディメンションのドリルダウン

ディメンションにドリルダウンすると、次のオプションが表示されます。

ユーザーが選択したディメンション値にクエリを制限する

ディメンションをドリルダウンする際に、選択したディメンション値にクエリを制限するオプションがあります。この場合、ユーザーがディメンション値を選択すると、その値でフィルタリングするかどうかを選択できます。

ディメンション [国] の値 [英国] のドリルメニューで、[英国のフィルタ] オプションが選択されています。

この例では、ドリルダウン メニューで [Filter on "UK"] を選択すると、結果のクエリがフィルタされ、[Country] の値が [UK] の結果のみが表示されます。

このオプションはディメンションのデフォルトの動作であり、drill_fields パラメータを使用する必要はありません。

ユーザーが選択したディメンションを別のディメンションに置き換える

ディメンションをドリルダウンするもう 1 つの方法は、選択したディメンション値にクエリを制限し、クエリ結果で元のディメンションを別の関連ディメンションに置き換えることです。たとえば、[国] というフィールドがあり、ユーザーが都道府県別や都市別にドリルダウンできるようにしたいとします。LookML は次のようになります。

dimension: country {
  sql: ${TABLE}.country ;;
  drill_fields: [state, city]
}

Looker UI では、[国] ディメンションのドリルダウン メニューに、各値を [都道府県別] と [市区町村別] にドリルダウンするオプションが表示されます。

この例では、ユーザーが [Country] 列の [USA] の値のドリルダウン メニューで [by State] オプションを選択すると、結果のクエリの [Country] 列が [State] に置き換えられます。ドリルダウン前にクエリに追加された測定値は、新しいクエリにも引き継がれます。

type: time のディメンション グループには、デフォルトでドリルダウン フィールドが追加されています。各期間は、より詳細な期間にドリルダウンできます（たとえば、週は日付と時間にドリルダウンできますが、月にはドリルダウンできません）。ただし、drill_fields パラメータを使用すると、ドリルダウンできる期間を制限できます。

dimension_group: created {
  type: time
  timeframes: [time, date, week, month, year]
  sql: ${TABLE}.created ;;
  drill_fields: [created_month, created_date]
}

メジャーのドリルダウン

メジャーをドリルダウンすると、そのメジャーを構成するアイテムに関する行レベルのデータが表示されます。drill_fields パラメータは任意のメジャータイプで使用できますが、一般的には drill_fields を type: count または type: count_distinct のメジャーで使用する方が理にかなっています。各行に表示される情報は、drill_fields パラメータで定義したフィールドまたはセットによって定義されます。

たとえば、次のような LookML があるとします。

measure: count {
  type: count
  drill_fields: [user_details*]
}
set: user_details {
  fields: [id, city, state, country]
}

この例では、LookML で定義されているように、set パラメータの fields サブパラメータにフィールド id、city、state、country がリストされているため、指標 count をドリルダウンすると、これらのフィールドがクエリ結果に表示されます。

カウント メジャーの値を選択すると、ID フィールド、都市フィールド、州フィールド、国フィールドに対するクエリが開かれます。

ドリルメニューのダッシュボードへのリンク

特定のダッシュボード（または Looker 以外の URL）へのリンクを指定するには、link パラメータを使用します。

ドリルダウンするフィールドにフィルタが設定されている場合、ダッシュボードはドリルメニューに自動的に表示されます。これは、次のような場合に発生します。

  • ダッシュボードに、ドリルダウンするフィールドを指すグローバル フィールド タイプ フィルタがある。
  • ダッシュボード タイルのフィールドにダッシュボード フィルタが適用されている。たとえば、特定のダッシュボード タイルの users.age フィールドに数値ダッシュボード フィルタが適用されている場合があります。これにより、users.age フィールドのドリルメニューにダッシュボードが表示されます。
  • ダッシュボードは共有フォルダにあります。

フィールドのドリルダウン メニューからダッシュボードにドリルダウンする例については、Looker でのデータの探索のドキュメント ページのダッシュボードへのドリルダウンのセクションをご覧ください。