Database Eksternal

Pengantar

Menggunakan database eksternal yang sudah ada sebagai data source. Database eksternal yang saat ini didukung meliputi MySQL, MariaDB, PostgreSQL, MSSQL, Oracle.

Petunjuk Penggunaan

Menambahkan Database Eksternal

Setelah plugin diaktifkan, Anda dapat memilih dan menambahkannya melalui dropdown Add new pada manajemen data source.

20240507204316

Isi informasi database yang akan diintegrasikan

20240507204820

Sinkronisasi Collection

Setelah database eksternal terhubung, semua Collection di data source akan langsung dibaca. Database eksternal tidak mendukung penambahan Collection langsung atau modifikasi struktur tabel. Jika perlu modifikasi, dapat dioperasikan melalui database client, lalu klik tombol "Refresh" di antarmuka untuk sinkronisasi.

20240507204725

Konfigurasi Field

Database eksternal akan otomatis membaca field dari Collection yang sudah ada, dan menampilkannya. Anda dapat dengan cepat melihat dan mengonfigurasi judul field, tipe data (Field type), dan tipe UI (Field interface). Anda juga dapat mengklik tombol "Edit" untuk mengubah konfigurasi lebih lanjut.

20240507210537

Karena database eksternal tidak mendukung modifikasi struktur tabel, saat menambahkan field, hanya tipe field relasi yang dapat dipilih. Field relasi bukanlah field aktual, melainkan digunakan untuk membangun koneksi antar Collection.

20240507220140

Untuk lebih lanjut, lihat bagian Field Collection / Ikhtisar.

Pemetaan Tipe Field

NocoBase akan otomatis memetakan tipe data (Field type) dan tipe UI (Field Interface) yang sesuai untuk tipe field database eksternal.

Tipe Data (Field type): Digunakan untuk mendefinisikan jenis, format, dan struktur data yang dapat disimpan field;
Tipe UI (Field interface): Mengacu pada tipe kontrol yang digunakan untuk menampilkan dan menginput nilai field di antarmuka pengguna.

PostgreSQL	MySQL/MariaDB	NocoBase Data Type	NocoBase Interface Type
BOOLEAN	BOOLEAN TINYINT(1)	boolean	checkbox switch
SMALLINT INTEGER SERIAL SMALLSERIAL	TINYINT SMALLINT MEDIUMINT INTEGER	integer boolean sort	integer sort checkbox switch select radioGroup
BIGINT BIGSERIAL	BIGINT	bigInt sort	integer sort checkbox switch select radioGroup unixTimestamp createdAt updatedAt
REAL	FLOAT	float	number percent
DOUBLE PRECISION	DOUBLE PRECISION	double	number percent
DECIMAL NUMERIC	DECIMAL	decimal	number percent currency
VARCHAR CHAR	VARCHAR CHAR	string password uuid nanoid	input email phone password color icon select radioGroup uuid nanoid
TEXT	TEXT TINYTEXT MEDIUMTEXT LONGTEXT	text json	textarea markdown vditor richText url json
UUID	-	uuid	uuid
JSON JSONB	JSON	json	json
TIMESTAMP	DATETIME TIMESTAMP	date	date time createdAt updatedAt
DATE	DATE	dateOnly	datetime
TIME	TIME	time	time
-	YEAR		datetime
CIRCEL		circle	json circle
PATH GEOMETRY(LINESTRING)	LINESTRING	lineString	Json lineString
POINT GEOMETRY(POINT)	POINT	point	json point
POLYGON GEOMETRY(POLYGON)	POLYGON	polygon	json polygon
GEOMETRY	GEOMETRY	-	-
BLOB	BLOB	blob	-
ENUM	ENUM	enum	select radioGroup
ARRAY	-	array	multipleSelect checkboxGroup
BIT	BIT	-	-
SET	SET	set	multipleSelect checkboxGroup
RANGE	-	-	-

Tipe Field yang Tidak Didukung

Tipe field yang tidak didukung akan ditampilkan secara terpisah. Field-field ini perlu dikembangkan adaptasinya sebelum dapat digunakan.

20240507221854

Filter Target Key

Collection yang digunakan sebagai tampilan block harus mengonfigurasi Filter target key. Filter target key mengacu pada filter data berdasarkan field tertentu, dan nilai field harus memiliki keunikan. Filter target key secara default adalah field Primary Key Collection. Jika Collection adalah view atau Collection tanpa Primary Key, atau Collection dengan Primary Key gabungan, perlu mengkustomisasi filter target key.

20240507210230

Hanya Collection yang sudah diatur filter target key-nya yang dapat ditambahkan ke halaman

20240507222827

#Database Eksternal

#Pengantar

#Petunjuk Penggunaan

#Menambahkan Database Eksternal

#Sinkronisasi Collection

#Konfigurasi Field

#Pemetaan Tipe Field

#Tipe Field yang Tidak Didukung

#Filter Target Key