order_by_field

Penggunaan

view: view_name {
  dimension: field_name {
    order_by_field: field_name
  }
}

Hierarki Lihat File view Jenis Kolom order_by_field

Jenis Kolom yang Mungkin Dimensi, Grup Dimensi, Ukuran Menerima Nama kolom

Penggunaan order_by_field yang salah dapat menyebabkan perilaku yang tidak konsisten dan membingungkan bagi pengguna.

Definisi

Parameter order_by_field memungkinkan Anda menggunakan urutan pengurutan dari dimensi, grup dimensi, atau ukuran pada kolom lain dengan jenis yang sama, bukan menggunakan urutan pengurutan default. Kolom yang dirujuk oleh parameter order_by_field harus sesuai dengan jenis kolom induk. Dimensi tidak dapat mereferensikan kolom type: measure, dan sebaliknya.

Misalnya, Anda memiliki tabel yang berisi kolom status_id dan status_name. Saat pengguna mengurutkan menurut Nama Status di UI, Anda ingin nama muncul dalam urutan ID status, dan bukan urutan abjad nama.

Harus ada hubungan 1:1 antara dimensi atau grup dimensi dan kolom yang dirujuk oleh parameter order_by_field, sehingga karakteristik pengelompokan kedua kolom tersebut sama persis. Jika Anda tidak memastikan hal ini, pengurutan dapat tampak acak bagi pengguna.

Jika hanya ada satu status_id untuk setiap status_name, Anda dapat menulis:

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

Dengan ukuran, order_by_field memungkinkan Anda menggunakan urutan pengurutan dari satu ukuran pada ukuran lain.

Hal ini dapat berguna jika Anda ingin mengurutkan jenis ukuran non-numerik, seperti string, menurut jenis ukuran numerik.

Dalam contoh ini, string kota diurutkan berdasarkan ukuran count:

measure: user_cities {
  type: string
  order_by_field: count
}