sql_analytic_model_name (untuk tampilan)

Pratinjau: Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dalam Persyaratan Khusus Layanan. Produk dan fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Jika Anda mengalami masalah selama Pratinjau Publik interoperabilitas Looker dengan model analisis, laporkan ke [e-mail].

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

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

Penggunaan

view: view_name {
  sql_analytic_model_name: analytic_model_name ;;
}

Hierarki Lihat File view sql_analytic_model_name

Nilai Default Tidak ada Menerima Nama model analitik dalam database Aturan Khusus Model analisis hanya didukung untuk koneksi BigQuery dan Snowflake. Model analisis yang dirujuk oleh sql_analytic_model_name harus dapat diakses dalam koneksi database modelnya. Jika model analisis berada di database, skema, project, atau set data yang berbeda dengan jalur default yang Anda tentukan di koneksi database, Anda harus mencakup nama model analisis.

Definisi

Untuk koneksi BigQuery dan Snowflake, parameter sql_analytic_model_name menentukan nama model analisis dalam database yang ada (Grafik BigQuery atau tampilan semantik di Snowflake) yang akan digunakan sebagai dasar untuk tampilan LookML. Dengan demikian, Anda dapat memanfaatkan model analitik yang ditentukan langsung di database, seperti BigQuery Graph atau tampilan semantik di Snowflake.

Dalam skenario ini, objek model analisis sudah ada di database Anda dan dikelola oleh database Anda; model analisis tidak dibuat, dikelola, atau diatur oleh Looker. Hal ini serupa dengan cara tabel database reguler yang diekspos sebagai tabel virtual LookML menggunakan sql_table_name tidak diatur oleh Looker.

Catatan: Jika Anda ingin Looker membuat model analisis baru dan mengelola model analisis, Anda dapat menggunakan parameter derived_analytic_model.

Dalam file tampilan LookML, gunakan parameter sql_analytic_model_name untuk mengarahkan Looker ke model analitik di database Anda. Kemudian, buat dimensi dan ukuran Looker untuk dipetakan ke model analitik sehingga Anda dapat menggunakan Looker untuk mengkueri model analitik.

Mencakup nama model analisis

Saat Anda mereferensikan model analisis hanya dengan menggunakan nama model analisis, Looker akan menggunakan jalur penelusuran default (database dan skema) yang telah dikonfigurasi oleh admin Looker di setelan untuk koneksi database.

Jika Anda perlu mereferensikan model analisis dalam database dan skema yang berbeda yang tidak ada di jalur penelusuran default pengguna database, Anda dapat mencakup nama model analisis menggunakan format <database_name>.<schema_name>.<analytic_model_name> untuk mengarah ke database atau skema lain:

• Untuk mereferensikan model analisis dari skema yang berbeda, gunakan <schema_name>.<analytic_model_name>.
• Untuk mereferensikan model analisis dari database lain, gunakan <database_name>.<schema_name>.<analytic_model_name> lengkap.

Untuk koneksi Google BigQuery, Anda dapat mereferensikan model analisis di project dan set data yang berbeda dengan mencakup nama model analisis menggunakan format <project_name>.<dataset_name>.<analytic_model_name>. Lihat halaman dokumentasi koneksi Google BigQuery untuk mengetahui informasi tambahan.

Membuat dimensi dan ukuran LookML berdasarkan tampilan analisis Anda

Setelah membuat file tampilan dan mengidentifikasi model analitik sebagai sql_analytic_model_name, dalam file tampilan yang sama, Anda dapat menentukan dimensi dan ukuran LookML yang didasarkan pada model analitik.

Lihat dokumentasi dialek Anda untuk mengetahui informasi tentang sintaksis SQL yang tepat untuk digunakan saat merujuk ke elemen dalam model analisis Anda. Misalnya, untuk membuat dimensi LookML dari entitas Grafik BigQuery, Anda harus menggunakan garis bawah untuk memisahkan elemen saat menentukan cakupan. Misalnya, untuk BigQuery Graph, dimensi LookML ini didasarkan pada properti location_id dalam tabel node Stores:

  dimension: location_id {
    type: number
    sql: Stores_location_id ;;
  }

Namun, untuk membuat dimensi LookML yang didasarkan pada tampilan semantik Snowflake, Anda harus menggunakan nama metrik atau dimensi yang tidak memenuhi syarat.

Contoh

Berikut adalah contoh Grafik BigQuery bernama StoreGraph yang ditentukan di database BigQuery:

CREATE OR REPLACE PROPERTY GRAPH mydataset.StoreGraph
  NODE TABLES (
    mydataset.Stores AS S,
    mydataset.Locations AS L
    PROPERTIES(id, name, population, MEASURE(SUM(population)) AS total_population)
  )
  EDGE TABLES (
    mydataset.Stores AS SL
    SOURCE KEY (location_id) REFERENCES L (id)
    DESTINATION KEY (name) REFERENCES S (name)
  );

Berikut adalah contoh tampilan LookML yang didasarkan pada StoreGraphGrafik BigQuery, termasuk dimensi dan ukuran yang dipetakan ke Grafik:

view: MyStoreGraphView {
  sql_analytic_model_name: StoreGraph ;;

  dimension: location_id {
    type: number
    sql: Stores_location_id ;;
  }

  dimension: population {
    type: number
    sql: Locations_population ;;
  }

  dimension: location_name {
    type: string
    sql: Locations_name ;;
  }

  measure: locations_total_population {
    type: number
    sql: Locations_total_population ;;
  }
}

Hal-hal yang perlu dipertimbangkan

Pertimbangan untuk model analisis di Looker

Saat menggunakan model analisis dalam database, perhatikan pertimbangan dan batasan berikut:

• Jenis data: Hanya jenis data berikut untuk dimensi dan metrik yang didukung dengan model analisis:

  • Didukung untuk dimensi dan ukuran:
    • string
    • number
    • date
    • yesno
  • Hanya didukung untuk dimensi:
    • time
    • date_time

• Ukuran:

  • Ukuran dasar harus ditentukan sebelumnya: Ukuran dasar harus ditentukan sebelumnya dalam model analitik database yang mendasarinya. Looker tidak dapat menentukan ukuran dasar baru dengan melakukan agregasi (seperti type: sum atau type: count) pada dimensi dari model analisis.

  • Ukuran yang didasarkan pada ukuran lain didukung: Anda dapat menggunakan parameter sql dari ukuran LookML untuk melakukan komputasi non-gabungan yang menggunakan ukuran dasar yang telah ditentukan sebelumnya dari model analisis. Saat membuat ukuran yang didasarkan pada ukuran lain, Anda tidak dapat menentukan ukuran baru sebagai jenis ukuran agregat seperti sum atau count. Anda harus menentukan ukuran baru sebagai jenis ukuran non-gabungan, seperti string, number, date, atau yesno. Lihat contoh berikut:

    measure: average_order_amount {
      type: number
      sql: ROUND(${total_order_amount} / NULLIF(${count_orders}, 0), 2) ;;
    }
    

• Gabungan: Eksplorasi yang tampilan dasarnya didasarkan pada model analitik tidak dapat menyertakan gabungan apa pun. Demikian pula, tampilan yang didasarkan pada model analisis tidak dapat digabungkan ke dalam Eksplorasi yang memiliki tampilan dasar LookML standar.

• Penggabungan implisit: Fitur yang mengandalkan penggabungan implisit tidak didukung untuk model analitik. Beberapa contoh fitur yang mengandalkan gabungan implisit adalah kalender kustom dan kolom yang ditentukan dengan type: location, type: distance, atau type: zipcode.

• Fitur berikut tidak didukung dengan model analisis:

  • Ukuran yang difilter
  • Aggregate awareness
  • Runtime lama Looker

Model analisis harus dapat diakses dari koneksi saat ini

Jika parameter sql_analytic_model_name digunakan dalam objek view, objek view tersebut dapat dirujuk dalam objek explore, yang pada gilirannya dirujuk dalam objek model. Objek model memiliki connection database yang ditentukan di dalamnya. Saat Anda mereferensikan model analisis dalam parameter sql_analytic_model_name, model analisis harus dapat diakses dalam koneksi terkait yang ditentukan dalam file model.

Database dan skema default (atau, untuk Google BigQuery, project penagihan dan set data) ditentukan oleh admin Looker saat mereka membuat koneksi Looker ke database Anda.