Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Create a Microsoft OneLake connection

Establish a zero copy connection to a Microsoft OneLake system in Zero Copy Connector Hub.

Before you begin

Role required: df_connection_admin

About this task

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

Procedure

  1. Navigate to the available primary connectors in Zero Copy Connector 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.
    • Find the Microsoft OneLake connector and select Connect.
  2. On the form, fill in the fields.

FieldDescription
Name and description
Connection labelUnique name for this connection. This helps in identifying the connection within your system.
Connection nameSystem-generated name based on the Connection label. This field cannot be modified once the connection is established.
Short descriptionDescription of the connection explaining what it is about.
Catalog Configuration
Iceberg REST catalog URIURI of the Iceberg REST catalog endpoint for Microsoft OneLake. For example:
https://onelake.dfs.fabric.microsoft.com/iceberg
OAuth client IDClient ID for authenticating with the Iceberg REST catalog.
OAuth secretSecret key associated with the client ID.
OAuth EndpointEndpoint for the Iceberg REST catalog OAuth2 server URI. For example:
https://login.microsoftonline.com/<tenant-id>/oauth2/v2.0/token
WareHouseIceberg REST catalog warehouse.
Object Storage System configuration
Azure tenant IDTenant ID issued by Microsoft OneLake for authentication.
OAuth client IDAzure issued client ID for authenticating with Microsoft OneLake.
OAuth secretSecret key associated with the client ID.
OAuth EndpointAzure OAuth endpoint for connection. For example:
https://login.microsoftonline.com/<tenant-id>/oauth2/v2.0/token
  1. 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 .

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