order_by_field

Utilisation

view: view_name {
  dimension: field_name {
    order_by_field: field_name
  }
}
Hiérarchie
view
Type de champ
order_by_field
Types de champs possibles
Dimension, groupe de dimensions, mesure

Acceptation
Nom d'un champ

Une utilisation incorrecte de order_by_field peut entraîner un comportement incohérent et déroutant pour les utilisateurs.

Définition

Le paramètre order_by_field vous permet d'utiliser l'ordre de tri d'une dimension, d'un groupe de dimensions ou d'une mesure sur un autre champ du même type, au lieu d'utiliser l'ordre de tri par défaut. Les champs référencés par le paramètre order_by_field doivent correspondre au type de champ du champ parent. Une dimension ne peut pas faire référence à un champ de type: measure, et inversement.

Par exemple, vous disposez d'un tableau contenant à la fois une colonne status_id et une colonne status_name. Lorsqu'un utilisateur trie les données par Nom de l'état dans l'UI, vous souhaitez que les noms apparaissent dans l'ordre des ID d'état, et non dans l'ordre alphabétique des noms.

Il doit exister une relation de type "un à un" entre une dimension ou un groupe de dimensions et le champ référencé par le paramètre order_by_field, de sorte que les caractéristiques de regroupement des deux champs soient exactement les mêmes. Si vous ne le faites pas, le tri peut sembler aléatoire pour les utilisateurs.

Si un seul status_id est associé à chaque status_name, vous pouvez écrire :

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

Avec les mesures, order_by_field vous permet d'utiliser l'ordre de tri d'une mesure sur une autre.

Cela peut être utile si vous souhaitez trier une mesure non numérique, telle qu'une string, par une mesure numérique.

Dans cet exemple, une chaîne de villes est classée par une mesure count :

measure: user_cities {
  type: string
  order_by_field: count
}