From 79153d58ae7ffd072eb8ac378e44d961f0918130 Mon Sep 17 00:00:00 2001
From: Dorota Wojcik <dorota.wojcik@aiven.io>
Date: Thu, 5 Oct 2023 17:56:21 +0200
Subject: [PATCH] draft

---
 _toc.yml                                      |  4 +++
 docs/products/clickhouse/reference.rst        |  8 +++++
 .../reference/s3-supported-file-formats.rst   | 17 ++++++++++
 .../clickhouse/reference/table-functions.rst  | 31 +++++++++++++++++++
 4 files changed, 60 insertions(+)
 create mode 100644 docs/products/clickhouse/reference/s3-supported-file-formats.rst
 create mode 100644 docs/products/clickhouse/reference/table-functions.rst

diff --git a/_toc.yml b/_toc.yml
index 4810310070..68728347e2 100644
--- a/_toc.yml
+++ b/_toc.yml
@@ -815,6 +815,10 @@ entries:
             title: Supported table engines
           - file: docs/products/clickhouse/reference/metrics-list
             title: ClickHouse metrics in Grafana
+          - file: docs/products/clickhouse/reference/table-functions
+            title: Table functions
+          - file: docs/products/clickhouse/reference/s3-supported-file-formats
+            title: S3 file formats
           - file: docs/products/clickhouse/reference/supported-input-output-formats
             title: Formats for ClickHouse-Kafka data exchange
           - file: docs/products/clickhouse/reference/advanced-params
diff --git a/docs/products/clickhouse/reference.rst b/docs/products/clickhouse/reference.rst
index 198c2f88df..33d26733a7 100644
--- a/docs/products/clickhouse/reference.rst
+++ b/docs/products/clickhouse/reference.rst
@@ -20,3 +20,11 @@ Additional reference information for Aiven for ClickHouse®:
     .. grid-item-card:: :doc:`Advanced parameters </docs/products/clickhouse/reference/advanced-params>`
         :shadow: md
         :margin: 2 2 0 0
+
+    .. grid-item-card:: :doc:`File formats for the S3 table function in Aiven for ClickHouse® </docs/products/clickhouse/reference/s3-supported-file-formats>`
+        :shadow: md
+        :margin: 2 2 0 0
+
+    .. grid-item-card:: :doc:`Table functions supported in Aiven for ClickHouse® </docs/products/clickhouse/reference/table-functions>`
+        :shadow: md
+        :margin: 2 2 0 0
diff --git a/docs/products/clickhouse/reference/s3-supported-file-formats.rst b/docs/products/clickhouse/reference/s3-supported-file-formats.rst
new file mode 100644
index 0000000000..f59a66118e
--- /dev/null
+++ b/docs/products/clickhouse/reference/s3-supported-file-formats.rst
@@ -0,0 +1,17 @@
+File formats for the S3 table function in Aiven for ClickHouse®
+===============================================================
+
+The `S3 table function <https://clickhouse.com/docs/en/sql-reference/table-functions/s3>`_ allows you to select and insert data in S3-compatible storages. The S3 table function in Aiven for ClickHouse® can be used with the following file formats:
+
+* ``Arrow``
+* ``CSV``
+* ``JSON``
+* ``TSV``
+* ``Parquet``
+* ``ORC``
+* ``Avro``
+
+.. seealso::
+
+    * :doc:`Table functions supported in Aiven for ClickHouse® </docs/products/clickhouse/reference/table-functions>`
+    * :doc:`Read and pull data from S3 object storages and web resources over HTTP </docs/products/clickhouse/howto/run-federated-queries>`
diff --git a/docs/products/clickhouse/reference/table-functions.rst b/docs/products/clickhouse/reference/table-functions.rst
new file mode 100644
index 0000000000..e6b1f06650
--- /dev/null
+++ b/docs/products/clickhouse/reference/table-functions.rst
@@ -0,0 +1,31 @@
+Table functions supported in Aiven for ClickHouse®
+==================================================
+
+Table functions return data of the table type and are used to construct tables. Aiven for ClickHouse® supports the following `table functions <https://clickhouse.com/docs/en/sql-reference/table-functions>`_:
+
+* ``cluster``
+* ``clusterAllReplicas``
+* ``cosn``
+* ``deltaLake``
+* ``format``
+* ``generateRandom``
+* ``hudi``
+* ``iceberg``
+* ``input``
+* ``merge``
+* ``mysql``
+* ``null``
+* ``numbers``
+* ``numbers_mt``
+* ``postgresql``
+* ``remote``
+* ``remoteSecure``
+* ``s3``
+* ``s3Cluster``
+* ``url``
+* ``values``
+* ``view``
+* ``viewExplain``
+* ``viewIfPermitted``
+* ``zeros``
+* ``zeros_mt``