Hoppa till innehållet
Verifierad

Tabell

Definitionen av en dataentitet, dess kolumner och index, lagrad via en utbytbar databasdrivrutin.

En tabell definierar en dataentitet: dess kolumner, indexen som används för att slå upp rader och vilken databasdrivrutin som lagrar den. Till skillnad från ett program har en tabell inget arbetsflöde, inga händelser och inget gränssnitt, dess schema är hela kontraktet. Varje läsning och skrivning i en Xuda-app pekar till slut på en tabell via en Hämta data-, Sätt data-, Batch- eller komponentdatakälla.

Egenskaper

Tabellen ligger under studio_meta.parentId: "database" (eller en mapp nästlad under den).

tableFields

Ge kolumnerna en tabellkod som prefix

En tabell som heter "ORD - Orders" ger varje kolumn ett prefix: ORD_Id, ORD_Total, ORD_Status. Det håller fältnamn entydiga när flera tabeller finns i samma uttryck, och det är konventionen som varje befintlig tabell i ett projekt följer.

tableIndexes

En tabell behöver minst ett fält innan den kan bära ett index. Ett index är bara obligatoriskt för tabeller på en icke-inbyggd databasdrivrutin, plattformens egen motor (@xuda.io/xuda-dbs-plugin-xuda) accepterar en tabell utan index, men i praktiken behöver varje tabell som en komponent eller ett set_data-program kan binda till en enskild post ett unikt <TBL>_Id-index för att göra det.

Att använda en tabell

  • Läsa eller skriva en rad: ett Hämta data-, Sätt data- eller Batch-programs progDataSource.dataSourceTableId namnger den här tabellens _id.
  • Binda en komponent direkt: samma par dataSourceTableId / dataSourceIndexId, inbäddat i komponenten i stället för i ett separat program.
  • Från ett skript: xu.dbs_create, xu.dbs_read, xu.dbs_update, xu.dbs_delete, anropade med tabellens _id, aldrig dess namn.

Genomgånget exempel

Modellera kolumnerna

En tabell per entitet, ett prefix på 3 bokstäver per tabell: STU_Student_Id, STU_Full_Name.

Lägg till ett unikt index på id:t

Ge varje tabell ett unikt index på dess <TBL>_Id-fält. Komponenter som binder en enskild post med nyckel, och set_data-program i uppdaterings- eller borttagningsläge, löser målraden genom det indexet.

Peka en datakälla på den

Ett Hämta data- eller Sätt data-programs dataSourceTableId namnger den här tabellens _id. dataSourceIndexId namnger ett av id:na i tableIndexes.

Under Databas i Studio-trädet lägger du till en tabell och sedan rader i dess rutnät Fält (id, typ, obligatoriskt) och dess rutnät Index (namn, nycklar, unik). Fliken Data på samma nod visar och redigerar rader direkt.

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"] }
  ]
}

En tabell har ingen .xu-källform, xuda-cli-projekt deklarerar den som en .table.json5-fil i stället (det här är den filen, visad som 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"] } }
  ]
}