المفاتيح والقيم

يخزن Azure App Configuration بيانات التكوين كقيم رئيسية. قيم المفاتيح هي تمثيل بسيط ومرنة لإعدادات التطبيق التي يستخدمها المطورون.

المفاتيح

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

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

    AppName:Service1:ApiEndpoint
    AppName:Service2:ApiEndpoint

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

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

يمكنك استخدام أي حرف unicode في أسماء المفاتيح باستثناء %. لا يمكن أن يكون . اسم المفتاح أو .. إما. هناك حد للحجم المجمع يبلغ 10 كيلوبايت على قيمة المفتاح. يتضمن هذا الحد جميع الأحرف في المفتاح وقيمته وجميع السمات الاختيارية المقترنة. ضمن هذا الحد، يمكن أن يكون لديك العديد من المستويات الهرمية للمفاتيح.

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

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

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

يمكنك تنظيم المفاتيح في تكوين التطبيق هرميا بعدة طرق. فكر في مفاتيح مثل معرفات URI. كل مفتاح هرمي هو مسار مورد يتكون من مكون واحد أو أكثر من المكونات التي يتم ربطها معا بواسطة المحددات. اختر الحرف الذي تريد استخدامه كمحدد استنادا إلى ما يحتاجه التطبيق أو لغة البرمجة أو إطار العمل. استخدم محددات متعددة لمفاتيح مختلفة في تكوين التطبيق.

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

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

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

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

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

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

إشعار

إذا كنت تبحث عن إصدارات التغيير، فإن App Configuration يحتفظ تلقائيا بجميع تغييرات قيمة المفتاح التي حدثت في الفترة الزمنية المحددة الماضية. لمزيد من المعلومات، راجع لقطة نقطة زمنية.

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

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

مفتاح	‏‏الوصف
key تم حذفه أو key=*	يطابق جميع المفاتيح.
key=abc	يطابق اسم abc المفتاح تماما.
key=abc*	يطابق أسماء المفاتيح التي تبدأ ب abc.
key=abc,xyz	يطابق أسماء abc المفاتيح أو xyz. يقتصر على خمسة CSVs.

يمكنك أيضا تضمين أنماط التسمية التالية:

تسميه	‏‏الوصف
label تم حذفه أو label=*	يطابق أي تسمية، والتي تتضمن \0.
label=%00	يطابق التسمية \0 .
label=1.0.0	يطابق التسمية 1.0.0 تماما.
label=1.0.*	يطابق التسميات التي تبدأ ب 1.0..
label=%00,1.0.0	يطابق التسميات \0 أو 1.0.0، يقتصر على خمسة CSVs.

إشعار

*، ,و، و \ أحرف محجوزة في الاستعلامات. إذا تم استخدام حرف محجوز في أسماء المفاتيح أو التسميات، فيجب عليك تخطيه باستخدام \{Reserved Character} في الاستعلامات.

القيم

القيم المُعينة للمفاتيح هي أيضاً سلاسل unicode. يمكنك استخدام جميع أحرف unicode للقيم.

استخدام نوع المحتوى

تحتوي كل قيمة مفتاح في تكوين التطبيق على سمة نوع المحتوى. يمكنك اختياريا استخدام هذه السمة لتخزين معلومات حول نوع القيمة في قيمة مفتاح تساعد تطبيقك على معالجتها بشكل صحيح. يمكنك استخدام أي تنسيق لنوع المحتوى. يستخدم تكوين التطبيق أنواع الوسائط (المعروفة أيضا باسم أنواع MIME) لأنواع البيانات المضمنة مثل علامات الميزات ومراجع Key Vault وقيم مفاتيح JSON.

الخطوات التالية

لقطة في نقطة زمنية

إدارة الميزات

معالجة الأحداث