تُرجمت هذه الصفحة من الإنجليزية بمساعدة الذكاء الاصطناعي. إذا اختلفت النسختان، فالمرجع هو النسخة الإنجليزية.
DESCRIBE
تصف موردًا أو أسلوبًا محددًا لمورد.
راجع أيضًا: [ التسلسل الهرمي لموارد StackQL ]
بناء الجملة
describeStatement::=
DESCRIBE [ METHOD ] [ EXTENDED ] <multipartIdentifier> ;
DESC [ EXTENDED ] <multipartIdentifier> ;
يقبل StackQL الكلمة الأساسية DESC كاسم مستعار لـ DESCRIBE عند وصف مورد؛ أما جملة DESCRIBE METHOD فتتطلب الكلمة الأساسية كاملة.
الاستجابة
- DESCRIBE
- DESCRIBE METHOD
| العمود | الوصف |
|---|---|
name | اسم الحقل |
type | نوع البيانات (string، integer، boolean، number، object، array) |
description | وصف الحقل (عند تحديد EXTENDED) |
| العمود | الوصف |
|---|---|
name | اسم الحقل |
type | نوع البيانات (string، integer، boolean، number، object، array) |
param_type | input_required أو input_optional أو output |
shape | مجموعة فرعية من JSON Schema لحقول الكائنات والمصفوفات؛ فارغ للحقول المفردة. يتضمن properties وitems وrequired وenum وdefault وdescription المتداخلة، ويتضمن اختياريًا قيمًا منطقية إذا أتاحها الموفر (readOnly، writeOnly، deprecated) |
description | وصف الحقل (عند تحديد EXTENDED) |
أمثلة
جملة DESCRIBE أساسية
شغّل جملة DESCRIBE أساسية لسرد الحقول في مورد من جلسة مصادق عليها.
-- Show the available fields in a Compute Engine resource
DESCRIBE google.compute.instances;
جملة DESCRIBE موسعة
شغّل جملة DESCRIBE موسعة لسرد الحقول في مورد وأوصافها من جلسة مصادق عليها.
-- Show the available fields in a Compute Engine resource
DESCRIBE EXTENDED google.compute.instances;
الاسم المستعار DESC
الكلمة الأساسية DESC اختصار لـ DESCRIBE عند وصف مورد، مع EXTENDED أو بدونها. ويعاملها StackQL كجملة للقراءة فقط في كل موضع يعامل فيه DESCRIBE كذلك، بما في ذلك الأداة run_select_query في خادم MCP في الوضعين read_only وsafe.
-- Same result as DESCRIBE EXTENDED google.compute.instances
DESC EXTENDED google.compute.instances;
جملة DESCRIBE METHOD أساسية
افحص أسلوبًا واحدًا لمورد. تتضمن النتيجة معلمات الإدخال وحقول الاستجابة، مع عرض البنية المتداخلة في العمود shape.
-- Show the inputs and outputs for the buckets.get method
DESCRIBE METHOD google.storage.buckets.get;
جملة DESCRIBE METHOD موسعة
شغّل جملة DESCRIBE METHOD موسعة لتضمين وصف لكل حقل إلى جانب الشكل.
-- Show inputs, outputs, and descriptions for the buckets.insert method
DESCRIBE METHOD EXTENDED google.storage.buckets.insert;
اكتشاف حمولة INSERT
جملة DESCRIBE METHOD هي الوسيلة المعيارية لاكتشاف الحقول التي تقبلها جملة INSERT (أو أي أسلوب لتعديل البيانات). يحمل العمود shape بنية متداخلة يمكن للوكلاء والبشر استخدامها لبناء حمولة في استعلام واحد.
-- See what google.compute.instances.insert requires
DESCRIBE METHOD EXTENDED google.compute.instances.insert;