order_by_field

用途

view: view_name {
  dimension: field_name {
    order_by_field: field_name
  }
}
階層
view
フィールド タイプ
order_by_field
使用可能なフィールドタイプ
ディメンション、ディメンション グループ、メジャー

許可
フィールド名

order_by_field を正しく使用しないと、ユーザーにとって一貫性のない、混乱を招く動作が発生する可能性があります。

定義

order_by_field パラメータを使用すると、デフォルトの並べ替え順序を使用するのではなく、ディメンション、ディメンショングループ、またはメジャーの並べ替え順序を同じタイプの別のフィールドで使用できます。order_by_field パラメータで参照されるフィールドは、親フィールドのフィールド タイプと一致している必要があります。ディメンションは type: measure のフィールドを参照できません。その逆も同様です。

たとえば、status_id 列と status_name 列の両方を含むテーブルがあるとします。ユーザーが UI で [ステータス名] で並べ替えるときに、名前のアルファベット順ではなく、ステータス ID の順に名前が表示されるようにします。

ディメンションまたはディメンション グループと order_by_field パラメータで参照されるフィールドの間には 1 対 1 の関係があり、両方のフィールドのグループ化特性が完全に同じである必要があります。これを保証しないと、ユーザーには並べ替えがランダムに見える可能性があります。

各 status_name に status_id が 1 つだけ存在する場合は、次のように記述できます。

dimension: status_name {
  sql: ${TABLE}.status_name ;;
  order_by_field: status_id
}

メジャーの場合、order_by_field を使用すると、別のメジャーのメジャーから並べ替え順を使用できます。

これは、string などの数値以外の指標タイプを数値指標タイプで並べ替える場合に役立ちます。

この例では、都市の文字列が count メジャーで並べ替えられています。

measure: user_cities {
  type: string
  order_by_field: count
}