مشاركة عبر


read_state_metadata دالة ذات قيمة جدولية

ينطبق على: وضع علامة Databricks SQL وضع علامة Databricks Runtime 14.3 وما فوق

إرجاع جدول يحتوي على صفوف تمثل بيانات التعريف لحالة استعلام الدفق.

دالة قيم الجدول لقراءة بيانات التعريف لعوامل تشغيل الاستعلام المتدفقة ذات الحالة. وهو يدعم فقط التشغيل كتعلام دفعي.

بناء الجملة

read_state_metadata(path)

الوسيطات

تتطلب هذه الدالة استدعاء معلمة مسماة لمفاتيح الخيارات.

  • pathSTRING: قيمة حرفية مع مسار موقع نقطة التحقق للاستعلام المتدفق.

المرتجعات

يحتوي جدول بيانات تعريف الحالة على المخطط التالي. كافة الأعمدة ليست فارغة.

  • operatorId INT NOT NULL

    معرف عدد صحيح لمشغل البث ذي الحالة.

  • operatorName STRING NOT NULL

    اسم عامل تشغيل الدفق ذي الحالة.

  • stateStoreName STRING NOT NULL

    اسم مخزن الحالة لعامل التشغيل.

  • numPartitions INT NOT NULL

    عدد أقسام مخزن الحالة.

  • minBatchId BIGINT NOT NULL

    الحد الأدنى لمعرف الدفعة المتاح لحالة الاستعلام. قد تكون القيمة غير صالحة إذا كان الاستعلام المتدفق الذي يأخذ نقطة التحقق قيد التشغيل، لأنه قد يؤدي إلى تشغيل التنظيف.

  • maxBatchId BIGINT NOT NULL

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

الأمثلة

- Read state metadata from the checkpoint
> SELECT * FROM read_state_metadata('/checkpoint/path');