Skip to content

Commit f4ad567

Browse files
authored
Merge pull request #288692 from Clare-Zheng82/1017-Add_connector_deprecation_FAQ
[Doc update] Add connector deprecation FAQ doc
2 parents cd37019 + df6b467 commit f4ad567

File tree

4 files changed

+81
-0
lines changed

4 files changed

+81
-0
lines changed

articles/data-factory/TOC.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1400,6 +1400,8 @@ items:
14001400
items:
14011401
- name: Connector upgrade and deprecations
14021402
href: connector-deprecation-plan.md
1403+
- name: Connector deprecation FAQ
1404+
href: connector-deprecation-frequently-asked-questions.md
14031405
- name: Whitepapers
14041406
href: whitepapers.md
14051407
- name: FAQ
Lines changed: 79 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,79 @@
1+
---
2+
title: Connector deprecation FAQ
3+
description: Get answers to frequently asked questions about connector deprecation.
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.date: 10/17/2024
10+
---
11+
12+
# Connector deprecation FAQ
13+
14+
This article provides answers to frequently asked questions about connector deprecation.
15+
16+
## Why does Azure Data Factory (ADF) release new connectors and ask users to upgrade their existing connectors?
17+
18+
At Azure Data Factory (ADF), we are committed to continually enhancing our platform by improving performance, security and overall user experience. Upgrading connectors is a key part of our efforts to deliver the latest innovations and ensure your data workflows run smoothly. These upgrades offer several important benefits:
19+
20+
- Improved data ingestion performance for faster processing
21+
- Seamless native integration with your data sources
22+
- Better supportability, ensuring quicker response times and bug fixes.
23+
- Enhanced security through a more robust application model
24+
25+
## Which users should be concerned about this?
26+
27+
If your data factory includes any of the connectors listed in the [parent article](connector-deprecation-plan.md) announcing the **End of Support**, you should plan to migrate to the newer version of the connector or explore alternative solutions before the deprecation/disabled date.
28+
29+
Alternatively, you can check if you have any impacted objects in your data factory by navigating to **Manage → Linked Services** page. If you have any legacy connectors, an alert icon will be displayed beside those linked services.
30+
31+
:::image type="content" source="media/connector-deprecation-frequently-asked-questions/linked-services-page.png" alt-text="Screenshot of the linked services page." lightbox="media/connector-deprecation-frequently-asked-questions/linked-services-page.png":::
32+
33+
## Where can I see the upgrade notification?
34+
35+
The upgrade notifications were shared across multiple channels,
36+
37+
- Public documentation – Refer [Planned connector deprecations for Azure Data Factory](connector-deprecation-plan.md).
38+
- Azure Data Factory Portal – The upgrade warning was displayed as a global banner and on the related linked service page.
39+
40+
:::image type="content" source="media/connector-deprecation-frequently-asked-questions/upgrade-warning.png" alt-text="Screenshot of the upgrade warning." lightbox="media/connector-deprecation-frequently-asked-questions/upgrade-warning.png":::
41+
42+
- Azure Notification – Notification emails were sent on regular cadence to the impacted subscriptions, detailing the required actions and corresponding timeline.
43+
44+
- Azure Service Health – Your subscription owners will see the upgrade notifications under Azure Service Health → Advisories for all impacted subscriptions.
45+
46+
## What actions should I take? What is the recommended upgrade path?
47+
48+
Your upgrade path may vary depending on the connector:
49+
50+
1. **Review the differences** – Upgrading your connector may or may not be straightforward. We recommend first reviewing our connector [documentation](connector-deprecation-plan.md#overview), which highlights the differences between the legacy and new versions and offers detailed upgrade guidance.
51+
2. **Migrate to the new connector** – For legacy connectors with updated versions, we strongly recommend migrating to the new connector.
52+
3. **If you're blocked from upgrading** – If you're unable to upgrade to the new connector, determine whether it's due to a feature gap or an error/bug with the new connector. Then follow the instructions outlined under [question 6](#what-should-i-do-if-i-encounter-the-feature-gaps-and-errors-bugs-that-are-preventing-me-from-migrating-to-the-new-connectors) to contact us.
53+
54+
## What will happen after the migration deadline?
55+
56+
There are three key deadlines outlined in our documentation:
57+
1. **End of Support Announcement**: This period serves as a recommended upgrade window. You are encouraged to upgrade your legacy connectors to the new ones during this time and engage with the Microsoft team if you encounter any blockers.
58+
- New linked services cannot use legacy connectors, but existing linked services with legacy connectors will continue to work.
59+
60+
1. **End of Support (EOS)**: At this point, the connector is officially deprecated and no longer supported. Your data factories using legacy connectors will continue to operate, we will not intentionally fail any pipelines. However, the deprecation takes effect with the following:
61+
- No bug fixes will be provided.
62+
- No new features will be added.
63+
- Microsoft reserves the right to disable the connector if a critical security vulnerability (CVE) is identified.
64+
65+
1. **Disabled Date**: After this date, pipelines using legacy connectors will be disabled, meaning all pipelines relying on legacy connectors will start to fail as we stop all traffic on legacy drivers.
66+
- New features and bug fixes will only be available on the new connectors.
67+
68+
## What should I do if I encounter the feature gaps and errors/ bugs that are preventing me from migrating to the new connectors?
69+
70+
If you encounter any feature gaps while migrating from legacy connectors, please review our connector documentation to check if it’s a known limitation. Additionally, send us an email at **[email protected]** with a description of the feature gap.
71+
72+
If you encounter any errors or bugs while migrating from legacy connectors, please contact our Microsoft support team and open a support ticket. Be sure to include detailed information about the connector, the error encountered, and your use case.
73+
74+
Our Azure Data Factory team will assist you and ensure a smooth transition to the new connectors.
75+
76+
## Related content
77+
78+
- [Planned connector deprecations for Azure Data Factory](connector-deprecation-plan.md)
79+
168 KB
Loading
163 KB
Loading

0 commit comments

Comments
 (0)