Použití typu obsahu k ukládání hodnot klíčů JSON v App Configuration

Data se ve službě App Configuration ukládají jako hodnoty klíče, kde se hodnoty ve výchozím nastavení považují za typ řetězce. Vlastní typ ale můžete zadat pomocí vlastnosti typu obsahu přidružené ke každé hodnotě klíče. Tento proces zachovává původní typ vašich dat nebo způsobí, že se vaše aplikace chová odlišně podle typu obsahu.

Přehled

Ve službě App Configuration můžete jako typ obsahu hodnot klíčů použít typ média JSON, abyste mohli využít následující výhody:

• Jednodušší správa dat: Správa hodnot klíčů, jako jsou pole, se na webu Azure Portal stane mnohem jednodušší.
• Vylepšený export dat: Při exportu dat se zachovají primitivní typy, pole a objekty JSON.
• Nativní podpora u zprostředkovatele konfigurace aplikace: Hodnoty klíčů s typem obsahu JSON budou při využívání knihoven zprostředkovatele konfigurace aplikací ve vašich aplikacích fungovat správně.

Platný typ obsahu JSON

Typy médií, jak je zde definováno, se dají přiřadit k typu obsahu přidruženému ke každé hodnotě klíče. Typ média se skládá z typu a podtypu. Pokud je application typ a podtyp (nebo přípona) je json, bude typ média považován za platný typ obsahu JSON. Mezi příklady platných typů obsahu JSON patří:

• application/json
• application/activity+json
• application/vnd.foobar+json;charset=utf-8

Platné hodnoty JSON

Pokud má klíč-hodnota typ obsahu JSON, musí být jeho hodnota v platném formátu JSON, aby ji klienti mohli správně zpracovat. V opačném případě to může způsobit, že klienti nefungují správně nebo se vrátí k původnímu nastavení, kde to považují za formát řetězce. Mezi příklady platných hodnot JSON patří:

• "John Doe"
• 723
• false
• null
• "2020-01-01T12:34:56.789Z"
• [1, 2, 3, 4]
• {"ObjectSetting":{"Targeting":{"Default":true,"Level":"Information"}}}

Poznámka:

Ve zbývající části tohoto článku se všechny hodnoty klíče v konfiguraci aplikace, které mají platný typ obsahu JSON, a platná hodnota JSON se bude označovat jako hodnota klíče JSON.

V tomto kurzu se naučíte:

• Vytvořte hodnoty klíčů JSON v App Configuration.
• Naimportujte hodnoty klíčů JSON ze souboru JSON.
• Export hodnot klíčů JSON do souboru JSON
• Konzumujte klíčové hodnoty JSON ve vašich aplikacích.

Pokud nemáte účet Azure, vytvořte si bezplatný účet před tím, než začnete.

Požadavky

• Použijte prostředí Bash v Azure Cloud Shellu. Další informace najdete v tématu Začínáme s Azure Cloud Shellem.

  

• Pokud chcete spouštět referenční příkazy CLI lokálně, nainstalujte Azure CLI. Pokud používáte Windows nebo macOS, zvažte spuštění Azure CLI v kontejneru Docker. Pro více informací, viz Jak spustit Azure CLI v Docker kontejneru.

  • Pokud používáte místní instalaci, přihlaste se k Azure CLI pomocí příkazu az login. Chcete-li dokončit proces ověřování, postupujte podle kroků zobrazených ve vašem terminálu. Další možnosti přihlášení najdete v tématu Ověřování v Azure pomocí Azure CLI.

  • Když budete vyzváni, nainstalujte rozšíření Azure CLI při prvním použití. Další informace o rozšířeních najdete v tématu Použití a správa rozšíření pomocí Azure CLI.

  • Spusťte az version, abyste zjistili verzi a závislé knihovny, které jsou nainstalovány. Pokud chcete upgradovat na nejnovější verzi, spusťte az upgrade.

• Úložiště App Configuration, jak je znázorněno v kurzu pro vytvoření úložiště.
• Tento kurz vyžaduje verzi 2.10.0 nebo novější azure CLI. Pokud používáte Azure Cloud Shell, je už nainstalovaná nejnovější verze.

Vytvoření hodnot klíčů JSON v App Configuration

Hodnoty klíčů JSON je možné vytvořit pomocí webu Azure Portal, Azure CLI nebo importem ze souboru JSON. V této části najdete pokyny k vytvoření stejných hodnot klíčů JSON pomocí všech tří metod.

Vytvoření hodnot klíčů JSON pomocí webu Azure Portal

Do úložiště App Configuration přidejte následující hodnoty klíčů. Ponechte popisek s výchozí hodnotou. Další informace o tom, jak přidat hodnoty klíčů do úložiště pomocí webu Azure Portal nebo rozhraní příkazového řádku, najdete v tématu Vytvoření hodnoty klíče.

Klíč	Hodnota	Typ obsahu
Nastavení:BackgroundColor	"Zelená"	application/json
Nastavení:FontSize	24	application/json
Nastavení:UseDefaultRouting	falešný	application/json
Nastavení:BlockedUsers	nula	application/json
Nastavení:ReleaseDate	"2020-08-04T12:34:56.789Z"	application/json
Nastavení:Procento zavedení	[25,50,75,100]	application/json
Nastavení:Protokolování	{"Test":{"Level":"Debug"},"Prod":{"Level":"Warning"}}	application/json

1. Vyberte a použijte.

Vytvoření hodnot klíčů JSON pomocí Azure CLI

Následující příkazy vytvoří ve službě App Configuration Store hodnoty klíčů JSON. Nahraďte <appconfig_name> názvem obchodu App Configuration Store.

appConfigName=<appconfig_name>
az appconfig kv set -n $appConfigName --content-type application/json --key Settings:BackgroundColor --value \"Green\"
az appconfig kv set -n $appConfigName --content-type application/json --key Settings:FontSize --value 24
az appconfig kv set -n $appConfigName --content-type application/json --key Settings:UseDefaultRouting --value false
az appconfig kv set -n $appConfigName --content-type application/json --key Settings:BlockedUsers --value null
az appconfig kv set -n $appConfigName --content-type application/json --key Settings:ReleaseDate --value \"2020-08-04T12:34:56.789Z\"
az appconfig kv set -n $appConfigName --content-type application/json --key Settings:RolloutPercentage --value [25,50,75,100]
az appconfig kv set -n $appConfigName --content-type application/json --key Settings:Logging --value {\"Test\":{\"Level\":\"Debug\"},\"Prod\":{\"Level\":\"Warning\"}}

Důležité

Pokud k vytváření JSON klíč-hodnot používáte Azure CLI nebo Azure Cloud Shell, musí být zadaná hodnota upravený JSON řetězec.

Import hodnot klíčů JSON ze souboru

Vytvořte soubor JSON s následujícím Import.json obsahem a naimportujte ho jako hodnoty klíče do app Configuration:

{
  "Settings": {
    "BackgroundColor": "Green",
    "BlockedUsers": null,
    "FontSize": 24,
    "Logging": {"Test":{"Level":"Debug"},"Prod":{"Level":"Warning"}},
    "ReleaseDate": "2020-08-04T12:34:56.789Z",
    "RolloutPercentage": [25,50,75,100],
    "UseDefaultRouting": false
  }
}

az appconfig kv import -s file --format json --path "~/Import.json" --content-type "application/json" --separator : --depth 2

Poznámka:

Argument --depth slouží k zploštění hierarchických dat ze souboru do hodnot klíčů. V tomto kurzu se zadává hloubka pro předvedení, že objekty JSON můžete uložit také jako hodnoty v App Configuration. Pokud není zadána hloubka, objekty JSON se ve výchozím nastavení zploštějí na nejnižší úroveň.

Hodnoty klíče JSON, které jste vytvořili, by měly v konfiguraci aplikace vypadat takto:

Pokud to chcete zkontrolovat, otevřete prostředek Konfigurace aplikace na webu Azure Portal a přejděte do Průzkumníka konfigurace.

Export hodnot klíčů JSON do souboru

Jednou z hlavních výhod použití hodnot klíčů JSON je možnost zachovat původní datový typ hodnot při exportu. Pokud klíč-hodnota v App Configuration nemá typ obsahu JSON, jeho hodnota se bude považovat za řetězec.

Zvažte tyto hodnoty klíčů bez typu obsahu JSON:

Klíč	Hodnota	Typ obsahu
Nastavení:Velikost písma	dvacet čtyři
Nastavení:UseDefaultRouting	Nepravda

Při exportu těchto hodnot klíčů do souboru JSON se hodnoty exportují jako řetězce:

{
  "Settings": {
    "FontSize": "24",
    "UseDefaultRouting": "false"
  }
}

Při exportu hodnot klíče JSON do souboru ale všechny hodnoty zachová původní datový typ. Pokud chcete tento proces ověřit, exportujte hodnoty klíčů z konfigurace aplikace do souboru JSON. Uvidíte, že exportovaný soubor má stejný obsah jako Import.json soubor, který jste předtím naimportovali.

az appconfig kv export -d file --format json --path "~/Export.json" --separator :

Poznámka:

Pokud má úložiště App Configuration nějaké hodnoty klíčů bez typu obsahu JSON, exportují se také do stejného souboru ve formátu řetězce.

Využívání hodnot klíčů JSON v aplikacích

Nejjednodušší způsob, jak ve své aplikaci využívat hodnoty klíčů JSON, je prostřednictvím knihoven zprostředkovatele konfigurace aplikací. S knihovnami zprostředkovatele nemusíte ve své aplikaci implementovat speciální zpracování hodnot klíčů JSON. Budou analyzovány a převedeny tak, aby odpovídaly nativní konfiguraci vaší aplikace.

Pokud máte například následující klíč-hodnota v nastavení aplikace:

Klíč	Hodnota	Typ obsahu
Nastavení	{"FontSize":24,"UseDefaultRouting":false}	application/json

Vaše konfigurace aplikace .NET bude mít následující hodnoty klíče:

Klíč	Hodnota
Nastavení:Velikost písma	dvacet čtyři
Nastavení:UseDefaultRouting	Nepravda

K novým klíčům můžete přistupovat přímo nebo můžete zvolit vytvoření vazby konfiguračních hodnot k instancím objektů .NET.

Důležité

Nativní podpora hodnot klíčů JSON je dostupná ve zprostředkovateli konfigurace .NET verze 4.0.0 (nebo novější). Další informace najdete v části Další kroky .

Pokud ke čtení hodnot klíčů ze služby App Configuration na základě typu obsahu používáte sadu SDK nebo rozhraní REST API, zodpovídá vaše aplikace za parsování hodnoty klíče JSON.

Vyčistěte zdroje

Pokud nechcete dál používat prostředky vytvořené v tomto článku, odstraňte skupinu prostředků, kterou jste tady vytvořili, abyste se vyhnuli poplatkům.

Důležité

Odstranění skupiny prostředků je nevratné. Skupina prostředků a všechny prostředky v ní se trvale odstraní. Dávejte pozor, abyste omylem neodstranili nesprávnou skupinu prostředků nebo jednotlivé prostředky. Pokud jste vytvořili prostředky pro tento článek ve skupině prostředků, která obsahuje další prostředky, které chcete zachovat, odstraňte jednotlivé prostředky z příslušného podokna místo odstranění skupiny prostředků.

1. Přihlaste se k webu Azure Portal a vyberte skupiny prostředků.
2. Do pole Filtrovat podle názvu zadejte název vaší skupiny prostředků.
3. V seznamu výsledků vyberte název skupiny prostředků, abyste zobrazili přehled.
4. Vyberte odstranit skupinu zdrojů.
5. Zobrazí se výzva k potvrzení odstranění skupiny prostředků. Potvrďte název skupiny prostředků a vyberte Odstranit.

Po několika okamžicích se skupina prostředků a všechny její prostředky vymažou.

Další kroky

Teď, když víte, jak pracovat s hodnotami klíčů JSON v App Configuration Storu, vytvořte aplikaci pro využívání těchto hodnot klíčů:

Rychlý start pro ASP.NET Core

Rychlý start s .NET Core