sql_table_name (untuk gabungan)

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

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 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 menentukan cakupan 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 Anda yang akan dikueri oleh join. Hal ini tidak biasa, tetapi dapat berguna jika 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 itu, sebaiknya gunakan extends atau penyempurnaan.

Menentukan cakupan 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 Anda dalam 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 menentukan cakupan 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 menentukan cakupan 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-hal yang perlu dipertimbangkan di halaman ini).
• Bergantung pada konfigurasi dan dialek database Anda, tabel yang digabungkan di seluruh database mungkin juga perlu berada di mesin fisik yang sama. Lihat bagian Penggabungan gabungan di halaman dokumentasi sql_table_name (untuk tampilan).

Contoh

Contoh ini membuat gabungan customers bergantung pada 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 bergantung pada tabel customer_1 dari skema analytics dengan menentukan cakupan 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 direferensikan oleh sql_table_name harus dapat diakses dari koneksi saat ini

Saat 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 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 join yang berbeda dari tabel yang mendasarinya, terapkan sql_table_name di tingkat tampilan

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

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

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} ;;
  }
}

File Tampilan

view: customers {
  sql_table_name: customer_1 ;;
}