extends (untuk tampilan)

Halaman ini mengacu pada parameter extends yang merupakan bagian dari tampilan.

extends juga dapat digunakan sebagai bagian dari Eksplorasi, yang dijelaskan di halaman dokumentasi parameter extends (untuk Eksplorasi).

extends juga dapat digunakan sebagai bagian dari dasbor LookML, yang dijelaskan di halaman dokumentasi Parameter dasbor.

Penggunaan

view: view_name {
  extends: [view_name, view_name, ...]
}
Hierarki
view
extends
Nilai Default
Tidak ada

Menerima
Tanda kurung siku yang berisi daftar nama tampilan yang dipisahkan koma

Definisi

Parameter extends memungkinkan Anda membuat konten dan setelan dari file tampilan lain, menggunakan file tampilan lain sebagai titik awal. Jika ada konflik, tampilan yang diperluas akan menggunakan setelannya sendiri, menggantikan setelan tampilan yang diperluas. Lihat Menggunakan kembali kode dengan ekstensi untuk mengetahui detail cara Looker melakukannya.

Lihat penajaman LookML.

Memperluas tampilan atau Eksplorasi sangat ideal untuk skenario saat Anda ingin memiliki beberapa versi tampilan atau Eksplorasi. Namun, jika sasaran Anda hanya untuk mengubah tampilan atau Eksplorasi tanpa mengedit file LookML yang memuatnya, Anda dapat menggunakan penyempurnaan. Anda juga dapat menggunakan parameter extends di dalam penyempurnaan. Lihat halaman dokumentasi Penyempurnaan LookML untuk mengetahui informasi dan kasus penggunaan selengkapnya.

Saat memperluas tampilan, penting untuk menggunakan parameter sql_table_name pada tampilan yang akan diperluas, jika belum ada. Parameter sql_table_name menentukan tabel dalam database Anda yang akan dikueri oleh tampilan. Untuk tampilan apa pun, nilai defaultnya adalah nama tampilan. Jadi, jika Anda belum menggunakan sql_table_name, cukup berikan nilai yang sama dengan nama tampilan Anda.

Penting juga bahwa dalam file tampilan baru, kita menggunakan parameter include untuk mengarah ke nama file tampilan yang ingin kita perluas.

Hindari memperluas tampilan yang didasarkan pada tabel turunan persisten (PDT). Setiap perluasan PDT akan membuat salinan baru tabel di database Anda. Dalam hal ini, sebaiknya gunakan penyempurnaan LookML. Lihat halaman dokumentasi Penyempurnaan LookML untuk mengetahui informasi dan kasus penggunaan selengkapnya.

Contoh

Berikut adalah contoh file tampilan yang dapat kita perluas. Tampilan diberi nama looker_events dan nama file tampilan adalah events.view.

File: events.view 

view: looker_events {
  sql_table_name: looker_db.events ;;
  # The normal contents of the view follow
}

Sekarang kita akan membuat file tampilan baru dan menentukan tampilan yang memperluas tampilan looker_events. Dalam file baru, kita harus menggunakan parameter include untuk mengarah ke nama file tampilan yang ingin kita perluas:

File: new_events.view 

include: "events.view"
view: name_of_the_new_view {
  extends: [looker_events]

  measure: additional_measure {
    type: count
  }
  # Additional things you want to add or change
}

Kemudian, kita telah menambahkan ukuran baru yang akan ditampilkan di tampilan baru selain semua dimensi dan ukuran yang ditentukan dalam tampilan looker_events yang kita perluas.

Menggunakan metadata untuk melihat ekstensi objek

Anda dapat mengklik parameter explore atau view di Looker IDE dan menggunakan panel metadata untuk melihat ekstensi apa pun pada objek, atau untuk melihat objek yang diperluasnya. Lihat halaman dokumentasi Metadata untuk objek LookML untuk mengetahui informasi.

Hal-hal yang perlu dipertimbangkan

Beberapa parameter bersifat aditif

Dalam banyak kasus, jika objek yang diperluas berisi parameter yang sama dengan objek yang sedang diperluas, nilai objek yang memperluas akan menggantikan nilai parameter objek yang diperluas.

Namun, ekstensi dapat bersifat aditif untuk beberapa parameter, yang berarti nilai dari objek yang diperluas digunakan bersama dengan nilai dari objek yang diperluas.

Parameter berikut bersifat aditif:

Dalam contoh berikut, tampilan carriers memiliki dimensi name dengan parameter link:

view: carriers {
  sql_table_name: flightstats.carriers ;;

  dimension: name {
    sql: ${TABLE}.name ;;
    type: string
    link: {
      label: "Google {{ value }}"
      url: "http://www.google.com/search?q={{ value }}"
      icon_url: "http://google.com/favicon.ico"
    }
  }
}

Berikut adalah tampilan carriers_extended, yang memperluas tampilan carriers. Tampilan carriers_extended juga memiliki dimensi name dengan setelan yang berbeda dalam parameter link:


include: "/views/carriers.view.lkml"

view: carriers_extended {
  extends: [carriers]

  dimension: name {
    sql: ${TABLE}.name ;;
    type: string
    link: {
      label: "Dashboard for {{ value }}"
      url: "https://docsexamples.dev.looker.com/dashboards/307?Carrier={{ value }}"
      icon_url: "https://www.looker.com/favicon.ico"
    }
  }
}

Dalam tampilan carriers_extended, kedua parameter link bersifat aditif, sehingga dimensi name akan memiliki kedua link.

Project dengan pelokalan

Saat memperluas objek, perhatikan bahwa aturan pelokalan juga berlaku untuk perluasan Anda. Jika Anda memperluas objek, lalu menentukan label atau deskripsi baru, Anda harus memberikan definisi pelokalan dalam file string bahasa project. Lihat halaman dokumentasi Melokalkan model LookML untuk mengetahui informasi selengkapnya.