order_by_field

Nutzung

view: view_name {
  dimension: field_name {
    order_by_field: field_name
  }
}
Hierarchie
order_by_field
Mögliche Feldtypen
Dimension, Dimensionsgruppe, Messwert

Akzeptiert
Ein Feldname

Die falsche Verwendung von order_by_field kann zu inkonsistentem, verwirrendem Verhalten für Nutzer führen.

Definition

Mit dem Parameter order_by_field können Sie die Sortierreihenfolge einer Dimension, einer Dimensionsgruppe oder eines Messwerts für ein anderes Feld desselben Typs verwenden, anstatt die Standardsortierreihenfolge zu nutzen. Felder, auf die mit dem Parameter order_by_field verwiesen wird, müssen dem Feldtyp des übergeordneten Felds entsprechen. Eine Dimension darf nicht auf ein Feld von type: measure verweisen und umgekehrt.

Angenommen, Sie haben eine Tabelle, die sowohl eine status_id- als auch eine status_name-Spalte enthält. Wenn ein Nutzer in der Benutzeroberfläche nach Status Name sortiert, sollen die Namen in der Reihenfolge der Status-ID und nicht in alphabetischer Reihenfolge angezeigt werden.

Es sollte eine 1:1-Beziehung zwischen einer Dimension oder Dimensionsgruppe und dem Feld bestehen, auf das mit dem Parameter order_by_field verwiesen wird, damit die Gruppierungsmerkmale beider Felder genau gleich sind. Andernfalls kann die Sortierung für Nutzer zufällig erscheinen.

Wenn es für jede status_name-Entität genau ein status_id gibt, können Sie Folgendes schreiben:

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

Mit dem Parameter order_by_field können Sie die Sortierreihenfolge eines Messwerts für einen anderen Messwert verwenden.

Das kann hilfreich sein, wenn Sie einen nicht numerischen Messwerttyp wie string nach einem numerischen Messwerttyp sortieren möchten.

In diesem Beispiel wird eine Liste von Städten nach dem count-Messwert sortiert:

measure: user_cities {
  type: string
  order_by_field: count
}