sql_analytic_model_name (untuk tampilan)

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
view
sql_analytic_model_name
Nilai Default
Tidak ada

Menerima
Nama model analisis dalam database

Aturan Khusus
  • Model analisis hanya didukung untuk koneksi BigQuery dan Snowflake.
  • Model analisis yang direferensikan 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 dari jalur default yang Anda tentukan dalam 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 (Big1}BigQuery Graph atau tampilan semantik di Snowflake) untuk digunakan sebagai dasar tampilan LookML. Hal ini memungkinkan Anda memanfaatkan model analisis 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 analog dengan cara tabel database reguler yang diekspos sebagai tampilan LookML menggunakan sql_table_name tidak diatur oleh Looker.

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

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 Anda di setelan untuk koneksi database.

Jika Anda perlu mereferensikan model analisis di 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 yang berbeda, 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

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

Lihat dokumentasi dialek Anda untuk mengetahui informasi tentang sintaksis SQL yang tepat untuk digunakan saat mereferensikan elemen dalam model analisis Anda. Misalnya, untuk membuat dimensi LookML dari entity BigQuery Graph, Anda harus menggunakan garis bawah untuk memisahkan elemen saat mencakup. 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 BigQuery Graph 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 BigQuery Graph StoreGraph, termasuk dimensi dan ukuran yang dipetakan ke Graph:

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 ukuran 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 analisis 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-agregat 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-agregat, 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 analisis 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.

  • Gabungan implisit: Fitur yang mengandalkan gabungan implisit tidak didukung untuk model analisis. 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:

Model analisis harus dapat diakses dari koneksi saat ini

Saat parameter sql_analytic_model_name digunakan dalam objek view, objek view tersebut dapat direferensikan dalam objek explore, yang pada gilirannya direferensikan dalam objek model. Objek model memiliki database connection 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 default dan skema (atau, untuk Google BigQuery, project penagihan dan set data) ditentukan oleh admin Looker Anda saat mereka membuat koneksi Looker ke database Anda.