sql_analytic_model_name (untuk Jelajah)

Halaman ini merujuk 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 analitik 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 menjelaskan beberapa model analisis di database Anda.
  • 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) 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 analitik dalam 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 bawah parameter explore.

Saat Anda menentukan sql_analytic_model_name di bawah parameter explore, Eksplorasi akan menggantikan model analisis yang ditentukan dalam file tampilan dan sebagai gantinya, membuat kueri model analisis yang Anda tentukan dalam sql_analytic_model_name di bawah 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.

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.

Contoh

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

Dengan asumsi bahwa database memiliki Grafik lain bernama ShopDetailsGraph dengan elemen yang sama seperti StoreGraph, berikut adalah Jelajah yang menggantikan 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 mengkueri 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 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:

Model analisis harus dapat diakses dari koneksi saat ini

Jika 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 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.