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

# مقابلة الأنواع

> مقابلة الأنواع في ClickHouse وElasticsearch

يدعم Elasticsearch وClickHouse مجموعة واسعة من أنواع البيانات، لكن آليات التخزين الأساسية ونماذج الاستعلام فيهما تختلف جذريًا. يوضّح هذا القسم ما يقابل أنواع الحقول الشائعة الاستخدام في Elasticsearch في ClickHouse، حيثما توفّر ذلك، كما يقدّم سياقًا يساعد في توجيه عمليات الترحيل. وعند عدم وجود مقابل مباشر، تُذكر بدائل أو ملاحظات في التعليقات.

| **نوع Elasticsearch**              | **المقابل في ClickHouse**                                                                                                                                                                                                                                                               | **ملاحظات**                                                                                                                                                                                                                                                                                                                                                                                                           |
| ---------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `boolean`                          | [`UInt8`](/ar/reference/data-types/int-uint)  أو [`Bool`](/ar/reference/data-types/boolean)                                                                                                                                                                                             | يدعم ClickHouse النوع `Boolean` كاسم مستعار لـ `UInt8` في الإصدارات الأحدث.                                                                                                                                                                                                                                                                                                                                           |
| `keyword`                          | [`String`](/ar/reference/data-types/string)                                                                                                                                                                                                                                             | يُستخدم للتصفية بالمطابقة التامة، والتجميع، والفرز.                                                                                                                                                                                                                                                                                                                                                                   |
| `text`                             | [`String`](/ar/reference/data-types/string)                                                                                                                                                                                                                                             | إمكانات full-text search محدودة في ClickHouse؛ وتتطلب tokenization منطقًا مخصصًا باستخدام دوال مثل `tokens` مع array functions.                                                                                                                                                                                                                                                                                       |
| `long`                             | [`Int64`](/ar/reference/data-types/int-uint)                                                                                                                                                                                                                                            | عدد صحيح موقّع 64-بت.                                                                                                                                                                                                                                                                                                                                                                                                 |
| `integer`                          | [`Int32`](/ar/reference/data-types/int-uint)                                                                                                                                                                                                                                            | عدد صحيح موقّع 32-بت.                                                                                                                                                                                                                                                                                                                                                                                                 |
| `short`                            | [`Int16`](/ar/reference/data-types/int-uint)                                                                                                                                                                                                                                            | عدد صحيح موقّع 16-بت.                                                                                                                                                                                                                                                                                                                                                                                                 |
| `byte`                             | [`Int8`](/ar/reference/data-types/int-uint)                                                                                                                                                                                                                                             | عدد صحيح موقّع 8-بت.                                                                                                                                                                                                                                                                                                                                                                                                  |
| `unsigned_long`                    | [`UInt64`](/ar/reference/data-types/int-uint)                                                                                                                                                                                                                                           | عدد صحيح غير موقّع 64-بت.                                                                                                                                                                                                                                                                                                                                                                                             |
| `double`                           | [`Float64`](/ar/reference/data-types/float)                                                                                                                                                                                                                                             | عدد عشري عائم 64-بت.                                                                                                                                                                                                                                                                                                                                                                                                  |
| `float`                            | [`Float32`](/ar/reference/data-types/float)                                                                                                                                                                                                                                             | عدد عشري عائم 32-بت.                                                                                                                                                                                                                                                                                                                                                                                                  |
| `half_float`                       | [`Float32`](/ar/reference/data-types/float) أو [`BFloat16`](/ar/reference/data-types/float)                                                                                                                                                                                             | أقرب مكافئ. لا يحتوي ClickHouse على نوع float بحجم 16-بت. يتوفر في ClickHouse النوع `BFloat16`، لكنه يختلف عن Half-float IEE-754: إذ يوفّر half-float دقة أعلى مع نطاق أصغر، بينما يضحّي bfloat16 بالدقة مقابل نطاق أوسع، مما يجعله أنسب لأحمال تعلّم الآلة.                                                                                                                                                          |
| `scaled_float`                     | [`Decimal(x, y)`](/ar/reference/data-types/decimal)                                                                                                                                                                                                                                     | لتخزين numeric values ذات الفاصلة الثابتة.                                                                                                                                                                                                                                                                                                                                                                            |
| `date`                             | [`DateTime`](/ar/reference/data-types/datetime)                                                                                                                                                                                                                                         | أنواع تاريخ مكافئة بدقة الثواني.                                                                                                                                                                                                                                                                                                                                                                                      |
| `date_nanos`                       | [`DateTime64`](/ar/reference/data-types/datetime64)                                                                                                                                                                                                                                     | يدعم ClickHouse دقة النانوثانية باستخدام `DateTime64(9)`.                                                                                                                                                                                                                                                                                                                                                             |
| `binary`                           | [`String`](/ar/reference/data-types/string), [`FixedString(N)`](/ar/reference/data-types/fixedstring)                                                                                                                                                                                   | يتطلب فك ترميز base64 للحقول الثنائية.                                                                                                                                                                                                                                                                                                                                                                                |
| `ip`                               | [`IPv4`](/ar/reference/data-types/ipv4), [`IPv6`](/ar/reference/data-types/ipv6)                                                                                                                                                                                                        | تتوفر أنواع `IPv4` و`IPv6` الأصلية.                                                                                                                                                                                                                                                                                                                                                                                   |
| `object`                           | [`Nested`](/ar/reference/data-types/nested-data-structures/index), [`Map`](/ar/reference/data-types/map), [`Tuple`](/ar/reference/data-types/tuple), [`JSON`](/ar/reference/data-types/newjson)                                                                                         | يمكن لـ ClickHouse تمثيل الكائنات الشبيهة بـ JSON باستخدام [`Nested`](/ar/reference/data-types/nested-data-structures/index) أو [`JSON`](/ar/reference/data-types/newjson).                                                                                                                                                                                                                                           |
| `flattened`                        | [`String`](/ar/reference/data-types/string)                                                                                                                                                                                                                                             | يخزّن النوع flattened في Elasticsearch كائنات JSON كاملةً كحقول مفردة، ما يتيح وصولًا مرنًا ومن دون schema ثابتة إلى المفاتيح المتداخلة من دون تعيين كامل. وفي ClickHouse، يمكن تحقيق وظيفة مشابهة باستخدام النوع String، لكن ذلك يتطلب تنفيذ المعالجة في materialized views.                                                                                                                                         |
| `nested`                           | [`Nested`](/ar/reference/data-types/nested-data-structures/index)                                                                                                                                                                                                                       | توفّر أعمدة ClickHouse `Nested` دلالات مشابهة للحقول الفرعية المجمّعة، بافتراض استخدام `flatten_nested=0`.                                                                                                                                                                                                                                                                                                            |
| `join`                             | NA                                                                                                                                                                                                                                                                                      | لا يوجد مفهوم مباشر لعلاقات الأصل-الفرع. ولا حاجة إليه في ClickHouse لأن joins عبر الجداول مدعومة.                                                                                                                                                                                                                                                                                                                    |
| `alias`                            | [`Alias`](/ar/reference/statements/create/table#alias) modifier للعمود                                                                                                                                                                                                                  | الأسماء المستعارة [مدعومة](/ar/reference/statements/create/table#alias) من خلال modifier للحقل. ويمكن تطبيق الدوال على هذا alias، مثل `size String ALIAS formatReadableSize(size_bytes)`                                                                                                                                                                                                                              |
| `range` types (`*_range`)          | [`Tuple(start, end)`](/ar/reference/data-types/tuple) أو [`Array(T)`](/ar/reference/data-types/array)                                                                                                                                                                                   | لا يحتوي ClickHouse على نوع range أصلي، لكن يمكن تمثيل النطاقات الرقمية ونطاقات التاريخ باستخدام البنى [`Tuple(start, end)`](/ar/reference/data-types/tuple) أو [`Array`](/ar/reference/data-types/array). وبالنسبة إلى نطاقات IP (`ip_range`)، خزّن قيم CIDR كـ `String` وقيّمها باستخدام دوال مثل `isIPAddressInRange()`. وبدلًا من ذلك، يمكن استخدام قواميس lookup المعتمدة على `ip_trie` للحصول على تصفية فعّالة. |
| `aggregate_metric_double`          | [`AggregateFunction(...)`](/ar/reference/data-types/aggregatefunction) و[`SimpleAggregateFunction(...)`](/ar/reference/data-types/simpleaggregatefunction)                                                                                                                              | استخدم aggregate function states وmaterialized views لنمذجة المقاييس المجمّعة مسبقًا. تدعم جميع دوال aggregation aggregate states.                                                                                                                                                                                                                                                                                    |
| `histogram`                        | [`Tuple(Array(Float64), Array(UInt64))`](/ar/reference/data-types/tuple)                                                                                                                                                                                                                | مثّل الحاويات والعدّادات يدويًا باستخدام arrays أو schema مخصصة.                                                                                                                                                                                                                                                                                                                                                      |
| `annotated-text`                   | [`String`](/ar/reference/data-types/string)                                                                                                                                                                                                                                             | لا يوجد دعم مدمج للبحث المدرك للكيانات أو annotations.                                                                                                                                                                                                                                                                                                                                                                |
| `completion`, `search_as_you_type` | NA                                                                                                                                                                                                                                                                                      | لا يوجد محرّك autocomplete أو suggester أصلي. يمكن محاكاة ذلك باستخدام `String` و[search functions](/ar/reference/functions/regular-functions/string-search-functions).                                                                                                                                                                                                                                               |
| `semantic_text`                    | NA                                                                                                                                                                                                                                                                                      | لا يوجد semantic search أصلي — أنشئ embeddings واستخدم vector search.                                                                                                                                                                                                                                                                                                                                                 |
| `token_count`                      | [`Int32`](/ar/reference/data-types/int-uint)                                                                                                                                                                                                                                            | استخدمه أثناء ingestion لحساب عدد الـ token يدويًا، مثلًا عبر الدالة `length(tokens())`، على سبيل المثال مع عمود Materialized                                                                                                                                                                                                                                                                                         |
| `dense_vector`                     | [`Array(Float32)`](/ar/reference/data-types/array)                                                                                                                                                                                                                                      | استخدم arrays لتخزين embeddings.                                                                                                                                                                                                                                                                                                                                                                                      |
| `sparse_vector`                    | [`Map(UInt32, Float32)`](/ar/reference/data-types/map)                                                                                                                                                                                                                                  | حاكِ المتجهات sparse باستخدام الخرائط. لا يوجد دعم أصلي للمتجهات sparse.                                                                                                                                                                                                                                                                                                                                              |
| `rank_feature` / `rank_features`   | [`Float32`](/ar/reference/data-types/float), [`Array(Float32)`](/ar/reference/data-types/array)                                                                                                                                                                                         | لا يوجد تعزيز أصلي أثناء الاستعلام، لكن يمكن تمثيله يدويًا ضمن منطق التقييم.                                                                                                                                                                                                                                                                                                                                          |
| `geo_point`                        | [`Tuple(Float64, Float64)`](/ar/reference/data-types/tuple) أو [`Point`](/ar/reference/data-types/geo#point)                                                                                                                                                                            | استخدم Tuple من (خط العرض، خط الطول). ويتوفر [`Point`](/ar/reference/data-types/geo#point) أيضًا كنوع في ClickHouse.                                                                                                                                                                                                                                                                                                  |
| `geo_shape`, `shape`               | [`Ring`](/ar/reference/data-types/geo#ring), [`LineString`](/ar/reference/data-types/geo#linestring), [`MultiLineString`](/ar/reference/data-types/geo#multilinestring), [`Polygon`](/ar/reference/data-types/geo#polygon), [`MultiPolygon`](/ar/reference/data-types/geo#multipolygon) | دعم أصلي للأشكال الجغرافية والفهرسة المكانية.                                                                                                                                                                                                                                                                                                                                                                         |
| `percolator`                       | NA                                                                                                                                                                                                                                                                                      | لا يوجد مفهوم لفهرسة الاستعلامات. استخدم SQL القياسي + العروض المادية التزايدية بدلًا من ذلك.                                                                                                                                                                                                                                                                                                                         |
| `version`                          | [`String`](/ar/reference/data-types/string)                                                                                                                                                                                                                                             | لا يوفّر ClickHouse نوعًا أصليًا للإصدارات. خزّن الإصدارات كسلاسل نصية، واستخدم دوال UDFs مخصصة لإجراء المقارنات الدلالية عند الحاجة. وفكّر في تطبيعها إلى تنسيقات رقمية إذا كانت استعلامات النطاق مطلوبة.                                                                                                                                                                                                            |

<div id="notes">
  ### ملاحظات
</div>

* **المصفوفات**: في Elasticsearch، تدعم جميع الحقول المصفوفات دعمًا أصيلًا. أما في ClickHouse، فيجب تعريف المصفوفات صراحةً (مثل `Array(String)`)، مع ميزة إمكانية الوصول إلى مواضع محددة فيها والاستعلام عنها، مثل `an_array[1]`.
* **الحقول المتعددة**: يتيح Elasticsearch فهرسة [الحقل نفسه بطرائق متعددة](https://www.elastic.co/docs/reference/elasticsearch/mapping-reference/multi-fields#_multi_fields_with_multiple_analyzers) (مثل `text` و`keyword` معًا). أما في ClickHouse، فيجب تمثيل هذا النمط باستخدام أعمدة أو views منفصلة.
* **نوعا Map وJSON** - في ClickHouse، يُستخدم النوع [`Map`](/ar/reference/data-types/map) عادةً لتمثيل بنى key-value الديناميكية مثل `resourceAttributes` و`logAttributes`. ويتيح هذا النوع إدخال البيانات بمرونة ومن دون مخطط ثابت، إذ يسمح بإضافة مفاتيح عشوائية في وقت التشغيل — وهو ما يشبه من حيث الفكرة JSON objects في Elasticsearch. ومع ذلك، هناك قيود مهمة ينبغي مراعاتها:

  * **أنواع قيم موحّدة**: يجب أن تحتوي أعمدة [`Map`](/ar/reference/data-types/map) في ClickHouse على نوع قيم متّسق (مثل `Map(String, String)`). ولا تُدعَم القيم ذات الأنواع المختلطة من دون تحويل قسري.
  * **تكلفة على الأداء**: يتطلب الوصول إلى أي مفتاح في [`Map`](/ar/reference/data-types/map) تحميل الخريطة بالكامل إلى الذاكرة، وهو ما قد يكون غير مثالي من ناحية الأداء.
  * **عدم وجود subcolumns**: بخلاف JSON، لا تُمثَّل المفاتيح في [`Map`](/ar/reference/data-types/map) بوصفها subcolumns فعلية، مما يحدّ من قدرة ClickHouse على الفهرسة والضغط والاستعلام بكفاءة.

  وبسبب هذه القيود، يتجه ClickStack إلى الاستغناء عن [`Map`](/ar/reference/data-types/map) لصالح النوع [`JSON`](/ar/reference/data-types/newjson) المحسّن في ClickHouse. ويعالج النوع [`JSON`](/ar/reference/data-types/newjson) العديد من أوجه القصور في `Map`:

  * **تخزين عمودي حقيقي**: يُخزَّن كل JSON path بوصفه subcolumn، مما يتيح ضغطًا وترشيحًا وتنفيذًا متجهيًا للاستعلامات بكفاءة.
  * **دعم الأنواع المختلطة**: يمكن لأنواع البيانات المختلفة (مثل الأعداد الصحيحة والسلاسل النصية والمصفوفات) أن تتعايش تحت المسار نفسه من دون تحويل قسري أو توحيد للنوع.
  * **قابلية التوسع على مستوى نظام الملفات**: تمنع الحدود الداخلية للمفاتيح الديناميكية (`max_dynamic_paths`) والأنواع (`max_dynamic_types`) حدوث تضخم في عدد column files على القرص، حتى مع مجموعات المفاتيح ذات high cardinality.
  * **تخزين كثيف**: تُخزَّن nulls والقيم المفقودة بشكل sparse لتجنّب overhead غير الضروري.

    يُعد النوع [`JSON`](/ar/reference/data-types/newjson) مناسبًا بشكل خاص لأعباء observability، إذ يوفّر مرونة الإدخال من دون مخطط ثابت، إلى جانب أداء أنواع ClickHouse الأصلية وقابليتها للتوسع — مما يجعله بديلًا مثاليًا لـ [`Map`](/ar/reference/data-types/map) في حقول attributes الديناميكية.

    ولمزيد من التفاصيل حول نوع JSON، نوصي بالاطلاع على [JSON guide](/ar/guides/clickhouse/data-formats/json/intro) و["How we built a new powerful JSON data type for ClickHouse"](https://clickhouse.com/blog/a-new-powerful-json-data-type-for-clickhouse).