#قاعدة البيانات الخارجية

#مقدمة

يمكنك استخدام قاعدة بيانات خارجية موجودة كمصدر للبيانات. تدعم NocoBase حاليًا قواعد البيانات الخارجية التالية: MySQL، MariaDB، PostgreSQL، MSSQL، و Oracle.

#تعليمات الاستخدام

#إضافة قاعدة بيانات خارجية

بعد تفعيل الإضافة، يمكنك اختيارها وإضافتها من القائمة المنسدلة "إضافة جديد" (Add new) في إدارة مصادر البيانات.

املأ معلومات قاعدة البيانات التي ترغب في ربطها.

#مزامنة المجموعات

بعد إنشاء اتصال بقاعدة بيانات خارجية، ستقوم NocoBase تلقائيًا بقراءة جميع المجموعات الموجودة في مصدر البيانات. لا تدعم قواعد البيانات الخارجية إضافة مجموعات أو تعديل هيكل الجداول بشكل مباشر. إذا كنت بحاجة إلى إجراء تعديلات، يمكنك القيام بذلك عبر عميل قاعدة البيانات، ثم النقر على زر "تحديث" (Refresh) في الواجهة للمزامنة.

#تهيئة الحقول

ستقوم قاعدة البيانات الخارجية تلقائيًا بقراءة وعرض حقول المجموعات الموجودة. يمكنك عرض وتهيئة عنوان الحقل، ونوع البيانات (Field type)، ونوع واجهة المستخدم (UI type) بسرعة. كما يمكنك النقر على زر "تعديل" (Edit) لتعديل المزيد من الإعدادات.

نظرًا لأن قواعد البيانات الخارجية لا تدعم تعديل هيكل الجداول، فإن النوع الوحيد المتاح عند إضافة حقل جديد هو حقل العلاقة. حقول العلاقة ليست حقولًا حقيقية، بل تُستخدم لإنشاء روابط بين المجموعات.

لمزيد من التفاصيل، راجع فصل حقول المجموعة/نظرة عامة.

#ربط أنواع الحقول

تقوم NocoBase تلقائيًا بربط أنواع الحقول من قاعدة البيانات الخارجية بأنواع البيانات (Field type) وأنواع واجهة المستخدم (Field Interface) المقابلة لها.

• نوع البيانات (Field type): يُستخدم لتحديد نوع البيانات التي يمكن للحقل تخزينها، بالإضافة إلى تنسيقها وهيكلها.
• نوع واجهة المستخدم (Field interface): يشير إلى نوع عنصر التحكم المستخدم في واجهة المستخدم لعرض قيم الحقول وإدخالها.

PostgreSQL	MySQL/MariaDB	نوع بيانات NocoBase	نوع واجهة NocoBase
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	-	-	-

#أنواع الحقول غير المدعومة

تُعرض أنواع الحقول غير المدعومة بشكل منفصل. تتطلب هذه الحقول تكييفًا تطويريًا قبل أن تتمكن من استخدامها.

#مفتاح تصفية الهدف

يجب أن تحتوي المجموعات التي تُعرض ككتل على مفتاح تصفية هدف (Filter target key) مهيأ. يشير مفتاح تصفية الهدف إلى تصفية البيانات بناءً على حقل معين، ويجب أن تكون قيمة الحقل فريدة. بشكل افتراضي، يكون مفتاح تصفية الهدف هو حقل المفتاح الأساسي للمجموعة. أما بالنسبة للعروض (views)، أو المجموعات التي لا تحتوي على مفتاح أساسي، أو المجموعات ذات المفتاح الأساسي المركب، فيجب عليك تحديد مفتاح تصفية هدف مخصص.

لا يمكن إضافة المجموعات التي تم تهيئة مفتاح تصفية الهدف لها إلا إلى الصفحة.