> ## 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.
# مصفوفة الدعم
> مصفوفات دعم شاملة لتكاملات ClickHouse مع تنسيقات الجداول المفتوحة واتصالات كتالوجات البيانات.
توفّر هذه الصفحة مصفوفات دعم شاملة لتكاملات ClickHouse مع بحيرات البيانات. وهي تغطي الميزات المتاحة لكل تنسيق جداول مفتوح، والكتالوجات التي يمكن لـ ClickHouse الاتصال بها، والإمكانات التي يدعمها كل كتالوج.
## دعم تنسيقات الجداول المفتوحة
يدعم ClickHouse أربعة من تنسيقات الجداول المفتوحة: [Apache Iceberg](/ar/reference/engines/table-engines/integrations/iceberg)، و[Delta Lake](/ar/reference/engines/table-engines/integrations/deltalake)، و[Apache Hudi](/ar/reference/engines/table-engines/integrations/hudi)، و[Apache Paimon](/ar/reference/functions/table-functions/paimon). اختر تنسيقًا أدناه لعرض مصفوفة الدعم الخاصة به.
**المفتاح:** ✅ مدعوم | ⚠️ جزئي / تجريبي | ❌ غير مدعوم
| الميزة | الحالة | ملاحظات |
| ------------------------------- | :----: | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **أنظمة التخزين الخلفية** | | |
| AWS S3 | ✅ | عبر [`icebergS3()`](/ar/reference/functions/table-functions/iceberg) أو الاسم المستعار `iceberg()` |
| GCS | ✅ | عبر [`icebergS3()`](/ar/reference/functions/table-functions/iceberg) أو الاسم المستعار `iceberg()` |
| Azure Blob Storage | ✅ | عبر [`icebergAzure()`](/ar/reference/functions/table-functions/iceberg) |
| HDFS | ⚠️ | عبر [`icebergHDFS()`](/ar/reference/functions/table-functions/iceberg). مهمل. |
| نظام الملفات المحلي | ✅ | عبر [`icebergLocal()`](/ar/reference/functions/table-functions/iceberg) |
| **أساليب الوصول** | | |
| دالة table function | ✅ | [`icebergS3()`](/ar/reference/functions/table-functions/iceberg) مع متغيرات لكل نظام تخزين خلفي |
| محرك table engine | ✅ | [`IcebergS3`](/ar/reference/engines/table-engines/integrations/iceberg) مع متغيرات لكل نظام تخزين خلفي |
| قراءات موزعة على مستوى العنقود | ✅ | [`icebergS3Cluster`](/ar/reference/functions/table-functions/icebergCluster), [`icebergAzureCluster`](/ar/reference/functions/table-functions/icebergCluster), [`icebergHDFSCluster`](/ar/reference/functions/table-functions/icebergCluster) |
| المجموعات المسماة | ✅ | [تعريف مجموعة مسماة](/ar/reference/functions/table-functions/iceberg#defining-a-named-collection) |
| | | |
| **ميزات القراءة** | | |
| دعم القراءة | ✅ | دعم كامل لعبارات SELECT مع جميع دوال ClickHouse SQL |
| تقليم الأقسام | ✅ | راجع [تقليم الأقسام](/ar/reference/engines/table-engines/integrations/iceberg#partition-pruning). |
| التقسيم المخفي | ✅ | التقسيم المستند إلى تحويلات Iceberg مدعوم |
| تطور التقسيم | ✅ | قراءة الجداول ذات مواصفات التقسيم التي تتغير بمرور الوقت مدعومة |
| تطور المخطط | ✅ | إضافة الأعمدة وإزالتها وإعادة ترتيبها. راجع [تطور المخطط](/ar/reference/engines/table-engines/integrations/iceberg#schema-evolution). |
| ترقية الأنواع / توسيعها | ✅ | `int` → `long`, `float` → `double`, `decimal(P,S)` → `decimal(P',S)` حيث P' > P. راجع [تطور المخطط](/ar/reference/engines/table-engines/integrations/iceberg#schema-evolution). |
| السفر عبر الزمن / اللقطات | ✅ | عبر الإعدادات `iceberg_timestamp_ms` أو `iceberg_snapshot_id`. راجع [السفر عبر الزمن](/ar/reference/engines/table-engines/integrations/iceberg#time-travel). |
| حذف حسب الموضع | ✅ | راجع [معالجة الصفوف المحذوفة](/ar/reference/engines/table-engines/integrations/iceberg#deleted-rows). |
| حذف بالمساواة | ✅ | لمحرك الجدول فقط، بدءًا من v25.8+. راجع [معالجة الصفوف المحذوفة](/ar/reference/engines/table-engines/integrations/iceberg#deleted-rows). |
| الدمج عند القراءة | ⚠️ | تجريبي. مدعوم لـ [عمليات الحذف](/ar/reference/functions/table-functions/iceberg#iceberg-writes-delete). |
| إصدارات التنسيق | ⚠️ | الإصداران v1 وv2 مدعومان. V3 غير مدعوم. |
| إحصاءات الأعمدة | ✅ | |
| فلاتر Bloom / ملفات puffin | ❌ | فهارس Bloom filter في ملفات puffin غير مدعومة |
| الأعمدة الافتراضية | ✅ | `_path`, `_file`, `_size`, `_time`, `_etag`. راجع [الأعمدة الافتراضية](/ar/reference/functions/table-functions/iceberg#virtual-columns). |
| | | |
| **ميزات الكتابة** | | |
| إنشاء جدول | ✅ | تجريبي. يتطلب `allow_insert_into_iceberg = 1`. بدءًا من v25.7+. راجع [إنشاء جدول](/ar/reference/functions/table-functions/iceberg#create-iceberg-table). |
| INSERT | ✅ | Beta بدءًا من 26.2. يتطلب `allow_insert_into_iceberg = 1`. راجع [إدراج البيانات](/ar/reference/functions/table-functions/iceberg#writes-inserts). |
| DELETE | ✅ | تجريبية. يتطلب `allow_insert_into_iceberg = 1`. من خلال `ALTER TABLE ... DELETE WHERE`. راجع [حذف البيانات](/ar/reference/functions/table-functions/iceberg#iceberg-writes-delete). |
| ALTER TABLE (تغييرات المخطط) | ✅ | تجريبية. يتطلب `allow_insert_into_iceberg = 1`. إضافة الأعمدة أو حذفها أو تعديلها أو إعادة تسميتها. راجع [تطور المخطط](/ar/reference/functions/table-functions/iceberg#iceberg-writes-schema-evolution). |
| الدمج | ⚠️ | تجريبية. يتطلب `allow_experimental_iceberg_compaction = 1`. يدمج ملفات حذف المواضع في ملفات البيانات. راجع [الدمج](/ar/reference/functions/table-functions/iceberg#iceberg-writes-compaction). عمليات Compaction الأخرى في Iceberg غير مدعومة. |
| UPDATE / MERGE | ❌ | غير مدعوم. راجع الدمج. |
| النسخ عند الكتابة | ❌ | غير مدعوم |
| انتهاء صلاحية اللقطات | ❌ | غير مدعوم |
| إزالة الملفات اليتيمة | ❌ | غير مدعوم |
| كتابة الأقسام | ✅ | مدعوم. |
| تعديل الأقسام | ❌ | تغيير آلية التقسيم من ClickHouse غير مدعوم. يمكن لـ ClickHouse الكتابة إلى جداول Iceberg ذات التقسيم المتطور. |
| | | |
| **البيانات الوصفية** | | |
| التفريع والوسوم | ❌ | مراجع الفروع/الوسوم في Iceberg غير مدعومة |
| تحديد ملف البيانات الوصفية | ✅ | يدعم تحديد البيانات الوصفية عبر catalogs، أو سرد الدليل البسيط، أو باستخدام 'version-hint'، أو عبر مسار محدد. يمكن ضبط ذلك عبر `iceberg_metadata_file_path` و `iceberg_metadata_table_uuid`. راجع [تحديد ملف البيانات الوصفية](/ar/reference/engines/table-engines/integrations/iceberg#metadata-file-resolution). |
| التخزين المؤقت للبيانات | ✅ | الآلية نفسها المستخدمة في محركات التخزين S3/Azure/HDFS. راجع [ذاكرة التخزين المؤقت للبيانات](/ar/reference/engines/table-engines/integrations/iceberg#data-cache). |
| التخزين المؤقت للبيانات الوصفية | ✅ | تُخزَّن ملفات manifest وملفات البيانات الوصفية مؤقتًا في الذاكرة. وهو مفعّل افتراضيًا عبر `use_iceberg_metadata_files_cache`. راجع [ذاكرة التخزين المؤقت للبيانات الوصفية](/ar/reference/engines/table-engines/integrations/iceberg#metadata-cache). |
اعتبارًا من الإصدار 25.6، يقرأ ClickHouse جداول Delta Lake باستخدام نواة Delta Lake المكتوبة بلغة Rust، مما يوفّر دعمًا أوسع للميزات. ومع ذلك، توجد مشكلات معروفة عند الوصول إلى البيانات في Azure Blob Storage. لذلك، تُعطَّل هذه النواة عند قراءة البيانات من Azure Blob Storage. نوضّح أدناه الميزات التي تتطلب هذه النواة.
| الميزة | الحالة | ملاحظات |
| ---------------------------------- | :----: | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **خلفيات التخزين** | | |
| AWS S3 | ✅ | عبر [`deltaLake()`](/ar/reference/functions/table-functions/deltalake) أو `deltaLakeS3()` |
| GCS | ✅ | عبر [`deltaLake()`](/ar/reference/functions/table-functions/deltalake) أو `deltaLakeS3()` |
| Azure Blob Storage | ✅ | عبر [`deltaLakeAzure()`](/ar/reference/functions/table-functions/deltalake) |
| HDFS | ❌ | غير مدعوم |
| نظام الملفات المحلي | ✅ | عبر [`deltaLakeLocal()`](/ar/reference/functions/table-functions/deltalake) |
| **أساليب الوصول** | | |
| دالة جدول | ✅ | [`deltaLake()`](/ar/reference/functions/table-functions/deltalake) مع متغيرات بحسب خلفية التخزين |
| محرك جدول | ✅ | [`DeltaLake`](/ar/reference/engines/table-engines/integrations/deltalake) |
| القراءات الموزعة على مستوى العنقود | ✅ | [`deltaLakeCluster`](/ar/reference/functions/table-functions/deltalakeCluster)، [`deltaLakeAzureCluster`](/ar/reference/functions/table-functions/deltalakeCluster) |
| المجموعات المسماة | ✅ | [مجموعة مسماة](/ar/reference/functions/table-functions/deltalake#arguments) |
| **ميزات القراءة** | | |
| دعم القراءة | ✅ | دعم كامل لعبارات SELECT مع جميع دوال ClickHouse SQL |
| تقليم الأقسام | ✅ | يتطلب Delta Kernel. |
| تطور المخطط | ✅ | يتطلب Delta Kernel. |
| السفر عبر الزمن | ✅ | يتطلب Delta Kernel. |
| متجهات الحذف | ✅ | |
| تعيين الأعمدة | ✅ | |
| تغذية بيانات التغيير | ✅ | يتطلب Delta Kernel. |
| الأعمدة الافتراضية | ✅ | `_path`, `_file`, `_size`, `_time`, `_etag`. راجع [الأعمدة الافتراضية](/ar/reference/functions/table-functions/deltalake#virtual-columns). |
| **ميزات الكتابة** | | |
| INSERT | ✅ | تجريبي. يتطلب `allow_experimental_delta_lake_writes = 1`. راجع [محرك DeltaLake](/ar/reference/engines/table-engines/integrations/deltalake). ويتطلب Delta Kernel. |
| DELETE / UPDATE / MERGE | ❌ | غير مدعوم |
| CREATE empty table | ❌ | إنشاء جدول Delta Lake فارغ جديد غير مدعوم. تفترض عملية `CREATE TABLE` وجود Delta Lake حالي في التخزين الكائني. |
| **التخزين المؤقت** | | |
| التخزين المؤقت للبيانات | ✅ | الآلية نفسها المستخدمة في محركات التخزين S3/Azure/HDFS. راجع [ذاكرة التخزين المؤقت للبيانات](/ar/reference/engines/table-engines/integrations/deltalake#data-cache). |
| الميزة | الحالة | ملاحظات |
| ------------------------------ | :----: | ------------------------------------------------------------------------------------------------------------------------------------- |
| **أنظمة التخزين الخلفية** | | |
| AWS S3 | ✅ | عبر [`hudi()`](/ar/reference/functions/table-functions/hudi) |
| GCS | ✅ | عبر [`hudi()`](/ar/reference/functions/table-functions/hudi) |
| Azure Blob Storage | ❌ | غير مدعوم |
| HDFS | ❌ | غير مدعوم |
| نظام الملفات المحلي | ❌ | غير مدعوم |
| **طرق الوصول** | | |
| دالة جدول | ✅ | [`hudi()`](/ar/reference/functions/table-functions/hudi) |
| محرك جدول | ✅ | [`Hudi`](/ar/reference/engines/table-engines/integrations/hudi) |
| قراءات موزعة على مستوى العنقود | ✅ | [`hudiCluster`](/ar/reference/functions/table-functions/hudiCluster) (S3 فقط) |
| المجموعات المُسمّاة | ✅ | [وسيطات Hudi](/ar/reference/functions/table-functions/hudi#arguments) |
| **ميزات القراءة** | | |
| دعم القراءة | ✅ | دعم كامل لعبارات SELECT مع جميع دوال ClickHouse SQL |
| تطوّر المخطط | ❌ | غير مدعوم |
| السفر عبر الزمن | ❌ | غير مدعوم |
| الأعمدة الافتراضية | ✅ | `_path`, `_file`, `_size`, `_time`, `_etag`. راجع [الأعمدة الافتراضية](/ar/reference/functions/table-functions/hudi#virtual-columns). |
| **ميزات الكتابة** | | |
| INSERT / DELETE / UPDATE | ❌ | تكامل للقراءة فقط |
| **التخزين المؤقت** | | |
| التخزين المؤقت للبيانات | ❌ | غير مدعوم |
| الميزة | الحالة | ملاحظات |
| -------------------------- | :----: | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **واجهات التخزين الخلفية** | | |
| S3 | ✅ | تجريبي. عبر [`paimon()`](/ar/reference/functions/table-functions/paimon) أو `paimonS3()` |
| GCS | ✅ | تجريبي. عبر [`paimon()`](/ar/reference/functions/table-functions/paimon) أو `paimonS3()` |
| Azure Blob Storage | ✅ | تجريبي. عبر [`paimonAzure()`](/ar/reference/functions/table-functions/paimon) |
| HDFS | ⚠️ | تجريبي. عبر [`paimonHDFS()`](/ar/reference/functions/table-functions/paimon). متروك. |
| نظام الملفات المحلي | ✅ | تجريبي. عبر [`paimonLocal()`](/ar/reference/functions/table-functions/paimon) |
| **أساليب الوصول** | | |
| دالة جدول | ✅ | تجريبي. [`paimon()`](/ar/reference/functions/table-functions/paimon) مع بدائل لكل واجهة تخزين خلفية |
| محرك جدول | ❌ | لا يوجد محرك جدول مخصص |
| قراءات موزعة عبر المجموعة | ✅ | تجريبي. [`paimonS3Cluster`](/ar/reference/functions/table-functions/paimonCluster)، [`paimonAzureCluster`](/ar/reference/functions/table-functions/paimonCluster)، [`paimonHDFSCluster`](/ar/reference/functions/table-functions/paimonCluster) |
| مجموعات مسماة | ✅ | تجريبي. [تعريف مجموعة مسماة](/ar/reference/functions/table-functions/paimon#defining-a-named-collection) |
| **ميزات القراءة** | | |
| دعم القراءة | ✅ | تجريبي. دعم كامل لعبارات `SELECT` مع جميع دوال ClickHouse SQL |
| تطور المخطط | ❌ | غير مدعوم |
| السفر عبر الزمن | ❌ | غير مدعوم |
| أعمدة افتراضية | ✅ | تجريبي. `_path`, `_file`, `_size`, `_time`, `_etag`. راجع [الأعمدة الافتراضية](/ar/reference/functions/table-functions/paimon#virtual-columns). |
| **ميزات الكتابة** | | |
| INSERT / DELETE / UPDATE | ❌ | تكامل للقراءة فقط |
| **التخزين المؤقت** | | |
| التخزين المؤقت للبيانات | ❌ | غير مدعوم |
## دعم الكتالوجات
يمكن لـ ClickHouse الاتصال بكتالوجات البيانات الخارجية باستخدام محرك قاعدة البيانات [`DataLakeCatalog`](/ar/reference/engines/database-engines/datalake)، الذي يعرِض الكتالوج كقاعدة بيانات في ClickHouse. وتظهر الجداول المسجَّلة في الكتالوج تلقائيًا، ويمكن الاستعلام عنها باستخدام SQL القياسية.
الكتالوجات التالية مدعومة حاليًا. راجع الدليل المرجعي لكل كتالوج للحصول على تعليمات الإعداد الكاملة.
| الكتالوج | التنسيقات | القراءة | إنشاء جدول | INSERT | الدليل المرجعي |
| ------------------------------------------------------------------------------- | -------------- | :------: | :--------: | :----: | ----------------------------------------------------------------------------------- |
| [AWS Glue Catalog](/ar/guides/use-cases/data-warehousing/glue-catalog) | Iceberg | ✅ بيتا | ❌ | ❌ | [دليل Glue catalog](/ar/guides/use-cases/data-warehousing/glue-catalog) |
| [BigLake Metastore](/ar/guides/use-cases/data-warehousing/biglake-catalog) | Iceberg | ✅ بيتا | ❌ | ❌ | [دليل BigLake Metastore](/ar/guides/use-cases/data-warehousing/biglake-catalog) |
| [Databricks Unity Catalog](/ar/guides/use-cases/data-warehousing/unity-catalog) | Delta, Iceberg | ✅ بيتا | ✅ بيتا | ✅ بيتا | [دليل Unity Catalog](/ar/guides/use-cases/data-warehousing/unity-catalog) |
| [Iceberg REST](/ar/guides/use-cases/data-warehousing/rest-catalog) | Iceberg | ✅ بيتا | ❌ | ❌ | [دليل REST catalog](/ar/guides/use-cases/data-warehousing/rest-catalog) |
| [Lakekeeper](/ar/guides/use-cases/data-warehousing/lakekeeper-catalog) | Iceberg | ✅ بيتا | ❌ | ❌ | [دليل Lakekeeper catalog](/ar/guides/use-cases/data-warehousing/lakekeeper-catalog) |
| [Project Nessie](/ar/guides/use-cases/data-warehousing/nessie-catalog) | Iceberg | ✅ تجريبي | ❌ | ❌ | [دليل Nessie catalog](/ar/guides/use-cases/data-warehousing/nessie-catalog) |
| [Microsoft OneLake](/ar/guides/use-cases/data-warehousing/onelake-catalog) | Iceberg | ✅ بيتا | ✅ بيتا | ✅ بيتا | [دليل OneLake catalog](/ar/guides/use-cases/data-warehousing/onelake-catalog) |
تتطلب جميع تكاملات الكتالوج حاليًا تمكين إعداد تجريبي أو بإصدار بيتا. وباستثناء Microsoft OneLake وDatabricks Unity Catalog، توفّر جميع الكتالوجات وصولًا **للقراءة فقط** — إذ يمكن الاستعلام عن الجداول، ولكن لا يمكن إنشاؤها أو الكتابة إليها عبر اتصال الكتالوج. ولتحميل البيانات من كتالوج إلى ClickHouse بهدف تسريع التحليلات، استخدم `INSERT INTO SELECT` كما هو موضح في [دليل تسريع التحليلات](/ar/guides/use-cases/data-warehousing/getting-started/accelerating-analytics). وللكتابة مرة أخرى إلى تنسيقات الجداول المفتوحة، أنشئ جداول Iceberg مستقلة كما هو موضح في [دليل كتابة البيانات](/ar/guides/use-cases/data-warehousing/getting-started/writing-data).