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

Πίνακας

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

Ένας Πίνακας ορίζει μία οντότητα δεδομένων: τις στήλες της, τα ευρετήρια που χρησιμοποιούνται για την αναζήτηση γραμμών και ποιο πρόγραμμα οδήγησης βάσης δεδομένων την αποθηκεύει. Σε αντίθεση με ένα πρόγραμμα, ένας Πίνακας δεν φέρει ροή εργασίας, συμβάντα ή διεπαφή, το σχήμα του είναι ολόκληρο το συμβόλαιο. Κάθε ανάγνωση και εγγραφή σε μια εφαρμογή Xuda καταλήγει τελικά να δείχνει σε έναν Πίνακα μέσω ενός Get Data, Set Data, Batch ή μιας πηγής δεδομένων Component.

Ιδιότητες

Ο πίνακας βρίσκεται κάτω από το studio_meta.parentId: "database" (ή έναν φάκελο φωλιασμένο κάτω από αυτό).

tableFields

Προθέστε στις στήλες έναν κωδικό πίνακα

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

tableIndexes

Ένας πίνακας χρειάζεται τουλάχιστον ένα πεδίο πριν μπορέσει να φέρει ευρετήριο. Ένα ευρετήριο είναι υποχρεωτικό μόνο για πίνακες σε πρόγραμμα οδήγησης βάσης δεδομένων που δεν είναι γηγενές, η ίδια η μηχανή της πλατφόρμας (@xuda.io/xuda-dbs-plugin-xuda) δέχεται έναν πίνακα χωρίς κανένα ευρετήριο, αν και στην πράξη κάθε πίνακας που ένα Component ή ένα πρόγραμμα set_data μπορεί να δεσμεύσει σε μία εγγραφή χρειάζεται ένα μοναδικό ευρετήριο <TBL>_Id για να το κάνει.

Χρήση ενός πίνακα

  • Ανάγνωση ή εγγραφή γραμμής: το progDataSource.dataSourceTableId ενός προγράμματος Get Data, Set Data ή Batch ονομάζει το _id αυτού του πίνακα.
  • Απευθείας δέσμευση ενός Component: το ίδιο ζεύγος dataSourceTableId / dataSourceIndexId, ενσωματωμένο στο Component αντί για ξεχωριστό πρόγραμμα.
  • Από ένα script: xu.dbs_create, xu.dbs_read, xu.dbs_update, xu.dbs_delete, που καλούνται με το _id του πίνακα, ποτέ με το όνομά του.

Παράδειγμα εφαρμογής

Μοντελοποιήστε τις στήλες

Ένας πίνακας ανά οντότητα, ένα πρόθεμα 3 γραμμάτων ανά πίνακα: STU_Student_Id, STU_Full_Name.

Προσθέστε ένα μοναδικό ευρετήριο στο αναγνωριστικό

Δώστε σε κάθε πίνακα ένα μοναδικό ευρετήριο στο πεδίο <TBL>_Id. Τα Components που δεσμεύουν μία εγγραφή με κλειδί, και τα προγράμματα set_data σε λειτουργία ενημέρωσης ή διαγραφής, επιλύουν τη γραμμή-στόχο μέσω αυτού του ευρετηρίου.

Στρέψτε μια πηγή δεδομένων προς αυτόν

Το dataSourceTableId ενός προγράμματος Get Data ή Set Data ονομάζει το _id αυτού του πίνακα· το dataSourceIndexId ονομάζει ένα από τα αναγνωριστικά στα tableIndexes.

Κάτω από τη Βάση δεδομένων στο δέντρο του Studio, προσθέστε έναν πίνακα, και μετά προσθέστε γραμμές στο πλέγμα Πεδία του (αναγνωριστικό, τύπος, υποχρεωτικό) και στο πλέγμα Ευρετήρια του (όνομα, κλειδιά, μοναδικό). Η καρτέλα Δεδομένα στον ίδιο κόμβο δείχνει και επεξεργάζεται γραμμές απευθείας.

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

Ένας πίνακας δεν έχει μορφή πηγής .xu, τα έργα xuda-cli τον δηλώνουν ως αρχείο .table.json5 (αυτό είναι εκείνο το αρχείο, εμφανιζόμενο ως 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"] } }
  ]
}