دالة الجدول filesystem

تستعرض هذه الدالة دليل بشكل متكرر وتُرجع table تتضمن البيانات الوصفية للملفات (المسارات، والأحجام، والأنواع، وpermissions، وأوقات التعديل)، وبشكل اختياري، محتويات الملفات. في وضع clickhouse-server، يجب أن يكون path ضمن دليل ‏user_files_path. تتم متابعة الروابط الرمزية داخل user_files_path التي تشير إلى مسارات خارجه، ولكن لا تُرجع إلا entries التي يبدأ path الخاص بها (عبر الرابط الرمزي) بـ user_files_path. في وضع clickhouse-local، لا توجد قيود على path.

الصيغة

filesystem([path])

المعاملات

المعامل	الوصف
`path`	الدليل المراد عرض محتوياته. يمكن أن يكون مسارًا مطلقًا (ويجب أن يكون داخل `user_files_path` في وضع الخادم) أو مسارًا نسبيًا بالنسبة إلى `user_files_path`. وإذا كان فارغًا أو غير مذكور، فستكون القيمة الافتراضية هي `user_files_path`.

الأعمدة المُعادة

العمود	النوع	الوصف
`path`	`String`	الدليل الذي يحتوي على الإدخال (ولا يتضمن اسم الملف/الدليل نفسه).
`name`	`String`	اسم الملف أو الدليل (آخر مكوّن في المسار).
`file`	`String` (ALIAS of `name`)	اسم مستعار للعمود `name`.
`type`	`Enum8`	نوع الملف: `'none'`, `'not_found'`, `'regular'`, `'directory'`, `'symlink'`, `'block'`, `'character'`, `'fifo'`, `'socket'`, `'unknown'`.
`size`	`Nullable(UInt64)`	حجم الملف بالبايت (للملفات العادية). وتكون القيمة `NULL` للملفات غير العادية (الأدلة والروابط الرمزية وما إلى ذلك) وعند حدوث خطأ.
`depth`	`UInt16`	عمق التكرار. تكون القيمة `0` للدليل المطلوب نفسه ولأبنائه المباشرين، و`1` للإدخالات الأعمق بمستوى واحد، وهكذا.
`modification_time`	`Nullable(DateTime64(6))`	وقت آخر تعديل بدقة الميكروثانية. وتكون القيمة `NULL` عند حدوث خطأ.
`is_symlink`	`Bool`	ما إذا كان الإدخال رابطًا رمزيًا.
`content`	`Nullable(String)`	محتويات الملف (للملفات العادية). وتكون القيمة `NULL` للملفات غير العادية (الأدلة والروابط الرمزية وما إلى ذلك). تؤدي أخطاء القراءة إلى إثارة استثناء. وتؤدي قراءة هذا العمود إلى تنفيذ عمليات إدخال/إخراج فعلية للملفات، لذا يُفضَّل عدم تضمينه إذا لم تكن هناك حاجة إليه.
`owner_read`	`Bool`	لدى المالك إذن قراءة.
`owner_write`	`Bool`	لدى المالك إذن كتابة.
`owner_exec`	`Bool`	لدى المالك إذن تنفيذ.
`group_read`	`Bool`	لدى المجموعة إذن قراءة.
`group_write`	`Bool`	لدى المجموعة إذن كتابة.
`group_exec`	`Bool`	لدى المجموعة إذن تنفيذ.
`others_read`	`Bool`	لدى الآخرين إذن قراءة.
`others_write`	`Bool`	لدى الآخرين إذن كتابة.
`others_exec`	`Bool`	لدى الآخرين إذن تنفيذ.
`set_gid`	`Bool`	بت Set-GID.
`set_uid`	`Bool`	بت Set-UID.
`sticky_bit`	`Bool`	البت اللاصق.

لا تُحتسب إلا الأعمدة المستخدمة فعليًا في الاستعلام، لذا فإن اختيار مجموعة فرعية من الأعمدة (وخاصةً مع استبعاد content) يكون فعّالًا.

أمثلة

عرض الملفات في user_files

SELECT name, type, size, depth
FROM filesystem()
ORDER BY name;

العثور على الملفات الكبيرة

SELECT path, name, size
FROM filesystem()
WHERE type = 'regular' AND size > 1000000
ORDER BY size DESC;

قراءة محتويات الملف

SELECT name, content
FROM filesystem('my_directory')
WHERE name LIKE '%.csv';

سرد العناصر الفرعية المباشرة فقط

SELECT name, type
FROM filesystem('my_directory')
WHERE depth = 0;

​دالة الجدول filesystem

​الصيغة

​المعاملات

​الأعمدة المُعادة

​أمثلة

​عرض الملفات في user_files

​العثور على الملفات الكبيرة

​قراءة محتويات الملف

​سرد العناصر الفرعية المباشرة فقط