> ## 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.

> يحلّل البيانات من الوسيطات وفق تنسيق الإدخال المحدد. وإذا لم تُحدَّد وسيطة البنية، فستُستخلص من البيانات.

# format

يحلّل البيانات من الوسيطات وفق تنسيق الإدخال المحدد. وإذا لم تُحدَّد وسيطة البنية، فستُستخلص من البيانات.

<div id="syntax">
  ## البنية
</div>

```sql theme={null}
format(format_name, [structure], data)
```

<div id="arguments">
  ## الوسائط
</div>

* `format_name` — [تنسيق](/ar/reference/formats/index) البيانات.
* `structure` - بنية الجدول. اختياري. التنسيق: 'column1\_name column1\_type, column2\_name column2\_type, ...'.
* `data` — قيمة حرفية من نوع سلسلة نصية أو تعبير ثابت يُرجع سلسلة نصية تحتوي على بيانات بالتنسيق المحدد

<div id="returned_value">
  ## القيمة المعادة
</div>

جدول يتضمن بيانات جرى تحليلها من الوسيطة `data` وفقًا للتنسيق المحدد والبنية المحددة أو المستخرجة.

<div id="examples">
  ## أمثلة
</div>

بدون وسيطة `structure`:

```sql title="Query" theme={null}
SELECT * FROM format(JSONEachRow,
$$
{"a": "Hello", "b": 111}
{"a": "World", "b": 123}
{"a": "Hello", "b": 112}
{"a": "World", "b": 124}
$$)
```

```response title="Response" theme={null}
┌───b─┬─a─────┐
│ 111 │ Hello │
│ 123 │ World │
│ 112 │ Hello │
│ 124 │ World │
└─────┴───────┘
```

```sql title="Query" theme={null}
DESC format(JSONEachRow,
$$
{"a": "Hello", "b": 111}
{"a": "World", "b": 123}
{"a": "Hello", "b": 112}
{"a": "World", "b": 124}
$$)
```

```response title="Response" theme={null}
┌─name─┬─type──────────────┬─default_type─┬─default_expression─┬─comment─┬─codec_expression─┬─ttl_expression─┐
│ b    │ Nullable(Float64) │              │                    │         │                  │                │
│ a    │ Nullable(String)  │              │                    │         │                  │                │
└──────┴───────────────────┴──────────────┴────────────────────┴─────────┴──────────────────┴────────────────┘
```

باستخدام الوسيطة `structure`:

```sql title="Query" theme={null}
SELECT * FROM format(JSONEachRow, 'a String, b UInt32',
$$
{"a": "Hello", "b": 111}
{"a": "World", "b": 123}
{"a": "Hello", "b": 112}
{"a": "World", "b": 124}
$$)
```

```response title="Response" theme={null}
┌─a─────┬───b─┐
│ Hello │ 111 │
│ World │ 123 │
│ Hello │ 112 │
│ World │ 124 │
└───────┴─────┘
```

<div id="related">
  ## ذات صلة
</div>

* [التنسيقات](/ar/reference/formats/index)