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

> وثائق تنسيق ORC

# ORC

| المدخلات | المخرجات | الاسم المستعار |
| - | - | - |
| ✔ | ✔ | |

<div id="description">
  ## الوصف
</div>

يُعد [Apache ORC](https://orc.apache.org/) تنسيقَ تخزينٍ عموديًا يُستخدم على نطاق واسع ضمن منظومة [Hadoop](https://hadoop.apache.org/).

<div id="data-types-matching-orc">
  ## مطابقة أنواع البيانات
</div>

يقارن الجدول أدناه بين أنواع بيانات ORC المدعومة وأنواع [البيانات](/ar/reference/data-types/index) المقابلة لها في ClickHouse ضمن استعلامات `INSERT` و`SELECT`.

| نوع بيانات ORC (`INSERT`) | نوع بيانات ClickHouse | نوع بيانات ORC (`SELECT`) |
| - | - | - |
| `Boolean` | [Bool](/ar/reference/data-types/boolean) | `Boolean` |
| `Tinyint` | [Int8/UInt8](/ar/reference/data-types/int-uint)/[Enum8](/ar/reference/data-types/enum) | `Tinyint` |
| `Smallint` | [Int16/UInt16](/ar/reference/data-types/int-uint)/[Enum16](/ar/reference/data-types/enum) | `Smallint` |
| `Int` | [Int32/UInt32](/ar/reference/data-types/int-uint) | `Int` |
| `Bigint` | [Int64/UInt64](/ar/reference/data-types/int-uint) | `Bigint` |
| `Float` | [Float32](/ar/reference/data-types/float) | `Float` |
| `Double` | [Float64](/ar/reference/data-types/float) | `Double` |
| `Decimal` | [Decimal](/ar/reference/data-types/decimal) | `Decimal` |
| `Date` | [Date32](/ar/reference/data-types/date32) | `Date` |
| `Timestamp` | [DateTime64](/ar/reference/data-types/datetime64) | `Timestamp` |
| `String`, `Varchar`, `Binary` | [String](/ar/reference/data-types/string) | `String` |
| `Char` | [FixedString](/ar/reference/data-types/fixedstring) | `String` |
| `List` | [Array](/ar/reference/data-types/array) | `List` |
| `Struct` | [Tuple](/ar/reference/data-types/tuple) | `Struct` |
| `Map` | [Map](/ar/reference/data-types/map) | `Map` |
| `Int` | [IPv4](/ar/reference/data-types/int-uint) | `Int` |
| `Binary` | [IPv6](/ar/reference/data-types/ipv6) | `Binary` |
| `Binary` | [Int128/UInt128/Int256/UInt256](/ar/reference/data-types/int-uint) | `Binary` |
| `Binary` | [Decimal256](/ar/reference/data-types/decimal) | `Binary` |
| `Union` | [Variant](/ar/reference/data-types/variant) | `Union` |

* الأنواع الأخرى غير مدعومة.
* يُقرأ عمود `Union` في ORC باعتباره [Variant](/ar/reference/data-types/variant) لأنواع فروع union، ويُكتب عمود `Variant` باعتباره `Union` في ORC لأنواع فروعه. لاحظ أن `Variant` يرتب أنواع فروعه، لذا قد يختلف ترتيب الفروع عن ملف ORC. لا تُدعم أنواع union ذات أنواع الفروع المكررة (مثل `uniontype<int,int>`).
* يمكن أن تكون أنواع `Array` متداخلة، ويمكن أن تأخذ قيمة من النوع `Nullable` كوسيطة. كما يمكن أيضًا أن تكون الأنواع `Tuple` و`Map` متداخلة.
* لا يشترط أن تتطابق أنواع بيانات أعمدة جدول ClickHouse مع حقول بيانات ORC المقابلة. عند إدراج البيانات، يفسّر ClickHouse أنواع البيانات وفقًا للجدول أعلاه، ثم [يحوّلها](/ar/reference/functions/regular-functions/type-conversion-functions#CAST) إلى نوع البيانات المحدد لعمود جدول ClickHouse.

<div id="example-usage">
  ## مثال على الاستخدام
</div>

<div id="inserting-data">
  ### إدراج البيانات
</div>

باستخدام ملف ORC بالبيانات التالية، باسم `football.orc`:

```text theme={null}
    ┌───────date─┬─season─┬─home_team─────────────┬─away_team───────────┬─home_team_goals─┬─away_team_goals─┐
 1. │ 2022-04-30 │   2021 │ Sutton United         │ Bradford City       │               1 │               4 │
 2. │ 2022-04-30 │   2021 │ Swindon Town          │ Barrow              │               2 │               1 │
 3. │ 2022-04-30 │   2021 │ Tranmere Rovers       │ Oldham Athletic     │               2 │               0 │
 4. │ 2022-05-02 │   2021 │ Port Vale             │ Newport County      │               1 │               2 │
 5. │ 2022-05-02 │   2021 │ Salford City          │ Mansfield Town      │               2 │               2 │
 6. │ 2022-05-07 │   2021 │ Barrow                │ Northampton Town    │               1 │               3 │
 7. │ 2022-05-07 │   2021 │ Bradford City         │ Carlisle United     │               2 │               0 │
 8. │ 2022-05-07 │   2021 │ Bristol Rovers        │ Scunthorpe United   │               7 │               0 │
 9. │ 2022-05-07 │   2021 │ Exeter City           │ Port Vale           │               0 │               1 │
10. │ 2022-05-07 │   2021 │ Harrogate Town A.F.C. │ Sutton United       │               0 │               2 │
11. │ 2022-05-07 │   2021 │ Hartlepool United     │ Colchester United   │               0 │               2 │
12. │ 2022-05-07 │   2021 │ Leyton Orient         │ Tranmere Rovers     │               0 │               1 │
13. │ 2022-05-07 │   2021 │ Mansfield Town        │ Forest Green Rovers │               2 │               2 │
14. │ 2022-05-07 │   2021 │ Newport County        │ Rochdale            │               0 │               2 │
15. │ 2022-05-07 │   2021 │ Oldham Athletic       │ Crawley Town        │               3 │               3 │
16. │ 2022-05-07 │   2021 │ Stevenage Borough     │ Salford City        │               4 │               2 │
17. │ 2022-05-07 │   2021 │ Walsall               │ Swindon Town        │               0 │               3 │
    └────────────┴────────┴───────────────────────┴─────────────────────┴─────────────────┴─────────────────┘
```

أدرِج البيانات:

```sql theme={null}
INSERT INTO football FROM INFILE 'football.orc' FORMAT ORC;
```

<div id="reading-data">
  ### قراءة البيانات
</div>

يمكنك قراءة البيانات باستخدام تنسيق `ORC`:

```sql theme={null}
SELECT *
FROM football
INTO OUTFILE 'football.orc'
FORMAT ORC
```

<Tip>
  ORC هو تنسيق ثنائي لا يظهر على الطرفية بصيغة مقروءة للبشر. استخدم `INTO OUTFILE` لإخراج ملفات ORC.
</Tip>

<div id="format-settings">
  ## إعدادات التنسيق
</div>

| الإعداد | الوصف | القيمة الافتراضية |
| - | - | - |
| [`output_format_orc_string_as_string`](/ar/reference/settings/formats/output-format#output_format_orc_string_as_string) | استخدام النوع String في ORC بدلًا من Binary لأعمدة String. | `true` |
| [`output_format_orc_compression_method`](/ar/reference/settings/formats/output-format#output_format_orc_compression_method) | طريقة الضغط المستخدمة في تنسيق ORC للإخراج. القيمة الافتراضية | `zstd` |
| [`input_format_orc_case_insensitive_column_matching`](/ar/reference/settings/formats/input-format#input_format_orc_case_insensitive_column_matching) | تجاهل حالة الأحرف عند مطابقة أعمدة ORC مع أعمدة ClickHouse. | `false` |
| [`input_format_orc_allow_missing_columns`](/ar/reference/settings/formats/input-format#input_format_orc_allow_missing_columns) | السماح بالأعمدة المفقودة أثناء قراءة بيانات ORC. | `true` |
| [`input_format_orc_skip_columns_with_unsupported_types_in_schema_inference`](/ar/reference/settings/formats/input-format#input_format_orc_skip_columns_with_unsupported_types_in_schema_inference) | السماح بتخطي الأعمدة ذات الأنواع غير المدعومة أثناء استنتاج المخطط لتنسيق ORC. | `false` |

لتبادل البيانات مع Hadoop، يمكنك استخدام [محرك جدول HDFS](/ar/reference/engines/table-engines/integrations/hdfs).