• Bahasa Indonesia

      • Doris

      Data Source: External DorisEnterprise Edition+

      Pengenalan

      Doris dapat dihubungkan ke NocoBase sebagai database eksternal. Setelah terhubung, NocoBase akan membaca tabel data, field, dan view di Doris, lalu menggunakannya sebagai tabel data dalam sumber data eksternal.

      Doris lebih cocok untuk kueri analitik, detail tabel lebar, statistik metrik, dan tampilan laporan. Berbeda dari database transaksional, Doris tidak cocok digunakan sebagai sumber data untuk menambah, mengedit, dan menghapus catatan bisnis secara sering di NocoBase.

      Item konfigurasiDeskripsi
      Versi yang didukungDoris >= 2.1.0.
      Versi komersialDidukung dalam edisi Enterprise.
      Plugin terkait@nocobase/plugin-data-source-external-doris.
      Metode koneksiMenggunakan port Doris yang kompatibel dengan MySQL, yaitu FE query_port.
      Rekomendasi penggunaanTerutama untuk melihat, memfilter, membuat statistik, dan menampilkan laporan.

      Skenario yang cocok untuk menggunakan Doris eksternal:

      • Menghubungkan tabel detail, tabel agregat, tabel lebar, atau tabel metrik dari data warehouse
      • Membangun dasbor operasional, laporan statistik, atau halaman kueri di NocoBase
      • Menyediakan akses kueri hanya-baca bagi pengguna bisnis dan mengurangi kebutuhan untuk mengakses klien database secara langsung
      • Menerapkan kontrol akses dan tampilan visual untuk data Doris yang sudah ada
      Perhatian

      Doris disarankan digunakan sebagai sumber data analitik hanya-baca di NocoBase. Jangan menggunakannya sebagai sumber data penulisan untuk tabel bisnis biasa, dan juga tidak disarankan mengonfigurasi operasi penambahan, pengeditan, atau penghapusan di halaman.

      Instalasi plugin

      Plugin ini merupakan plugin komersial. Untuk mengetahui cara aktivasinya secara terperinci, lihat Panduan aktivasi plugin komersial

      Menambahkan sumber data

      Di 「Manajemen sumber data」, klik 「Add new」, pilih Doris, lalu isi informasi koneksi. 20260709211333

      Konfigurasi koneksi yang umum adalah sebagai berikut:

      KonfigurasiDeskripsi
      Data source nameNama identifikasi sumber data yang digunakan sebagai referensi dalam blok halaman, izin, alur kerja, dan API. Tidak dapat diubah setelah dibuat.
      Data source display nameNama sumber data yang ditampilkan di antarmuka. Sebaiknya gunakan nama yang mudah dipahami pengguna bisnis, seperti 「Doris data warehouse」 atau 「Pustaka metrik」.
      Host / PortAlamat Doris FE dan port yang kompatibel dengan MySQL, yaitu query_port. Jangan isi port HTTP.
      DatabaseNama database Doris yang akan dihubungkan.
      Username / PasswordNama pengguna dan kata sandi untuk menghubungkan ke Doris. NocoBase hanya dapat membaca objek yang dapat diakses oleh akun ini, dan tidak akan memberikan izin atau membaca objek pribadi akun lain.
      Table prefixPrefiks nama tabel. Setelah dikonfigurasi, NocoBase hanya membaca tabel data yang sesuai dengan prefiks tersebut dan membuat nama tabel tanpa prefiks di NocoBase.
      Enabled the data sourceMenentukan apakah sumber data ini diaktifkan. Setelah dinonaktifkan, konfigurasi sumber data tetap dipertahankan, tetapi blok halaman, izin, alur kerja, dan API tidak dapat lagi membaca datanya.
      Tips

      Plugin Doris terhubung melalui protokol yang kompatibel dengan MySQL. Sebelum melakukan konfigurasi, pastikan query_port Doris FE dapat diakses dari NocoBase dan akun tersebut memiliki izin untuk membaca metadata database, tabel, dan kolom target.

      Cakupan koneksi

      Halaman Doris tidak menyediakan tabel pilihan 「Collections」. Cakupan koneksi terutama dikendalikan oleh Database, izin akun koneksi, dan Table prefix.

      Jika terdapat banyak tabel di Doris, sebaiknya siapkan database, akun, atau prefiks nama tabel khusus untuk NocoBase agar hanya tabel yang perlu dilihat dan dianalisis oleh aplikasi saat ini yang terekspos.

      Perhatian

      Satu sumber data eksternal dapat menghubungkan maksimal 500 tabel data atau view sekaligus. Jika terdapat banyak objek di Doris, sebaiknya persempit cakupan terlebih dahulu melalui database, izin akun, atau Table prefix.

      Sinkronisasi dan konfigurasi field

      Struktur tabel Doris dikelola di sisi database. NocoBase tidak akan membuat field, mengubah tipe field, atau menghapus field sebenarnya di Doris eksternal.

      Saat struktur tabel di sisi Doris berubah, Anda dapat menjalankan 「Sync from database」 di sumber data untuk membaca ulang metadata tabel dan field. Sinkronisasi akan memperbarui informasi tabel data, field, kunci utama, kunci unik, dan pemetaan tipe field yang tersimpan di NocoBase, tetapi tidak akan menghapus tabel atau data sebenarnya di Doris.

      Setelah field disinkronkan, Anda dapat mengonfigurasi judul field, tipe field (Field type), dan komponen field (Field interface) di NocoBase. Jika perlu membuat field relasi NocoBase, metadata relasi juga disimpan di NocoBase dan tidak akan otomatis menambahkan field foreign key sebenarnya ke tabel Doris.

      Pemetaan tipe field

      NocoBase memetakan tipe field Doris berdasarkan logika yang kompatibel dengan MySQL dan tipe khusus Doris ke Field type dan Field interface yang sesuai. Anda dapat menyesuaikan cara tampilan antarmuka dalam konfigurasi field.

      Pemetaan umum adalah sebagai berikut:

      Tipe field DorisNocoBase Field typeField interface yang tersedia
      TINYINT、SMALLINTinteger、boolean、sortInteger、Sort、Checkbox、Switch、Select、Radio group。
      INT、INTEGERinteger、unixTimestamp、sortInteger、Sort、Unix timestamp、Select、Radio group。
      BIGINTbigInt、unixTimestamp、sortInteger、Sort、Unix timestamp、Created at、Updated at。
      LARGEINTbigIntInteger。
      FLOATfloat、sortNumber、Percent、Sort。
      DOUBLEdouble、sortNumber、Percent、Sort。
      DECIMAL、DECIMALV3decimalNumber、Percent、Currency。
      BOOLEANbooleanCheckbox、Switch。
      CHARstringInput、Email、Phone。
      VARCHARstring、uuid、nanoid、encryptionInput、Email、Phone、Password、Color、Icon、Select、Radio group、UUID、Nano ID。
      TEXT、STRINGtextTextarea、Markdown、Vditor、Rich text、URL。
      DATE、DATEV2dateDate。
      DATETIME、DATETIMEV2datetimeDate、Time、Created at、Updated at。
      JSON、JSONBjsonJSON。
      HLL、BITMAP、QUANTILE_STATE、AGG_STATEjsonJSON。
      VARIANT、ARRAY、MAP、STRUCTjsonJSON。
      IPV4、IPV6stringInput。

      VARIANT adalah tipe dinamis yang tersedia sejak Apache Doris 2.1.0. Saat menggunakan Doris versi di bawah 2.1.0, field jenis ini tidak dapat dihubungkan.

      Perhatian

      Tipe status agregasi, tipe semi-terstruktur, dan tipe kompleks di Doris lebih cocok untuk ditampilkan atau digunakan untuk debugging, dan belum tentu cocok sebagai field input formulir. Jika menemukan tipe kompleks, sebaiknya siapkan view atau tabel detail yang lebih sesuai untuk dilihat oleh pengguna bisnis di sisi Doris, lalu hubungkan ke NocoBase.

      Kunci utama dan pengenal unik catatan

      Model data dan model kunci Doris tidak selalu sama dengan pengenal unik bisnis. Untuk tabel data yang digunakan dalam tampilan blok halaman, tetap disarankan menyiapkan field yang dapat mengidentifikasi catatan secara unik.

      Jika yang dihubungkan adalah tabel atau view tanpa field unik, Anda perlu mengatur 「Record unique key」 secara manual dalam konfigurasi tabel data. Jika tidak ada pengenal unik yang tersedia, blok halaman mungkin tidak dapat menampilkan detail catatan dengan benar dan juga tidak cocok untuk dikonfigurasi dengan operasi pengeditan atau penghapusan.

      20260709211439 20260709211454

      Tautan terkait