Hoppa till innehållet
Verifierad

Tabeller och fält

En tabells kolumner är en sluten uppsättning av sex typer, var och en konverterad vid inskrivning, plus de index som gör en rad sökbar.

En tabell definieras en gång, i Xuda Studio, och varje ställe som visar dess data, Studios rutnät, dashboardens Data tab, ett Hämta data-program eller ett direkt API-anrop, läser samma fältdefinitioner.

Den fullständiga schemareferensen

Den här sidan beskriver fält så som du möter dem när du bygger och bläddrar i en tabell. För den fullständiga egenskapslistan, index och hur ett Hämta data- eller Sätt data-program pekar på en tabell, se Table i Building Blocks.

Sex fälttyper, inget annat

Varje fält i en tabell är exakt en av sex typer. Studio visar var och en med en egen ikon i rutnätets rubrik i stället för en textetikett, eftersom en kolumn är smal och ett fält-id som ORD_Total redan tar det mesta av bredden:

Det finns ingen sjunde typ och inget sätt att lägga till en egen. Ett fält som inte passar in i dessa sex, ett rich text-block, en fil, en relation till en annan tabell, modelleras som en string (ett id, en sökväg, en JSON-kodad blob) eller en array/object av sådana. Det finns ingen separat förstklassig kolumntyp för något av det i en tabell.

Vad varje typ faktiskt gör med ett värde

Både dbs_create och dbs_update konverterar värdet du skickar enligt fältets deklarerade typ innan det lagras, så det är värt att veta exakt vad varje konvertering gör i stället för att anta en välbekant betydelse:

string

Allt som inte redan är en sträng konverteras med en vanlig strängkonvertering. Ett tomt eller saknat värde lagras som "".

number

Number(value) lagras. Ett värde som inte tolkas som ett ändligt tal blir 0 i stället för att skrivningen avvisas. Ett tomt eller saknat värde lagras också som 0.

boolean

Bara en fast lista av tecken läses som true (Y, 1, true, TRUE, ON, YES), och en annan fast lista som false (N, 0, false, FALSE, OFF, NO). Allt annat, även ett tomt värde, lagras som false.

object

En sträng tolkas som JSON5. Ett värde som redan är ett objekt lagras som det är. Ett tomt eller saknat värde, eller en sträng som inte går att tolka, lagras som {}.

array

En sträng tolkas först som JSON5, och om det misslyckas utvärderas den i stället som en JavaScript-literal. Ett värde som redan är en array lagras som det är. Ett tomt eller saknat värde, eller en sträng som ingen av tolkningarna klarar, lagras som [].

date

Det finns ingen särskild datumhantering vid inskrivning: den sträng du skickar lagras exakt som den skickades. Välj ett format. ISO 8601 (2026-09-25T00:00:00.000Z) är det säkraste valet, eftersom ingenting i plattformen normaliserar ett datumfält åt dig, och en tabell med blandade format sorteras och filtreras inkonsekvent.

Ett tal avvisar aldrig en skrivning

Om du skickar ett värde som inte kan bli ett giltigt tal till ett number-fält misslyckas inte anropet, utan 0 lagras tyst. Validera ett numeriskt värde själv innan du skriver det om en 0 vore fel.

Namnge fält

Det finns ingen påtvingad namnregel utöver att fält-id måste vara unika i tabellen, men varje tabell som redan finns i ett Xuda-projekt följer en konvention: prefixera varje fält med en kort kod för själva tabellen, så att ORD - Orders ger ORD_Id, ORD_Total, ORD_Status. Det håller fältnamnen entydiga när en fråga, ett uttryck eller en importfil måste hänvisa till flera tabeller samtidigt.

Markera ett fält som obligatoriskt

Ett fält har en flagga för obligatoriskt som du anger när du definierar det, vid sidan av dess typ och kommentar, för att notera att en rad inte är tänkt att sparas utan ett värde där.

Tabeller har ett eget aktivt/arkiverat-läge

Skilt från att en enskild rad arkiveras (mjukraderas, se Querying data over the API) kan en tabell själv vara aktiv eller arkiverad som en Studio-nod. Dashboardens Data tab listar ett projekts tabeller som kort, med växling mellan Aktiv och Arkiverad, där varje kort visar tabellens namn och dess aktuella antal rader. Att arkivera en tabell här är en åtgärd på noden i Studio, och något annat än att arkivera rader i den.