Skip to content

Commit 4f2199d

Browse files
Clare Zheng (Shanghai Wicresoft Co Ltd)Clare Zheng (Shanghai Wicresoft Co Ltd)
authored andcommitted
Add BYOD doc
1 parent ac559dd commit 4f2199d

File tree

3 files changed

+71
-1
lines changed

3 files changed

+71
-1
lines changed

articles/data-factory/TOC.yml

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -376,7 +376,9 @@ items:
376376
- name: Connector release stages and timelines
377377
href: connector-release-stages-and-timelines.md
378378
- name: Connector upgrade FAQ
379-
href: connector-deprecation-frequently-asked-questions.md
379+
href: connector-deprecation-frequently-asked-questions.md
380+
- name: Guidance for BYOD approach
381+
href: guidance-for-byod-approach.md
380382
- name: Amazon Marketplace Web Service (Deprecated)
381383
href: connector-amazon-marketplace-web-service.md
382384
- name: Amazon RDS for Oracle
Lines changed: 68 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,68 @@
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)
4.27 KB
Loading

0 commit comments

Comments
 (0)