Zum Inhalt springen
Geprüft

Tabelle

Die Definition einer Dateneinheit, ihrer Spalten und Indizes, gespeichert über einen austauschbaren Datenbanktreiber.

Eine Tabelle definiert eine Dateneinheit: ihre Spalten, die Indizes zum Nachschlagen von Zeilen und den Datenbanktreiber, der sie speichert. Anders als ein Programm trägt eine Tabelle keinen Workflow, keine Ereignisse und keine UI, ihr Schema ist der gesamte Vertrag. Jedes Lesen und Schreiben in einer Xuda-App zeigt letztlich über Get Data, Set Data, Batch oder die Datenquelle einer Komponente auf eine Tabelle.

Eigenschaften

Die Tabelle liegt unter studio_meta.parentId: "database" (oder einem darin verschachtelten Ordner).

tableFields

Spalten mit einem Tabellenkürzel präfixen

Eine Tabelle namens "ORD - Orders" präfixt jede Spalte: ORD_Id, ORD_Total, ORD_Status. So bleiben Feldnamen eindeutig, sobald mehrere Tabellen im selben Ausdruck stehen, und es ist die Konvention, der jede vorhandene Tabelle in einem Projekt folgt.

tableIndexes

Eine Tabelle braucht mindestens ein Feld, bevor sie einen Index tragen kann. Ein Index selbst ist nur für Tabellen auf einem nicht nativen Datenbanktreiber Pflicht, die eigene Engine der Plattform (@xuda.io/xuda-dbs-plugin-xuda) akzeptiert eine Tabelle ohne Index, doch in der Praxis braucht jede Tabelle, die eine Komponente oder ein set_data-Programm an einen einzelnen Datensatz binden kann, dafür einen eindeutigen Index <TBL>_Id.

Eine Tabelle verwenden

  • Eine Zeile lesen oder schreiben: progDataSource.dataSourceTableId eines Get-Data-, Set-Data- oder Batch-Programms nennt die _id dieser Tabelle.
  • Eine Komponente direkt binden: dasselbe Paar dataSourceTableId / dataSourceIndexId, statt in einem eigenen Programm in die Komponente eingebettet.
  • Aus einem Skript: xu.dbs_create, xu.dbs_read, xu.dbs_update, xu.dbs_delete, aufgerufen mit der _id der Tabelle, nie mit ihrem Namen.

Praxisbeispiel

Die Spalten modellieren

Eine Tabelle pro Einheit, ein 3-Buchstaben-Präfix pro Tabelle: STU_Student_Id, STU_Full_Name.

Einen eindeutigen Index auf die ID legen

Gib jeder Tabelle einen eindeutigen Index auf ihr Feld <TBL>_Id. Komponenten, die einen einzelnen Datensatz über den Schlüssel binden, und set_data-Programme im Update- oder Löschmodus lösen die Zielzeile über diesen Index auf.

Eine Datenquelle darauf richten

dataSourceTableId eines Get-Data- oder Set-Data-Programms nennt die _id dieser Tabelle; dataSourceIndexId nennt eine der IDs in tableIndexes.

Füge unter Datenbank im Studio-Baum eine Tabelle hinzu und dann Zeilen zu ihrem Raster Felder (ID, Typ, Pflichtfeld) und ihrem Raster Indizes (Name, Schlüssel, eindeutig). Der Tab Daten am selben Knoten zeigt und bearbeitet Zeilen direkt.

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

Eine Tabelle hat keine .xu-Quellform, xuda-cli-Projekte deklarieren sie stattdessen als Datei .table.json5 (das ist diese Datei, als JSON gezeigt).

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