sql_table_name (untuk Jelajah)

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

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

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

Penggunaan

explore: explore_name {
  sql_table_name: table_name ;;
}
Hierarki
explore
sql_table_name
Nilai Default
Tabel database yang menjadi dasar tampilan Eksplorasi

Menerima
Nama tabel database

Aturan Khusus
  • sql_table_name untuk Eksplorasi hanya boleh digunakan jika tampilan yang sama dapat menjelaskan beberapa tabel di database Anda.
  • Tabel yang direferensikan oleh sql_table_name harus dapat diakses dalam koneksi database modelnya.
  • Jika tabel berada di database, skema, project, atau set data yang berbeda dari jalur default yang Anda tentukan dalam koneksi database, Anda harus mencakup nama tabel.

Definisi

Parameter sql_table_name menentukan tabel dalam database yang akan dikueri oleh Eksplorasi. Biasanya, tampilan yang menjadi nama Eksplorasi menentukan tabel yang akan dikueri. Namun, jika beberapa tabel memiliki struktur yang sama, Anda dapat menggunakan parameter sql_table_name di bawah parameter explore untuk mengganti tabel dasar yang ditentukan dalam file tampilan. Dengan cara ini, Anda dapat mengambil dimensi dan ukuran yang telah ditentukan dalam file tampilan dan menerapkannya ke tabel database selain tabel yang ditentukan dalam file tampilan.

Mencakup nama tabel

Jika Anda mereferensikan tabel hanya dengan menggunakan nama tabel, Looker akan menggunakan jalur penelusuran default (database dan skema) yang telah dikonfigurasi oleh admin Looker Anda di setelan untuk koneksi database. Lihat bagian Hal-hal yang perlu dipertimbangkan di halaman ini untuk mengetahui informasi selengkapnya.

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

  • Untuk mereferensikan tabel dari skema lain, gunakan <schema_name>.<table_name>, seperti yang ditunjukkan dalam contoh di halaman ini.
  • Untuk mereferensikan tabel dari database lain, gunakan <database_name>.<schema_name>.<table_name> lengkap.

Untuk koneksi Google BigQuery, Anda dapat mereferensikan tabel di project dan set data lain dengan mencakup nama tabel menggunakan format <project_name>.<dataset_name>.<table_name>. Lihat halaman dokumentasi koneksi Google BigQuery untuk mengetahui informasi tambahan.

Contoh

Contoh ini membuat Eksplorasi customers bergantung pada tabel customer_1 dari database/skema default:

explore: customers {
  sql_table_name: customer_1 ;;
}

Contoh ini membuat Eksplorasi customers bergantung pada tabel customer_1 dari skema analytics dengan mencakup nama tabel untuk menyertakan nama skema (menggunakan format <schema_name>.<table_name>):

explore: customers {
  sql_table_name: analytics.customer_1 ;;
}

Hal-hal yang perlu dipertimbangkan

Tabel yang direferensikan oleh sql_table_name harus dapat diakses dari koneksi saat ini

Jika parameter sql_table_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 tabel database dalam parameter sql_table_name, tabel tersebut 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.

Untuk memberi nama view yang berbeda dari tabel yang mendasarinya, terapkan sql_table_name di tingkat view

Penggunaan sql_table_name di tingkat explore, seperti yang dijelaskan di halaman ini, tidak terlalu umum. Parameter ini hanya boleh digunakan jika view yang sama dapat menjelaskan beberapa tabel.

Metode yang lebih umum adalah menggunakan sql_table_name di tingkat view jika Anda ingin memberi nama tampilan yang berbeda dari nama tabel yang mendasarinya.

Dengan kata lain, bukan seperti ini:

File Model

explore: customers {
  sql_table_name: customer_1 ;;
}

Lakukan hal berikut:

File Model

explore: customers { ... }

File Tampilan

view: customers {
  sql_table_name: customer_1 ;;
}