Halaman ini merujuk pada parameter
sql_table_nameyang merupakan bagian dari Eksplorasi.
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
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
Saat Anda mereferensikan tabel hanya dengan 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 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 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 ;;
}