Halaman ini merujuk pada parameter
sql_table_nameyang merupakan bagian dari Explore.
sql_table_namejuga dapat digunakan sebagai bagian dari tampilan, yang dijelaskan di halaman dokumentasi parametersql_table_name(untuk tampilan).
sql_table_namejuga dapat digunakan sebagai bagian dari gabungan, yang dijelaskan di halaman dokumentasi parametersql_table_name(untuk gabungan).
Penggunaan
explore: explore_name {
sql_table_name: table_name ;;
}
sql_table_name |
Nilai Default
Tabel database tempat tampilan Eksplorasi didasarkan
Menerima
Nama tabel database
Aturan Khusus
|
Definisi
sql_table_name menetapkan tabel dalam database Anda yang akan dikueri oleh Explore. Biasanya, tampilan yang namanya digunakan untuk Penjelajahan menentukan tabel yang akan dikueri. Namun, jika ada beberapa tabel dengan struktur yang sama, tampilan yang sama dapat digunakan untuk mendeskripsikan semuanya. sql_table_name memungkinkan Anda menentukan tabel mana yang akan digunakan.
Mencakup nama tabel
Saat Anda mereferensikan tabel hanya menggunakan nama tabel, Looker akan menggunakan jalur penelusuran default (database dan skema) yang telah dikonfigurasi oleh admin Looker di setelan untuk koneksi database. Lihat bagian Hal yang perlu dipertimbangkan di halaman ini untuk mengetahui informasi selengkapnya.
Jika Anda perlu mereferensikan tabel dalam database dan skema yang berbeda 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 merujuk tabel dari skema yang berbeda, 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 dalam project dan set data yang berbeda 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 mengandalkan tabel customer_1 dari database/skema default:
explore: customers {
sql_table_name: customer_1 ;;
}
Contoh ini membuat Eksplorasi customers mengandalkan 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 dirujuk 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 connection database yang ditentukan di dalamnya. Saat Anda mereferensikan tabel database dalam parameter sql_table_name, tabel 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 untuk koneksi database.
Untuk memberi nama view yang berbeda dari tabel dasarnya, terapkan sql_table_name di tingkat view
Penggunaan sql_table_name di tingkat explore, seperti yang dijelaskan di halaman ini, tidak terlalu umum. Fitur ini hanya boleh digunakan jika view yang sama dapat mendeskripsikan beberapa tabel.
Metode yang lebih umum adalah menggunakan sql_table_name di tingkat view saat Anda ingin memberi nama tampilan yang berbeda dengan nama tabel pokok.
Dengan kata lain, alih-alih ini:
File Model
explore: customers {
sql_table_name: customer_1 ;;
}
Lakukan hal berikut:
File Model
explore: customers { ... }
Lihat File
view: customers {
sql_table_name: customer_1 ;;
}