フィールドパラメーター

このページには、フィールドを定義するすべてのLookMLパラメーターへのリンクが含まれます。

フィールドにはいくつかのタイプがあります。

  • ディメンションは、テーブルの列、または何らかの列操作や列の組み合わせに基づく計算値を表します。
  • ディメンショングループは、時間ベースのデータとともにのみ使用されます。これにより、同時に多数の時間ベースのディメンションを作成することが可能になります。
  • メジャーは、SQL の集計関数（COUNT、SUM、AVG など）に似ており、複数の行に関する情報を表します。
  • フィルタ: ユーザーがテンプレート フィルタまたは条件付き結合に入力するために使用できるフィルタ専用フィールドを作成します。
  • パラメータは、ユーザーが Liquid {% parameter %} タグに入力するために使用できるフィルタ専用フィールドを作成します。

使用例

パラメータ名の上にカーソルを置くと、簡単な説明が表示されます。パラメータ名をクリックすると、そのリファレンス ページに移動します。

パラメータをいくつかの特定のオプションのいずれかに設定できる場合は、デフォルト値が最初にリストされています。

## STRUCTURAL PARAMETERS
view: view_name {
  (dimension |dimension_group |measure |filter | parameter):field_name{
    intervals: [interval, interval, …]
    timeframes: [timeframe, timeframe, …]

    # ACTION AND LINKING PARAMETERS
    action: {
      label: "Label to Appear in Action Menu"
      url: "url"
      icon_url: "url"
      form_url: "url"
      param: {
        name:  "name string"
        value:  "value string"
      }
      # Possibly more param definitions
      form_param: {
        name:  "title"
        type: select | string | textarea
        label:  "desired label name"
        required:  yes | no
        default:  "value string"
        option: {
          name:  "name string"
          value:  "value string"
        }
        # Possibly more option definitions
      }
      # Possibly more form_param definitions
    }
    drill_fields: [field_or_set, field_or_set, ...]
    tags: ["string1", "string2", ...]
    link: {
      label: "desired label name;"
      url: "desired_url"
      icon_url: "url_of_an_image_file"
    }
    # Possibly more link definitions
    # DISPLAY PARAMETERS
    alias: [old_field_name, old_field_name, ...]
    alpha_sort: yes | no
    description: "description string"
    group_label:  "desired group label name"
    group_item_label:  "label to use under the group label in the field picker"
    hidden: yes | no
    label: "desired label name"
    label_from_parameter: parameter_name
    order_by_field: dimension_name | dimension_group_name | measure_name 
    style: classic | interval | integer | relational
    view_label: "desired label name"

    # FILTER PARAMETERS
    can_filter: yes | no
    case_sensitive: yes | no
    filters: [dimension: "filter expression", dimension: "filter expression", ...]
    skip_drill_filter: yes | no

    # FILTER SUGGESTION PARAMETERS
    allowed_value: {
      label: "desired label name"
      value: "looker filter expression"
    }
    # Possibly more allowed_value definitions
    bypass_suggest_restrictions: yes | no
    full_suggestions: yes | no
    suggest_dimension: dimension_name
    suggest_explore: explore_name
    suggest_persist_for: "N (seconds | minutes | hours)"
    suggestable: yes | no
    suggestions: ["suggestion string", "suggestion string", "…"]<

    # QUERY PARAMETERS
    allow_approximate_optimization: yes | no
    approximate: yes | no
    approximate_threshold: N
    convert_tz: yes | no
    datatype: epoch | timestamp | datetime | date | yyyymmdd
    fanout_on: repeated_record_name
    precision: N
    primary_key: yes | no
    required_access_grants: [access_grant_name, access_grant_name, ...]
    required_fields: [field_name, field_name, ...]
    sql_distinct_key: SQL expression to define repeated entities ;;

    # VALUE AND FORMATTING PARAMETERS
    case: {
      when: {
        sql: SQL condition ;;
        label: "value"
      }
      # Possibly more when statements
    }
    default_value: "desired default value"
    direction: "row | column"
    end_location_field: dimension_name
    html: HTML expression using Liquid template elements ;;
    list_field: dimension_name

    percentile: Nth percentile
    sql: SQL expression to generate the field value ;;
    sql_end: SQL expression indicating the end time of a duration ;;
    sql_latitude: SQL expression to generate a latitude ;;
    sql_longitude: SQL expression to generate a longitude ;;
    sql_start: SQL expression indicating the start time of a duration ;;
    start_location_field: dimension_name
    synonyms: [synonym1, synonym2, ...]
    tiers: [N, N, ...]
    type: dimension_field_type # For a dimension field
    type: dimension_group_type
# For a dimension_group field
    type: measure_field_type   # For a measure field
    type: filter_field_type    # For a filter field
    type: parameter_field_type # For a parameter field
    string_datatype: unicode # For a dimension field
    units: feet | kilometers | meters | miles | nautical_miles | yards
    value_format: "excel-style formatting string"
    value_format_name: format_name

    # VISUALIZATION PARAMETERS
    allow_fill: yes | no
    map_layer_name: name_of_map_layer
  }
}

パラメータの定義

  • D = ディメンション
  • DG = ディメンション グループ
  • M = メジャー
  • F = Filter
  • P = Parameter
パラメータ名 有効なフィールドタイプ 説明
構造的パラメーター
dimension D ディメンションフィールドを作成します。
dimension_group DG 同時に複数の時間ベースのディメンションを作成します。
filter F テンプレートフィルターまたは条件付き結合で使用するフィルター専用フィールドを作成します。
measure M メジャーフィールドを作成します。
parameter P ユーザーが Liquid {% parameter %} タグに入力するために使用する、フィルタ専用フィールドを作成します
intervals DG type: duration の dimension_group で使用する期間ディメンションのセットを定義します
timeframes DG type: time の dimension_group に必要なタイムフレーム ディメンションのセットを定義します。
アクションおよびリンクパラメーター
action D M フィールドに対するデータアクションを作成して、ユーザーがLookerから直接他のツールでタスクを実行できるようにします。
drill_fields D DG M メジャーまたはディメンションのドリルダウン時に表示されるフィールドのリストを宣言します。
link D M 他のLookerや外部コンテンツへのリンクを作成します。
tags D DG M F P 他のアプリケーションに渡すことができるテキストを追加して、フィールドに関するデータを提供します。
表示パラメーター
alias D DG M F P フィールド名が変更された後でも、古いフィールド名を使った保存済みURLが機能するようにします。
alpha_sort D case パラメータがその条件をアルファベット順にソートするようにします。
description D DG M F P ユーザーがフィールドにカーソルを合わせたときに表示される説明をフィールドに追加します。
group_label D DG M F フィールドピッカーのビュー内でフィールドをグループ化します。
group_item_label D DG M F フィールドピッカーでグループラベルの下位のフィールドに使用するラベルを指定します。
hidden D DG M F P Explore UIからフィールドを非表示にします。
label D DG M F P フィールドピッカーでのフィールド名の表示方法を変更します。
label_from_parameter D M parameter への入力に基づいて、ビジュアリゼーションでのフィールド名の表示方法を変更します。
order_by_field D DG M

フィールドを別のフィールドの値でソートします。

ディメンション、ディメンション グループでサポートされます

メジャーでサポートされています
style D type: tier ディメンションの Looker UI に階層が表示される方法を変更します。
view_label D DG M F P フィールドピッカーのビュー内に表示されるフィールドを変更します。
フィルタパラメーター
can_filter D DG M ディメンションまたはメジャーをフィルターとして使用できるかどうかを決定します。
case_sensitive D F ディメンションでフィルタの大文字と小文字が区別されるかどうかを決定します。
filter F テンプレートフィルターで使用するためのフィルター専用フィールドを作成します。
filters M ディメンション制限に基づいてメジャーの計算を制限します
skip_drill_filter D メジャーのドリルダウン時にディメンションがフィルタに追加されないようにします。
フィルタ提案パラメーター
allowed_value P parameter の選択肢を指定します。
bypass_suggest_restrictions D DG F P sql_always_where の使用時に提案をユーザーに示しますが、提案に制限を適用しません。
full_suggestions D DG F P Looker がデータベースにクエリを実行して、Explore のフィルタでフィールドの値の候補を提示する方法を制御します。Looker は基本的な SELECT DISTINCT クエリを使用することも、結合、sql_always_where パラメータ、access_filter パラメータなど、Explore の完全なロジックを使用することもできます。
suggest_dimension D DG M F P 別のディメンションの値に基づいてフィールドの提案を行います。
suggest_explore D DG M F P 別のExploreの値に基づいてフィールドの提案を行います。
suggest_persist_for D F P Lookerフィルタ提案のキャッシュ設定を変更します。
suggestable D DG M F P フィールドの提案を有効または無効にします。
suggestions D F P フィールドの提案に使用される値のリストを宣言します。
クエリ パラメータ
allow_approximate_optimization M type: count または type: count_distinct のメジャーの個別のカウント近似値を許可します。これにより、メジャーを集約テーブルの自動認識に使用できます。
approximate M type: count_distinct のメジャーの近似値を求めます。このパラメータをサポートする言語の一覧については、approximate のドキュメント ページをご覧ください。
approximate_threshold M BigQueryが正確な結果から近似値に切り替える閾値を設定します。
convert_tz D DG M F P フィールドのタイムゾーン自動変換を無効にします。
datatype D DG F M フィールドに提供する時間データのタイプを指定します。
fanout_on D DG M Google BigQueryの反復フィールドへのアクセスを可能にします。
precision M Lookerの対称集計の計算を実行する際に使用する小数位の桁数を指定します。
primary_key D ディメンションをビューの主キーとして宣言します。
required_access_grants D DG F M P アクセス権限と一致するユーザー属性値を持つユーザーのみにフィールドへのアクセスを限定します。
required_fields D M あるフィールドが選択された場合、クエリにさらにフィールドを追加することを求めます。
sql_distinct_key M type: sum_distinct または type: average_distinct のメジャーの計算のベースとなる一意のエンティティを定義します。
値および書式設定パラメーター
case D SQL条件によって決定される、ディメンションが持つことのできる値のセットを作成します。
default_value F P フィルタフィールドのデフォルト値を指定します。
direction M ピボットが使用された場合の type: percent_of_total または type: running_total のメジャーの計算方向を決定します
end_location_field D type: distance のフィールドの終了位置を含むフィールドを定義します
html D DG M Liquidテンプレートを使用して、フィールドのHTML出力を変更します。
list_field M type: list の指標の計算の起点となるディメンションを宣言します。
percentile M type: percentile または type: percentile_distinct のメジャーの小数値（N 番目のパーセンタイル）を指定します。
sql D DG M F フィールドの計算方法を決定します。
sql_end D DG 期間タイプのディメンショングループまたは期間タイプのディメンションの期間の終了時刻を定義します。
sql_latitude D type: location のディメンションの緯度を定義します。
sql_longitude D type: location のディメンションの経度を定義します。
sql_start D DG 期間タイプのディメンショングループまたは期間タイプのディメンションの期間の開始時刻を定義します。
start_location_field D type: distance のフィールドの開始位置を含むフィールドを定義します
synonyms D DG F M P 大規模言語モデルとアプリ デベロッパーが、ユーザーがフィールドを指す可能性のある他の方法を理解するのに役立つ文字列の同義語（単語またはフレーズ）のリストを指定します。
tiers D type: tier のディメンションの階層を定義します
type（ディメンション、フィルタ、パラメータの場合） D F P ディメンション、フィルター、パラメーターのタイプを指定します。
type（ディメンション グループの場合） DG ディメンショングループのタイプを指定します。
type（指標の場合） M メジャーのタイプを指定します。
string_datatype D SQL Server または MySQL の type: string のフィールドの Unicode データ型を指定します
units D type: distance のフィールドに使用する単位を指定します。
value_format D M Excelスタイルオプションを使用して、フィールドの出力を書式設定します。
value_format_name D M 組み込み書式またはカスタム書式を使用してフィールドの出力を書式設定します。
ビジュアリゼーションパラメーター
allow_fill D DG ディメンションでディメンションフィルを許可するかどうかを決定します。
map_layer_name D 組み込みマップまたはカスタムマップで定義した地理的領域へのデータ値のマッピングを指定します。
避けるべきパラメーター
decimals D M 5.4 で削除 value_format に置き換え
format D M 3.16 で削除 value_format に置き換え