JSONCompactEachRowWithProgress

إدخال	إخراج	اسم مستعار
✗	✔

الوصف

تجمع هذه الصيغة بين الإخراج المضغوط صفًا بصف الذي توفّره صيغة JSONCompactEachRow ومعلومات التقدّم التي تُرسَل بشكل متدفق. يبثّ ClickHouse كل حدث في كائن JSON مستقل، وتحتفظ قيم الأعمدة بأنواع JSON الأصلية الخاصة بها. تستخدم الصيغة المرتبطة بها JSONCompactStringsEachRowWithProgress أنواع الكائنات نفسها في المستوى الأعلى، غير أن قيم الحقول فيها تُسلسَل على هيئة string. تشترك هذه الصيغة مع JSONEachRowWithProgress في عقد الدفق نفسه (writesProgressConcurrently / finalizeImpl)، باستثناء أن حمولات row / totals / min / max تكون مصفوفات من القيم مرتّبة وفق ترتيب الأعمدة، لا كائنات مسمّاة.

كائنات الدفق

يمثّل كل سطر من الاستجابة كائن JSON واحدًا. وينبغي للعملاء توجيه المعالجة بحسب المفتاح في المستوى الأعلى:

المفتاح في المستوى الأعلى	متى يظهر	الشكل
`meta`	مرة واحدة، قبل أول `row` (قد يُرسَل كائن `progress` قبله)	`{"meta":[{"name":...,"type":...}, ...]}` — أسماء الأعمدة وأنواعها
`row`	مرة واحدة لكل صف في النتيجة	`{"row":[...]}` — قيم الأعمدة بترتيب الترويسة
`progress`	دوريًا أثناء تنفيذ الاستعلام	`{"progress":{...}}` — عدّادات مثل `read_rows` و`read_bytes` و`total_rows_to_read`
`totals`	عند وجود إجماليات	`{"totals":[...]}` — قيم صف الإجماليات بترتيب الترويسة
`min` / `max`	عند وجود قيم قصوى	`{"min":[...]}` / `{"max":[...]}` — قيم صفَّي القيم القصوى بترتيب الترويسة
`rows_before_limit_at_least`	عندما يتضمّن الاستعلام `LIMIT`	`{"rows_before_limit_at_least":N}` — تقدير أدنى لعدد الصفوف التي كانت ستُعاد لولا `LIMIT` (وليس دليلًا على حذف صفوف)
`rows_before_aggregation`	عندما يُجري الاستعلام عملية تجميع ويكون العدّاد `rows_before_aggregation` مفعّلًا	`{"rows_before_aggregation":N}`
`exception`	عند فشل الاستعلام، عبر مسار HTTP مع `http_write_exception_in_output_format=1`	`{"exception":"..."}` — نص الخطأ بوصفه string في المستوى الأعلى، لا متداخلًا ضمن `row`

يُرسَل الكائن rows_before_limit_at_least عندما يتضمّن الاستعلام LIMIT، حتى إن لم يؤدِّ الحدّ إلى حذف أي صفوف. وهو تقدير أدنى لعدد الصفوف التي كانت ستُعاد لولا LIMIT (بالمعنى نفسه المستخدم في JSON)؛ لذا يجب ألا يعدّه العملاء دليلًا على حذف صفوف. يُرسَل meta مرة واحدة قبل أول row، غير أن كائن progress قد يصل قبل meta. ولا يُرسَل الكائن exception في المستوى الأعلى عبر مسار HTTP إلا عند ضبط http_write_exception_in_output_format=1؛ وفي غير ذلك يظهر الخطأ عبر طبقة النقل. وعند إرساله، يكون كائنًا مستقلًا في المستوى الأعلى، لا متداخلًا ضمن row.

مثال للاستخدام

Query

SELECT *
FROM generateRandom('a Array(Int8), d Decimal32(4), c Tuple(DateTime64(3), UUID)', 1, 10, 2)
LIMIT 5
FORMAT JSONCompactEachRowWithProgress

Response

{"meta":[{"name":"a","type":"Array(Int8)"},{"name":"d","type":"Decimal(9, 4)"},{"name":"c","type":"Tuple(DateTime64(3), UUID)"}]}
{"row":[[-8], 46848.5225, ["2064-06-11 14:00:36.578","b06f4fa1-22ff-f84f-a1b7-a5807d983ae6"]]}
{"row":[[-76], -85331.598, ["2038-06-16 04:10:27.271","2bb0de60-3a2c-ffc0-d7a7-a5c88ed8177c"]]}
{"row":[[-32], -31470.8994, ["2027-07-18 16:58:34.654","1cdbae4c-ceb2-1337-b954-b175f5efbef8"]]}
{"row":[[-116], 32104.097, ["1979-04-27 21:51:53.321","66903704-3c83-8f8a-648a-da4ac1ffa9fc"]]}
{"row":[[], 2427.6614, ["1980-04-24 11:30:35.487","fee19be8-0f46-149b-ed98-43e7455ce2b2"]]}
{"progress":{"read_rows":"5","read_bytes":"184","total_rows_to_read":"5","elapsed_ns":"335771"}}
{"rows_before_limit_at_least":5}

مرجع SQL

أنواع البيانات

المحركات

الدوال

الصيغ

الإعدادات

جداول النظام

بحيرات البيانات

الوصف

كائنات الدفق

مثال للاستخدام

إعدادات التنسيق

​الوصف

​كائنات الدفق

​مثال للاستخدام

​إعدادات التنسيق

الوصف

كائنات الدفق

مثال للاستخدام

إعدادات التنسيق