• Bahasa Indonesia

      • MariaDB

      Data Source: External MariaDBStandard Edition+

      Pendahuluan

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

      Berbeda dengan basis data utama, struktur tabel sebenarnya pada MariaDB eksternal tetap dikelola oleh sistem bisnis asli, klien basis data, atau skrip migrasi. NocoBase bertanggung jawab membaca struktur, menyimpan metadata field, serta mengonfigurasi blok halaman, izin, workflow, dan API.

      Item konfigurasiDeskripsi
      Versi yang didukungMariaDB >= 10.3.
      Versi komersialDidukung oleh edisi Standar, Profesional, dan Enterprise.
      Plugin terkait@nocobase/plugin-data-source-external-mariadb.
      Protokol yang kompatibelMenggunakan protokol MySQL untuk koneksi, dan pemetaan field secara keseluruhan mengikuti logika yang kompatibel dengan MySQL.

      Skenario yang sesuai untuk menggunakan MariaDB eksternal:

      • Menghubungkan basis data MariaDB dari sistem bisnis seperti ERP, MES, WMS, dan CRM yang sudah ada
      • Membangun antarmuka manajemen dengan NocoBase tanpa memigrasikan data historis
      • Menerapkan kontrol izin, pemrosesan alur, koreksi data, atau menampilkan laporan untuk tabel yang sudah ada
      • Struktur basis data tetap dikelola oleh DBA, skrip migrasi, atau sistem asli
      Perhatian

      MariaDB eksternal bukan basis data sistem NocoBase. NocoBase tidak akan mengambil alih pencadangan, pemulihan, migrasi, atau perubahan struktur tabelnya.

      Pemasangan plugin

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

      Menambahkan sumber data

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

      20260709204413

      Konfigurasi koneksi yang umum adalah sebagai berikut:

      KonfigurasiDeskripsi
      Data source nameNama identifikasi sumber data, yang digunakan untuk merujuknya dalam blok halaman, izin, workflow, dan API. Tidak dapat diubah setelah dibuat.
      Data source display nameNama sumber data yang ditampilkan di antarmuka. Disarankan menggunakan nama yang mudah dipahami oleh staf bisnis, seperti 「ERP MariaDB」 atau 「Basis data pesanan」.
      Host / PortAlamat host dan port MariaDB. Port default biasanya adalah 3306.
      DatabaseNama basis data MariaDB yang akan dihubungkan.
      Username / PasswordNama pengguna dan kata sandi untuk terhubung ke MariaDB. NocoBase hanya dapat membaca objek yang dapat diakses oleh akun ini, dan tidak akan memberikan izin atau membaca objek pribadi akun lain.
      Table prefixAwalan nama tabel. Setelah dikonfigurasi, NocoBase hanya akan membaca tabel data dan view yang cocok dengan awalan tersebut, lalu membuat nama tabel tanpa awalan di NocoBase.
      Collections / Add all collectionsMengontrol cakupan koneksi. Saat 「Add all collections」 diaktifkan, NocoBase akan menghubungkan semua tabel dan view dalam cakupan saat ini; jika dinonaktifkan, hanya objek yang dicentang di 「Collections」 yang akan dihubungkan.
      Enabled the data sourceMenentukan apakah sumber data ini diaktifkan. Setelah dinonaktifkan, konfigurasi sumber data tetap dipertahankan, tetapi blok halaman, izin, workflow, dan API tidak dapat lagi membaca datanya.
      Tips

      Jika terdapat banyak objek di MariaDB, prioritaskan penyempitan cakupan melalui Database, Table prefix, dan 「Collections」. Hubungkan hanya tabel dan view yang akan digunakan aplikasi saat ini agar konfigurasi izin, pembuatan halaman, dan pemeliharaan sinkronisasi berikutnya menjadi lebih ringan.

      Memilih tabel data

      Setelah mengisi informasi koneksi, Anda dapat mengeklik 「Load Collections」 untuk membaca tabel data dan view yang tersedia di MariaDB. Hasil pembacaan dipengaruhi oleh akun koneksi, Database, Table prefix, dan konfigurasi 「Collections」.

      Secara default, 「Add all collections」 akan diaktifkan, yang berarti semua tabel dan view dalam cakupan saat ini akan dihubungkan. Jika hanya ingin menghubungkan sebagian objek, nonaktifkan 「Add all collections」, lalu centang tabel data atau view yang diperlukan dalam daftar.

      20260709204452

      Perhatian

      Satu sumber data eksternal dapat menghubungkan paling banyak 500 tabel data atau view sekaligus. Jika terdapat banyak objek di MariaDB, disarankan untuk terlebih dahulu mempersempit cakupan melalui Database, Table prefix, atau 「Collections」.

      Sinkronisasi dan konfigurasi field

      Struktur tabel MariaDB eksternal dikelola di sisi basis data. NocoBase tidak akan membuat field, mengubah tipe field, atau menghapus field sebenarnya di MariaDB eksternal.

      Jika struktur tabel di sisi MariaDB berubah, Anda dapat menjalankan 「Sync from database」 di sumber data untuk membaca ulang metadata tabel dan field. Sinkronisasi akan memperbarui informasi tabel data, field, primary key, unique key, dan pemetaan tipe field yang disimpan di NocoBase, tetapi tidak akan menghapus tabel atau data sebenarnya di MariaDB.

      Setelah sinkronisasi field, 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 secara otomatis menambahkan field foreign key sebenarnya ke tabel MariaDB.

      Pemetaan tipe field

      NocoBase akan secara otomatis memetakan tipe field MariaDB ke Field type dan Field interface yang sesuai. Pemetaan field umum MariaDB pada dasarnya sama dengan MySQL. Anda dapat menyesuaikan cara tampilnya di antarmuka melalui konfigurasi field.

      Pemetaan umum adalah sebagai berikut:

      Tipe field MariaDBNocoBase Field typeField interface yang tersedia
      TINYINT、SMALLINT、MEDIUMINTinteger、boolean、sortInteger、Sort、Checkbox、Switch、Select、Radio group。
      INT、INTEGERinteger、unixTimestamp、sortInteger、Sort、Unix timestamp、Select、Radio group。
      BIGINTbigInt、snowflakeId、unixTimestamp、sortInteger、Sort、Unix timestamp、Created at、Updated at。
      FLOAT、DOUBLEfloatNumber、Percent。
      DECIMALdecimalNumber、Percent、Currency。
      CHAR、VARCHARstring、uuid、nanoid、encryptionInput、Email、Phone、Password、Color、Icon、Select、Radio group、UUID、Nano ID。
      TINYTEXT、TEXT、MEDIUMTEXT、LONGTEXTtextTextarea、Markdown、Vditor、Rich text、URL。
      DATEdateOnlyDate。
      TIMEtimeTime。
      DATETIMEdatetimeNoTz、datetimeTz、dateDate、Time、Created at、Updated at。
      TIMESTAMPdatetimeTz、dateDate、Time、Created at、Updated at。
      YEARstring、integerInput、Integer、Date。
      JSONjson、arrayJSON。
      Perhatian

      Tipe field MariaDB yang tidak didukung akan ditampilkan secara terpisah dalam konfigurasi field. Field tersebut perlu diadaptasi oleh pengembang sebelum dapat digunakan sebagai field biasa di NocoBase.

      Primary key dan identifikasi unik record

      Untuk tabel data yang digunakan untuk menampilkan dan mengedit blok halaman, disarankan untuk memiliki primary key atau field unik. NocoBase akan memprioritaskan primary key sebagai identifikasi unik record.

      Jika yang dihubungkan adalah view, tabel tanpa primary key, atau tabel dengan composite primary key, Anda perlu mengatur 「Record unique key」 secara manual dalam konfigurasi tabel data. Jika tidak ada identifikasi unik yang tersedia, blok halaman mungkin tidak dapat melihat, mengedit, atau menghapus record dengan benar.

      20260709205835 20260709205854

      Tautan terkait