Sari la conținut
Verificat

Tabel

Definiția unei entități de date, coloanele și indecșii ei, stocate printr-un driver de bază de date interschimbabil.

Un Tabel definește o entitate de date: coloanele ei, indecșii folosiți pentru a găsi rânduri și ce driver de bază de date o stochează. Spre deosebire de un program, un Tabel nu poartă workflow, evenimente sau interfață, schema lui este tot contractul. Fiecare citire și scriere dintr-o aplicație Xuda ajunge, în cele din urmă, la un Tabel printr-o sursă de date Get Data, Set Data, Batch sau Component.

Proprietăți

Tabelul se află sub studio_meta.parentId: "database" (sau un folder imbricat sub el).

tableFields

Prefixează coloanele cu un cod de tabel

Un tabel numit „ORD - Orders" prefixează fiecare coloană: ORD_Id, ORD_Total, ORD_Status. Păstrează numele câmpurilor fără ambiguitate odată ce mai multe tabele apar în aceeași expresie și este convenția pe care o urmează fiecare tabel existent dintr-un proiect.

tableIndexes

Un tabel are nevoie de cel puțin un câmp înainte să poată purta un index. Un index este obligatoriu doar pentru tabelele de pe un driver de bază de date non-nativ; motorul propriu al platformei (@xuda.io/xuda-dbs-plugin-xuda) acceptă un tabel fără niciun index, deși, în practică, orice tabel pe care o componentă sau un program set_data îl poate lega la o singură înregistrare are nevoie de un index unic <TBL>_Id ca s-o facă.

Folosirea unui tabel

  • Citește sau scrie un rând: progDataSource.dataSourceTableId al unui program Get Data, Set Data sau Batch numește _id-ul acestui tabel.
  • Leagă direct o componentă: aceeași pereche dataSourceTableId / dataSourceIndexId, încorporată în componentă, în loc de un program separat.
  • Dintr-un script: xu.dbs_create, xu.dbs_read, xu.dbs_update, xu.dbs_delete, apelate cu _id-ul tabelului, niciodată cu numele lui.

Exemplu lucrat

Modelează coloanele

Un tabel pentru fiecare entitate, un prefix de 3 litere pentru fiecare tabel: STU_Student_Id, STU_Full_Name.

Adaugă un index unic pe id

Dă fiecărui tabel un index unic pe câmpul lui <TBL>_Id. Componentele care leagă o singură înregistrare după cheie și programele set_data în modul update sau delete rezolvă rândul țintă prin acest index.

Îndreaptă o sursă de date spre el

dataSourceTableId al unui program Get Data sau Set Data numește _id-ul acestui tabel; dataSourceIndexId numește unul dintre id-urile din tableIndexes.

Sub Bază de date în arborele Studio, adaugă un tabel, apoi adaugă rânduri în grila lui Câmpuri (id, tip, obligatoriu) și în grila Indecși (nume, chei, unic). Fila Date de pe același nod arată și editează rândurile direct.

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

Un tabel nu are o formă sursă .xu, proiectele xuda-cli îl declară în schimb ca fișier .table.json5 (acesta este acel fișier, afișat ca 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"] } }
  ]
}