> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-vortex-format.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> يعرض محرك قاعدة البيانات Filesystem الملفات الموجودة في دليل محلي كجداول للقراءة فقط.

# Filesystem

يعرض محرك قاعدة البيانات `Filesystem` الملفات الموجودة في دليل محلي على هيئة جداول للقراءة فقط. ويُحدَّد اسم الجدول كمسار نسبي إلى دليل قاعدة البيانات، ثم تُقرأ محتوياته باستخدام دالة الجدول [`file`](/ar/reference/functions/table-functions/file).

## إنشاء قاعدة بيانات

```sql theme={null}
CREATE DATABASE files
ENGINE = Filesystem([path]);
```

`path` هو الدليل الذي يحتوي على الملفات. وإذا تم حذفه، يستخدم ClickHouse الدليل الحالي في `clickhouse-local`، ودليل `user_files` في خادم ClickHouse.

## الاستخدام

على سبيل المثال، مع وجود `data.csv` في الدليل المحدد:

```sql theme={null}
CREATE DATABASE files ENGINE = Filesystem('imports');

SELECT * FROM files.`data.csv`;
```

يمكن أن يتضمّن اسم الجدول مسارًا نسبيًا داخل دليل قاعدة البيانات. ويُستنتج مخطط الجدول والتنسيق بالطريقة نفسها المتبعة في دالة الجدول `file`.

لا تمتلك قاعدة البيانات أي تعريفات جداول: فالجداول تُنشأ عند تحليل مسارات ملفاتها لأول مرة، ويُحتفظ بها في الذاكرة المؤقتة فقط لأغراض الوصول اللاحق. أما `CREATE TABLE` و`INSERT` وغيرها من عمليات الكتابة عبر قاعدة البيانات هذه فغير مدعومة.

## التحكم في الوصول

في خادم ClickHouse، يجب أن يكون دليل قاعدة البيانات وكل ملف يُحلّ مساره داخل [`user_files_path`](/ar/reference/settings/server-settings/settings#user_files_path)؛ وينطبق هذا القيد كذلك بعد تتبّع الروابط الرمزية. أما `clickhouse-local` فهو غير مقيّد بـ `user_files_path`.

يتطلب إنشاء قاعدة البيانات هذه صلاحيتَي المصدر `READ` و`WRITE` على `FILE`، بصرف النظر عن [`table_engines_require_grant`](/ar/reference/settings/server-settings/settings/other#table_engines_require_grant). يمكن منحهما، على سبيل المثال، على النحو التالي:

```sql theme={null}
GRANT READ, WRITE ON FILE TO user_name;
```

راجع [امتيازات `SOURCES`](/ar/reference/statements/grant#sources) لمعرفة تفاصيل الإصدار والتوافق.

## انظر أيضاً

* [دالة الجدول `file`](/ar/reference/functions/table-functions/file)
* [محرك قاعدة البيانات S3](/ar/reference/engines/database-engines/s3)
* [محرك قاعدة البيانات HDFS](/ar/reference/engines/database-engines/hdfs)