Tabla
La definición de una entidad de datos, sus columnas y sus índices, guardada mediante un controlador de base de datos enchufable.
Una Tabla define una entidad de datos: sus columnas, los índices que se usan para buscar filas y qué controlador de base de datos la guarda. A diferencia de un programa, una Tabla no tiene flujo de trabajo, ni eventos ni interfaz; su esquema es todo el contrato. Cada lectura y escritura de una app de Xuda acaba apuntando a una Tabla mediante un Get Data, un Set Data, un Batch o una fuente de datos de un componente.
Propiedades
La tabla está bajo studio_meta.parentId: "database" (o una carpeta anidada dentro).
tableFields
Una tabla llamada "ORD - Orders" antepone el prefijo a cada columna: ORD_Id, ORD_Total, ORD_Status. Mantiene los nombres de campo inequívocos cuando varias tablas están en la misma expresión, y es la convención que sigue cada tabla existente de un proyecto.
tableIndexes
Una tabla necesita al menos un campo antes de poder tener un índice. Un índice solo es obligatorio en tablas de un controlador de base de datos no nativo; el motor propio de la plataforma (@xuda.io/xuda-dbs-plugin-xuda) acepta una tabla con cero índices, aunque en la práctica toda tabla a la que un componente o un programa set_data pueda vincularse como un único registro necesita un índice único <TBL>_Id para hacerlo.
Usar una tabla
- Leer o escribir una fila: el
progDataSource.dataSourceTableIdde un programa Get Data, Set Data o Batch nombra el_idde esta tabla. - Vincular un componente directamente: el mismo par
dataSourceTableId/dataSourceIndexId, incrustado en el componente en lugar de en un programa aparte. - Desde un script:
xu.dbs_create,xu.dbs_read,xu.dbs_update,xu.dbs_delete, llamados con el_idde la tabla, nunca con su nombre.
Ejemplo práctico
Modela las columnas
Una tabla por entidad, un prefijo de 3 letras por tabla: STU_Student_Id, STU_Full_Name.
Añade un índice único en el id
Dale a cada tabla un índice único en su campo <TBL>_Id. Los componentes que vinculan un único registro por clave, y los programas set_data en modo de actualización o eliminación, resuelven la fila de destino mediante este índice.
Apunta una fuente de datos a ella
El dataSourceTableId de un programa Get Data o Set Data nombra el _id de esta tabla; dataSourceIndexId nombra uno de los ids de tableIndexes.
En Base de datos, en el árbol de Studio, añade una tabla y luego añade filas a su cuadrícula de Campos (id, tipo, obligatorio) y a su cuadrícula de Índices (nombre, claves, único). La pestaña Datos del mismo nodo muestra y edita las filas directamente.
Una tabla no tiene forma de código fuente .xu; los proyectos de xuda-cli la declaran como un archivo .table.json5 (este es ese archivo, mostrado como JSON).