Tabella
La definizione di una singola entità di dati, delle sue colonne e dei suoi indici, memorizzata tramite un driver di database collegabile.
Una Tabella definisce una singola entità di dati: le sue colonne, gli indici usati per cercare le righe e quale driver di database la memorizza. A differenza di un programma, una Tabella non ha workflow, eventi né interfaccia: il suo schema è l'intero contratto. Ogni lettura e scrittura in un'app Xuda punta prima o poi a una Tabella tramite un programma Leggi dati, Imposta dati, Batch o l'origine dati di un Componente.
Proprietà
La tabella si trova sotto studio_meta.parentId: "database" (o una cartella annidata al suo interno).
tableFields
Una tabella chiamata "ORD - Orders" prefissa ogni colonna: ORD_Id, ORD_Total, ORD_Status. Mantiene non ambigui i nomi dei campi quando più tabelle compaiono nella stessa espressione ed è la convenzione che segue ogni tabella esistente in un progetto.
tableIndexes
Una tabella ha bisogno di almeno un campo prima di poter avere un indice. Un indice è obbligatorio solo per le tabelle su un driver di database non nativo: il motore proprio della piattaforma (@xuda.io/xuda-dbs-plugin-xuda) accetta una tabella senza indici, anche se in pratica ogni tabella che un Componente o un programma set_data può associare a un singolo record ha bisogno di un indice univoco <TBL>_Id per farlo.
Usare una tabella
- Leggere o scrivere una riga: il
progDataSource.dataSourceTableIddi un programma Leggi dati, Imposta dati o Batch indica il_iddi questa tabella. - Associare direttamente un Componente: la stessa coppia
dataSourceTableId/dataSourceIndexId, incorporata nel Componente invece che in un programma separato. - Da uno script:
xu.dbs_create,xu.dbs_read,xu.dbs_update,xu.dbs_delete, chiamati con il_iddella tabella, mai con il suo nome.
Esempio pratico
Modella le colonne
Una tabella per entità, un prefisso di 3 lettere per tabella: STU_Student_Id, STU_Full_Name.
Aggiungi un indice univoco sull'id
Dai a ogni tabella un indice univoco sul suo campo <TBL>_Id. I Componenti che associano un singolo record per chiave, e i programmi set_data in modalità aggiornamento o eliminazione, risolvono la riga di destinazione tramite questo indice.
Punta un'origine dati verso di essa
Il dataSourceTableId di un programma Leggi dati o Imposta dati indica il _id di questa tabella; dataSourceIndexId indica uno degli id in tableIndexes.
Sotto Database nell'albero di Studio, aggiungi una tabella, poi aggiungi righe alla sua griglia Campi (id, tipo, obbligatorio) e alla sua griglia Indici (nome, chiavi, univoco). La scheda Dati sullo stesso nodo mostra e modifica direttamente le righe.
Una tabella non ha una forma sorgente .xu: i progetti xuda-cli la dichiarano invece come file .table.json5 (questo è quel file, mostrato come JSON).