#Harici Veritabanı

#Giriş

Mevcut harici veritabanlarını veri kaynağı olarak kullanabilirsiniz. Şu anda desteklenen harici veritabanları arasında MySQL, MariaDB, PostgreSQL, MSSQL ve Oracle bulunmaktadır.

#Kullanım Talimatları

#Harici Veritabanı Ekleme

Eklentiyi etkinleştirdikten sonra, veri kaynağı yönetimindeki "Yeni ekle" açılır menüsünden seçerek ekleyebilirsiniz.

Bağlanmak istediğiniz veritabanı bilgilerini doldurun.

#Koleksiyon Senkronizasyonu

Harici bir veritabanıyla bağlantı kurulduktan sonra, veri kaynağındaki tüm koleksiyonlar doğrudan okunacaktır. Harici veritabanları, doğrudan koleksiyon eklemeyi veya tablo yapısını değiştirmeyi desteklemez. Eğer değişiklik yapmanız gerekirse, bunları bir veritabanı istemcisi aracılığıyla gerçekleştirebilir ve ardından arayüzdeki "Yenile" düğmesine tıklayarak senkronize edebilirsiniz.

#Alanları Yapılandırma

Harici veritabanı, mevcut koleksiyonların alanlarını otomatik olarak okuyacak ve gösterecektir. Alanın başlığını, veri tipini (Field type) ve UI tipini (Field interface) hızlıca görüntüleyebilir ve yapılandırabilirsiniz. Ayrıca, daha fazla yapılandırma yapmak için "Düzenle" düğmesine tıklayabilirsiniz.

Harici veritabanları tablo yapısını değiştirmeyi desteklemediği için, yeni bir alan eklerken seçilebilecek tek tür ilişki alanıdır. İlişki alanları gerçek alanlar değildir; koleksiyonlar arasında bağlantı kurmak için kullanılırlar.

Daha fazla bilgi için Koleksiyon Alanları/Genel Bakış bölümüne bakabilirsiniz.

#Alan Tipi Eşleştirme

NocoBase, harici veritabanındaki alan tiplerini otomatik olarak karşılık gelen veri tipine (Field type) ve UI tipine (Field Interface) eşleştirir.

• Veri tipi (Field type): Bir alanın depolayabileceği verinin türünü, formatını ve yapısını tanımlamak için kullanılır;
• UI tipi (Field interface): Kullanıcı arayüzünde alan değerlerini görüntülemek ve girmek için kullanılan kontrol türünü ifade eder.

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
CIRCLE		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	-	-	-

#Desteklenmeyen Alan Tipleri

Desteklenmeyen alan tipleri ayrı olarak gösterilir. Bu alanlar, kullanılabilmeleri için geliştirme adaptasyonu gerektirir.

#Filtre Hedef Anahtarı

Blok olarak gösterilen koleksiyonların bir Filtre hedef anahtarı (Filter target key) yapılandırılmış olması gerekir. Filtre hedef anahtarı, belirli bir alana göre verileri filtrelemek için kullanılır ve alan değeri benzersiz olmalıdır. Varsayılan olarak, filtre hedef anahtarı koleksiyonun birincil anahtar alanıdır. Görünümler, birincil anahtarı olmayan koleksiyonlar veya bileşik birincil anahtara sahip koleksiyonlar için özel bir filtre hedef anahtarı tanımlamanız gerekir.

Yalnızca filtre hedef anahtarı yapılandırılmış koleksiyonlar sayfaya eklenebilir.