Odborná definícia
Význam a odborné vymedzenie pojmu
JSON Schema je deklaratívny jazyk na opis štruktúry, typov, povolených hodnôt a validačných obmedzení JSON inštancií. Kľúčové slová definujú objekty, vlastnosti, povinné polia, polia položiek, číselné rozsahy, regulárne výrazy a kompozíciu subschém. Dialekt sa identifikuje cez $schema a opakovateľné definície cez $defs a $ref. V AI aplikáciách schéma formalizuje výstup nástroja, payload API, konfiguráciu pipeline alebo očakávaný štruktúrovaný výsledok modelu. Validná inštancia však nemusí byť vecne správna a podpora jednotlivých draftov sa líši medzi validátormi.
Zrozumiteľné vysvetlenie
Ako sa pojem používa v praxi
Aplikácia očakáva, že model vráti objekt s názvom produktu, cenou ako nezáporným číslom a zoznamom kategórií. JSON Schema presne zapíše, ktoré polia musia existovať, aký majú typ a aké obmedzenia platia. Validátor potom odmietne chýbajúcu cenu alebo text namiesto čísla ešte pred tým, ako sa dáta dostanú do databázy. Schéma však nezistí, že model uviedol cenu 19,90, hoci správna je 29,90. Chráni formálny kontrakt, nie pravdivosť obsahu. Verzia schémy musí byť kompatibilná s používaným validátorom.
Časté otázky
Otázky, ktoré spresňujú význam
Čo robí kľúč required?
V objekte vymenuje vlastnosti, ktoré musia byť prítomné. Neurčuje ich typ, ten sa definuje v properties alebo odkazovanej schéme. Pole môže byť povinné a zároveň povoľovať null, ak to typ výslovne pripúšťa.
Ako zakázať neočakávané polia?
Používa sa additionalProperties: false, prípadne novšie unevaluatedProperties podľa kompozície schémy. Prísne nastavenie chráni kontrakt, ale komplikuje spätnú kompatibilitu pri pridávaní nových polí.
Čo je rozdiel medzi oneOf a anyOf?
anyOf vyžaduje splnenie aspoň jednej subschémy. oneOf vyžaduje presne jednu, takže inštancia vyhovujúca dvom vetvám zlyhá. Pri prekrývajúcich sa vetvách môže oneOf priniesť prekvapivé chyby a vyššie validačné náklady.
Ako sa schéma verzuje?
Samotný dialekt označuje $schema, identitu dokumentu môže označiť $id. Aplikačné verzie sa riadia osobitne cez URL, repozitár alebo pole verzie. Zmena povinného poľa je spravidla nekompatibilná a vyžaduje migráciu klientov.
Zaručí schema-constrained generation validný JSON?
Ak implementácia vynucuje gramatiku odvodenú zo podporovanej podmnožiny schémy, môže výrazne zvýšiť syntaktickú a štrukturálnu validitu. Stále treba serverový validátor, kontrolu limitov a vecnú validáciu hodnôt.
Súvisiace pojmy
Významové a tematické súvislosti
Pojem v rozhodovaní
Odborné články, ktoré tento pojem používajú v praxi
Zdroje a redakčná stopa
Použité východiská a odborná revízia
- JSON Schema, Specification JSON Schema, Glossary
Definícia je autorská odborná syntéza. Pri právnych a regulačných rozhodnutiach má prednosť aktuálne oficiálne znenie predpisu a posúdenie konkrétneho prípadu.