sql_analytic_model_name (untuk Jelajah)

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

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

Penggunaan

explore: explore_name {
  sql_analytic_model_name: analytic_model_name ;;
}
Hierarki
explore
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.
  • sql_analytic_model_name untuk Eksplorasi hanya boleh digunakan jika tampilan yang sama dapat mendeskripsikan beberapa model analisis di database Anda.
  • 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 menentukan cakupan nama model analisis.

Definisi

Untuk koneksi BigQuery dan Snowflake, parameter sql_analytic_model_name menentukan nama model analisis dalam database yang ada (a BigQuery Graph atau a semantic view in Snowflake) untuk digunakan sebagai dasar Eksplorasi LookML.

Pada umumnya, Anda menggunakan parameter sql_analytic_model_name (untuk tampilan) untuk menentukan model analisis dalam file tampilan. Kemudian, dalam file tampilan tersebut, Anda menentukan dimensi dan ukuran LookML yang didasarkan pada model analisis di database Anda. Namun, jika database Anda memiliki beberapa model analisis yang dapat ditentukan oleh kolom LookML yang sama, Anda dapat menggunakan parameter sql_analytic_model_name di bagian parameter explore.

Jika Anda menentukan sql_analytic_model_name di bagian parameter explore, Eksplorasi akan mengganti model analisis yang ditentukan dalam file tampilan dan sebagai gantinya, akan membuat kueri model analisis yang Anda tentukan di sql_analytic_model_name di bagian parameter explore. Dalam hal ini, Eksplorasi akan menggunakan ukuran dan dimensi LookML yang ditentukan dalam file tampilan, tetapi menerapkannya ke model analisis yang ditentukan dalam parameter sql_analytic_model_name dari parameter explore.

Menentukan cakupan 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 dan tidak berada di jalur penelusuran default pengguna database, Anda dapat menentukan cakupan nama model analisis dengan 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 menentukan cakupan nama model analisis menggunakan format <project_name>.<dataset_name>.<analytic_model_name>. Lihat halaman dokumentasi koneksi Google BigQuery untuk mengetahui informasi tambahan.

Contoh

Berikut adalah contoh tampilan LookML bernama MyStoreGraphView yang didasarkan pada BigQuery Graph StoreGraph di database BigQuery, 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 ;;
  }
}

Dengan asumsi bahwa database memiliki Graph lain bernama ShopDetailsGraph dengan elemen yang sama seperti StoreGraph, berikut adalah Eksplorasi yang mengganti nilai sql_analytic_model_name dalam file tampilan MyStoreGraphView. Eksplorasi akan memiliki dimensi dan ukuran LookML yang sama yang ditentukan dalam MyStoreGraphView, tetapi Eksplorasi akan membuat kueri model analisis ShopDetailsGraph:

explore: MyStoreGraphView {
  sql_analytic_model_name: ShopDetailsGraph ;;
}

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 explore, objek explore tersebut akan disertakan dalam objek model. (Hierarki di halaman ini menunjukkan rantai hubungan ini.) 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.