Μετάβαση στο περιεχόμενο
Επαληθεύτηκε

Πίνακες και πεδία

Οι στήλες ενός πίνακα είναι ένα κλειστό σύνολο έξι τύπων, καθένας με μετατροπή κατά την εισαγωγή, μαζί με τα ευρετήρια που κάνουν μια γραμμή εύκολα ανιχνεύσιμη.

Ένας πίνακας ορίζεται μία φορά, στο Xuda Studio, και κάθε σημείο που εμφανίζει τα δεδομένα του, το πλέγμα του Studio, η καρτέλα Δεδομένα του πίνακα ελέγχου, ένα πρόγραμμα Λήψη δεδομένων ή μια άμεση κλήση API, διαβάζει τους ίδιους ορισμούς πεδίων.

Η πλήρης αναφορά σχήματος

Αυτή η σελίδα καλύπτει τα πεδία όπως τα συναντάτε όταν φτιάχνετε και περιηγείστε σε έναν πίνακα. Για την πλήρη λίστα ιδιοτήτων, τα ευρετήρια, και πώς ένα πρόγραμμα Λήψη δεδομένων ή Ορισμός δεδομένων δείχνει σε έναν πίνακα, δείτε το Πίνακας στα Δομικά στοιχεία.

Έξι τύποι πεδίων, τίποτα άλλο

Κάθε πεδίο ενός πίνακα είναι ακριβώς ένας από έξι τύπους. Το Studio δείχνει τον καθένα με το δικό του εικονίδιο στην επικεφαλίδα του πλέγματος αντί για κείμενο, αφού μια στήλη είναι στενή και ένα αναγνωριστικό πεδίου όπως ORD_Total πιάνει ήδη το μεγαλύτερο μέρος του πλάτους:

Δεν υπάρχει έβδομος τύπος, ούτε τρόπος να προσθέσετε δικό σας. Ένα πεδίο που δεν ταιριάζει σε αυτούς τους έξι, ένα μπλοκ εμπλουτισμένου κειμένου, ένα αρχείο, μια σχέση με άλλον πίνακα, μοντελοποιείται ως string (ένα αναγνωριστικό, μια διαδρομή, ένα κωδικοποιημένο σε JSON αντικείμενο) ή ως array/object από αυτά. Δεν υπάρχει ξεχωριστός πρωτεύων τύπος στήλης για κανένα από αυτά σε έναν πίνακα.

Τι κάνει πραγματικά κάθε τύπος με μια τιμή

Τόσο το dbs_create όσο και το dbs_update μετατρέπουν την τιμή που στέλνετε μέσω του δηλωμένου τύπου του πεδίου πριν αποθηκευτεί, οπότε αξίζει να γνωρίζετε ακριβώς τι κάνει κάθε μετατροπή αντί να υποθέτετε μια οικεία σημασία:

string

Οτιδήποτε δεν είναι ήδη string μετατρέπεται με απλή μετατροπή σε string. Μια κενή ή απούσα τιμή αποθηκεύεται ως "".

number

Αποθηκεύεται το Number(value). Μια τιμή που δεν αναλύεται σε πεπερασμένο αριθμό επανέρχεται στο 0 αντί να απορρίψει την εγγραφή. Μια κενή ή απούσα τιμή αποθηκεύεται επίσης ως 0.

boolean

Μόνο μια σταθερή λίστα τιμών διαβάζεται ως true (Y, 1, true, TRUE, ON, YES), και μια άλλη σταθερή λίστα ως false (N, 0, false, FALSE, OFF, NO). Οτιδήποτε άλλο, συμπεριλαμβανομένης μιας κενής τιμής, αποθηκεύεται ως false.

object

Ένα string αναλύεται ως JSON5. Μια τιμή που έχει ήδη μορφή αντικειμένου αποθηκεύεται ως έχει. Μια κενή ή απούσα τιμή, ή ένα string που δεν αναλύεται, αποθηκεύεται ως {}.

array

Ένα string αναλύεται πρώτα ως JSON5, και αν αποτύχει, αξιολογείται ως κυριολεκτικό JavaScript. Μια τιμή που έχει ήδη μορφή πίνακα αποθηκεύεται ως έχει. Μια κενή ή απούσα τιμή, ή ένα string που καμία ανάλυση δεν χειρίζεται, αποθηκεύεται ως [].

date

Δεν υπάρχει ειδικός χειρισμός ημερομηνίας κατά την εισαγωγή: όποιο string στείλετε αποθηκεύεται ακριβώς όπως στάλθηκε. Επιλέξτε μία μορφή, το ISO 8601 (2026-09-25T00:00:00.000Z) είναι η ασφαλέστερη προεπιλογή, αφού τίποτα στην πλατφόρμα δεν ομαλοποιεί ένα πεδίο ημερομηνίας για εσάς, και ένας πίνακας με μικτές μορφές ταξινομείται και φιλτράρεται ασυνεπώς.

Ένας αριθμός δεν απορρίπτει ποτέ μια εγγραφή

Η αποστολή μιας τιμής που δεν μπορεί να γίνει έγκυρος αριθμός για ένα πεδίο number δεν αποτυγχάνει την κλήση, αλλά αποθηκεύει σιωπηλά 0. Επικυρώστε μόνοι σας μια αριθμητική τιμή πριν την εγγράψετε, αν το 0 θα ήταν λάθος.

Ονομασία πεδίων

Δεν υπάρχει επιβεβλημένος κανόνας ονομασίας πέρα από το ότι τα αναγνωριστικά πεδίων πρέπει να είναι μοναδικά στον πίνακα, αλλά κάθε πίνακας που υπάρχει ήδη σε ένα project Xuda ακολουθεί μια σύμβαση: βάζετε σε κάθε πεδίο πρόθεμα με έναν σύντομο κωδικό για τον ίδιο τον πίνακα, έτσι το ORD - Orders δίνει ORD_Id, ORD_Total, ORD_Status. Κρατά τα ονόματα πεδίων σαφή όταν ένα ερώτημα, μια έκφραση ή ένα αρχείο εισαγωγής πρέπει να αναφερθεί σε πολλούς πίνακες ταυτόχρονα.

Σήμανση ενός πεδίου ως υποχρεωτικού

Ένα πεδίο φέρει μια σημαία υποχρεωτικού που ορίζετε όταν το καθορίζετε, μαζί με τον τύπο και το σχόλιό του, για να καταγράψετε ότι μια γραμμή δεν προορίζεται να αποθηκευτεί χωρίς τιμή εκεί.

Οι πίνακες έχουν τη δική τους κατάσταση ενεργού/αρχειοθετημένου

Ξεχωριστά από το να αρχειοθετηθεί μια μεμονωμένη γραμμή (soft delete, δείτε Ερωτήματα δεδομένων μέσω του API), ένας ίδιος ο πίνακας μπορεί να είναι ενεργός ή αρχειοθετημένος ως κόμβος του Studio. Η καρτέλα Δεδομένα του πίνακα ελέγχου εμφανίζει τους πίνακες ενός project ως κάρτες, με δυνατότητα εναλλαγής μεταξύ Ενεργό και Αρχειοθετήθηκε, κάθε κάρτα δείχνοντας το όνομα του πίνακα και τον τρέχοντα αριθμό γραμμών του. Η αρχειοθέτηση ενός πίνακα εδώ είναι ενέργεια του Studio στον κόμβο, και είναι διαφορετική λειτουργία από την αρχειοθέτηση γραμμών μέσα σε αυτόν.