Siirry sisältöön
Tarkistettu

Taulu

Yhden dataentiteetin määritelmä: sen sarakkeet ja indeksit, tallennettuna vaihdettavan tietokanta-ajurin kautta.

Taulu määrittelee yhden dataentiteetin: sen sarakkeet, rivien hakuun käytetyt indeksit ja sen, mikä tietokanta-ajuri sen tallentaa. Toisin kuin ohjelmalla, Taululla ei ole työnkulkua, tapahtumia eikä käyttöliittymää: sen skeema on koko sopimus. Jokainen Xuda-sovelluksen luku ja kirjoitus osoittaa lopulta Tauluun Hae dataa-, Aseta dataa-, Batch- tai Komponentin datalähteen kautta.

Ominaisuudet

Taulu sijaitsee kohdassa studio_meta.parentId: "database" (tai sen alle sisäkkäisessä kansiossa).

tableFields

Etuliitä sarakkeet taulun koodilla

Taulu nimeltä "ORD - Orders" etuliittää jokaisen sarakkeen: ORD_Id, ORD_Total, ORD_Status. Se pitää kenttien nimet yksiselitteisinä, kun useita tauluja on samassa lausekkeessa, ja se on käytäntö, jota jokainen projektin olemassa oleva taulu noudattaa.

tableIndexes

Taululla täytyy olla vähintään yksi kenttä, ennen kuin sillä voi olla indeksi. Indeksi itsessään on pakollinen vain tauluille, jotka ovat ei-natiivilla tietokanta-ajurilla. Alustan oma moottori (@xuda.io/xuda-dbs-plugin-xuda) hyväksyy taulun ilman indeksejä, vaikka käytännössä jokainen taulu, jonka Komponentti tai set_data-ohjelma voi sitoa yhteen tietueeseen, tarvitsee siihen yksilöllisen <TBL>_Id-indeksin.

Taulun käyttäminen

  • Lue tai kirjoita rivi: Hae dataa-, Aseta dataa- tai Batch-ohjelman progDataSource.dataSourceTableId nimeää tämän taulun _id:n.
  • Sido Komponentti suoraan: sama dataSourceTableId / dataSourceIndexId -pari, upotettuna Komponenttiin erillisen ohjelman sijaan.
  • Skriptistä: xu.dbs_create, xu.dbs_read, xu.dbs_update, xu.dbs_delete, kutsuttuna taulun _id:llä, ei koskaan nimellä.

Käyttöesimerkki

Mallinna sarakkeet

Yksi taulu entiteettiä kohti, yksi 3-kirjaiminen etuliite taulua kohti: STU_Student_Id, STU_Full_Name.

Lisää yksilöllinen indeksi tunnukselle

Anna jokaiselle taululle yksilöllinen indeksi sen <TBL>_Id-kentälle. Komponentit, jotka sitovat yksittäisen tietueen avaimella, ja set_data-ohjelmat päivitys- tai poistotilassa ratkaisevat kohderivin tämän indeksin kautta.

Osoita datalähde siihen

Hae dataa- tai Aseta dataa -ohjelman dataSourceTableId nimeää tämän taulun _id:n. dataSourceIndexId nimeää yhden tableIndexes-kentän tunnuksista.

Lisää Studion puussa Tietokanta-kohdan alle taulu ja lisää sitten rivejä sen Kentät-ruudukkoon (tunnus, tyyppi, pakollinen) ja sen Indeksit-ruudukkoon (nimi, avaimet, yksilöllinen). Saman solmun Tiedot-välilehti näyttää ja muokkaa rivejä suoraan.

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

Taululla ei ole .xu-lähdemuotoa, xuda-cli-projektit ilmoittavat sen .table.json5-tiedostona (tämä on se tiedosto, näytettynä JSONina).

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