الانتقال إلى المحتوى الرئيسي
يحتفظ محرك الجدول File بالبيانات في ملف بأحد تنسيقات الملفات المدعومة (TabSeparated, Native، إلخ). سيناريوهات الاستخدام:
  • تصدير البيانات من ClickHouse إلى ملف.
  • تحويل البيانات من تنسيق إلى آخر.
  • تحديث البيانات في ClickHouse من خلال تحرير ملف على قرص.
هذا المحرك غير متاح حاليًا في ClickHouse Cloud، يُرجى استخدام دالة الجدول S3 بدلًا من ذلك.

​
الاستخدام في خادم ClickHouse

File(Format)
تحدِّد المعلمة Format أحد تنسيقات الملفات المتاحة. ولتنفيذ استعلامات SELECT، يجب أن يكون التنسيق مدعومًا للإدخال، أما لتنفيذ استعلامات INSERT، فيجب أن يكون مدعومًا للإخراج. تُسرد التنسيقات المتاحة في قسم التنسيقات. لا يسمح ClickHouse بتحديد مسار filesystem للمحرّك File. وسيستخدم المجلد المحدَّد بواسطة إعداد path في تهيئة الخادم. عند إنشاء جدول باستخدام File(Format)، يُنشأ مجلد فرعي فارغ داخل ذلك المجلد. وعند كتابة البيانات إلى ذلك الجدول، تُحفظ في الملف data.Format داخل ذلك المجلد الفرعي. يمكنك إنشاء هذا المجلد الفرعي والملف يدويًا في filesystem الخاص بالخادم، ثم تنفيذ ATTACH لهما وربطهما بمعلومات الجدول المطابقة للاسم، بحيث يمكنك الاستعلام عن البيانات من ذلك الملف.
توخَّ الحذر عند استخدام هذه الوظيفة، لأن ClickHouse لا يتتبّع التغييرات الخارجية التي تطرأ على مثل هذه الملفات. ونتيجة الكتابة المتزامنة عبر ClickHouse ومن خارجه غير معرّفة.

​
مثال

1. أنشئ الجدول file_engine_table: 
CREATE TABLE file_engine_table (name String, value UInt32) ENGINE=File(TabSeparated)
افتراضيًا، سينشئ ClickHouse المجلد /var/lib/clickhouse/data/default/file_engine_table. 2. أنشئ يدويًا الملف /var/lib/clickhouse/data/default/file_engine_table/data.TabSeparated بحيث يتضمن: 
$ cat data.TabSeparated
one 1
two 2
3. نفِّذ استعلامًا على البيانات: 
SELECT * FROM file_engine_table

┌─name─┬─value─┐
│ one  │     1 │
│ two  │     2 │
└──────┴───────┘

​
الاستخدام في ClickHouse-local

في clickhouse-local، يقبل محرك File مسار الملف بالإضافة إلى Format. ويمكن تحديد تدفقات الإدخال/الإخراج الافتراضية باستخدام أسماء رقمية أو أسماء مقروءة بشريًا مثل 0 أو stdin، و1 أو stdout. كما يمكن قراءة الملفات المضغوطة وكتابتها استنادًا إلى مَعلَمة إضافية للمحرك أو امتداد الملف (gz أو br أو xz). مثال: 
$ echo -e "1,2\n3,4" | clickhouse-local -q "CREATE TABLE table (a Int64, b Int64) ENGINE = File(CSV, stdin); SELECT a, b FROM table; DROP TABLE table"

​
تفاصيل التنفيذ

  • يمكن تنفيذ عدة استعلامات SELECT بالتزامن، لكن استعلامات INSERT تنتظر بعضها بعضًا.
  • يدعم إنشاء ملف جديد باستخدام استعلام INSERT.
  • إذا كان الملف موجودًا، فإن INSERT يُلحِق به قيماً جديدة.
  • غير مدعوم:
    • ALTER
    • SELECT ... SAMPLE
    • الفهارس
    • النسخ المتماثل

​
PARTITION BY

PARTITION BY — اختياري. يمكن إنشاء ملفات منفصلة عبر تقسيم البيانات باستخدام مفتاح تقسيم. في معظم الحالات، لن تحتاج إلى مفتاح تقسيم، وحتى عند الحاجة إليه، فغالباً لا تحتاج إلى مفتاح تقسيم أدق من التقسيم حسب الشهر. لا يؤدي التقسيم إلى تسريع الاستعلامات (على خلاف تعبير ORDER BY). ويجب ألا تستخدم أبداً تقسيمًا شديد الدقة. لا تقسّم بياناتك حسب معرّفات العملاء أو أسمائهم (وعوضاً عن ذلك، اجعل معرّف العميل أو اسمه هو العمود الأول في تعبير ORDER BY). للتقسيم حسب الشهر، استخدم التعبير toYYYYMM(date_column)، حيث إن date_column هو عمود يحتوي على تاريخ من النوع Date. وتكون أسماء الأقسام هنا بالتنسيق "YYYYMM".

​
الأعمدة الافتراضية

  • _path — مسار الملف. النوع: LowCardinality(String).
  • _file — اسم الملف. النوع: LowCardinality(String).
  • _size — حجم الملف بالبايت. النوع: Nullable(UInt64). إذا كان الحجم غير معروف، تكون القيمة NULL.
  • _time — وقت آخر تعديل للملف. النوع: Nullable(DateTime). إذا كان الوقت غير معروف، تكون القيمة NULL.

​
الإعدادات

  • engine_file_empty_if_not_exists - يتيح قراءة بيانات فارغة من ملف غير موجود. يكون معطّلًا افتراضيًا.
  • engine_file_truncate_on_insert - يتيح اقتطاع الملف قبل الإدراج فيه. يكون معطّلًا افتراضيًا.
  • engine_file_allow_create_multiple_files - يتيح إنشاء ملف جديد عند كل عملية إدراج إذا كان للتنسيق لاحقة. يكون معطّلًا افتراضيًا.
  • engine_file_skip_empty_files - يتيح تخطي الملفات الفارغة أثناء القراءة. يكون معطّلًا افتراضيًا.
  • storage_file_read_method - طريقة قراءة البيانات من ملف التخزين، وتكون إحدى القيم التالية: read، pread، mmap. لا تنطبق طريقة mmap على clickhouse-server (فهي مخصّصة لـ clickhouse-local). القيمة الافتراضية: pread لـ clickhouse-server، وmmap لـ clickhouse-local.
آخر تعديل في ٢٩ يونيو ٢٠٢٦