From 54129115924e9fe8d61f48d61737c723c9ebe92f Mon Sep 17 00:00:00 2001
From: avogar <pav.cruglov@yandex.ru>
Date: Fri, 28 Oct 2022 17:43:07 +0000
Subject: [PATCH] Add documentation for 'format' table function

---
 .../sql-reference/table-functions/format.md   | 75 +++++++++++++++++++
 .../sql-reference/table-functions/format.md   |  1 +
 .../sql-reference/table-functions/format,md   |  1 +
 3 files changed, 77 insertions(+)
 create mode 100644 docs/en/sql-reference/table-functions/format.md
 create mode 120000 docs/ru/sql-reference/table-functions/format.md
 create mode 120000 docs/zh/sql-reference/table-functions/format,md

diff --git a/docs/en/sql-reference/table-functions/format.md b/docs/en/sql-reference/table-functions/format.md
new file mode 100644
index 00000000000..bc0ada9795b
--- /dev/null
+++ b/docs/en/sql-reference/table-functions/format.md
@@ -0,0 +1,75 @@
+---
+slug: /en/sql-reference/table-functions/format
+sidebar_position: 56
+sidebar_label: format
+---
+
+# format
+
+Extracts table structure from data and parse it according to specified input format.
+
+**Syntax**
+
+``` sql
+format(format_name, data)
+```
+
+**Parameters**
+
+-   `format_name` — The [format](../../interfaces/formats.md#formats) of the data.
+-   `data` — String literal containing data in specified format
+
+**Returned value**
+
+A table with data parsed from `data` argument according specified format and extracted schema.
+
+**Examples**
+
+**Query:**
+``` sql
+:) select * from format(JSONEachRow, 
+$$
+{"a": "Hello", "b": 111}
+{"a": "World", "b": 123}
+{"a": "Hello", "b": 112}
+{"a": "World", "b": 124}
+$$)
+```
+
+**Result:**
+
+```text
+┌───b─┬─a─────┐
+│ 111 │ Hello │
+│ 123 │ World │
+│ 112 │ Hello │
+│ 124 │ World │
+└─────┴───────┘
+```
+
+**Query:**
+```sql
+
+:) desc format(JSONEachRow,
+$$
+{"a": "Hello", "b": 111}
+{"a": "World", "b": 123}
+{"a": "Hello", "b": 112}
+{"a": "World", "b": 124}
+$$)
+```
+
+**Result:**
+
+```text
+┌─name─┬─type──────────────┬─default_type─┬─default_expression─┬─comment─┬─codec_expression─┬─ttl_expression─┐
+│ b    │ Nullable(Float64) │              │                    │         │                  │                │
+│ a    │ Nullable(String)  │              │                    │         │                  │                │
+└──────┴───────────────────┴──────────────┴────────────────────┴─────────┴──────────────────┴────────────────┘
+```
+
+**See Also**
+
+-   [Formats](../../interfaces/formats.md)
+
+[Original article](https://clickhouse.com/docs/en/sql-reference/table-functions/format) <!--hide-->
diff --git a/docs/ru/sql-reference/table-functions/format.md b/docs/ru/sql-reference/table-functions/format.md
new file mode 120000
index 00000000000..cc5e3a5a142
--- /dev/null
+++ b/docs/ru/sql-reference/table-functions/format.md
@@ -0,0 +1 @@
+../../../en/sql-reference/table-functions/format.md
\ No newline at end of file
diff --git a/docs/zh/sql-reference/table-functions/format,md b/docs/zh/sql-reference/table-functions/format,md
new file mode 120000
index 00000000000..cc5e3a5a142
--- /dev/null
+++ b/docs/zh/sql-reference/table-functions/format,md
@@ -0,0 +1 @@
+../../../en/sql-reference/table-functions/format.md
\ No newline at end of file