Tabel
Definitionen af én dataentitet, dens kolonner og indekser, gemt gennem en udskiftelig databasedriver.
En Tabel definerer én dataentitet: dens kolonner, de indekser, der bruges til at slå rækker op, og hvilken databasedriver der gemmer den. I modsætning til et program bærer en Tabel ingen workflow, ingen hændelser og intet UI, dens skema er hele kontrakten. Hver læsning og skrivning i en Xuda-app peger til sidst på en Tabel gennem et Hent data-, Sæt data-, Batch- eller Komponent-datakilde.
Egenskaber
Tabellen ligger under studio_meta.parentId: "database" (eller en mappe indlejret under den).
tableFields
En tabel ved navn "ORD - Orders" giver hver kolonne et præfiks: ORD_Id, ORD_Total, ORD_Status. Det holder feltnavne entydige, når flere tabeller står i det samme udtryk, og det er den konvention, som hver eksisterende tabel i et projekt følger.
tableIndexes
En tabel skal have mindst ét felt, før den kan bære et indeks. Et indeks er kun obligatorisk for tabeller på en driver, der ikke er den oprindelige. Platformens egen motor (@xuda.io/xuda-dbs-plugin-xuda) accepterer en tabel uden indekser, men i praksis har hver tabel, som en Komponent eller et set_data-program kan binde til en enkelt post, brug for et entydigt <TBL>_Id-indeks for at gøre det.
Brug en tabel
- Læs eller skriv en række: et Hent data-, Sæt data- eller Batch-programs
progDataSource.dataSourceTableIdangiver denne tabels_id. - Bind en Komponent direkte: det samme par
dataSourceTableId/dataSourceIndexId, indlejret i Komponenten i stedet for i et separat program. - Fra et script:
xu.dbs_create,xu.dbs_read,xu.dbs_update,xu.dbs_delete, kaldt med tabellens_id, aldrig dens navn.
Eksempel
Modellér kolonnerne
Én tabel pr. entitet, ét præfiks på 3 bogstaver pr. tabel: STU_Student_Id, STU_Full_Name.
Tilføj et entydigt indeks på id'et
Giv hver tabel et entydigt indeks på sit <TBL>_Id-felt. Komponenter, der binder en enkelt post med nøgle, og set_data-programmer i opdaterings- eller sletningstilstand finder målrækken gennem dette indeks.
Peg en datakilde på den
Et Hent data- eller Sæt data-programs dataSourceTableId angiver denne tabels _id. dataSourceIndexId angiver et af id'erne i tableIndexes.
Under Database i Studio-træet tilføjer du en tabel og derefter rækker til dens gitter Felter (id, type, obligatorisk) og dens gitter Indekser (navn, nøgler, entydig). Fanen Data på den samme node viser og redigerer rækker direkte.
En tabel har ingen .xu-kildeform, xuda-cli-projekter erklærer den som en .table.json5-fil i stedet (det er den fil, vist som JSON).