Edit

Share via


Guidance on using the Bring Your Own Driver (BYOD) approach

APPLIES TO: Azure Data Factory Azure Synapse Analytics

Tip

Try out Data Factory in Microsoft Fabric, an all-in-one analytics solution for enterprises. Microsoft Fabric covers everything from data movement to data science, real-time analytics, business intelligence, and reporting. Learn how to start a new trial for free!

This article provides step-by-step guidance for using connectors with Bring Your Own Driver (BYOD) approach and upgrading from outdated V1 connectors to the latest V2 connectors in scenarios where the BYOD approach is required.

Guidance on using connectors with BYOD approach

Steps

  1. Review Connector Requirements
    Visit the Data Factory documentation for the specific connector. Under the Pre-requisites section, verify:

    • The supported version of the client driver.
    • The minimum required SHIR version for compatibility.
  2. Install and Configure Self-Hosted Integration Runtime (SHIR)

  3. Download the Required Driver Package

    Navigate to the connector's documentation or driver source to download the appropriate version of the client driver supported for the connector.

  4. Install the Driver

    Install the downloaded driver package on the machine where SHIR is running.

Guidance on upgrading connectors with BYOD approach required

Steps

  1. Review Connector Requirements
    Visit the Data Factory documentation for the specific V2 connector. Under the Pre-requisites section, verify:

    • The supported version of the client driver.
    • The minimum required SHIR version for compatibility.
  2. Install and Configure Self-Hosted Integration Runtime (SHIR)

  3. Download the Required Driver Package

    Navigate to the connector's documentation or driver source to download the appropriate version of the client driver supported for V2 connector.

  4. Install the Driver

    Install the downloaded driver package on the machine where SHIR is running.

  5. Update Linked Services in Data Factory

    • Identify existing linked services that currently use the V1 connector (typically via Azure IR or SHIR).
    • Modify them to:
      • Use the new SHIR instance.

      • Set the connector version to 2.0 from 1.0.

        Screenshot of the linked services page.

  6. Test the Connection

    Validate connectivity to the data source using the updated linked service with version 2.0 connector.

  7. Validate Pipeline Functionality

    Run test executions of your pipelines to confirm they function correctly with the new V2 connector and SHIR setup.