Add connector upgrade advisor doc

Author: Lucky-Wang16

articles/data-factory/TOC.yml

@@ -1404,6 +1404,8 @@ items:
       href: connector-deprecation-plan.md
     - name: Connector upgrade FAQ
       href: connector-deprecation-frequently-asked-questions.md
+    - name: Connector upgrade advisor
+      href: connector-migration-advisor.md
   - name: Whitepapers
     href: whitepapers.md
   - name: FAQ

articles/data-factory/connector-migration-advisor.md

@@ -0,0 +1,85 @@
+---
+title: Connector Migration Advisor in Azure Data Factory and Azure Synapse Analytics 
+description: This article describes connector migration advisor in Azure Data Factory and Azure Synapse Analytics.
+author: jianleishen
+ms.author: jianleishen
+ms.service: azure-data-factory
+ms.subservice: data-movement
+ms.topic: concept-article
+ms.custom: references_regions
+ms.date: 03/31/2025
+---
+
+# Connector Migration Advisor in Azure Data Factory and Azure Synapse Analytics
+
+This article describes connector migration advisor in Azure Data Factory and Azure Synapse Analytics.
+
+To learn more, see [Upgrade plan for Azure Data Factory connectors](connector-deprecation-plan.md).
+
+## Overview
+
+The Connector migration advisor is a comprehensive tool that helps upgrade pipelines that use outdated V1 linked services and datasets to their latest available versions. This advisor tool applies to V1 connectors with updated versions already available.
+
+:::image type="content" source="media/connector-migration-advisor/connector-upgrade-advisor.png" alt-text="Screenshot of the linked services page." lightbox="media/connector-migration-advisor/connector-upgrade-advisor.png":::
+
+## Supported data sources
+
+- Salesforce
+- Salesforce Service Cloud
+- ServiceNow
+- PostgreSQL
+- Google Big Query
+
+## Known limitations
+
+Currently, support for the Snowflake data source is unavailable. It will be added soon.
+
+## How to use
+
+Before using the Connector migration advisor, it is recommended to **save** or **discard all** pending changes.
+
+1. To access the **Connector migration advisor**, navigate to the **Manage** pane in your data factory. Under the **General** section, locate and select **Connector migration advisor**.
+
+    :::image type="content" source="media/connector-migration-advisor/connector-upgrade-advisor.png" alt-text="Screenshot of the connector migration advisor page." lightbox="media/connector-migration-advisor/connector-upgrade-advisor.png":::
+
+2. Once you select the **Connector migration advisor**, it scans your data factory and identifies all existing pipelines using outdated connectors along with the number of dependencies on outdated versions. 
+
+    :::image type="content" source="media/connector-migration-advisor/outdated-connectors.png" alt-text="Screenshot of the outdated-connectors page." lightbox="media/connector-migration-advisor/outdated-connectors.png":::
+
+3. In the **Connector upgrade advisor** home page, choose the pipelines you want to upgrade and click **Upgrade**.
+
+    :::image type="content" source="media/connector-migration-advisor/upgrade.png" alt-text="Screenshot of upgrade." lightbox="media/connector-migration-advisor/upgrade.png":::
+
+4. If a selected pipeline references an outdated dataset shared with other unselected pipelines, a **Select upgrade methods** dialog appears listing all the pipelines sharing datasets.
+
+    :::image type="content" source="media/connector-migration-advisor/select-upgrade-methods.png" alt-text="Screenshot of the select-upgrade-methods page." lightbox="media/connector-migration-advisor/select-upgrade-methods.png":::
+
+    If you want to upgrade all pipelines using the same dataset simultaneously, choose **Include listed pipelines to upgrade together**. Otherwise, if you just want to upgrade the selected pipeline separately, select **Create new datasets for selected pipelines**. Click **OK** to confirm your selection.
+
+    :::image type="content" source="media/connector-migration-advisor/enable-options.png" alt-text="Screenshot of two options." lightbox="media/connector-migration-advisor/enable-options.png":::
+
+5. The next window **Map outdated linked services to new linked services** list all outdated linked services. Select an equivalent V2 linked service from the dropdown menu or create a new one that supports the V2 format by clicking **New**. Once configured, click **Next**.
+
+    :::image type="content" source="media/connector-migration-advisor/new-linked-services.png" alt-text="Screenshot of the linked services page." lightbox="media/connector-migration-advisor/new-linked-services.png":::
+
+6. The **Update pipeline queries** page (if applicable) appears only if your selected pipelines use **Salesforce**, **Salesforce Service Cloud**, or **ServiceNow** connectors in the **Copy** activity with a query.
+
+Due to query format differences between V1 and V2: 
+
+- Salesforce queries are pre-populated as V1 (SQL) and V2 (SOQL) share common syntax. 
+
+- ServiceNow queries require manual adjustments, as the structure has changed. 
+
+Once modifications are complete, click **Next**.
+
+    :::image type="content" source="media/connector-migration-advisor/update-pipeline-queries.png" alt-text="Screenshot of the update pipeline queries page." lightbox="media/connector-migration-advisor/update-pipeline-queries.png":::
+
+7. Review and finalize changes using the **Review** page. It provides a summary of all modifications made by the advisor tool. Click **Open and review** to exit the wizard and navigate to the authoring page.
+
+    :::image type="content" source="media/connector-migration-advisor/review-page.png" alt-text="Screenshot of the review page." lightbox="media/connector-migration-advisor/review-page.png":::
+
+Review all modified connectors, then **Save all** or **Publish** all the changes as needed.
+
+    :::image type="content" source="media/connector-migration-advisor/linked-services-page.png" alt-text="Screenshot of the linked services page." lightbox="media/connector-migration-advisor/linked-services-page.png":::
+
+This process ensures a smooth transition from outdated connectors to the latest supported versions.