عبارات KILL

توثيق KILL

يوجد نوعان من عبارات KILL: أحدهما لإنهاء استعلام والآخر لإنهاء mutation

​

KILL QUERY

KILL QUERY [ON CLUSTER cluster]
  WHERE <where expression to SELECT FROM system.processes query>
  [SYNC|ASYNC|TEST]
  [FORMAT format]

تُستخدَم لإنهاء الاستعلامات الجارية حاليًا قسرًا. تُحدَّد الاستعلامات المطلوب إنهاؤها من جدول system.processes باستخدام المعايير المحددة في عبارة WHERE ضمن استعلام KILL.

أمثلة:

أولًا، ستحتاج إلى الحصول على قائمة الاستعلامات غير المكتملة. يعرض استعلام SQL هذا هذه القائمة مرتبةً حسب الأطول تشغيلًا:

قائمة من عقدة ClickHouse واحدة:

SELECT
  initial_query_id,
  query_id,
  formatReadableTimeDelta(elapsed) AS time_delta,
  query,
  *
  FROM system.processes
  WHERE query ILIKE 'SELECT%'
  ORDER BY time_delta DESC;

قائمة من عنقود ClickHouse:

SELECT
  initial_query_id,
  query_id,
  formatReadableTimeDelta(elapsed) AS time_delta,
  query,
  *
  FROM clusterAllReplicas(default, system.processes)
  WHERE query ILIKE 'SELECT%'
  ORDER BY time_delta DESC;

أنهِ الاستعلام:

-- Forcibly terminates all queries with the specified query_id:
KILL QUERY WHERE query_id='2-857d-4a57-9ee0-327da5d60a90'

-- Synchronously terminates all queries run by 'username':
KILL QUERY WHERE user='username' SYNC

إذا كنت تُنهي استعلامًا في ClickHouse Cloud أو في عنقود مُدار ذاتيًا، فتأكّد من استخدام الخيار ON CLUSTER [cluster-name] لضمان إنهاء الاستعلام على جميع النُسخ المتماثلة

لا يمكن للمستخدمين للقراءة فقط إيقاف سوى استعلاماتهم الخاصة.

بشكل افتراضي، يُستخدَم الإصدار غير المتزامن من الاستعلامات (ASYNC)، وهو لا ينتظر تأكيدًا على توقّف الاستعلامات.

ينتظر الإصدار المتزامن (SYNC) حتى تتوقف جميع الاستعلامات، ويعرض معلومات عن كل عملية عند توقفها. تتضمن الاستجابة العمود kill_status، والذي يمكن أن يأخذ القيم التالية:

1. finished – تم إنهاء الاستعلام بنجاح.
2. waiting – جارٍ انتظار انتهاء الاستعلام بعد إرسال إشارة إليه بإنهائه.
3. تشرح القيم الأخرى سبب تعذّر إيقاف الاستعلام.

لا يتحقق الاستعلام الاختباري (TEST) إلا من صلاحيات المستخدم ويعرض قائمة بالاستعلامات المطلوب إيقافها.

​

KILL MUTATION

غالبًا ما يشير وجود عمليات mutation تستغرق وقتًا طويلًا أو عمليات mutation غير مكتملة إلى أن خدمة ClickHouse لا تعمل بكفاءة. وقد تتسبب الطبيعة غير المتزامنة لهذه عمليات mutation في استهلاكها جميع الموارد المتاحة على النظام. وقد تحتاج إلى أحد الخيارين التاليين:

• إيقاف جميع عمليات mutation الجديدة وعمليات INSERT وSELECT مؤقتًا، وترك قائمة انتظار عمليات mutation تكتمل.
• أو إنهاء بعض هذه عمليات mutation يدويًا بإرسال أمر KILL.

KILL MUTATION
  WHERE <where expression to SELECT FROM system.mutations query>
  [TEST]
  [FORMAT format]

يحاول إلغاء عمليات mutations الجارية حاليًا وإزالتها. تُحدَّد عمليات mutations المطلوب إلغاؤها من جدول system.mutations باستخدام عامل التصفية المحدد في عبارة WHERE ضمن استعلام KILL.

استعلام الاختبار (TEST) يتحقق فقط من صلاحيات المستخدم ويعرض قائمة بعمليات mutations التي سيتم إيقافها.

أمثلة:

الحصول على count() لعدد عمليات mutations غير المكتملة:

عدد عمليات mutations من عقدة ClickHouse واحدة:

SELECT count(*)
FROM system.mutations
WHERE is_done = 0;

عدد عمليات mutation في عنقود ClickHouse من النُسخ المتماثلة:

SELECT count(*)
FROM clusterAllReplicas('default', system.mutations)
WHERE is_done = 0;

استعلم عن قائمة عمليات mutation غير المكتملة:

قائمة عمليات mutation من عقدة ClickHouse واحدة:

SELECT mutation_id, *
FROM system.mutations
WHERE is_done = 0;

قائمة عمليات mutation في عنقود ClickHouse:

SELECT mutation_id, *
FROM clusterAllReplicas('default', system.mutations)
WHERE is_done = 0;

أوقِف عمليات الـ mutation عند الحاجة:

-- Cancel and remove all mutations of the single table:
KILL MUTATION WHERE database = 'default' AND table = 'table'

-- Cancel the specific mutation:
KILL MUTATION WHERE database = 'default' AND table = 'table' AND mutation_id = 'mutation_3.txt'

يكون هذا الاستعلام مفيدًا عندما تكون إحدى عمليات mutation عالقة ولا يمكنها الاكتمال (على سبيل المثال، إذا كانت إحدى الدوال في استعلام mutation تُطلق استثناءً عند تطبيقها على البيانات الموجودة في الجدول).

لا يُتراجع عن التغييرات التي أجرتها mutation بالفعل.

لا يعني العمود is_killed=1 (في ClickHouse Cloud فقط) في جدول system.mutations بالضرورة أن mutation قد انتهت بالكامل. فقد تظل mutation في حالة يكون فيها is_killed=1 وis_done=0 لفترة طويلة. ويمكن أن يحدث هذا إذا كانت mutation أخرى طويلة التشغيل تحجب mutation التي تم إيقافها. هذا وضع طبيعي.