Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Usługa Azure App Configuration przechowuje dane konfiguracji jako pary klucz-wartość. Kluczowe wartości to prosta i elastyczna reprezentacja ustawień aplikacji używanych przez deweloperów.
Klucze
Klucze służą jako identyfikatory klucz-wartości i są używane do przechowywania i pobierania odpowiednich wartości. Typowym rozwiązaniem jest organizowanie kluczy w hierarchiczną przestrzeń nazw przy użyciu ogranicznika znaków, takiego jak / lub :. Użyj konwencji najlepiej dopasowanej do aplikacji. Usługa App Configuration traktuje klucze jako całość. Nie analizuje kluczy, aby dowiedzieć się, jak ich nazwy są ustrukturyzowane, ani nie narzuca im żadnych reguł.
Oto przykład nazw kluczy ustrukturyzowanych w hierarchii według usług komponentów.
AppName:Service1:ApiEndpoint
AppName:Service2:ApiEndpoint
Użycie danych konfiguracji w strukturach aplikacji może dyktować określone schematy nazewnictwa dla par klucz-wartości. Na przykład platforma Spring Cloud języka Java definiuje Environment zasoby, które udostępniają ustawienia aplikacji Spring. Te zasoby są sparametryzowane przez zmienne, które obejmują nazwę aplikacji i profil. Klucze dla danych konfiguracji związanych z platformą Spring Cloud zwykle zaczynają się od tych dwóch elementów rozdzielonych ogranicznikiem.
Klucze przechowywane w usłudze App Configuration są opartymi na standardzie Unicode ciągami uwzględniającymi wielkość liter. Klucze app1 i App1 są odrębne w magazynie konfiguracji aplikacji. Należy pamiętać, że w przypadku używania ustawień konfiguracji w aplikacji niektóre struktury obsługują klucze konfiguracji bez uwzględniania wielkości liter. Nie zalecamy rozróżniania kluczy ze względu na wielkość liter.
Można użyć dowolnego znaku Unicode w nazwach kluczy z wyjątkiem %. Nazwa klucza nie może być . albo .. albo. Istnieje łączny limit rozmiaru 10 KB dla wartości klucza. Ten limit obejmuje wszystkie znaki w kluczu, jego wartość i wszystkie skojarzone atrybuty opcjonalne. W ramach tego limitu można mieć wiele poziomów hierarchicznych dla kluczy.
Projektowanie przestrzeni nazw kluczy
Dwa ogólne podejścia do kluczy nazewnictwa są używane na potrzeby danych konfiguracji: płaskie lub hierarchiczne. Te metody są podobne z punktu widzenia użycia aplikacji, ale hierarchiczne nazewnictwo oferuje wiele zalet:
- Łatwiejsze do odczytania. Ograniczniki w hierarchicznej nazwie klucza działają jako spacje w zdaniu. Zapewniają one również naturalne przerwy między wyrazami.
- Łatwiejsze zarządzanie. Hierarchia nazw kluczy reprezentuje logiczne grupy danych konfiguracji.
- Łatwiejsze w użyciu. Łatwiej jest napisać zapytanie, które dopasowuje klucze do wzorca w strukturze hierarchicznej i pobiera tylko fragment danych konfiguracyjnych. Ponadto wiele nowszych struktur programowania ma natywną obsługę danych konfiguracji hierarchicznej, dzięki czemu aplikacja może korzystać z określonych zestawów konfiguracji.
Klucze można organizować hierarchicznie w usłudze App Configuration na wiele sposobów. Pomyśl o takich kluczach, jak identyfikatory URI. Każdy klucz hierarchiczny jest ścieżką zasobu składającą się z co najmniej jednego składnika połączonego ze sobą przez ograniczniki. Wybierz znak, który ma być używany jako ogranicznik na podstawie potrzeb aplikacji, języka programowania lub struktury. Użyj wielu ograniczników dla różnych kluczy w usłudze App Configuration.
Klucze do etykiet
Pary klucz-wartość w usłudze App Configuration mogą opcjonalnie mieć atrybut etykiety. Etykiety umożliwiają rozróżnienie par klucz-wartość z tym samym kluczem. Klucz app1 z etykietami A i B tworzy dwa oddzielne klucze w sklepie App Configuration. Domyślnie wartość-klucz nie ma etykiety. Aby jawnie odwołać się do wartości klucza bez etykiety, użyj ( \0 adres URL zakodowany jako %00).
Etykieta zapewnia wygodny sposób tworzenia wariantów klucza. Typowym zastosowaniem etykiet jest określenie wielu środowisk dla tego samego klucza:
Key = AppName:DbEndpoint & Label = Test
Key = AppName:DbEndpoint & Label = Staging
Key = AppName:DbEndpoint & Label = Production
Wartości klucza wersji
Użyj etykiet jako sposobu tworzenia wielu wersji klucza-wartość. Można na przykład wprowadzić numer wersji aplikacji lub identyfikator zatwierdzenia usługi Git w etykietach, aby zidentyfikować wartości kluczy skojarzone z określoną kompilacją oprogramowania.
Uwaga / Notatka
Jeśli szukasz zmian, usługa App Configuration przechowuje wszystkie zmiany klucza-wartości, które wystąpiły w ostatnim okresie czasu automatycznie. Aby uzyskać więcej informacji, zobacz migawkę punktu w czasie.
Wykonywanie zapytań o klucz-wartości
Każda para klucz-wartość jest unikatowo identyfikowana za pomocą klucza oraz etykiety, która może mieć wartość \0. Zapytanie dotyczące magazynu usługi App Configuration dla wartości klucza można wykonać, określając wzorzec. Magazyn App Configuration zwraca wszystkie wartości kluczowe zgodne z wzorcem, w tym ich odpowiednie wartości i atrybuty. Użyj następujących kluczowych wzorców w wywołaniach interfejsu API REST do usługi App Configuration:
| Klawisz | Opis |
|---|---|
key zostanie pominięty lub key=* |
Pasuje do wszystkich kluczy. |
key=abc |
Pasuje dokładnie do nazwy abc klucza. |
key=abc* |
Pasuje do nazw kluczy rozpoczynających się od abc. |
key=abc,xyz |
Pasuje do nazw abc kluczy lub xyz. Ograniczone do pięciu plików CSV. |
Można również uwzględnić następujące wzorce etykiet:
| Etykieta | Opis |
|---|---|
label zostanie pominięty lub label=* |
Pasuje do dowolnej etykiety, która zawiera \0. |
label=%00 |
Pasuje do etykiety \0. |
label=1.0.0 |
Dokładnie dopasowuje etykietę 1.0.0. |
label=1.0.* |
Dopasuje etykiety rozpoczynające się od 1.0.. |
label=%00,1.0.0 |
Dopasuj etykiety \0 lub 1.0.0 CSV, ograniczone do pięciu plików CSV. |
Uwaga / Notatka
*, ,i \ są znakami zarezerwowanymi w zapytaniach. Jeśli zastrzeżony znak jest używany w nazwach kluczy lub etykietach, należy go zeskalować przy użyciu \{Reserved Character} w zapytaniach.
Wartości
Wartości przypisane do kluczy są również ciągami Unicode. W przypadku wartości można używać wszystkich znaków Unicode.
Użyj typu zawartości
Każda wartość klucza w usłudze App Configuration ma atrybut typu zawartości. Możesz opcjonalnie użyć tego atrybutu do przechowywania informacji o typie wartości w parze klucz-wartość, co pomaga aplikacji odpowiednio ją przetworzyć. Można użyć dowolnego formatu dla typu zawartości. Usługa App Configuration używa typów multimediów (nazywanych również typami MIME) dla wbudowanych typów danych, takich jak flagi funkcji, odwołania do usługi Key Vault i klucz-wartości JSON.