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

טבלה

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

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

מאפיינים

הטבלה נמצאת תחת studio_meta.parentId: "database" (או תיקייה מקוננת תחתיו).

tableFields

מוסיפים לעמודות קידומת של קוד הטבלה

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

tableIndexes

טבלה צריכה לפחות שדה אחד לפני שאפשר לתת לה אינדקס. אינדקס עצמו הוא חובה רק לטבלאות על דרייבר מסד נתונים לא מקורי, המנוע של הפלטפורמה עצמה (@xuda.io/xuda-dbs-plugin-xuda) מקבל טבלה בלי אינדקסים בכלל, אם כי בפועל כל טבלה שרכיב או תוכנית set_data יכולים לקשור לרשומה בודדת צריכה אינדקס <TBL>_Id ייחודי כדי לעשות זאת.

שימוש בטבלה

  • קריאה או כתיבה של שורה: ה-progDataSource.dataSourceTableId של תוכנית קבלת נתונים, שמירת נתונים או אצווה מציין את ה-_id של הטבלה הזאת.
  • קישור ישיר של רכיב: אותו זוג dataSourceTableId / dataSourceIndexId, מוטמע ברכיב במקום בתוכנית נפרדת.
  • מסקריפט: xu.dbs_create, xu.dbs_read, xu.dbs_update, xu.dbs_delete, שנקראות עם ה-_id של הטבלה, ולעולם לא עם שמה.

דוגמת עבודה

למדל את העמודות

טבלה אחת לכל ישות, קידומת אחת בת 3 אותיות לכל טבלה: STU_Student_Id, STU_Full_Name.

להוסיף אינדקס ייחודי על המזהה

נותנים לכל טבלה אינדקס ייחודי על השדה <TBL>_Id שלה. רכיבים שקושרים רשומה בודדת לפי מפתח, ותוכניות set_data במצב עדכון או מחיקה, מאתרים את שורת היעד דרך האינדקס הזה.

להפנות מקור נתונים אליה

ה-dataSourceTableId של תוכנית קבלת נתונים או שמירת נתונים מציין את ה-_id של הטבלה הזאת; dataSourceIndexId מציין אחד מהמזהים ב-tableIndexes.

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

json
{
  "id": "student_profiles_table",
  "menuTitle": "Student Profiles Table",
  "fields": [
    { "field_id": "student_id", "type": "string" },
    { "field_id": "full_name", "type": "string" },
    { "field_id": "campus", "type": "string" }
  ],
  "indexes": [
    { "id": "student_idx", "name": "Student", "keys": ["student_id"] },
    { "id": "campus_idx", "name": "Campus", "keys": ["campus"] }
  ]
}

לטבלה אין צורת מקור .xu, פרויקטים של xuda-cli מצהירים עליה כקובץ .table.json5 במקום (זה הקובץ הזה, מוצג כ-JSON).

json
{
  "properties": {
    "menuType": "table",
    "menuName": "STU - Students",
    "databaseSocket": "@xuda.io/xuda-dbs-plugin-xuda"
  },
  "tableFields": [
    { "id": "b2c3d4e5-…", "data": { "field_id": "STU_Student_Id" }, "props": { "fieldType": "string", "mandatory": true } },
    { "id": "c3d4e5f6-…", "data": { "field_id": "STU_Full_Name" }, "props": { "fieldType": "string", "mandatory": true } }
  ],
  "tableIndexes": [
    { "id": "a1b2c3d4-…", "data": { "name": "Index_0", "unique": true, "keys": ["STU_Student_Id"] } }
  ]
}