Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Azure App Configuration menyimpan data konfigurasi sebagai kunci-nilai. Kunci-nilai adalah representasi sederhana dan fleksibel dari pengaturan aplikasi yang digunakan oleh pengembang.
Tombol / Kunci
Kunci berfungsi sebagai pengidentifikasi untuk nilai kunci dan digunakan untuk menyimpan dan mengambil nilai yang sesuai. Ini adalah praktik umum untuk mengatur kunci ke dalam namespace hierarkis dengan menggunakan pemisah karakter, seperti / atau :. Gunakan konvensi yang paling cocok untuk aplikasi Anda. App Configuration memperlakukan kunci secara keseluruhan. Ini tidak mengurai kunci untuk mengetahui bagaimana namanya disusun atau menerapkan aturan apa pun terhadap mereka.
Berikut adalah contoh nama kunci yang disusun ke dalam hierarki berdasarkan layanan komponen:
AppName:Service1:ApiEndpoint
AppName:Service2:ApiEndpoint
Penggunaan data konfigurasi dalam kerangka kerja aplikasi dapat menentukan skema penamaan tertentu untuk kunci-nilai. Misalnya, kerangka kerja Cloud Spring Java menentukan Environment sumber daya yang memasok pengaturan ke aplikasi Spring. Sumber daya ini diparameterkan oleh variabel yang menyertakan nama dan profilaplikasi. Kunci untuk data konfigurasi yang terkait dengan Spring Cloud biasanya dimulai dengan dua elemen ini yang dipisahkan oleh sebuah pemisah.
Kunci yang disimpan dalam App Configuration adalah string berbasis unicode yang sensitif terhadap huruf besar/kecil. Kunci app1 dan App1 berbeda di penyimpanan App Configuration. Ingatlah hal ini saat Anda menggunakan pengaturan konfigurasi dalam aplikasi karena beberapa kerangka kerja menangani kunci konfigurasi dengan tidak peka huruf besar/kecil. Kami tidak merekomendasikan penggunaan huruf besar/kecil untuk membedakan kunci.
Anda dapat menggunakan karakter unicode apa pun dalam nama kunci kecuali untuk %. Nama kunci tidak boleh . atau .. juga. Ada batas ukuran gabungan 10 KB pada nilai kunci. Batas ini mencakup semua karakter dalam kunci, nilainya, dan semua atribut opsional terkait. Dalam batas ini, Anda dapat memiliki banyak tingkat hierarkis untuk kunci.
Mendesain namespace utama
Dua pendekatan umum untuk penamaan kunci digunakan untuk data konfigurasi: datar atau hierarkis. Metode ini serupa dari sudut pandang penggunaan aplikasi, tetapi penamaan hierarkis menawarkan beberapa keuntungan:
- Lebih mudah dibaca. Pembatas dalam nama kunci hierarkis berfungsi sebagai spasi dalam kalimat. Mereka juga memberikan jeda alami di antara kata-kata.
- Lebih mudah dikelola. Hierarki nama kunci mewakili grup logis data konfigurasi.
- Lebih mudah digunakan. Lebih mudah untuk menulis kueri yang mencocokkan pola kunci dalam struktur hierarkis dan hanya mengambil sebagian data konfigurasi. Selain itu, banyak kerangka kerja pemrograman yang lebih baru memiliki dukungan asli untuk data konfigurasi hierarkis sehingga aplikasi Anda dapat menggunakan set konfigurasi tertentu.
Anda dapat mengatur kunci di App Configuration secara hierarkis dalam banyak cara. Pikirkan kunci seperti URI. Setiap kunci hierarkis adalah jalur sumber daya yang terdiri dari satu atau beberapa komponen yang digabungkan oleh pemisah. Pilih karakter apa yang akan digunakan sebagai pemisah berdasarkan apa yang dibutuhkan aplikasi, bahasa pemrograman, atau kerangka kerja Anda. Gunakan beberapa pemisah untuk kunci yang berbeda di App Configuration.
Kunci label
Kunci-nilai dalam App Configuration dapat secara opsional memiliki atribut label. Label digunakan untuk membedakan kunci-nilai dengan kunci yang sama. Sebuah kunci app1 dengan label A dan B membentuk dua kunci terpisah di penyimpanan App Configuration. Secara default, kunci-nilai tidak memiliki label. Untuk secara eksplisit mereferensikan kunci-nilai tanpa label, gunakan \0 (URL yang dikodekan sebagai %00).
Label menyediakan cara yang mudah untuk membuat varian kunci. Penggunaan label yang umum adalah menentukan beberapa lingkungan untuk kunci yang sama:
Key = AppName:DbEndpoint & Label = Test
Key = AppName:DbEndpoint & Label = Staging
Key = AppName:DbEndpoint & Label = Production
Nilai kunci versi
Gunakan label sebagai cara untuk membuat versi beragam dari kunci-nilai. Misalnya, Anda dapat memasukkan nomor versi aplikasi atau ID penerapan Git di label untuk mengidentifikasi nilai kunci yang terkait dengan build perangkat lunak tertentu.
Nota
Jika Anda mencari versi perubahan, App Configuration menyimpan semua perubahan nilai kunci yang terjadi dalam periode waktu tertentu sebelumnya secara otomatis. Untuk informasi selengkapnya, lihat rekam jepret titik waktu.
Nilai kunci kueri
Setiap kunci-nilai secara unik diidentifikasi oleh kunci tersebut ditambah label yang dapat berupa \0. Anda meminta penyimpanan App Configuration untuk kunci-nilai dengan menentukan pola. Penyimpanan App Configuration mengembalikan semua kunci-nilai yang cocok dengan pola termasuk semua nilai dan atribut terkait. Gunakan pola kunci berikut dalam panggilan REST API ke App Configuration:
| Kunci | Deskripsi |
|---|---|
key dihilangkan atau key=* |
Mencocokkan semua kunci. |
key=abc |
Persis sama dengan nama kunci abc. |
key=abc* |
Cocok dengan nama kunci yang dimulai dengan abc. |
key=abc,xyz |
Cocok dengan kunci nama abc atau xyz. Dibatasi hingga lima CSV. |
Anda juga dapat menyertakan pola label berikut:
| Etiket | Deskripsi |
|---|---|
label dihilangkan atau label=* |
Cocok dengan label apa pun, yang mencakup \0. |
label=%00 |
Cocok dengan \0 label. |
label=1.0.0 |
Sama persis dengan label 1.0.0 . |
label=1.0.* |
Cocok dengan label yang dimulai dengan 1.0.. |
label=%00,1.0.0 |
Cocokkan label \0 atau 1.0.0, dengan batas sampai lima CSV. |
Nota
*, ,, dan \ adalah karakter yang telah dipesan dalam kueri. Jika karakter cadangan digunakan dalam nama kunci atau label Anda, Anda harus mengecualikannya dengan menggunakan \{Reserved Character} dalam kueri.
Nilai
Nilai yang ditetapkan terhadap kunci juga merupakan string unicode. Anda dapat menggunakan semua karakter unicode untuk nilai.
Gunakan tipe isi
Setiap nilai kunci dalam App Configuration memiliki atribut jenis konten. Anda dapat secara opsional menggunakan atribut ini untuk menyimpan informasi tentang jenis nilai dalam nilai kunci yang membantu aplikasi Anda memprosesnya dengan benar. Anda dapat menggunakan format apa pun untuk tipe konten. App Configuration menggunakan Jenis Media (juga dikenal sebagai jenis MIME) untuk jenis data bawaan seperti bendera fitur, referensi Key Vault, dan nilai kunci JSON.