SYSTEM RELOAD EMBEDDED DICTIONARIES
Ok. بغضّ النظر عن نتيجة تحديث القواميس الداخلية.
SYSTEM RELOAD DICTIONARIES
SYSTEM RELOAD DICTIONARIES تحميل القواميس التي تكون حالتها LOADED (راجع العمود status في system.dictionaries)، أي القواميس التي سبق تحميلها بنجاح.
تُحمَّل القواميس افتراضيًا بأسلوب التحميل عند الطلب (راجع dictionaries_lazy_load)، لذلك بدلًا من تحميلها تلقائيًا عند بدء التشغيل، تُهيَّأ عند أول وصول إليها باستخدام الدالة dictGet أو بتنفيذ SELECT على الجداول التي تستخدم ENGINE = Dictionary.
الصياغة
SYSTEM RELOAD DICTIONARY
dictionary_name بالكامل، بغضّ النظر عن حالته (LOADED / NOT_LOADED / FAILED).
ويُرجع دائمًا Ok. بصرف النظر عن نتيجة تحديث القاموس.
system.dictionaries.
SYSTEM RELOAD MODELS
لا تقوم هذه التعليمة ولا
SYSTEM RELOAD MODEL إلا بإلغاء تحميل نماذج catboost من clickhouse-library-bridge. وتحمّل الدالة catboostEvaluate()
نموذجًا عند أول استخدام له إذا لم يكن محمّلًا بالفعل.SYSTEM RELOAD MODEL
model_path.
الصياغة
SYSTEM RELOAD FUNCTIONS
SYSTEM RELOAD ASYNCHRONOUS METRICS
SYSTEM CLEAR|DROP DNS CACHE
disable_internal_dns_cache وdns_cache_max_entries وdns_cache_update_period.
SYSTEM CLEAR|DROP MARK CACHE
SYSTEM CLEAR|DROP ICEBERG METADATA CACHE
SYSTEM CLEAR|DROP AVRO SCHEMA CACHE
AvroConfluent. تُسقِط هذه العملية كلاً من ذاكرة التخزين المؤقت لجلب المخططات (id → schema) وذاكرة التخزين المؤقت لتسجيل المخططات (subject + schema → id)، لذا ستعود عمليات القراءة والكتابة اللاحقة إلى خادم السجل. ويكون ذلك مفيدًا عندما يكون مخطط قد حُذف أو أُعيدت كتابته على جانب السجل، أو للتحقق من خاصية idempotency الخاصة بالسجل في الاختبارات.
SYSTEM DROP PARQUET METADATA CACHE
SYSTEM CLEAR|DROP TEXT INDEX CACHES
SYSTEM CLEAR TEXT INDEX HEADER CACHE,SYSTEM CLEAR TEXT INDEX DICTIONARY CACHE، أوSYSTEM CLEAR TEXT INDEX POSTINGS CACHE
SYSTEM DROP REPLICA
ReplicatedMergeTree باستخدام الصيغة التالية:
ReplicatedMergeTree في ZooKeeper. ويكون ذلك مفيدًا عندما تكون النسخة المتماثلة متوقفة ولا يمكن إزالة بياناتها الوصفية من ZooKeeper باستخدام DROP TABLE لأنه لم يعد هناك مثل هذا الجدول. ولن يؤدي ذلك إلا إلى حذف النسخة المتماثلة غير النشطة/القديمة، ولا يمكنه حذف النسخة المتماثلة المحلية، لذا يُرجى استخدام DROP TABLE لهذا الغرض. ولا يقوم DROP REPLICA بحذف أي جداول، كما لا يزيل أي بيانات أو بيانات وصفية من القرص.
الأول يزيل البيانات الوصفية للنسخة المتماثلة 'replica_name' من الجدول database.table.
والثاني يفعل الأمر نفسه لجميع الجداول المتماثلة في قاعدة البيانات.
والثالث يفعل الأمر نفسه لجميع الجداول المتماثلة على الخادم المحلي.
والرابع مفيد لإزالة البيانات الوصفية لنسخة متماثلة متوقفة عندما تكون جميع النسخ المتماثلة الأخرى للجدول قد حُذفت. ويتطلب تحديد مسار الجدول بشكل صريح. ويجب أن يكون هو نفسه المسار الذي مُرِّر إلى الوسيطة الأولى لمحرك ReplicatedMergeTree عند إنشاء الجدول.
SYSTEM DROP DATABASE REPLICA
Replicated باستخدام الصياغة التالية:
SYSTEM DROP REPLICA، لكنه يزيل مسار النسخة المتماثلة لقاعدة البيانات Replicated من ZooKeeper عندما لا تكون هناك قاعدة بيانات يمكن تنفيذ DROP DATABASE عليها. يُرجى ملاحظة أنه لا يزيل النسخ المتماثلة لـ ReplicatedMergeTree (لذا قد تحتاج أيضًا إلى SYSTEM DROP REPLICA). اسمَا الـ shard والنسخة المتماثلة هما الاسمان اللذان تم تحديدهما في وسائط المحرك Replicated عند إنشاء قاعدة البيانات. كذلك، يمكن الحصول على هذين الاسمين من العمودين database_shard_name وdatabase_replica_name في system.clusters. إذا كان بند FROM SHARD غير موجود، فيجب أن يكون replica_name اسم النسخة المتماثلة الكامل بالتنسيق shard_name|replica_name.
SYSTEM CLEAR|DROP UNCOMPRESSED CACHE
use_uncompressed_cache على مستوى الاستعلام/المستخدم/ملف التعريف.
يمكن تهيئة حجمه باستخدام الإعداد uncompressed_cache_size على مستوى الخادم.
SYSTEM CLEAR|DROP COMPILED EXPRESSION CACHE
compile_expressions على مستوى الاستعلام/المستخدم/الملف الشخصي.
SYSTEM CLEAR|DROP QUERY CONDITION CACHE
SYSTEM CLEAR|DROP QUERY CACHE
SYSTEM CLEAR|DROP FORMAT SCHEMA CACHE
format_schema_path.
الأهداف المدعومة:
- Protobuf: يزيل تعريفات رسائل Protobuf المستوردة من الذاكرة.
- Files: يحذف ملفات المخططات المخزّنة مؤقتًا والمحفوظة محليًا في
format_schema_path، والتي تُنشأ عند تعيينformat_schema_sourceإلىquery. ملاحظة: إذا لم يتم تحديد أي هدف، فستُمسح كلتا الذاكرتين المؤقتتين.
SYSTEM FLUSH LOGS
SYSTEM RELOAD CONFIG
SYSTEM RELOAD CONFIG لا يعيد تحميل تهيئة USER المخزنة في ZooKeeper، وإنما يعيد تحميل تهيئة USER المخزنة في users.xml فقط. لإعادة تحميل جميع إعدادات USER، استخدم SYSTEM RELOAD USERS
SYSTEM RELOAD USERS
SYSTEM SHUTDOWN
service clickhouse-server stop / kill {$pid_clickhouse-server})
SYSTEM KILL
kill -9 {$ pid_clickhouse-server})
SYSTEM INSTRUMENT
ENABLE_XRAY=1.
ويتيح ذلك تصحيح الأعطال وتحليل الأداء في بيئة الإنتاج من دون تعديل الشيفرة المصدرية وبأقل تكلفة إضافية ممكنة.
وعند عدم إضافة أي نقطة تتبّع، تكون كلفة الأداء مهملة تقريبًا، لأنه لا يضيف سوى قفزة إضافية إلى عنوان قريب
في بداية تلك الدوال ونهايتها التي يزيد طولها على 200 تعليمة.
SYSTEM INSTRUMENT ADD
system.instrumentation. ويمكن إضافة أكثر من handler واحد إلى الدالة نفسها، وسيُنفَّذ بالترتيب نفسه الذي أُضيفت به تتبّع.
يمكن جلب الدوال المطلوب تتبّعها من جدول النظام system.symbols.
توجد ثلاثة أنواع مختلفة من handler يمكن إضافتها إلى الدوال:
Syntax
FUNCTION أي دالة أو جزءًا فرعيًا من دالة، مثل QueryMetricLog::startQuery، ويكون المعالج أحد العناصر التالية
LOG
ENTRY أو EXIT للدالة.
SLEEP
ENTRY أو EXIT:
PROFILE
ENTRY وEXIT في الدالة.
تُخزَّن نتيجة التنميط في system.trace_log، ويمكن تحويلها
إلى تنسيق تتبّع أحداث Chrome.
SYSTEM INSTRUMENT REMOVE
ALL:
system.instrumentation.
إدارة الجداول الموزعة
STOP DISTRIBUTED SENDS وFLUSH DISTRIBUTED وSTART DISTRIBUTED SENDS. ويمكنك أيضًا إدراج البيانات الموزعة بشكل متزامن باستخدام الإعداد distributed_foreground_insert.
SYSTEM STOP DISTRIBUTED SENDS
إذا كان
prefer_localhost_replica مُمكّنًا (وهو الإعداد الافتراضي)، فستُدرَج البيانات في الشظية المحلية على أي حال.SYSTEM FLUSH DISTRIBUTED
SETTINGS، وقد يكون ذلك مفيدًا لتجاوز بعض القيود المؤقتة، مثل max_concurrent_queries_for_all_users أو max_memory_usage.
تُخزَّن كل كتلة معلّقة على القرص وفقًا لإعدادات استعلام INSERT الأصلي، لذلك قد تحتاج أحيانًا إلى تجاوز هذه الإعدادات.
SYSTEM START DISTRIBUTED SENDS
SYSTEM STOP LISTEN
- إذا جرى تحديد المُعدِّل
CUSTOM 'protocol'، فسيتم إيقاف البروتوكول المخصّص الذي يحمل الاسم المحدد، والمُعرَّف في قسم البروتوكولات ضمن إعدادات الخادم. - إذا جرى تحديد المُعدِّل
QUERIES ALL [EXCEPT .. [,..]]، فسيتم إيقاف جميع البروتوكولات، ما لم يُنص على خلاف ذلك باستخدام العبارةEXCEPT. - إذا جرى تحديد المُعدِّل
QUERIES DEFAULT [EXCEPT .. [,..]]، فسيتم إيقاف جميع البروتوكولات الافتراضية، ما لم يُنص على خلاف ذلك باستخدام العبارةEXCEPT. - إذا جرى تحديد المُعدِّل
QUERIES CUSTOM [EXCEPT .. [,..]]، فسيتم إيقاف جميع البروتوكولات المخصّصة، ما لم يُنص على خلاف ذلك باستخدام العبارةEXCEPT.
SYSTEM START LISTEN
إدارة جداول MergeTree
SYSTEM STOP MERGES
سيؤدي تنفيذ
DETACH / ATTACH على الجدول إلى بدء عمليات الدمج في الخلفية لهذا الجدول، حتى إذا كانت عمليات الدمج قد أُوقِفت سابقًا لجميع جداول MergeTree.SYSTEM START MERGES
SYSTEM STOP TTL MERGES
Ok. حتى إذا لم يكن الجدول موجودًا أو لم يكن يستخدم محرك MergeTree. ويُرجع خطأ إذا كانت قاعدة البيانات غير موجودة:
SYSTEM START TTL MERGES
Ok. حتى إذا لم يكن الجدول موجودًا. ويعيد خطأً إذا لم تكن قاعدة البيانات موجودة:
SYSTEM STOP MOVES
Ok. حتى إذا لم يكن الجدول موجودًا. ويعيد خطأً عندما لا تكون قاعدة البيانات موجودة:
SYSTEM START MOVES
Ok. حتى إذا لم يكن الجدول موجودًا. ويُرجع خطأً عندما لا تكون قاعدة البيانات موجودة:
SYSTEM UNFREEZE
SYSTEM WAIT LOADING PARTS
إدارة جداول ReplicatedMergeTree
SYSTEM STOP FETCHES
ReplicatedMergeTree:
يُرجِع دائمًا Ok. بغضّ النظر عن محرك الجدول، وحتى إذا لم يكن الجدول أو قاعدة البيانات موجودَين.
SYSTEM START FETCHES
ReplicatedMergeTree:
ويُرجع دائمًا Ok. بغضّ النظر عن محرك الجدول، وحتى إذا لم يكن الجدول أو قاعدة البيانات موجودًا.
SYSTEM STOP REPLICATED SENDS
ReplicatedMergeTree:
SYSTEM START REPLICATED SENDS
ReplicatedMergeTree:
SYSTEM STOP REPLICATION QUEUES
ReplicatedMergeTree. أنواع مهام الخلفية الممكنة هي - عمليات الدمج، وعمليات الجلب، وعمليات mutation، وعبارات DDL التي تتضمن عبارة ON CLUSTER:
SYSTEM START REPLICATION QUEUES
ReplicatedMergeTree. أنواع المهام الخلفية الممكنة: عمليات الدمج، وعمليات الجلب، وعمليات التعديل، وعبارات DDL مع البند ON CLUSTER:
SYSTEM STOP PULLING REPLICATION LOG
ReplicatedMergeTree.
SYSTEM START PULLING REPLICATION LOG
SYSTEM STOP PULLING REPLICATION LOG.
SYSTEM SYNC REPLICA
ReplicatedMergeTree مع النسخ المتماثلة الأخرى في العنقود، على ألا تتجاوز مدة الانتظار receive_timeout ثانية.
[db.]replicated_merge_tree_family_table_name الأوامر من السجل المشترك للنسخ المتماثل إلى قائمة انتظار النسخ المتماثل الخاصة به، ثم ينتظر الاستعلام حتى تعالج النسخة المتماثلة جميع الأوامر التي تم جلبها. المعدِّلات التالية مدعومة:
- مع
IF EXISTS(متاح منذ 25.6)، لن يُرجع الاستعلام خطأً إذا لم يكن الجدول موجودًا. يفيد ذلك عند إضافة نسخة متماثلة جديدة إلى عنقود، عندما تكون بالفعل جزءًا من تهيئة العنقود لكنها لا تزال في طور إنشاء الجدول ومزامنته. - إذا جرى تحديد المعدِّل
STRICT، فإن الاستعلام ينتظر حتى تصبح قائمة انتظار النسخ المتماثل فارغة. وقد لا ينجحSTRICTأبدًا إذا كانت إدخالات جديدة تظهر باستمرار في قائمة انتظار النسخ المتماثل. - إذا جرى تحديد المعدِّل
LIGHTWEIGHT، فإن الاستعلام ينتظر فقط حتى تتم معالجة إدخالاتGET_PARTوATTACH_PARTوDROP_RANGEوREPLACE_RANGEوDROP_PART. بالإضافة إلى ذلك، يدعم المعدِّلLIGHTWEIGHTعبارةFROM 'srcReplicas'اختيارية، حيث إن ‘srcReplicas’ هي قائمة مفصولة بفواصل تضم أسماء النسخ المتماثلة المصدر. يتيح هذا الامتداد مزامنة أكثر استهدافًا من خلال التركيز فقط على مهام النسخ المتماثل القادمة من النسخ المتماثلة المصدر المحددة. - إذا جرى تحديد المعدِّل
PULL، فإن الاستعلام يسحب إدخالات جديدة إلى قائمة انتظار النسخ المتماثل من ZooKeeper، لكنه لا ينتظر معالجة أي شيء.
SYNC DATABASE REPLICA
SYSTEM RESTART REPLICA
ReplicatedMergeTree، إذ يقارن الحالة الحالية مع ZooKeeper باعتباره المصدر المرجعي المعتمد، ويضيف مهام إلى قائمة انتظار ZooKeeper عند الحاجة.
تتم تهيئة قائمة انتظار النسخ المتماثل استنادًا إلى بيانات ZooKeeper بالطريقة نفسها المتبعة في تعليمة ATTACH TABLE. وخلال فترة قصيرة، لن يكون الجدول متاحًا لإجراء أي عمليات.
SYSTEM RESTORE REPLICA
ReplicatedMergeTree في وضع readonly.
يمكن تنفيذ الاستعلام بعد:
- فقدان جذر ZooKeeper
/. - فقدان مسار النسخ المتماثلة
/replicas. - فقدان مسار نسخة متماثلة فردية
/replicas/replica_name/.
تُنقل الأجزاء في جميع حالاتها إلى المجلد
detached/. وتُرفَق الأجزاء التي كانت نشطة قبل فقدان البيانات (committed).SYSTEM RESTORE DATABASE REPLICA
SYSTEM RESTART REPLICAS
ReplicatedMergeTree، ويقارن الحالة الحالية مع ZooKeeper بوصفه المصدر المرجعي الصحيح، ويضيف مهام إلى قائمة الانتظار في ZooKeeper إذا لزم الأمر
SYSTEM CLEAR|DROP FILESYSTEM CACHE
SYSTEM SYNC FILE CACHE
هذا الإجراء مكلف جدًا وقد يُساء استخدامه.
SYSTEM LOAD PRIMARY KEY
SYSTEM UNLOAD PRIMARY KEY
إدارة Refreshable Materialized Views
system.view_refreshes عند استخدامها.
SYSTEM STOP [REPLICATED] VIEW, STOP VIEWS
STOP VIEW يؤثر فقط في النسخة المتماثلة الحالية، بينما يؤثر STOP REPLICATED VIEW في جميع النسخ المتماثلة.
لا تستمر حالة الإيقاف بعد إعادة تشغيل الخادم. بعد إعادة التشغيل، ستستأنف العروض جداول التحديث المُعدّة لها.
في قواعد بيانات Replicated أو Shared، يؤثر
SYSTEM STOP VIEW فقط في النسخة المتماثلة الحالية. استخدم SYSTEM STOP REPLICATED VIEW لإيقاف عمليات التحديث على جميع النسخ المتماثلة.SYSTEM START [REPLICATED] VIEW, START VIEWS
START VIEW يلغي أثر STOP VIEW، وSTART REPLICATED VIEW يلغي أثر STOP REPLICATED VIEW. كما يلغي START VIEW أثر PAUSE VIEW.
SYSTEM PAUSE VIEW, PAUSE VIEWS
SYSTEM STOP VIEW، فإن SYSTEM PAUSE VIEW لا يوقف تحديثًا قيد التنفيذ بالفعل: يُسمح للتحديث الجاري بأن يكتمل، ولا تُمنع إلا التحديثات اللاحقة.
يمكن التراجع عن ذلك باستخدام SYSTEM START VIEW أو SYSTEM START VIEWS.
لا تستمر حالة الإيقاف المؤقت بعد إعادة تشغيل الخادم. بعد إعادة التشغيل، ستستأنف العروض جداول التحديث المُهيأة لها.
في قواعد البيانات Replicated أو Shared، يؤثر
SYSTEM PAUSE VIEW في النسخة المتماثلة الحالية فقط.