İçeriğe geç
Doğrulandı

Tablo

Tek bir veri varlığının tanımı, sütunları ve dizinleri; takılabilir bir veritabanı sürücüsüyle saklanır.

Bir Tablo tek bir veri varlığını tanımlar: sütunlarını, satırları bulmak için kullanılan dizinleri ve onu hangi veritabanı sürücüsünün sakladığını. Bir programdan farklı olarak bir Tablo iş akışı, olay veya arayüz taşımaz: şeması sözleşmenin tamamıdır. Bir Xuda uygulamasındaki her okuma ve yazma, sonunda bir Get Data, Set Data, Batch veya Component veri kaynağı aracılığıyla bir Tabloya işaret eder.

Özellikler

Tablo, studio_meta.parentId: "database" altında (veya altında iç içe bir klasörde) durur.

tableFields

Sütunlara bir tablo koduyla önek verin

"ORD - Orders" adlı bir tablo her sütuna önek koyar: ORD_Id, ORD_Total, ORD_Status. Birkaç tablo aynı ifadede yer aldığında alan adlarını belirsizlikten korur ve bir projedeki her mevcut tablonun izlediği kuraldır.

tableIndexes

Bir tablonun dizin taşıyabilmesi için en az bir alana ihtiyacı vardır. Bir dizin yalnızca yerel olmayan bir veritabanı sürücüsündeki tablolar için zorunludur, platformun kendi motoru (@xuda.io/xuda-dbs-plugin-xuda) sıfır dizinli bir tabloyu kabul eder, ancak pratikte bir Component'in veya bir set_data programının tek bir kayda bağlayabileceği her tablonun bunu yapmak için benzersiz bir <TBL>_Id dizinine ihtiyacı vardır.

Bir tabloyu kullanma

  • Bir satırı okuma veya yazma: bir Get Data, Set Data veya Batch programının progDataSource.dataSourceTableId değeri bu tablonun _id'sini adlandırır.
  • Bir Component'i doğrudan bağlama: aynı dataSourceTableId / dataSourceIndexId çifti, ayrı bir program yerine Component'e gömülür.
  • Bir betikten: xu.dbs_create, xu.dbs_read, xu.dbs_update, xu.dbs_delete, tablonun _id'siyle çağrılır, hiçbir zaman adıyla değil.

Çalışan örnek

Sütunları modelleyin

Varlık başına bir tablo, tablo başına 3 harfli bir önek: STU_Student_Id, STU_Full_Name.

Kimliğe benzersiz bir dizin ekleyin

Her tabloya <TBL>_Id alanında benzersiz bir dizin verin. Tek bir kaydı anahtarla bağlayan Component'ler ve güncelleme veya silme kipindeki set_data programları, hedef satırı bu dizin üzerinden çözer.

Bir veri kaynağını ona yöneltin

Bir Get Data veya Set Data programının dataSourceTableId değeri bu tablonun _id'sini adlandırır, dataSourceIndexId ise tableIndexes içindeki kimliklerden birini adlandırır.

Studio ağacında Veritabanı altında bir tablo ekleyin, ardından Alanlar ızgarasına (kimlik, tür, zorunlu) ve Dizinler ızgarasına (ad, anahtarlar, benzersiz) satırlar ekleyin. Aynı düğümdeki Veri sekmesi satırları doğrudan gösterir ve düzenler.

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

Bir tablonun .xu kaynak biçimi yoktur, xuda-cli projeleri onu bunun yerine bir .table.json5 dosyası olarak bildirir (bu o dosyadır, JSON olarak gösterilmiştir).

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