sql_table_name (untuk gabungan)

Halaman ini merujuk pada parameter sql_table_name yang merupakan bagian dari gabungan.

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 Eksplorasi, yang dijelaskan di halaman dokumentasi parameter sql_table_name (untuk Eksplorasi).

Penggunaan

explore: view_name {
  join: view_name {
    sql_table_name: table_name ;;
  }
}

Hierarki File Model explore join sql_table_name

Nilai Default Tidak ada Menerima Nama tabel di database Anda Aturan Khusus Tabel yang dirujuk oleh sql_table_name harus dapat diakses dalam koneksi database modelnya. Jika tabel berada di database, skema, project, atau set data yang berbeda dengan jalur default yang Anda tentukan di koneksi database, Anda harus mencakup nama tabel.

Definisi

Biasanya, tampilan yang menjadi dasar join menentukan tabel yang akan dikueri.

Anda dapat menggunakan sql_table_name untuk menetapkan tabel di database yang akan dikueri oleh join. Hal ini tidak biasa, tetapi dapat berguna saat beberapa tabel memiliki skema yang sama; hal ini memungkinkan tampilan yang sama digunakan untuk mendeskripsikan semuanya. sql_table_name memungkinkan Anda menentukan tabel mana yang harus digunakan oleh tampilan yang Anda gabungkan. Dalam situasi seperti ini, pertimbangkan untuk menggunakan extends atau penyempurnaan.

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.

Catatan:

• Penggabungan di seluruh database mengharuskan kedua database berada dalam dialek SQL yang sama dan kedua database dapat diakses dari koneksi yang sama di Looker (lihat bagian Hal yang perlu dipertimbangkan di halaman ini).
• Bergantung pada konfigurasi dan dialek database Anda, tabel yang digabungkan di seluruh database juga mungkin perlu berada di mesin fisik yang sama. Lihat bagian Gabungan terfederasi di halaman dokumentasi sql_table_name (untuk tampilan).

Contoh

Contoh ini membuat gabungan customers mengandalkan tabel customer_1 dari skema default:

explore: orders {
  join: customers {
    sql_table_name: customer_1 ;;
    sql_on: ${order.customer_id} = ${customer.id} ;;
  }
}

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

explore: orders {
  join: customers {
    sql_table_name: analytics.customer_1 ;;
    sql_on: ${order.customer_id} = ${customer.id} ;;
  }
}

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 join, objek join tersebut ditentukan dalam objek explore, yang pada gilirannya 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 join yang berbeda dengan tabel dasarnya, terapkan sql_table_name di tingkat tampilan

Penggunaan sql_table_name di tingkat join, seperti yang dijelaskan di halaman ini, jarang terjadi. Parameter ini hanya boleh digunakan jika tampilan yang sama dapat mendeskripsikan beberapa tabel.

Metode yang lebih umum adalah menggunakan sql_table_name di tingkat tampilan untuk memberi nama tampilan yang berbeda dengan nama tabel pokok.

Daripada fungsi berikut:

File Model

explore: orders {
  join: customers {
    sql_table_name: customer_1 ;;
    sql_on: ${order.customer_id} = ${customer.id} ;;
  }
}}

Lakukan hal berikut:

File Model

explore: orders {
  join: customers {
    sql_on: ${order.customer_id} = ${customer.id} ;;
  }
}

Lihat File

view: customers {
  sql_table_name: customer_1 ;;
}