Merge pull request #46712 from kssenii/add-iceberg-doc

Add iceberg engine doc

docs/en/engines/table-engines/integrations/deltalake.md

@@ -19,7 +19,9 @@ CREATE TABLE deltalake
 **Engine parameters**
 
 -   `url` — Bucket url with path to the existing Delta Lake table.
--   `aws_access_key_id`, `aws_secret_access_key` - Long-term credentials for the [AWS](https://aws.amazon.com/) account user.  You can use these to authenticate your requests. Parameter is optional. If credentials are not specified, they are used from the configuration file. For more information see [Using S3 for Data Storage](../mergetree-family/mergetree.md#table_engine-mergetree-s3).
+-   `aws_access_key_id`, `aws_secret_access_key` - Long-term credentials for the [AWS](https://aws.amazon.com/) account user.  You can use these to authenticate your requests. Parameter is optional. If credentials are not specified, they are used from the configuration file.
+
+Engine parameters can be specified using [Named Collections](../../../operations/named-collections.md)
 
 **Example**
 
@@ -27,7 +29,24 @@ CREATE TABLE deltalake
 CREATE TABLE deltalake ENGINE=DeltaLake('http://mars-doc-test.s3.amazonaws.com/clickhouse-bucket-3/test_table/', 'ABC123', 'Abc+123')
 ```
 
+Using named collections:
+
+``` xml
+<clickhouse>
+    <named_collections>
+        <deltalake_conf>
+            <url>http://mars-doc-test.s3.amazonaws.com/clickhouse-bucket-3/</url>
+            <access_key_id>ABC123<access_key_id>
+            <secret_access_key>Abc+123</secret_access_key>
+        </deltalake_conf>
+    </named_collections>
+</clickhouse>
+```
+
+```sql
+CREATE TABLE deltalake ENGINE=DeltaLake(deltalake_conf, filename = 'test_table')
+```
+
 ## See also
 
 -  [deltaLake table function](../../../sql-reference/table-functions/deltalake.md)
-

docs/en/engines/table-engines/integrations/hudi.md

@@ -19,7 +19,9 @@ CREATE TABLE hudi_table
 **Engine parameters**
 
 -   `url` — Bucket url with the path to an existing Hudi table.
--   `aws_access_key_id`, `aws_secret_access_key` - Long-term credentials for the [AWS](https://aws.amazon.com/) account user.  You can use these to authenticate your requests. Parameter is optional. If credentials are not specified, they are used from the configuration file. For more information see [Using S3 for Data Storage](../mergetree-family/mergetree.md#table_engine-mergetree-s3).
+-   `aws_access_key_id`, `aws_secret_access_key` - Long-term credentials for the [AWS](https://aws.amazon.com/) account user.  You can use these to authenticate your requests. Parameter is optional. If credentials are not specified, they are used from the configuration file.
+
+Engine parameters can be specified using [Named Collections](../../../operations/named-collections.md)
 
 **Example**
 
@@ -27,7 +29,24 @@ CREATE TABLE hudi_table
 CREATE TABLE hudi_table ENGINE=Hudi('http://mars-doc-test.s3.amazonaws.com/clickhouse-bucket-3/test_table/', 'ABC123', 'Abc+123')
 ```
 
+Using named collections:
+
+``` xml
+<clickhouse>
+    <named_collections>
+        <hudi_conf>
+            <url>http://mars-doc-test.s3.amazonaws.com/clickhouse-bucket-3/</url>
+            <access_key_id>ABC123<access_key_id>
+            <secret_access_key>Abc+123</secret_access_key>
+        </hudi_conf>
+    </named_collections>
+</clickhouse>
+```
+
+```sql
+CREATE TABLE hudi_table ENGINE=Hudi(hudi_conf, filename = 'test_table')
+```
+
 ## See also
 
 -  [hudi table function](/docs/en/sql-reference/table-functions/hudi.md)
-

docs/en/engines/table-engines/integrations/iceberg.md

@@ -0,0 +1,52 @@
+---
+slug: /en/engines/table-engines/integrations/iceberg
+sidebar_label: Iceberg
+---
+
+# Iceberg Table Engine
+
+This engine provides a read-only integration with existing Apache [Iceberg](https://iceberg.apache.org/) tables in Amazon S3.
+
+## Create Table
+
+Note that the Iceberg table must already exist in S3, this command does not take DDL parameters to create a new table.
+
+``` sql
+CREATE TABLE iceberg_table
+    ENGINE = Iceberg(url, [aws_access_key_id, aws_secret_access_key,])
+```
+
+**Engine parameters**
+
+-   `url` — url with the path to an existing Iceberg table.
+-   `aws_access_key_id`, `aws_secret_access_key` - Long-term credentials for the [AWS](https://aws.amazon.com/) account user.  You can use these to authenticate your requests. Parameter is optional. If credentials are not specified, they are used from the configuration file.
+
+Engine parameters can be specified using [Named Collections](../../../operations/named-collections.md)
+
+**Example**
+
+```sql
+CREATE TABLE iceberg_table ENGINE=Iceberg('http://test.s3.amazonaws.com/clickhouse-bucket/test_table', 'test', 'test')
+```
+
+Using named collections:
+
+``` xml
+<clickhouse>
+    <named_collections>
+        <iceberg_conf>
+            <url>http://test.s3.amazonaws.com/clickhouse-bucket/</url>
+            <access_key_id>test<access_key_id>
+            <secret_access_key>test</secret_access_key>
+        </iceberg_conf>
+    </named_collections>
+</clickhouse>
+```
+
+```sql
+CREATE TABLE iceberg_table ENGINE=Iceberg(iceberg_conf, filename = 'test_table')
+```
+
+## See also
+
+-  [iceberg table function](/docs/en/sql-reference/table-functions/iceberg.md)

docs/en/sql-reference/table-functions/iceberg.md

@@ -0,0 +1,58 @@
+---
+slug: /en/sql-reference/table-functions/iceberg
+sidebar_label: Iceberg
+---
+
+# iceberg Table Function
+
+Provides a read-only table-like interface to Apache [Iceberg](https://iceberg.apache.org/) tables in Amazon S3.
+
+## Syntax
+
+``` sql
+iceberg(url [,aws_access_key_id, aws_secret_access_key] [,format] [,structure])
+```
+
+## Arguments
+
+- `url` — Bucket url with the path to an existing Iceberg table in S3.
+- `aws_access_key_id`, `aws_secret_access_key` - Long-term credentials for the [AWS](https://aws.amazon.com/) account user.  You can use these to authenticate your requests. These parameters are optional. If credentials are not specified, they are used from the ClickHouse configuration. For more information see [Using S3 for Data Storage](/docs/en/engines/table-engines/mergetree-family/mergetree.md/#table_engine-mergetree-s3).
+- `format` — The [format](/docs/en/interfaces/formats.md/#formats) of the file. By default `Parquet` is used.
+- `structure` — Structure of the table. Format `'column1_name column1_type, column2_name column2_type, ...'`.
+
+Engine parameters can be specified using [Named Collections](../../operations/named-collections.md)
+
+**Returned value**
+
+A table with the specified structure for reading data in the specified Iceberg table in S3.
+
+**Example**
+
+```sql
+SELECT * FROM iceberg('http://test.s3.amazonaws.com/clickhouse-bucket/test_table', 'test', 'test')
+```
+
+Using named collections:
+
+```xml
+<clickhouse>
+    <named_collections>
+        <iceberg_conf>
+            <url>http://test.s3.amazonaws.com/clickhouse-bucket/</url>
+            <access_key_id>test<access_key_id>
+            <secret_access_key>test</secret_access_key>
+            <format>auto</format>
+            <structure>auto</structure>
+        </iceberg_conf>
+    </named_collections>
+</clickhouse>
+```
+
+```sql
+SELECT * FROM iceberg(iceberg_conf, filename = 'test_table')
+DESCRIBE iceberg(iceberg_conf, filename = 'test_table')
+```
+
+**See Also**
+
+- [Iceberg engine](/docs/en/engines/table-engines/integrations/iceberg.md)