Przejdź do treści
Zweryfikowano

Tabela

Definicja jednej encji danych, jej kolumn i indeksów, przechowywanej przez wymienny sterownik bazy danych.

Tabela definiuje jedną encję danych: jej kolumny, indeksy używane do wyszukiwania wierszy i sterownik bazy danych, który ją przechowuje. W odróżnieniu od programu Tabela nie niesie przepływu pracy, zdarzeń ani interfejsu; jej schemat jest całą umową. Każdy odczyt i zapis w aplikacji Xuda ostatecznie wskazuje na Tabelę przez Get Data, Set Data, Batch lub źródło danych Component.

Właściwości

Tabela leży pod studio_meta.parentId: "database" (albo folderem zagnieżdżonym pod nim).

tableFields

Poprzedzaj kolumny kodem tabeli

Tabela o nazwie "ORD - Orders" poprzedza każdą kolumnę: ORD_Id, ORD_Total, ORD_Status. Dzięki temu nazwy pól pozostają jednoznaczne, gdy w jednym wyrażeniu jest kilka tabel, i jest to konwencja, której trzyma się każda istniejąca tabela w projekcie.

tableIndexes

Tabela potrzebuje co najmniej jednego pola, zanim będzie mogła mieć indeks. Sam indeks jest obowiązkowy tylko dla tabel na nienatywnym sterowniku bazy danych; własny silnik platformy (@xuda.io/xuda-dbs-plugin-xuda) przyjmuje tabelę bez żadnych indeksów, choć w praktyce każda tabela, którą Component lub program set_data może powiązać z pojedynczym rekordem, potrzebuje do tego unikalnego indeksu <TBL>_Id.

Korzystanie z tabeli

  • Odczyt lub zapis wiersza: progDataSource.dataSourceTableId programu Get Data, Set Data lub Batch wskazuje _id tej tabeli.
  • Powiązanie Component bezpośrednio: ta sama para dataSourceTableId / dataSourceIndexId, osadzona w Component zamiast w osobnym programie.
  • Ze skryptu: xu.dbs_create, xu.dbs_read, xu.dbs_update, xu.dbs_delete, wywoływane z _id tabeli, nigdy z jej nazwą.

Przykład krok po kroku

Zamodeluj kolumny

Jedna tabela na encję, jeden 3-literowy prefiks na tabelę: STU_Student_Id, STU_Full_Name.

Dodaj unikalny indeks na identyfikatorze

Daj każdej tabeli unikalny indeks na jej polu <TBL>_Id. Component, które wiążą pojedynczy rekord po kluczu, i programy set_data w trybie aktualizacji lub usuwania znajdują docelowy wiersz przez ten indeks.

Wskaż na nią źródło danych

dataSourceTableId programu Get Data lub Set Data wskazuje _id tej tabeli; dataSourceIndexId wskazuje jeden z identyfikatorów w tableIndexes.

W Bazie danych w drzewie Studio dodaj tabelę, a potem dodaj wiersze do jej siatki Pola (identyfikator, typ, wymagane) i siatki Indeksy (nazwa, klucze, unikalny). Karta Dane na tym samym węźle pokazuje i edytuje wiersze bezpośrednio.

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

Tabela nie ma formy źródłowej .xu; projekty xuda-cli deklarują ją jako plik .table.json5 (to jest ten plik, pokazany jako 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"] } }
  ]
}