Nycklar och värden

Azure App Configuration lagrar konfigurationsdata som nyckelvärden. Nyckelvärden är en enkel och flexibel representation av programinställningar som används av utvecklare.

Nycklar

Nycklar fungerar som identifierare för nyckelvärden och används för att lagra och hämta motsvarande värden. Det är vanligt att ordna nycklar i ett hierarkiskt namnområde med hjälp av en teckengränsare, till exempel / eller :. Använd en konvention som passar bäst för ditt program. App Configuration behandlar nycklar som helhet. Det parsar inte nycklar för att ta reda på hur deras namn är strukturerade eller tillämpa någon regel.

Här är ett exempel på nyckelnamn som är strukturerade i en hierarki baserat på komponenttjänster:

    AppName:Service1:ApiEndpoint
    AppName:Service2:ApiEndpoint

Användningen av konfigurationsdata inom programramverk kan diktera specifika namngivningsscheman för nyckelvärden. Javas Spring Cloud-ramverk definierar Environment till exempel resurser som tillhandahåller inställningar för ett Spring-program. Dessa resurser parametriseras av variabler som innehåller programnamn och profil. Nycklar för Spring Cloud-relaterade konfigurationsdata börjar vanligtvis med dessa två element avgränsade med en avgränsare.

Nycklar som lagras i App Configuration är skiftlägeskänsliga, Unicode-baserade strängar. Nycklarna App1 och App1 är distinkta i en konfigurationslagring för appar. Tänk på detta när du använder konfigurationsinställningar i ett program eftersom vissa ramverk hanterar konfigurationsnycklar skiftlägesokänsligt. Vi rekommenderar inte att använda versaler och gemener för att särskilja nycklar.

Du kan använda alla unicode-tecken i nyckelnamn förutom %. Ett nyckelnamn får inte vara . eller .. heller. Det finns en kombinerad storleksgräns på 10 kB för ett nyckelvärde. Den här gränsen omfattar alla tecken i nyckeln, dess värde och alla associerade valfria attribut. Inom den här gränsen kan du ha många hierarkiska nivåer för nycklar.

Designnyckelnamnområden

Två allmänna metoder för namngivningsnycklar används för konfigurationsdata: flat eller hierarkisk. Dessa metoder är liknande från programanvändningssynpunkt, men hierarkisk namngivning ger många fördelar:

• Lättare att läsa. Avgränsare i ett hierarkiskt nyckelnamn fungerar som mellanslag i en mening. De ger också naturliga brytningar mellan ord.
• Enklare att hantera. En nyckelnamnshierarki representerar logiska grupper med konfigurationsdata.
• Enklare att använda. Det är enklare att skriva en fråga som mönstermatchar nycklar i en hierarkisk struktur och endast hämtar en del av konfigurationsdata. Dessutom har många nyare programmeringsramverk inbyggt stöd för hierarkiska konfigurationsdata så att ditt program kan använda specifika konfigurationsuppsättningar.

Du kan ordna nycklar i App Configuration hierarkiskt på många sätt. Tänk på sådana nycklar som URI:er. Varje hierarkisk nyckel är en resurssökväg som består av en eller flera komponenter som kopplas samman av avgränsare. Välj vilket tecken som ska användas som avgränsare baserat på vad programmet, programmeringsspråket eller ramverket behöver. Använd flera avgränsare för olika nycklar i App Configuration.

Nycklar för etiketter

Som tillval kan nyckelvärden i App Configuration ha attributet label (etikett). Etiketter används för att skilja mellan nyckelvärden med samma nyckel. En nyckel app1 med etiketter A och B bildar två separata nycklar i en appkonfigurationslagringsplats. Som standard har ett nyckelvärde ingen etikett. Om du uttryckligen vill referera till ett nyckelvärde utan en etikett använder du \0 (URL-kodad som %00).

Etikett är ett bekvämt sätt att skapa varianter av en nyckel. En vanlig användning av etiketter är att ange flera miljöer för samma nyckel:

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

Versionsnyckelvärden

Använd etiketter som ett sätt att skapa flera versioner av ett nyckelvärde. Du kan till exempel ange ett programversionsnummer eller ett Git-inchecknings-ID i etiketter för att identifiera nyckelvärden som är associerade med en viss programvaruversion.

Fråga efter nyckelvärden

Varje nyckelvärde identifieras unikt genom sin nyckel plus en etikett som kan vara \0. Du frågar ett App Configuration Store efter nyckelvärden genom att ange ett mönster. Appkonfigurationsarkivet returnerar alla nyckelvärden som matchar mönstret, inklusive deras motsvarande värden och attribut. Använd följande nyckelmönster i REST API-anrop till App Configuration:

Du kan också inkludera följande etikettmönster:

Värden

Värden som tilldelas till nycklar är också Unicode-strängar. Du kan använda alla Unicode-tecken för värden.

Använd innehållstyp

Varje nyckelvärde i App Configuration har ett innehållstypattribut. Du kan också använda det här attributet för att lagra information om typen av värde i ett nyckelvärde som hjälper ditt program att bearbeta det korrekt. Du kan använda valfritt format för innehållstypen. AppKonfiguration använder medietyper (kallas även MIME-typer) för inbyggda datatyper som funktionsflaggor, Key Vault-referenser och JSON-nyckelvärden.

Nästa steg