דילוג לתוכן
אומת

טבלאות ושדות

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

טבלה מוגדרת פעם אחת, ב-Xuda Studio, וכל מקום שמציג את הנתונים שלה, הרשת ב-Studio, לשונית הנתונים בדשבורד, תוכנית קבלת נתונים או קריאת API ישירה, קורא את אותן הגדרות שדה.

מדריך הסכמה המלא

הדף הזה מכסה שדות כפי שפוגשים אותם בבניית טבלה ובעיון בה. לרשימת המאפיינים המלאה, לאינדקסים ולאופן שבו תוכנית קבלת נתונים או שמירת נתונים מצביעה על טבלה, ראו טבלה ב-Building Blocks.

שישה סוגי שדה, ושום דבר אחר

כל שדה בטבלה הוא בדיוק אחד משישה סוגים. Studio מציג כל אחד עם סמל משלו בכותרת הרשת ולא עם תג טקסט, כי עמודה צרה ומזהה שדה כמו ORD_Total כבר תופס את רוב הרוחב:

אין סוג שביעי, ואין דרך להוסיף סוג מותאם. שדה שלא מתאים לשישה האלה, בלוק טקסט עשיר, קובץ, קשר לטבלה אחרת, מעוצב כ-string (מזהה, נתיב, גוש מקודד ב-JSON) או כ-array/object שלהם. אין סוג עמודה נפרד מהשורה הראשונה לאף אחד מאלה בטבלה.

מה כל סוג עושה בפועל עם ערך

גם dbs_create וגם dbs_update ממירים את הערך שאתם שולחים דרך הסוג המוצהר של השדה לפני שהוא נשמר, ולכן כדאי לדעת בדיוק מה כל המרה עושה ולא להניח משמעות מוכרת:

string

כל מה שאינו כבר מחרוזת מומר בהמרה פשוטה למחרוזת. ערך ריק או חסר נשמר כ-"".

number

נשמר Number(value). ערך שלא מתפרש למספר סופי חוזר ל-0 ולא דוחה את הכתיבה. גם ערך ריק או חסר נשמר כ-0.

boolean

רק רשימה קבועה של אסימונים נקראת כ-true (Y, 1, true, TRUE, ON, YES), ורשימה קבועה אחרת כ-false (N, 0, false, FALSE, OFF, NO). כל דבר אחר, כולל ערך ריק, נשמר כ-false.

object

מחרוזת מפוענחת כ-JSON5. ערך שכבר בצורת אובייקט נשמר כמו שהוא. ערך ריק או חסר, או מחרוזת שלא מתפענחת, נשמרים כ-{}.

array

מחרוזת מפוענחת קודם כ-JSON5, ואם זה נכשל, מוערכת במקום זה כליטרל של JavaScript. ערך שכבר בצורת מערך נשמר כמו שהוא. ערך ריק או חסר, או מחרוזת ששני הפיענוחים לא מטפלים בה, נשמרים כ-[].

date

אין טיפול ייעודי בתאריך בדרך פנימה: כל מחרוזת שתשלחו נשמרת בדיוק כפי שנשלחה. בוחרים פורמט אחד. ISO 8601 (2026-09-25T00:00:00.000Z) הוא ברירת המחדל הבטוחה ביותר, כי שום דבר בפלטפורמה לא מנרמל בשבילכם שדה תאריך, וטבלה עם פורמטים מעורבים ממיינת ומסננת בצורה לא עקבית.

מספר אף פעם לא דוחה כתיבה

שליחת ערך שאי אפשר להפוך למספר תקין בשדה number לא מכשילה את הקריאה, אלא שומרת בשקט 0. מאמתים ערך מספרי בעצמכם לפני הכתיבה אם 0 יהיה שגוי.

מתן שמות לשדות

אין כלל מפורש למתן שמות מעבר לכך שמזהי שדות חייבים להיות ייחודיים בטבלה, אבל כל טבלה שכבר קיימת בפרויקט Xuda עוקבת אחרי מוסכמה אחת: מוסיפים לכל שדה קידומת של קוד קצר לטבלה עצמה, כך ש-ORD - Orders יוצר ORD_Id, ORD_Total, ORD_Status. זה שומר על שמות שדות חד-משמעיים כשצריך שחיפוש, ביטוי או קובץ ייבוא יתייחסו לכמה טבלאות בבת אחת.

סימון שדה כחובה

לשדה יש דגל חובה שקובעים כשמגדירים אותו, לצד הסוג וההערה שלו, כדי לציין ששורה לא אמורה להישמר בלי ערך שם.

לטבלאות יש מצב פעיל/בארכיון משלהן

בנפרד מכך ששורה בודדת מועברת לארכיון (מחיקה רכה, ראו שאילתות נתונים דרך ה-API), גם טבלה עצמה יכולה להיות פעילה או בארכיון בתור צומת ב-Studio. לשונית הנתונים בדשבורד מציגה את הטבלאות של פרויקט ככרטיסים, עם מעבר בין פעילים ובארכיון, וכל כרטיס מציג את שם הטבלה ואת מספר השורות הנוכחי שלה. העברת טבלה לארכיון כאן היא פעולה בצד של Studio על הצומת, והיא פעולה שונה מהעברת שורות בתוכה לארכיון.