Add Iceberg format doc

Author: Clare Zheng (Shanghai Wicresoft Co Ltd)

articles/data-factory/TOC.yml

@@ -492,6 +492,8 @@ items:
       displayName: timeout
     - name: HubSpot
       href: connector-hubspot.md
+    - name: Iceberg format
+      href: format-iceberg.md      
     - name: Impala
       href: connector-impala.md
     - name: Informix

articles/data-factory/connector-azure-data-lake-storage.md

@@ -7,7 +7,7 @@ author: jianleishen
 ms.subservice: data-movement
 ms.topic: conceptual
 ms.custom: synapse
-ms.date: 01/05/2024
+ms.date: 09/12/2024
 ---
 
 # Copy and transform data in Azure Data Lake Storage Gen2 using Azure Data Factory or Azure Synapse Analytics
@@ -428,6 +428,7 @@ For a full list of sections and properties available for defining activities, se
 ### Azure Data Lake Storage Gen2 as a source type
 
 [!INCLUDE [data-factory-v2-file-formats](includes/data-factory-v2-file-formats.md)] 
+- [Iceberg format](format-iceberg.md)
 
 You have several options to copy data from ADLS Gen2:
 

articles/data-factory/format-iceberg.md

@@ -0,0 +1,91 @@
+---
+title: Iceberg format in Azure Data Factory
+titleSuffix: Azure Data Factory & Azure Synapse
+description: This topic describes how to deal with Iceberg format in Azure Data Factory and Azure Synapse Analytics.
+author: jianleishen
+ms.subservice: data-movement
+ms.custom: synapse
+ms.topic: conceptual
+ms.date: 09/12/2024
+ms.author: jianleishen
+---
+
+# Iceberg format in Azure Data Factory and Azure Synapse Analytics
+
+[!INCLUDE[appliesto-adf-asa-md](includes/appliesto-adf-asa-md.md)]
+
+Follow this article when you want to **write the data into Iceberg format**. 
+
+Iceberg format is supported for the following connectors: 
+
+- [Azure Data Lake Storage Gen2](connector-azure-data-lake-storage.md)
+
+## Dataset properties
+
+For a full list of sections and properties available for defining datasets, see the [Datasets](concepts-datasets-linked-services.md) article. This section provides a list of properties supported by the Iceberg format dataset.
+
+| Property         | Description                                                  | Required |
+| ---------------- | ------------------------------------------------------------ | -------- |
+| type             | The type property of the dataset must be set to **Iceberg**. | Yes      |
+| location         | Location settings of the file(s). Each file-based connector has its own location type and supported properties under `location`.  | Yes      |
+
+Below is an example of Iceberg dataset on Azure Data Lake Storage Gen2:
+
+```json
+{
+    "name": "IcebergDataset",
+    "properties": {
+        "type": "Iceberg",
+        "linkedServiceName": {
+            "referenceName": "<Azure Data Lake Storage Gen2 linked service name>",
+            "type": "LinkedServiceReference"
+        },
+        "schema": [ < physical schema, optional, retrievable during authoring >
+        ],
+        "typeProperties": {
+            "location": {
+                "type": "AzureBlobFSLocation",
+                "fileSystem": "filesystemname",
+                "folderPath": "folder/subfolder",
+            }
+        }
+    }
+}
+
+```
+
+## Copy activity properties
+
+For a full list of sections and properties available for defining activities, see the [Pipelines](concepts-pipelines-activities.md) article. This section provides a list of properties supported by the Iceberg sink.
+
+### Iceberg as sink
+
+The following properties are supported in the copy activity ***\*sink\**** section.
+
+| Property       | Description                                                  | Required |
+| -------------- | ------------------------------------------------------------ | -------- |
+| type           | The type property of the copy activity source must be set to **IcebergSink**. | Yes      |
+| formatSettings | A group of properties. Refer to **Iceberg write settings** table below. |    No      |
+| storeSettings  | A group of properties on how to write data to a data store. Each file-based connector has its own supported write settings under `storeSettings`.  | No       |
+
+Supported **Iceberg write settings** under `formatSettings`:
+
+| Property      | Description                                                  | Required                                              |
+| ------------- | ------------------------------------------------------------ | ----------------------------------------------------- |
+| type          | The type of formatSettings must be set to **IcebergWriteSettings**. | Yes                                                   |
+
+## Related connectors and formats
+
+Here are some common connectors and formats related to the delimited text format:
+
+- [Azure Data Lake Storage Gen2](connector-azure-data-lake-storage.md)
+- [Binary format](format-binary.md)
+- [Delta format](format-delta.md)
+- [Excel format](format-excel.md)
+- [JSON format](format-json.md)
+- [Parquet format](format-parquet.md)
+
+## Related content
+
+- [Data type mapping in dataset schemas](copy-activity-schema-and-type-mapping.md#data-type-mapping)
+- [Copy activity overview](copy-activity-overview.md)