#מסד נתונים חיצוני

#מבוא

השתמשו במסד נתונים חיצוני קיים כמקור נתונים. נכון לעכשיו, מסדי הנתונים החיצוניים הנתמכים כוללים את MySQL, MariaDB, PostgreSQL, MSSQL ו-Oracle.

#הוראות שימוש

#הוספת מסד נתונים חיצוני

לאחר הפעלת התוסף, תוכלו לבחור ולהוסיף אותו מתפריט ה'הוספה חדשה' (Add new) בניהול מקורות הנתונים.

מלאו את פרטי מסד הנתונים שאליו תרצו להתחבר.

#סנכרון אוספים

לאחר יצירת חיבור למסד נתונים חיצוני, כל האוספים בתוך מקור הנתונים ייקראו באופן ישיר. מסדי נתונים חיצוניים אינם תומכים בהוספת אוספים או בשינוי מבנה הטבלה ישירות. אם יש צורך בשינויים, תוכלו לבצע אותם באמצעות לקוח מסד נתונים, ולאחר מכן ללחוץ על כפתור ה'רענן' (Refresh) בממשק כדי לסנכרן.

#הגדרת שדות

מסד הנתונים החיצוני יקרא ויציג באופן אוטומטי את השדות של האוספים הקיימים. תוכלו לצפות במהירות ולהגדיר את כותרת השדה, סוג הנתונים (Field type) וסוג ממשק המשתמש (Field interface). כמו כן, תוכלו ללחוץ על כפתור ה'עריכה' (Edit) כדי לשנות הגדרות נוספות.

מכיוון שמסדי נתונים חיצוניים אינם תומכים בשינוי מבנה הטבלה, סוג השדה היחיד הזמין בעת הוספת שדה חדש הוא שדה יחס (association field). שדות יחס אינם שדות ממשיים, אלא משמשים ליצירת חיבורים בין אוספים.

לפרטים נוספים, עיינו בפרק שדות אוסף/סקירה כללית.

#מיפוי סוגי שדות

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). מפתח יעד לסינון משמש לסינון נתונים על בסיס שדה ספציפי, וערך השדה חייב להיות ייחודי. כברירת מחדל, מפתח יעד לסינון הוא שדה המפתח הראשי של האוסף. עבור תצוגות, אוספים ללא מפתח ראשי, או אוספים עם מפתח ראשי מורכב, עליכם להגדיר מפתח יעד לסינון מותאם אישית.

רק אוספים שהוגדר עבורם מפתח יעד לסינון ניתנים להוספה לדף.