Kodiniai pavadinimai#

Kadangi DSA lentelė skirta naudoti tiek žmonėms tiek automatizuotoms priemonėms, tam tikros lentelės dalys privalo naudoti sutartinius kodinius pavadinimus. Kodiniams pavadinimams keliami griežtesni reikalavimai, kadangi šiuos pavadinimus interpretuos automatizuotos priemonės.

Visi DSA lentelės stulpelių pavadinimai turi būti užrašyti tiksliai taip, kaip nurodyta, kad kompiuterio programos galėtų juos atpažinti.

Kodiniai pavadinimai rašomi naudojant tik lotyniškas raidas. Lietuviškų raidžių naudoti negalima, todėl geriausia pavadinimus užrašyti anglų kalba, arba pakeičiant lietuviškas raides į lotyniškos raidės analogą.

Deja, vis dar pasitaiko vietų, kuriose palaikoma tik lotyniška abėcėlė, todėl ir keliamas toks reikalavimas, siekiant užtikrinti maksimalų suderinamumą tarp skirtingų sistemų.

Pavadinimai turėtu būti rašomi laikantis tokio stiliaus:

Vardų erdvių#

Pavyzdys: datasets/gov/abbr/short/word

Visos mažosios raidės, stengiantis naudoti vieno žodžio trumpus pavadinimus arba žodžio trumpinius. Kadangi vardų erdvė rašoma prie kiekvieno modelio pavadinimo, todėl reikia stengtis vardų erdvių ir duomenų rinkinių pavadinimus išlaikyti kiek įmanoma trumpesnius.

Vardų erdvės pavadinimai užrašomi daugiskaita ir turi prasidėti mažąja raide.

Modeliai#

Pavyzdys: UpperCamelCase

Kiekvieno modelio pavadinimo pirma raidė didžioji, kitos mažosios. Pavadinimo žodžiai atskiriami juos užrašant iš didžiosios raidės. Tarp žodžių neturi būti nei tarpų, nei kitų skyrybos ženklų.

Modelio pavadinimas įprastai užrašomas veinaskaitos forma.

Modelio kodinius pavadinimus užrašome taip, kaip pavadintume vieną objektą, kuriam yra taikomas duomenų modelis. Tarkime jei aprašome pastatus, tai vienas pastatas būtų vadinamas vienaskaitos forma Pastatas. Tačiau, jei vienas objektas yra patatų grupė, kuriuos jungia bendra paskirtis, tada galima pavadinti Pastatai arba PastatuKompleksas.

Modelio pavadinimas turi atspindėti duomenų subjekto tipą. Duomenų subjektas yra dalykas turintis pavadinimą ar unikalų identifikatorių. Duomenų subjekto tipas yra subjektų grupė priklausančių tai pačiai kategorijai ar klasei.

Nekartojame vardų erdvės#

Modelio pavadinime nekartojamos vardų erdvės, kurioje yra modelis.

Pavyzdys, kaip nereikėtų daryti: example/planets/EarthPlanet. Šioje vietoje nereikia kartoti Planet, kadangi tai atsispindi vardų erdvės pavadinime planets.

Duomenų laukai#

Pavyzdys: snake_case

Visi duomenų lauko žodžiai rašomi mažosiomis raidėmis, atskiriami pabraukimo ženklu _.

Duomenų lauko pavadinimas turi prasidėti mažąja raide.

Ryšiai tarp modelių#

ref tipo laukai rašomi be id ar _id galūnės, kadangi jis yra perteklinis.

ref tipo laukai atspindi ne konkretų identifikatorių, o visą objektą. Konkretus identifikatorius yra rezervuotas pavadinimas ir duomenų struktūros apraše nenurodomas.

Pavyzdžiui vietoje country_id, kurio tipas yra ref, reikėŧų rašyti country.

m	property	type	ref
Country
	name@lt	text
City
	name@lt	text
	country	ref	Country

Tais atvejais, kai duomenys yra denormalizuoti, duomenų lauko pavadinimas užrašomas su tašku, nurodant duomenų lauką iš siejamo modelio. Plačiau apie tai Denormalizuoti duomenys.

Nekartojame modelio pavadinimo#

Visi modelio duomenų laukai yra konkretaus modelio laukai, todėl nereikia kartoti duomenų laukuose modelio pavadinimo, pavyzdžiui vietoje tokių pavadinimų:

m	property
City
	city_id
	city_name

Reikėtų rašyti taip:

m	property
City
	id
	name

Jei kiti modeliai siejami su City, tada nurodant tarkim city_name iš kito modelio, reikėtų rašyti city.city_name. Todėl city.name yra aiškesnis pavadinimas, kuriame nesikartoja modelio pavadinimas.

Nekartojame duomenų tipo pavadinimo#

Duomenų lauko pavadinime nereikia kartoti duomenų tipo pavadinimo.

Pavyzdžiui taip nereikėtų daryti:

m	property	type
City
	founded_date	date