Vai al contenuto
Verificata

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

Prefissa le colonne con un codice di tabella

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.dataSourceTableId di un programma Leggi dati, Imposta dati o Batch indica il _id di 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 _id della 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.

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

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).

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