انتقل إلى المحتوى

مختبر JMESPath

اختبر تعبير JMESPath على JSON وشاهد النتيجة بصيغة JSON منسقة. اكتب تعبيرات مثل locations[?state == 'WA'].name | sort(@) لتصفية البيانات وإسقاطها وإعادة تشكيلها. لغة الاستعلام JMESPath هي اللغة المستخدمة في خيار --query لـ AWS CLI وCLI في Azure، لذا فهذه طريقة سريعة لإتقان مثل هذا الاستعلام.

إعادة تعيين

الأسئلة الشائعة

ما هي JMESPath؟

JMESPath هي لغة استعلام لـ JSON ذات مواصفات رسمية. تتيح تحديد القيم بمسارات مثل a.b، وتصفية المصفوفات باستخدام [?condition]، وإسقاط القوائم باستخدام [*]، وتحويل البيانات بدوال مثل sort_by وlength وjoin.

أين تُستخدم JMESPath؟

يستخدم AWS CLI هذه اللغة لخيار --query، ويستخدمها CLI في Azure للخيار --query أيضًا، كما تتيحها Ansible عبر عامل التصفية json_query. اختبر تعبيرًا هنا، ثم ألصقه في أمرك.

كيف تبدو النتيجة إذا لم يطابق أي شيء؟

تُرجع JMESPath القيمة null عندما لا يوجد المسار، ومصفوفة فارغة عندما لا يُبقي عامل التصفية أي عناصر. تطبع الأداة تلك القيمة كما هي، لذا تعني null في النتيجة أن التعبير لم يعثر على شيء.

كيف أكتب قيمة نصية حرفية في عامل تصفية؟

استخدم علامات اقتباس مفردة للسلاسل النصية الخام، مثل [?name == 'web']. القيم داخل علامات الاقتباس الخلفية هي قيم حرفية من نوع JSON، مثل `10` أو `true`. تُستخدم علامات الاقتباس المزدوجة للمعرّفات ذات الأحرف الخاصة، مثل "first-name".

ما الدوال المتاحة؟

جميع دوال مواصفات JMESPath، بما في ذلك abs وavg وcontains وends_with وjoin وkeys وlength وmap وmax_by وmerge وmin_by وnot_null وreverse وsort وsort_by وstarts_with وsum وto_array وto_number وto_string وtype وvalues.

لماذا يظهر لي خطأ متعلق بالأنواع؟

تتحقق دوال JMESPath من أنواع الوسائط. مثلًا، يفشل abs عند تطبيقه على سلسلة نصية، وتذكر الرسالة النوع المتوقع. حوّل القيم أولًا باستخدام to_number أو to_string، أو صفِّ العناصر ذات النوع غير المناسب.

نبذة عن OneClick Pro

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