إنشاء مفاتيح وقيم مقترنة

مكتمل

يخزن Azure App Configuration بيانات التكوين باعتبارها أزواج لقيم المفاتيح.

المفاتيح

تعمل المفاتيح باعتبارها أزواج قيم المفاتيح وتُستخدم لتخزين واسترداد القيم المقابلة. من الممارسات الشائعة تنظيم المفاتيح في مساحة أسماء هرمية باستخدام محدِّد الأحرف، مثل / أو :. استخدام الاتفاقية الأنسب لتطبيقك. تتعامل خدمة App Configuration مع المفاتيح ككل. لا تحلل المفاتيح لمعرفة كيفية هيكلة أسمائها أو فرض أي قاعدة عليها.

فيما يلي مثال على أسماء المفاتيح المصنفة في تسلسل هرمي استنادًا إلى الخدمات المكونة:

AppName:Service1:ApiEndpoint
AppName:Service2:ApiEndpoint

قد يفرض استخدام بيانات التكوين داخل أطر عمل التطبيق أنظمة تسمية محددة لقيم المفاتيح. على سبيل المثال، يحدد إطار عمل Java Spring Cloud الموارد Environment التي توفر الإعدادات لتطبيق Spring. يتم التعبير عن هذه المعلمات عبر الحدود عن طريق المتغيرات التي تتضمن اسم التطبيق وملف التعريف. تبدأ مفاتيح بيانات التكوين ذات الصلة بـ Spring Cloud عادةً بهذين العنصرين مفصولين بمحدد.

المفاتيح المخزنة في "App Configuration" هي سلاسل حساسة لحالة الأحرف، تستند إلى Unicode. المفتاحان app1 و App1 متميزان في مخزن App Configuration. ضع ذلك في الاعتبار عند استخدام إعدادات التكوين داخل أحد التطبيقات لأن بعض إطارات العمل تتعامل مع مفاتيح التكوين بصورةٍ غير حساسة لحالة الأحرف.

يمكنك استخدام أي حرف unicode في أسماء المفاتيح التي تم إدخالها في App Configuration باستثناء * و , و \. هذه الأحرف محجوزة. إذا كنت بحاجة إلى تضمين حرف محجوز، فيجب عليك الهروب منه باستخدام \{Reserved Character}. يوجد حد مجمّع للحجم يبلغ 10000 حرف على زوج قيم المفاتيح. يشمل هذا الحد جميع الأحرف في المفتاح وقيمته وجميع السمات الاختيارية المرتبطة به. ضمن هذا الحد، يمكن أن يكون لديك العديد من المستويات الهرمية للمفاتيح.

تصميم مساحات أسماء المفاتيح

هناك طريقتان عامتان لتسمية المفاتيح المستخدمة لبيانات التكوين: مسطحة أو هرمية. هذه الأساليب متشابهة من وجهة نظر استخدام التطبيق، لكن التسمية الهرمية تقدم الكثير من المزايا:

• أسهل في القراءة. بدلاً من سلسلة واحدة طويلة من الأحرف، تعمل المحدِّدات في اسم المفتاح الهرمي باعتبارها مسافات في الجملة.
• أسهل في الإدارة. يمثل التدرج الهرمي لاسم المفتاح المجموعات المنطقية لبيانات التكوين.
• أسهل في الاستخدام. من الأسهل كتابة استعلام يطابق الأنماط المفاتيح في بنية هرمية ويسترد جزءًا فقط من بيانات التكوين.

مفاتيح التسمية

قد تحتوي القيم الأساسية في App Configuration اختيارياً على سمة التسمية. تُستخدم التسميات لتمييز قيم المفاتيح باستخدام نفس المفتاح. مفتاح app1 مع التسميات A و Bيشكل مفتاحين منفصلين في مخزن App Configuration. بشكلٍ افتراضي، لا تحتوي قيمة المفتاح على تسمية. للإشارة صراحة إلى قيمة مفتاح دون تسمية، استخدم \0 (عنوان URL مرمز باسم %00).

توفر تسمية طريقة ملائمة لإنشاء متغيرات لأحد المفاتيح. الاستخدام الشائع للتسميات هو تحديد بيئات متعددة لنفس المفتاح:

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

قيم مفتاح الإصدار

لا يصدر "App Configuration" قيم المفاتيح تلقائيًا أثناء تعديلها. استخدام التسميات باعتبارها طريقة لإنشاء إصدارات متعددة من قيمة مفتاح. على سبيل المثال، يمكنك إدخال رقم إصدار تطبيق أو معرّف تثبيت Git في التسميات لتحديد قيم المفاتيح المقترنة ببناء برنامج معين.

الاستعلام عن قيم المفاتيح

تُعرَّف كل قيمة مفتاح تعريفاً فريداً بواسطة مفتاحها بالإضافة إلى تسمية يمكن أن تكون \0. يمكنك الاستعلام عن مخزن App Configuration للقيم الأساسية عن طريق تحديد نمط. يعرض مخزن "App Configuration" جميع القيم الأساسية التي تطابق النمط بما في ذلك القيم والسمات المقابلة لها.

القيم

القيم المُعينة للمفاتيح هي أيضاً سلاسل unicode. يمكنك استخدام جميع أحرف unicode للقيم. هناك نوع محتوى اختياري معرّف بواسطة المستخدم مرتبط بكل قيمة. استخدم هذه السمة لتخزين المعلومات، على سبيل المثال، مخطط ترميز، حول قيمة تساعد تطبيقك على معالجتها بشكل صحيح.

تُشفَّر بيانات التكوين المُخزَّنة في مخزن "App Configuration"، والذي يتضمن جميع المفاتيح والقيم، في حالة الثبات وأثناء النقل. App Configuration ليس حلاً بديلاً لـ Azure Key Vault. لا تُخزَّن أسرار التطبيق فيه.