Nycklar och värden

Azure App konfiguration lagrar konfigurations data som nyckel värden. Nyckel värden är en enkel och flexibel representation av program inställningar som används av utvecklare.

Nycklar

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

Här är ett exempel på nyckel namn som är strukturerade i en hierarki baserat på komponent tjänster:

    AppName:Service1:ApiEndpoint
    AppName:Service2:ApiEndpoint

Användningen av konfigurations data i Application Framework kan diktera specifika namngivnings scheman för nyckel värden. Till exempel definierar Javas moln ramverk Environment resurser som tillhandahåller inställningar för ett våren-program. Dessa parametrar är parameterstyrda av variabler som innehåller program namn och profil. Nycklar för vår moln-relaterade konfigurations data börjar normalt 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 ett konfigurations Arkiv för appar. Tänk på detta när du använder konfigurations inställningar i ett program eftersom vissa ramverk hanterar konfigurations nycklar SKIFT läges okänsligt. Vi rekommenderar inte att du använder SKIFT läge för att särskilja nycklar.

Du kan använda valfritt Unicode-tecken i nyckel namn förutom för % . Ett nyckel namn får inte vara . eller något av dem .. . Det finns en sammanlagd storleks gräns på 10 KB på ett nyckel värde. Den här gränsen omfattar alla tecken i nyckeln, dess värde och alla tillhör ande valfria attribut. Inom den här gränsen kan du ha många hierarkiska nivåer för nycklar.

Design nyckel namn rymder

Det finns två generella metoder för namngivning av nycklar som används för konfigurationsdata: platt eller hierarkisk. Dessa metoder liknar ett program användnings synpunkt, men hierarkiska namn erbjuder ett antal fördelar:

• Enklare att läsa. Avgränsare i ett hierarkiskt nyckel namn fungerar som blank steg 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 bara hämtar en del av konfigurationsdata. Dessutom har många nyare programmerings ramverk inbyggda stöd för hierarkiska konfigurations data, så att ditt program kan använda specifika uppsättningar konfiguration.

Du kan organisera nycklar i App Configuration hierarkiskt på många sätt. Tänk på sådana nycklar som URI: er. Varje hierarkisk nyckel är en resurs Sök väg bestående av en eller flera komponenter som kopplas samman med 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-konfigurationen.

Etikett nycklar

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 viktig APP1 med etiketter A och B formar två separata nycklar i ett konfigurations lager för appar. Som standard har ett nyckel värde ingen etikett. Om du explicit vill referera till ett nyckel värde utan en etikett använder du \0 (URL kodad som %00 ).

Label ä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

Versions nyckel-värden

Använd etiketter som ett sätt att skapa flera versioner av ett nyckel värde. Exempelvis kan du 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 nyckel värden

Varje nyckelvärde identifieras unikt genom sin nyckel plus en etikett som kan vara \0. Du frågar efter ett konfigurations lager för nyckel värden genom att ange ett mönster. Konfigurations arkivet för appar returnerar alla nyckel värden som matchar mönstret, inklusive motsvarande värden och attribut. Använd följande nyckel mönster i REST API anrop till app-konfiguration:

Du kan också inkludera följande etikett mö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ålls typ

Varje nyckel värde i app-konfigurationen har ett attribut för innehålls typ. Du kan också använda det här attributet för att lagra information om typen av värde i ett nyckel värde som hjälper ditt program att bearbeta det korrekt. Du kan använda valfritt format för innehålls typen. Konfiguration av appar använder medie typer (även kallade MIME-typer) för inbyggda data typer, till exempel funktions flaggor, Key Vault referenser och JSON-nyckel värden.

Nästa steg

• Tidpunktsbaserad ögonblicksbild
• Funktionshantering
• Händelsehantering