> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-fbfa8bee.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
> توثيق دوال الجداول
# دوال الجداول
دوال الجداول هي أساليب لإنشاء الجداول.
| الصفحة | الوصف |
| -------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [azureBlobStorage](/ar/reference/functions/table-functions/azureBlobStorage) | يوفّر واجهة شبيهة بالجدول لتنفيذ select/insert على الملفات في Azure Blob Storage. وهو مشابه للدالة s3. |
| [azureBlobStorageCluster](/ar/reference/functions/table-functions/azureBlobStorageCluster) | يتيح معالجة الملفات من Azure Blob Storage بالتوازي باستخدام العديد من العُقد في عنقود محدد. |
| [clusterAllReplicas](/ar/reference/functions/table-functions/cluster) | يتيح الوصول إلى جميع الشظايا (المُعدّة في قسم `remote_servers`) في عنقود ما دون إنشاء جدول Distributed. |
| [deltaLake](/ar/reference/functions/table-functions/deltalake) | يوفّر واجهة شبيهة بالجدول للقراءة فقط إلى جداول DeltaLake في Amazon S3. |
| [deltaLakeCluster](/ar/reference/functions/table-functions/deltalakeCluster) | هذا امتداد لدالة الجدول deltaLake. |
| [dictionary](/ar/reference/functions/table-functions/dictionary) | يعرض بيانات Dictionary كجدول ClickHouse. ويعمل بالطريقة نفسها التي يعمل بها محرك Dictionary. |
| [executable](/ar/reference/functions/table-functions/executable) | تنشئ دالة الجدول `executable` جدولًا استنادًا إلى مخرجات دالة معرّفة من المستخدم (UDF) تعرّفها في برنامج نصي يُخرج الصفوف إلى **stdout**. |
| [file](/ar/reference/functions/table-functions/file) | محرك جدول يوفّر واجهة شبيهة بالجدول لتنفيذ `SELECT` من الملفات و`INSERT` إليها، على نحو مشابه لدالة الجدول s3. استخدم `file` عند العمل مع الملفات المحلية، و`s3` عند العمل مع الحاويات في التخزين الكائني مثل S3 أو GCS أو MinIO. |
| [fileCluster](/ar/reference/functions/table-functions/fileCluster) | يتيح المعالجة المتزامنة للملفات المطابقة لمسار محدد عبر عدة عُقد داخل عنقود. تنشئ العقدة البادئة اتصالات مع العقد العاملة، وتوسّع أنماط glob في مسار الملف، وتفوّض مهام قراءة الملفات إلى العقد العاملة. وتستعلم كل عقدة عاملة من العقدة البادئة عن الملف التالي لمعالجته، ويتكرر ذلك حتى تكتمل جميع المهام (أي تُقرأ كل الملفات). |
| [filesystem](/ar/reference/functions/table-functions/filesystem) | يوفّر الوصول إلى نظام الملفات لسرد الملفات وإرجاع بياناتها الوصفية ومحتوياتها. |
| [format](/ar/reference/functions/table-functions/format) | يحلّل البيانات من الوسائط وفقًا لتنسيق الإدخال المحدد. وإذا لم تُحدَّد وسيطة البنية، فستُستخرج من البيانات. |
| [gcs](/ar/reference/functions/table-functions/gcs) | يوفّر واجهة شبيهة بالجدول لـ `SELECT` و`INSERT` البيانات من Google Cloud Storage. ويتطلب دور IAM `Storage Object User`. |
| [fuzzQuery](/ar/reference/functions/table-functions/fuzzQuery) | يُحدث تغييرات عشوائية في سلسلة الاستعلام المعطاة. |
| [fuzzJSON](/ar/reference/functions/table-functions/fuzzJSON) | يُحدث تغييرات عشوائية في سلسلة JSON. |
| [generateRandom](/ar/reference/functions/table-functions/generate) | يولّد بيانات عشوائية وفق مخطط معيّن. ويتيح ملء جداول الاختبار بهذه البيانات. ليست كل الأنواع مدعومة. |
| [mergeTreeTextIndex](/ar/reference/functions/table-functions/mergeTreeTextIndex) | يمثّل Dictionary لفهرس نصي في جدول MergeTree. ويمكن استخدامه للفحص الداخلي. |
| [mergeTreeProjection](/ar/reference/functions/table-functions/mergeTreeProjection) | يمثّل محتويات بعض projection في جداول MergeTree. ويمكن استخدامه للفحص الداخلي. |
| [mergeTreeIndex](/ar/reference/functions/table-functions/mergeTreeIndex) | يمثّل محتويات الفهرس وملفات العلامات الخاصة بجداول MergeTree. ويمكن استخدامه للفحص الداخلي. |
| [hdfs](/ar/reference/functions/table-functions/hdfs) | ينشئ جدولًا من ملفات في HDFS. ودالة الجدول هذه مشابهة لدالتي الجدول url وfile. |
| [hdfsCluster](/ar/reference/functions/table-functions/hdfsCluster) | يتيح معالجة الملفات من HDFS بالتوازي باستخدام العديد من العُقد في عنقود محدد. |
| [hudi](/ar/reference/functions/table-functions/hudi) | يوفّر واجهة شبيهة بالجدول للقراءة فقط إلى جداول Apache Hudi في Amazon S3. |
| [ytsaurus](/ar/reference/functions/table-functions/ytsaurus) | تتيح دالة الجدول قراءة البيانات من عنقود YTsaurus. |
| [hudiCluster Table Function](/ar/reference/functions/table-functions/hudiCluster) | امتداد لدالة الجدول hudi. ويتيح معالجة الملفات من جداول Apache Hudi في Amazon S3 بالتوازي باستخدام العديد من العُقد في عنقود محدد. |
| [iceberg](/ar/reference/functions/table-functions/iceberg) | يوفّر واجهة شبيهة بالجدول للقراءة فقط إلى جداول Apache Iceberg في Amazon S3 أو Azure أو HDFS أو المخزّنة محليًا. |
| [paimon](/ar/reference/functions/table-functions/paimon) | يوفّر واجهة شبيهة بالجدول للقراءة فقط إلى جداول Apache Paimon في Amazon S3 أو Azure أو HDFS أو المخزّنة محليًا. |
| [icebergCluster](/ar/reference/functions/table-functions/icebergCluster) | امتداد لدالة الجدول iceberg يتيح معالجة الملفات من Apache Iceberg بالتوازي باستخدام العديد من العُقد في عنقود محدد. |
| [paimonCluster](/ar/reference/functions/table-functions/paimonCluster) | امتداد لدالة الجدول paimon يتيح معالجة الملفات من Apache Paimon بالتوازي باستخدام العديد من العُقد في عنقود محدد. |
| [input](/ar/reference/functions/table-functions/input) | دالة جدول تتيح تحويل البيانات المرسلة إلى الخادم ببنية معينة وإدراجها بكفاءة في جدول ذي بنية أخرى. |
| [jdbc](/ar/reference/functions/table-functions/jdbc) | تُرجع جدولًا متصلًا عبر JDBC driver. |
| [merge](/ar/reference/functions/table-functions/merge) | ينشئ جدول Merge مؤقتًا. وسيُشتق التركيب من الجداول الأساسية باستخدام اتحاد أعمدتها واستنتاج الأنواع المشتركة. |
| [mongodb](/ar/reference/functions/table-functions/mongodb) | يتيح تنفيذ استعلامات `SELECT` على البيانات المخزنة على خادم MongoDB بعيد. |
| [mysql](/ar/reference/functions/table-functions/mysql) | يتيح تنفيذ استعلامات `SELECT` و `INSERT` على البيانات المخزنة على خادم MySQL بعيد. |
| [null](/ar/reference/functions/table-functions/null) | ينشئ جدولًا مؤقتًا بالبنية المحددة باستخدام محرك الجدول Null. تُستخدم هذه الدالة لتسهيل كتابة الاختبارات والعروض التوضيحية. |
| [timeSeriesMetrics](/ar/reference/functions/table-functions/timeSeriesMetrics) | تُرجع timeSeriesMetrics جدول المقاييس الذي يستخدمه الجدول `db_name.time_series_table` ذي محرك الجدول TimeSeries. |
| [timeSeriesSelector](/ar/reference/functions/table-functions/timeSeriesSelector) | يقرأ السلاسل الزمنية من جدول TimeSeries بعد تصفيتها بواسطة محدِّد، ومع طوابع زمنية ضمن فاصل زمني محدد. |
| [timeSeriesTags](/ar/reference/functions/table-functions/timeSeriesTags) | تُرجع دالة الجدول timeSeriesTags جدول الوسوم الذي يستخدمه الجدول `db_name.time_series_table` ذي محرك الجدول TimeSeries. |
| [prometheusQueryRange](/ar/reference/functions/table-functions/prometheusQueryRange) | يقيّم استعلام prometheus باستخدام بيانات من جدول TimeSeries. |
| [zeros](/ar/reference/functions/table-functions/zeros) | تُستخدم لأغراض الاختبار بوصفها أسرع طريقة لتوليد عدد كبير من الصفوف. وهي مشابهة لجدولي النظام `system.zeros` و `system.zeros_mt`. |
| [primes](/ar/reference/functions/table-functions/primes) | تُرجع جدولًا يحتوي على عمود واحد باسم `prime` يتضمن الأعداد الأولية. |
| [numbers](/ar/reference/functions/table-functions/numbers) | تُرجع جدولًا يحتوي على عمود واحد باسم `number` يتضمن تسلسلًا من الأعداد الصحيحة. |
| [prometheusQuery](/ar/reference/functions/table-functions/prometheusQuery) | يقيّم استعلام prometheus باستخدام بيانات من جدول TimeSeries. |
| [timeSeriesSamples](/ar/reference/functions/table-functions/timeSeriesSamples) | تُرجع timeSeriesSamples جدول العينات الذي يستخدمه الجدول `db_name.time_series_table` ذي محرك الجدول TimeSeries. |
| [generate\_series (generateSeries)](/ar/reference/functions/table-functions/generate_series) | تُرجع جدولًا يحتوي على عمود واحد باسم `generate_series` (UInt64) يتضمن أعدادًا صحيحة من البداية إلى النهاية، شاملًا القيمتين. |
| [odbc](/ar/reference/functions/table-functions/odbc) | تُرجع الجدول المتصل عبر ODBC. |
| [postgresql](/ar/reference/functions/table-functions/postgresql) | يتيح تنفيذ استعلامات `SELECT` و `INSERT` على البيانات المخزنة على خادم PostgreSQL بعيد. |
| [redis](/ar/reference/functions/table-functions/redis) | تتيح دالة الجدول هذه تكامل ClickHouse مع Redis. |
| [remote, remoteSecure](/ar/reference/functions/table-functions/remote) | تتيح دالة الجدول `remote` الوصول إلى الخوادم البعيدة عند الطلب، أي من دون إنشاء جدول موزّع. أما دالة الجدول `remoteSecure` فهي مثل `remote` ولكن عبر اتصال آمن. |
| [s3 Table Function](/ar/reference/functions/table-functions/s3) | توفّر واجهة شبيهة بالجدول لاختيار الملفات أو إدراجها في Amazon S3 و Google Cloud Storage. دالة الجدول هذه مشابهة للدالة hdfs، لكنها توفّر ميزات خاصة بـ S3. |
| [s3Cluster](/ar/reference/functions/table-functions/s3Cluster) | امتداد لدالة الجدول s3، يتيح معالجة الملفات من Amazon S3 و Google Cloud Storage بالتوازي عبر عدد من العقد ضمن cluster محدد. |
| [sqlite](/ar/reference/functions/table-functions/sqlite) | يتيح تنفيذ استعلامات على البيانات المخزنة في قاعدة بيانات SQLite. |
| [arrowFlight](/ar/reference/functions/table-functions/arrowflight) | يتيح القراءة من البيانات المعروضة عبر خادم Apache Arrow Flight والكتابة إليها. |
| [url](/ar/reference/functions/table-functions/url) | ينشئ جدولًا من `URL` باستخدام `format` و `structure` المحددين |
| [urlCluster](/ar/reference/functions/table-functions/urlCluster) | يتيح معالجة الملفات من URL بالتوازي عبر عدد من العقد ضمن cluster محدد. |
| [view](/ar/reference/functions/table-functions/view) | يحوّل استعلامًا فرعيًا إلى جدول. تنفّذ هذه الدالة views. |
| [values](/ar/reference/functions/table-functions/values) | ينشئ مساحة تخزين مؤقتة تملأ الأعمدة بالقيم. |
| [loop](/ar/reference/functions/table-functions/loop) | تُستخدم دالة الجدول loop في ClickHouse لإرجاع نتائج الاستعلام في حلقة لا نهائية. |
## الاستخدام
يمكن استخدام دوال الجداول في العبارة [`FROM`](/ar/reference/statements/select/from)
ضمن استعلام `SELECT`. على سبيل المثال، يمكنك استخدام `SELECT` لقراءة البيانات من ملف على جهازك
المحلي باستخدام دالة الجدول `file`.
```bash title="Query" theme={null}
echo "1, 2, 3" > example.csv
```
```text title="Response" theme={null}
./clickhouse client
:) SELECT * FROM file('example.csv')
┌─c1─┬─c2─┬─c3─┐
│ 1 │ 2 │ 3 │
└────┴────┴────┘
```
يمكنك أيضًا استخدام دوال الجداول لإنشاء جدول مؤقت لا يكون متاحًا
إلا في الاستعلام الحالي. على سبيل المثال:
```sql title="Query" theme={null}
SELECT * FROM generateSeries(1,5);
```
```response title="Response" theme={null}
┌─generate_series─┐
│ 1 │
│ 2 │
│ 3 │
│ 4 │
│ 5 │
└─────────────────┘
```
يُحذف الجدول عند انتهاء الاستعلام.
يمكن استخدام دوال الجداول لإنشاء الجداول، وفق الصياغة التالية:
```sql title="Query" theme={null}
CREATE TABLE [IF NOT EXISTS] [db.]table_name AS table_function()
```
على سبيل المثال:
```sql title="Query" theme={null}
CREATE TABLE series AS generateSeries(1, 5);
SELECT * FROM series;
```
```response title="Response" theme={null}
┌─generate_series─┐
│ 1 │
│ 2 │
│ 3 │
│ 4 │
│ 5 │
└─────────────────┘
```
أخيرًا، يمكن أيضًا استخدام دوال الجداول لتنفيذ `INSERT` للبيانات إلى جدول. على سبيل المثال،
يمكننا كتابة محتويات الجدول الذي أنشأناه في المثال السابق
إلى ملف على القرص باستخدام دالة الجدول `file` مرة أخرى:
```sql title="Query" theme={null}
INSERT INTO FUNCTION file('numbers.csv', 'CSV') SELECT * FROM series;
```
```bash title="Query" theme={null}
cat numbers.csv
1
2
3
4
5
```
لا يمكنك استخدام دوال الجداول إذا كان الإعداد [allow\_ddl](/ar/reference/settings/session-settings#allow_ddl) معطّلًا.