Klíče a hodnoty

Azure App Configuration ukládá konfigurační data jako hodnoty klíče. Klíčové hodnoty představují jednoduchou a flexibilní reprezentaci nastavení aplikací používaných vývojáři.

Klíče

Klíče slouží jako identifikátory hodnot klíčů a slouží k ukládání a načítání odpovídajících hodnot. Běžným postupem je uspořádání klíčů do hierarchického oboru názvů pomocí oddělovače znaků, například / nebo :. Použijte konvenci, která je pro vaši aplikaci nejvhodnější. App Configuration vnímá klíče jako celek. Neanalyzuje klíče, aby zjistil, jak jsou jejich názvy strukturované, ani na ně neaplikuje žádná pravidla.

Tady je příklad názvů klíčů strukturovaných do hierarchie založené na službách komponent:

    AppName:Service1:ApiEndpoint
    AppName:Service2:ApiEndpoint

Použití konfiguračních dat v rámci aplikačních architektur může diktovat specifická schémata pojmenování pro hodnoty klíče. Architektura Spring Cloud v Javě například definuje Environment prostředky, které poskytují nastavení pro aplikaci Spring. Tyto prostředky jsou parametrizovány proměnnými, které zahrnují název aprofil aplikace. Klíče konfiguračních dat souvisejících s Spring Cloudem obvykle začínají těmito dvěma prvky oddělenými oddělovačem.

Klíče uložené v App Configuration jsou řetězce založené na kódování Unicode citlivé na malá a velká písmena. Klíče app1 a App1 jsou odlišné v úložišti App Configuration. Mějte na paměti při používání nastavení konfigurace v aplikaci, že některé rámce zpracovávají klíče konfigurace bez rozlišování velikosti písmen. Nedoporučujeme používat velikost písmen k rozlišení klíčů.

V názvech klíčů můžete použít libovolný znak unicode s výjimkou znaku %. Název klíče nemůže být ani . ani ... U hodnoty klíče existuje kombinovaný limit velikosti 10 kB. Tento limit zahrnuje všechny znaky v klíči, jeho hodnotu a všechny přidružené volitelné atributy. V rámci tohoto limitu můžete mít pro klíče mnoho hierarchických úrovní.

Návrh klíčových jmenných prostorů

Pro konfigurační data se používají dva obecné přístupy k pojmenování klíčů: ploché nebo hierarchické. Tyto metody jsou podobné z hlediska použití aplikace, ale hierarchické pojmenování nabízí mnoho výhod:

• Čitelnější. Oddělovače v hierarchickém názvu klíče fungují jako mezery ve větě. Poskytují také přirozené mezery mezi slovy.
• Snadnější správa. Hierarchie názvů klíčů představuje logické skupiny konfiguračních dat.
• Jednodušší použití. Je jednodušší napsat dotaz, který se shoduje s klíči v hierarchické struktuře a načte pouze část konfiguračních dat. Mnoho novějších programovacích architektur má také nativní podporu pro hierarchická konfigurační data, aby vaše aplikace mohl využívat konkrétní sady konfigurace.

Klíče můžete uspořádat v Konfiguraci aplikací hierarchicky mnoha způsoby. Představte si takové klíče, jako jsou identifikátory URI. Každý hierarchický klíč je cesta datového prostředku složená z jednoho nebo více prvků, které jsou spojeny oddělovacími znaky. Zvolte, jaký znak se má použít jako oddělovač na základě toho, co vaše aplikace, programovací jazyk nebo architektura potřebuje. Pro různé klíče v App Configuration použijte více oddělovačů.

Klíče popisků

Hodnoty klíčů v App Configuration můžou volitelně obsahovat atribut popisku. Popisky se používají k rozlišení hodnot se stejným klíčem. Klíčová aplikace 1 s popisky A a B tvoří dva samostatné klíče v obchodě App Configuration Store. Ve výchozím nastavení klíč-hodnota nemá žádný popisek. Pokud chcete explicitně odkazovat na hodnotu klíče bez popisku, použijte \0 adresu URL zakódovanou jako %00.

Štítek nabízí pohodlný způsob vytváření variant klíče. Běžným použitím popisků je zadat více prostředí pro stejný klíč:

    Key = AppName:DbEndpoint & Label = Test
    Key = AppName:DbEndpoint & Label = Staging
    Key = AppName:DbEndpoint & Label = Production

Hodnoty klíčů verzí

Popisky mohou být používány k vytvoření více verzí hodnoty klíče. Můžete například zadat číslo verze aplikace nebo ID potvrzení Gitu do popisků a identifikovat hodnoty klíče přidružené ke konkrétnímu sestavení softwaru.

Poznámka:

Pokud hledáte historii změn, App Configuration automaticky uchovává všechny změny hodnoty klíče, ke kterým došlo za určité uplynulé časové období. Další informace najdete v tématu snímek k určitému bodu v čase.

Dotazování klíčových hodnotových párů

Každá hodnota klíče je jedinečně identifikována jeho klíčem a popiskem, který může být \0. Dotazováním úložiště App Configuration pro hodnoty klíčů zadáte vzor. App Configuration Store vrátí všechny hodnoty klíče, které odpovídají vzoru, včetně odpovídajících hodnot a atributů. Ve voláních rozhraní REST API do služby App Configuration použijte následující klíčové vzory:

Klíč	Popis
key je vynechán nebo key=*	Odpovídá všem klíčům.
key=abc	Přesně odpovídá názvu abc klíče.
key=abc*	Odpovídá názvům klíčů, které začínají na abc.
key=abc,xyz	Porovnává názvy klíčů, jako jsou abc nebo xyz. Omezeno na pět CSV souborů.

Můžete také zahrnout následující vzory popisků:

Označení	Popis
label je vynechán nebo label=*	Odpovídá jakémukoli popisku, který obsahuje \0.
label=%00	Odpovídá \0 popisku.
label=1.0.0	Přesně odpovídá popisku 1.0.0 .
label=1.0.*	Odpovídá popiskům, které začínají na 1.0..
label=%00,1.0.0	Odpovídá popiskům \0 nebo 1.0.0, omezeno na pět CSV.

Poznámka:

*, ,a \ jsou vyhrazené znaky v dotazech. Pokud se v názvech klíčů nebo popiscích používá vyhrazený znak, musíte ho upravit pomocí \{Reserved Character} v dotazech.

Hodnoty

Hodnoty přiřazené ke klíčům jsou také řetězce unicode. Pro hodnoty můžete použít všechny znaky Unicode.

Použijte typ obsahu

Každá hodnota klíče v App Configuration má atribut typu obsahu. Atribut můžete volitelně použít k uložení informací o typu hodnoty v páru klíč-hodnota, což pomůže vaší aplikaci je správně zpracovat. Pro typ obsahu můžete použít libovolný formát. App Configuration používá typy médií (označované také jako typy MIME) pro předdefinované datové typy, jako jsou příznaky funkcí, reference ke službě Key Vault a hodnoty klíčů JSON.

Další kroky

Snímek k určitému bodu v čase

Správa funkcí

Zpracování událostí