Virtual Foreign Keys

Buka di CMS

Virtual foreign key adalah relasi antara dua tabel yang Anda definisikan di konfigurasi plugin, terlepas dari skema database yang sebenarnya. AI menggunakan relasi ini untuk memahami bagaimana tabel bisa di-join, bahkan ketika tidak ada constraint foreign key di database.


Kapan Menggunakan Virtual Foreign Key

Gunakan virtual foreign key ketika:

  • Tabel-tabel berelasi melalui kolom yang sama, tetapi tidak ada constraint FOREIGN KEY yang didefinisikan di database.
  • Tabel-tabel berada di schema yang berbeda dan tidak bisa memiliki constraint FK bawaan.
  • Database dirancang tanpa constraint integritas referensial demi alasan performa.
  • Anda ingin AI secara andal menemukan jalur JOIN yang sebaliknya bisa terlewat atau ditebak dengan salah.

Tanpa virtual foreign key, AI menyimpulkan relasi hanya dari nama kolom dan deskripsi. Definisi FK yang eksplisit menghasilkan pembuatan JOIN yang lebih andal dan konsisten.


Mendefinisikan Virtual Foreign Key

Buka konfigurasi skema, buka sebuah tabel, lalu buka kolom yang ingin Anda hubungkan. Di bagian Foreign Key, atur:

FieldDeskripsi
Referenced TableNama tabel yang dirujuk oleh kolom ini.
Referenced ColumnKolom di tabel yang dirujuk yang nilainya cocok dengan kolom ini.

Contoh: Kolom customer_id di tabel orders merujuk ke kolom id di tabel customers.

Contoh peta FK untuk skema e-commerce

TabelKolomReferenced TableReferenced Column
orderscustomer_idcustomersid
order_linesorder_idordersid
order_linesproduct_idproductsid
invoicesorder_idordersid

Bagaimana Virtual Foreign Key Memengaruhi Pembuatan Query

AI menggunakan peta FK untuk membangun kondisi JOIN secara otomatis ketika sebuah pertanyaan melibatkan beberapa tabel.

Tanpa FK yang didefinisikan, pertanyaan seperti "Tampilkan semua order untuk pelanggan Arjuna" mengharuskan AI menebak kondisi join-nya. Dengan FK yang didefinisikan, AI secara konsisten menghasilkan:

SELECT o.*
FROM orders o
JOIN customers c ON o.customer_id = c.id
WHERE c.name = 'Arjuna'

Semakin lengkap peta FK Anda, semakin sedikit error JOIN yang akan Anda lihat di panel pengujian query.


Keterbatasan

  • Virtual foreign key adalah petunjuk bagi AI; FK ini tidak ditegakkan saat query dieksekusi.
  • Definisikan FK hanya antara tabel-tabel yang keduanya sudah disertakan dalam konfigurasi skema.
  • Referensi FK melingkar (A → B → A) bisa menghasilkan jalur JOIN yang ambigu.

Halaman Terkait