إنتقل إلى المحتوى الرئيسي
صفحة مترجمة

تُرجمت هذه الصفحة من الإنجليزية بمساعدة الذكاء الاصطناعي. إذا اختلفت النسختان، فالمرجع هو النسخة الإنجليزية.

DESCRIBE

تصف موردًا أو أسلوبًا محددًا لمورد.

راجع أيضًا: [ التسلسل الهرمي لموارد StackQL ]


بناء الجملة​

describeStatement::=

DESCRIBEMETHODEXTENDEDmultipartIdentifier';'

   

DESCRIBE [ METHOD ] [ EXTENDED ] <multipartIdentifier> ;
DESC [ EXTENDED ] <multipartIdentifier> ;

يقبل StackQL الكلمة الأساسية DESC كاسم مستعار لـ DESCRIBE عند وصف مورد؛ أما جملة DESCRIBE METHOD فتتطلب الكلمة الأساسية كاملة.

الاستجابة​

العمودالوصف
nameاسم الحقل
typeنوع البيانات (string، integer، boolean، number، object، array)
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;