Kontrola konfigurace

Validace dat zapsaných v YAML

YAML schema validation je ověření, či datová struktura načítaná z YAML splňuje externí pravidla pro typy, povinné pole, rozsahy, enumerace, vzájomné závislosti a neznámé klúče. YAML špecifikace sama neposkytuje univerzální aplikačný kontrakt, proto se používají mechanizmy jako JSON Schema, Openapi, Kubernetes schémata nebo typové modely knižníc. Validace má proběhnout po bezpečnom parsování a před spuštěním tréninku či nasazení. Syntakticky platný YAML totiž může představovat vecne neplatnou konfiguraci.

Poslední odborná revize
7. srpna 2026
Odborný garant
Miroslav Schmiedt
ID
AI-GEO-Y-07

Odborná definice

Odborná definice

YAML schema validation je ověření, či datová struktura načítaná z YAML splňuje externí pravidla pro typy, povinné pole, rozsahy, enumerace, vzájomné závislosti a neznámé klúče. YAML špecifikace sama neposkytuje univerzální aplikačný kontrakt, proto se používají mechanizmy jako JSON Schema, Openapi, Kubernetes schémata nebo typové modely knižníc. Validace má proběhnout po bezpečnom parsování a před spuštěním tréninku či nasazení. Syntakticky platný YAML totiž může představovat vecne neplatnou konfiguraci.

Srozumitelné vysvětlení

Srozumitelné vysvětlení

Schéma je kontrolní seznam, který hovoří, co smie YAML obsahovat. Může vyžadovat pole model_name, povolit pouze tri typy optimalizátora a zakázat zápornou velikost dávky. Bez schémata projde parserom i preklep, který aplikace ignoruje nebo nahradí defaultom. Při AI experimentoch je to nebezpečné, protože běh vypadá úspešne, ale nevykonal zamýšlané nastavení. Kvalitná validace vrací přesnou cestu k chybě, pracuje s verzí kontraktu a rozlišuje varování od blokujúceho porušení.

Časté otázky

Časté otázky

Je platný YAML automaticky platnou konfigurací?

Ne. Syntax může být bezchybná, ačkoli chybí povinný parameter nebo má hodnota neprípustný rozsah.

Lze na YAML použít JSON Schema?

Ano, pokud se YAML po načítaní mapuje na datové typy kompatibilní s JSON. Je třeba však ošetrit YAML špecifiká, které JSON nereprezentuje stejně.

Proč zakazovat další neznámé pole?

Zachytí se preklep i parameter z nekompatibilnej verze. Jinak může uživatel veriť, že nastavení platí, ačkoli ho aplikace nečíta.

Kdy má validace proběhnout?

Najskůr v editore nebo CI a znova tesne před vykonáním. Druhá kontrola chrání před změnou souboru, schémata nebo prostředí mezi krokmi.

Jak se verzují schémata?

Konfigurace nese identifikátor verze a migrace mezi verzemi jsou explicitní. Tiché změny významu stejného pola se mají vylúčit.

Související pojmy

Související pojmy

Zdroje a redakční stopa

Zdroje a redakční stopa

  • JSON Schema Specification YAML 1.2.2 Specification

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.