|
| 1 | +--- |
| 2 | +title: Guidance on using the Bring Your Own Driver (BYOD) approach |
| 3 | +description: This article provides step-by-step guidance for migrating from outdated V1 connectors to the latest V2 connectors in scenarios where the Bring Your Own Driver (BYOD) approach is required. |
| 4 | +author: KrishnakumarRukmangathan |
| 5 | +ms.author: krirukm |
| 6 | +ms.service: azure-data-factory |
| 7 | +ms.subservice: data-movement |
| 8 | +ms.topic: concept-article |
| 9 | +ms.custom: references_regions |
| 10 | +ms.date: 05/29/2025 |
| 11 | +--- |
| 12 | + |
| 13 | +# Guidance on using the Bring Your Own Driver (BYOD) approach |
| 14 | + |
| 15 | +[!INCLUDE[appliesto-adf-asa-md](includes/appliesto-adf-asa-md.md)] |
| 16 | + |
| 17 | +This article provides step-by-step guidance for migrating from outdated V1 connectors to the latest V2 connectors in scenarios where the **Bring Your Own Driver (BYOD)** approach is required. |
| 18 | + |
| 19 | +## Supported connectors |
| 20 | + |
| 21 | +- Vertica |
| 22 | +- Netezza |
| 23 | + |
| 24 | +## Migration steps |
| 25 | + |
| 26 | +1. **Review Connector Requirements** |
| 27 | + Visit the Data Factory documentation for the specific V2 connector. Under the **Pre-requisites** section, verify: |
| 28 | + |
| 29 | + - The supported version of the **client driver**. |
| 30 | + - The minimum required **SHIR version** for compatibility. |
| 31 | + |
| 32 | +1. **Install and Configure Self-Hosted Integration Runtime (SHIR)** |
| 33 | + |
| 34 | + - Set up SHIR on a physical machine or virtual machine within your network. |
| 35 | + - Follow the official [Microsoft SHIR installation guide](create-self-hosted-integration-runtime.md) to complete setup. |
| 36 | + |
| 37 | +1. **Download the Required Driver Package** |
| 38 | + |
| 39 | + Navigate to the connector's documentation or driver source to download the appropriate version of the client driver supported for V2 connector. |
| 40 | + |
| 41 | +1. **Install the Driver** |
| 42 | + |
| 43 | + Install the downloaded driver package on the machine where SHIR is running. |
| 44 | + |
| 45 | +1. **Update Linked Services in Data Factory** |
| 46 | + |
| 47 | + - Identify existing linked services that currently use the V1 connector (typically via Azure IR or SHIR). |
| 48 | + - Modify them to: |
| 49 | + - Use the new SHIR instance. |
| 50 | + - Set the connector version to **2.0** from 1.0. |
| 51 | + |
| 52 | + :::image type="content" source="media/connector-lifecycle/select-version.png" alt-text="Screenshot of the linked services page." lightbox="media/connector-lifecycle/select-version.png"::: |
| 53 | + |
| 54 | +1. **Test the Connection** |
| 55 | + |
| 56 | + Validate connectivity to the data source using the updated linked service with version 2.0 connector. |
| 57 | + |
| 58 | +1. **Validate Pipeline Functionality** |
| 59 | + |
| 60 | + Run test executions of your pipelines to confirm they function correctly with the new V2 connector and SHIR setup. |
| 61 | + |
| 62 | +## Related content |
| 63 | + |
| 64 | +- [Connector lifecycle overview](connector-lifecycle-overview.md) |
| 65 | +- [Connector upgrade guidance](connector-upgrade-guidance.md) |
| 66 | +- [Connector upgrade advisor](connector-upgrade-advisor.md) |
| 67 | +- [Connector release stages and timelines](connector-release-stages-and-timelines.md) |
| 68 | +- [Connector upgrade FAQ](connector-deprecation-frequently-asked-questions.md) |
0 commit comments