Kulcsok és értékek

Az Azure App Configuration kulcsértékekként tárolja a konfigurációs adatokat. A kulcsértékek a fejlesztők által használt alkalmazásbeállítások egyszerű és rugalmas ábrázolása.

Kulcsok

A kulcsok a kulcsértékek azonosítóiként szolgálnak, és a megfelelő értékek tárolására és lekérésére szolgálnak. Gyakori eljárás, hogy a kulcsokat hierarchikus névtérbe rendezi egy karakterelválasztóval, például / vagy :. Az alkalmazáshoz leginkább illő konvenciók használata. Az alkalmazáskonfiguráció a kulcsokat egészként kezeli. Nem elemzi a kulcsokat annak megállapításához, hogy a nevük hogyan van strukturálva, és nem kényszeríti ki őket semmilyen szabályra.

Íme egy példa az összetevők szolgáltatásain alapuló hierarchiába strukturált kulcsnevekre:

    AppName:Service1:ApiEndpoint
    AppName:Service2:ApiEndpoint

A konfigurációs adatok alkalmazás-keretrendszereken belüli használata meghatározott elnevezési sémákat diktálhat a kulcsértékekhez. A Java Spring Cloud-keretrendszere például olyan erőforrásokat határoz meg Environment , amelyek beállításokat biztosítanak egy Spring-alkalmazáshoz. Ezeket az erőforrásokat olyan változók paraméterezik, amelyek tartalmazzák az alkalmazás nevét és profilját. A Spring Cloudhoz kapcsolódó konfigurációs adatok kulcsai általában ezekkel a két elválasztó elemekkel kezdődnek.

Az App Configurationben tárolt kulcsok kis- és nagybetűérzékeny, Unicode-alapú karakterláncok. Az app1 és a app1 kulcsok különállóak egy alkalmazáskonfigurációs áruházban. Ezt tartsa szem előtt, amikor konfigurációs beállításokat használ egy alkalmazáson belül, mert egyes keretrendszerek figyelmen kívül hagyják a kis- és nagybetűket a konfigurációs kulcsok kezelésekor. Nem javasoljuk, hogy a kulcsok megkülönböztetéséhez használjon kis- vagy nagybetűket.

A kulcsnevekben bármilyen Unicode-karaktert használhat, kivéve a %. A kulcsnév nem lehet . vagy .. egyik sem. Egy kulcsértéken 10 KB kombinált méretkorlát van érvényben. Ez a korlát magában foglalja a kulcs összes karakterét, értékét és az összes társított opcionális attribútumot. Ezen a korláton belül számos hierarchikus szinttel rendelkezhet a kulcsokhoz.

Kulcsfontosságú névterek tervezése

Az elnevezési kulcsok két általános megközelítését használják a konfigurációs adatokhoz: lapos vagy hierarchikus. Ezek a módszerek alkalmazáshasználati szempontból hasonlóak, de a hierarchikus elnevezés számos előnnyel jár:

• Könnyebben olvasható. A hierarchikus kulcsnevek elválasztói úgy működnek, mint a szóközök egy mondatban. Természetes szüneteket is biztosítanak a szavak között.
• Egyszerűbben kezelhető. A kulcsnév-hierarchia a konfigurációs adatok logikai csoportjait jelöli.
• Egyszerűbben használható. Egyszerűbb olyan lekérdezést írni, amely egy hierarchikus struktúrában lévő kulcsokkal egyezik, és a konfigurációs adatoknak csak egy részét kéri le. Emellett számos újabb programozási keretrendszer natív támogatást nyújt a hierarchikus konfigurációs adatokhoz, így az alkalmazás bizonyos konfigurációkészleteket használhat.

Az alkalmazáskonfigurációban számos módon rendszerezheti a kulcsokat hierarchikusan. Gondolj az ilyen kulcsokra, mintha URI-k lennének. Minden hierarchikus kulcs egy erőforrásútvonal , amely egy vagy több összetevőből áll, amelyeket elválasztók kötnek össze. Válassza ki, hogy milyen karaktert használjon elválasztóként az alkalmazás, a programozási nyelv vagy a keretrendszer igényei alapján. Használjon több elválasztójelet az alkalmazáskonfiguráció különböző kulcsaihoz.

Címkék kulcsai

Az Alkalmazáskonfiguráció kulcsértékei opcionálisan címkeattribútummal is rendelkezhetnek. A címkék az azonos kulccsal rendelkező kulcsértékek megkülönböztetésére szolgálnak. Egy alkalmazás1 kulcs, amely a A és a B címkéket tartalmazza, két különálló kulcsot képez egy alkalmazáskonfigurációs tárolóban. Alapértelmezés szerint egy kulcsértéknek nincs címkéje. Ha címkével nem rendelkező kulcsértékre szeretne explicit módon hivatkozni, használja \0 a (kódolt %00URL-címet).

A címke kényelmes módot kínál a kulcsok változatainak létrehozására. A címkék gyakori használata, ha több környezetet ad meg ugyanahhoz a kulcshoz:

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

Verziókulcs-értékek

Címkék használata kulcsértékek több verziójának létrehozásához. Beírhat például egy alkalmazásverziószámot vagy egy Git-véglegesítési azonosítót a címkékbe egy adott szoftver buildhez társított kulcsértékek azonosításához.

Megjegyzés:

Ha változásverziókat keres, az Alkalmazáskonfiguráció automatikusan megőrzi az elmúlt időszakban bekövetkezett kulcsértékek minden módosítását. További információ: időponthoz kötött pillanatkép.

Kulcsértékek lekérdezése

Minden kulcsértéket egyedileg azonosít a kulcs, valamint egy címkét, amely lehet \0. Egy alkalmazáskonfigurációs áruházban kulcsértékeket kérdez le egy minta megadásával. Az Alkalmazáskonfigurációs áruház az összes olyan kulcsértéket visszaadja, amely megfelel a mintának, beleértve a hozzájuk tartozó értékeket és attribútumokat. Használja a következő kulcsmintákat az alkalmazáskonfigurációra irányuló REST API-hívásokban:

Kulcs	Leírás
key nincs megadva, vagy key=*	Megfelel az összes kulcsnak.
key=abc	Pontosan egyezik a kulcs nevével abc .
key=abc*	A következővel abckezdődő kulcsneveknek felel meg: .
key=abc,xyz	A kulcsneveket illeszt abc vagy xyz. Legfeljebb öt CSV-re korlátozva.

A következő címkemintákat is felveheti:

Címke	Leírás
label nincs megadva, vagy label=*	Megfelel bármely címkének, amely tartalmazza a \0.
label=%00	Megegyezik \0 a címkével.
label=1.0.0	Pontosan egyezik a címkével 1.0.0 .
label=1.0.*	Megegyezik a következővel kezdődő címkékkel 1.0.: .
label=%00,1.0.0	A \0 vagy 1.0.0 címkék egyezése, legfeljebb öt CSV-re korlátozva.

Megjegyzés:

*, ,és \ fenntartott karakterek a lekérdezésekben. Ha egy fenntartott karaktert használ a kulcsnevekben vagy a címkékben, akkor a lekérdezésekben meg kell adnia a \{Reserved Character} karaktert annak elkerülésére.

Értékek

A kulcsokhoz rendelt értékek unicode-sztringek is. Az értékekhez az összes Unicode-karakter használható.

Tartalomtípus használata

Az Alkalmazáskonfiguráció minden kulcsértéke tartalmaz egy tartalomtípus-attribútumot. Ezzel az attribútummal tárolhatja az érték típusával kapcsolatos információkat egy kulcs-értékben, amely segít az alkalmazásnak a megfelelő feldolgozásban. A tartalomtípushoz bármilyen formátumot használhat. Az alkalmazáskonfiguráció médiatípusokat (más néven MIME-típusokat) használ a beépített adattípusokhoz, például funkciójelölőkhöz, Key Vault-hivatkozásokhoz és JSON-kulcsértékekhez.

Következő lépések

Időponthoz kötött pillanatkép

Funkciókezelés

Eseménykezelés