> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-trino-dialect.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# مصفوفة الدعم
> مصفوفات دعم شاملة لتكاملات ClickHouse مع تنسيقات الجداول المفتوحة واتصالات كتالوجات البيانات.
توفّر هذه الصفحة مصفوفات دعم شاملة لتكاملات ClickHouse مع بحيرات البيانات. وهي تغطي الميزات المتاحة لكل تنسيق جداول مفتوح، والكتالوجات التي يمكن لـ ClickHouse الاتصال بها، والإمكانات التي يدعمها كل كتالوج.
يُعرض الدعم بشكل منفصل لـ ClickHouse Cloud وClickHouse المُدار ذاتيًا. تكون الميزات التجريبية معطّلة افتراضيًا في ClickHouse Cloud، و[يجب طلب تفعيلها عبر Support](https://clickhouse.com/blog/common-getting-started-issues-with-clickhouse#13-experimental-features-in-production). يعتمد التوافر على الميزة، لذا تواصل مع Support للتأكد من إمكانية تفعيل ميزة تجريبية محددة. يُوضَّح الضبط والقيود الخاصة بالنشر في عمود الملاحظات.
## دعم تنسيقات الجداول المفتوحة
يدعم 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). اختر تنسيقًا أدناه لعرض مصفوفة الدعم الخاصة به.
**المفتاح:** ✅ مدعوم | ⚠️ جزئي أو تجريبي أو مهجور | ❌ غير مدعوم
| الميزة | ClickHouse Cloud | مُدار ذاتيًا | ملاحظات |
| ------------------------------- | :----------------------------------------------------------------: | :----------: | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **واجهات التخزين الخلفية** | | | |
| 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) |
| **طرق الوصول** | | | |
| دالة جدول | ✅ | ✅ | [`icebergS3()`](/ar/reference/functions/table-functions/iceberg) مع بدائل لكل واجهة تخزين خلفية |
| محرك جدول | ✅ | ✅ | [`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/concepts/features/configuration/server-config/named-collections) التي أُنشئت باستخدام DDL على خدمات ClickHouse Cloud محددة. تواصل مع فريق الدعم للتحقق من التوافر. |
| | | | |
| **ميزات القراءة** | | | |
| دعم القراءة | ✅ | ✅ | دعم كامل لـ `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 في ملفات 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 | ✅ Beta | Beta بدءًا من الإصدار 26.2. يتطلب `allow_insert_into_iceberg = 1`. راجع [إدراج البيانات](/ar/reference/functions/table-functions/iceberg#writes-inserts). |
| `DELETE` | ⚠️ | ⚠️ | Experimental. يتطلب `allow_insert_into_iceberg = 1`. باستخدام `ALTER TABLE ... DELETE WHERE`. راجع [حذف البيانات](/ar/reference/functions/table-functions/iceberg#iceberg-writes-delete). |
| `ALTER TABLE` (تغييرات المخطط) | ⚠️ | ⚠️ | Experimental. يتطلب `allow_insert_into_iceberg = 1`. إضافة الأعمدة أو حذفها أو تعديلها أو إعادة تسميتها. راجع [تطور المخطط](/ar/reference/functions/table-functions/iceberg#iceberg-writes-schema-evolution). |
| الدمج | ⚠️ | ⚠️ | Experimental. يتطلب `allow_experimental_iceberg_compaction = 1`. راجع [الدمج](/ar/reference/functions/table-functions/iceberg#iceberg-writes-compaction). |
| `UPDATE` / `MERGE` | ❌ | ❌ | غير مدعوم. راجع الدمج. |
| النسخ عند الكتابة | ❌ | ❌ | غير مدعوم |
| انتهاء صلاحية اللقطات | ⚠️ | ⚠️ | Experimental. يتطلب Iceberg v2 و`allow_insert_into_iceberg = 1` و`allow_experimental_expire_snapshots = 1`. راجع [انتهاء صلاحية اللقطات](/ar/reference/functions/table-functions/iceberg#iceberg-expire-snapshots). |
| إزالة الملفات اليتيمة | ⚠️ | ⚠️ | Experimental. يتطلب Iceberg v2 أو إصدارًا أحدث و`allow_insert_into_iceberg = 1` و`allow_iceberg_remove_orphan_files = 1`. راجع [إزالة الملفات اليتيمة](/ar/reference/functions/table-functions/iceberg#iceberg-remove-orphan-files). |
| كتابة الأقسام | ✅ Beta | ✅ Beta | مدعوم لعمليات الكتابة في Iceberg. |
| تعديل الأقسام | ❌ | ❌ | لا يدعم ClickHouse تغيير مخطط التقسيم. يمكنه الكتابة إلى جداول Iceberg ذات مخطط تقسيم متطور. |
| | | | |
| **البيانات الوصفية** | | | |
| التفريع ووضع العلامات | ❌ | ❌ | مراجع الفروع/العلامات في Iceberg غير مدعومة |
| تحديد ملف البيانات الوصفية | ✅ | ✅ | يدعم التحديد عبر الكتالوجات، وإدراج الدليل، و`version-hint`، ومسار محدد. راجع [تحديد ملف البيانات الوصفية](/ar/reference/engines/table-engines/integrations/iceberg#metadata-file-resolution). |
| التخزين المؤقت للبيانات | ✅ | ✅ | يستخدم الآلية نفسها لمحركات التخزين S3/Azure/HDFS. راجع [ذاكرة التخزين المؤقت للبيانات](/ar/reference/engines/table-engines/integrations/iceberg#data-cache). |
| التخزين المؤقت للبيانات الوصفية | ✅ | ✅ | مفعّل افتراضيًا عبر `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. نبيّن أدناه الميزات التي تتطلب هذه النواة.
| الميزة | ClickHouse Cloud | ذاتية الإدارة | ملاحظات |
| ------------------------------- | :---------------------------------------------------------------: | :-----------: | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **الأنظمة الخلفية للتخزين** | | | |
| 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/concepts/features/configuration/server-config/named-collections) المنشأة باستخدام DDL في خدمات ClickHouse Cloud محددة. تواصل مع فريق الدعم لتأكيد التوافر. |
| **ميزات القراءة** | | | |
| دعم القراءة | ✅ | ✅ | دعم كامل لـ `SELECT` مع جميع دوال ClickHouse SQL |
| استبعاد الأقسام | ✅ بيتا | ✅ بيتا | يتطلب نواة Delta. |
| تطور المخطط | ✅ بيتا | ✅ بيتا | يتطلب نواة Delta. |
| السفر عبر الزمن | ✅ بيتا | ✅ بيتا | يتطلب نواة Delta. |
| متجهات الحذف | ✅ | ✅ | |
| تعيين الأعمدة | ✅ | ✅ | |
| تغذية بيانات التغيير | ✅ بيتا | ✅ بيتا | يتطلب نواة Delta. |
| الأعمدة الافتراضية | ✅ | ✅ | `_path`، `_file`، `_size`، `_time`، `_etag`. راجع [الأعمدة الافتراضية](/ar/reference/functions/table-functions/deltalake#virtual-columns). |
| **ميزات الكتابة** | | | |
| `INSERT` | ✅ بيتا | ✅ بيتا | يتطلب نواة Delta. تدعم عمليات الكتابة S3 وGCS، ولا تدعم الكتابة إلى Azure. يتطلب `allow_delta_lake_writes = 1` بدءًا من الإصدار 26.7؛ وفي الإصدارات الأقدم، استخدم `allow_experimental_delta_lake_writes = 1`. راجع [الكتابة في Delta Lake](/ar/reference/functions/table-functions/deltalake#inserting-data). |
| `DELETE` / `UPDATE` / `MERGE` | ❌ | ❌ | غير مدعوم |
| إنشاء جدول فارغ | ❌ | ❌ | تفترض عملية `CREATE TABLE` أن جدول Delta Lake موجود بالفعل في تخزين الكائنات. |
| **التخزين المؤقت** | | | |
| التخزين المؤقت للبيانات | ✅ | ✅ | الآلية نفسها المستخدمة في محركات تخزين S3/Azure/HDFS. راجع [ذاكرة التخزين المؤقت للبيانات](/ar/reference/engines/table-engines/integrations/deltalake#data-cache). |
| الميزة | ClickHouse Cloud | مُدار ذاتيًا | ملاحظات |
| ------------------------------ | :-----------------------------------------------------------: | :----------: | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **أنظمة التخزين الخلفية** | | | |
| 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 فقط) |
| المجموعات المسماة | ⚠️ | ✅ | يمكن تمكين [المجموعات المسماة](/ar/concepts/features/configuration/server-config/named-collections) المُنشأة باستخدام DDL في بعض خدمات ClickHouse Cloud. تواصل مع الدعم لتأكيد مدى التوافر. |
| **ميزات القراءة** | | | |
| دعم القراءة | ✅ | ✅ | دعم كامل لـ `SELECT` مع جميع دوال ClickHouse SQL |
| تطور المخطط | ❌ | ❌ | غير مدعوم |
| السفر عبر الزمن | ❌ | ❌ | غير مدعوم |
| الأعمدة الافتراضية | ✅ | ✅ | `_path`، `_file`، `_size`، `_time`، `_etag`. راجع [الأعمدة الافتراضية](/ar/reference/functions/table-functions/hudi#virtual-columns). |
| **ميزات الكتابة** | | | |
| `INSERT` / `DELETE` / `UPDATE` | ❌ | ❌ | تكامل للقراءة فقط |
| **التخزين المؤقت** | | | |
| التخزين المؤقت للبيانات | ❌ | ❌ | غير مدعوم |
| الميزة | ClickHouse Cloud | ذاتي الإدارة | ملاحظات |
| ------------------------------ | :----------------------------------------------------------: | :----------: | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **واجهات التخزين الخلفية** | | | |
| 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) مع بدائل لكل واجهة تخزين خلفية |
| محرك جدول | ⚠️ | ⚠️ | تجريبية. [`Paimon`](/ar/reference/engines/table-engines/integrations/paimon) مع بدائل لكل واجهة تخزين خلفية. يتطلب `allow_experimental_paimon_storage_engine = 1`. |
| قراءات موزعة على مستوى الكتلة | ⚠️ | ⚠️ | تجريبية. [`paimonS3Cluster`](/ar/reference/functions/table-functions/paimonCluster)، [`paimonAzureCluster`](/ar/reference/functions/table-functions/paimonCluster)، [`paimonHDFSCluster`](/ar/reference/functions/table-functions/paimonCluster) |
| المجموعات المسماة | ⚠️ | ⚠️ | تجريبية. يمكن تمكين [المجموعات المسماة](/ar/concepts/features/configuration/server-config/named-collections) المُنشأة باستخدام DDL في بعض خدمات ClickHouse Cloud. تواصل مع الدعم للتحقق من التوافر. |
| **ميزات القراءة** | | | |
| دعم القراءة | ⚠️ | ⚠️ | تجريبية. دعم كامل لـ `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) |
| [SeaweedFS](/ar/guides/use-cases/data-warehousing/seaweedfs-catalog) | Iceberg | ✅ بيتا | ✅ بيتا | ✅ بيتا | [دليل SeaweedFS catalog](/ar/guides/use-cases/data-warehousing/seaweedfs-catalog) |
تتطلب جميع تكاملات الكتالوج حاليًا تمكين إعداد تجريبي أو بإصدار بيتا. وباستثناء Microsoft OneLake وDatabricks Unity Catalog وSeaweedFS، توفّر جميع الكتالوجات وصولًا **للقراءة فقط** — إذ يمكن الاستعلام عن الجداول، ولكن لا يمكن إنشاؤها أو الكتابة إليها عبر اتصال الكتالوج. ولتحميل البيانات من كتالوج إلى 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).