Create an Apache Iceberg connection

  • Release version: Zurich
  • Updated July 31, 2025
  • 2 minutes to read

    • Establish a zero copy connection to Apache Iceberg in Workflow Data Fabric Hub.

    Before you begin

    Role required: df_connection_admin

    About this task

    Work with your data source admin to create a connection to Apache Iceberg. For additional information about connecting, refer to the Iceberg connector documentation.

    Procedure

    1. Navigate to the available primary connectors in Workflow Data Fabric Hub in one of the following ways:
      • Navigate to All > Workflow Data Fabric Hub > Available connectors > Primary connectors.
      • Navigate to Admin > Workflow Data Fabric Hub > Available connectors > Primary connectors.
    2. Find the Apache Iceberg connector and select Connect.
    3. On the form, fill in the fields.
      Table 1. New Apache Iceberg Connection form
      Field Description
      Name and description
      Connection label Unique name for this connection. This helps in identifying the connection within your system.
      Connection name System-generated name based on the Connection label. This field cannot be modified once the connection is established.
      Short description Description of the connection explaining what it is about.
      Object storage authentication
      Object storage system Storage system used. Default is Amazon S3.
      AWS access key Access key used to access S3.
      AWS secret key Secret key used to access S3.
      AWS region AWS region where your S3 bucket is located.
    4. Configure the object storage system that you want to use with Apache Iceberg.
      OptionDescription
      Amazon S3
      1. Enter the access key used to access S3.
      2. Enter the secret key used to access S3.
      3. Enter the AWS region where your S3 bucket is located.
      4. Configure the metastore that you want to use with Apache Iceberg.
      Azure Data Lake Storage (ADLS) Enter the ADLS Access Key.
    5. Configure the metastore that you want to use with Apache Iceberg.
      Note:
      AWS Glue is only applicable when you select Amazon S3 as the object storage system.
      OptionDescription
      Hive Thrift
      1. Attach the truststore file using one of the following options:
        • Upload the truststore file by selecting Attach TrustStore file and selecting the file.
        • Copy and paste the contents of the truststore file.
      2. Enter the truststore password.
      3. Enter the metastore URI that you want to connect to using the Thrift protocol. For example:

        thrift://<host>:<port>
      AWS Glue
      1. Enter the AWS access key to connect to the Glue Catalog.
      2. Enter the AWS secret key to use to connect to the Glue Catalog.
      3. Enter the AWS region of the Glue Catalog.
    6. Select Connect.

    Result

    A test connection is made to the external data source, verifying that the connection details are correct and the data source is accessible.

    What to do next

    If the connection succeeds, configure data steward access on the Access Control tab. See Manage access to an established connection using roles.

    If the connection fails, verify the connection details with your data source administrator and try again.