Merge pull request #219683 from fbsolo-ms1/updates-for-YP

Update files as requested by Yogi P . . .

Author: ShannonLeavitt

articles/machine-learning/.openpublishing.redirection.machine-learning.json

@@ -1,5 +1,10 @@
 {
-    "redirections": [ 
+    "redirections": [
+    {
+        "source_path_from_root": "/articles/machine-learning/how-to-link-synapse-ml-workspaces.md",
+        "redirect_url": "/azure/machine-learning/v1/how-to-link-synapse-ml-workspaces",
+        "redirect_document_id": true
+    },
     {
         "source_path_from_root": "/articles/machine-learning/how-to-use-environments.md",
         "redirect_url": "/azure/machine-learning/how-to-manage-environments-v2",

articles/machine-learning/concept-compute-target.md

@@ -159,7 +159,7 @@ Azure Machine Learning supports the following unmanaged compute types:
 * Azure HDInsight
 * Azure Databricks
 * Azure Data Lake Analytics
-* [Azure Synapse Spark pool](how-to-link-synapse-ml-workspaces.md) (preview)
+* [Azure Synapse Spark pool](v1/how-to-link-synapse-ml-workspaces.md) (preview)
 
     > [!TIP]
     > Currently this requires the Azure Machine Learning SDK v1.

articles/machine-learning/how-to-private-endpoint-integration-synapse.md

@@ -18,7 +18,7 @@ ms.date: 11/16/2022
 In this article, learn how to securely integrate with Azure Machine Learning from Azure Synapse. This integration enables you to use Azure Machine Learning from notebooks in your Azure Synapse workspace. Communication between the two workspaces is secured using an Azure Virtual Network.
 
 > [!TIP]
-> You can also perform integration in the opposite direction, using Azure Synapse spark pool from Azure Machine Learning. For more information, see [Link Azure Synapse and Azure Machine Learning](how-to-link-synapse-ml-workspaces.md).
+> You can also perform integration in the opposite direction, using Azure Synapse spark pool from Azure Machine Learning. For more information, see [Link Azure Synapse and Azure Machine Learning](v1/how-to-link-synapse-ml-workspaces.md).
 
 ## Prerequisites
 
@@ -141,4 +141,4 @@ To verify that the integration between Azure Synapse and Azure Machine Learning
 ## Next steps
 
 * [Quickstart: Create a new Azure Machine Learning linked service in Synapse](../synapse-analytics/machine-learning/quickstart-integrate-azure-machine-learning.md).
-* [Link Azure Synapse Analytics and Azure Machine Learning workspaces](how-to-link-synapse-ml-workspaces.md).
+* [Link Azure Synapse Analytics and Azure Machine Learning workspaces](v1/how-to-link-synapse-ml-workspaces.md).

articles/machine-learning/v1/how-to-attach-compute-targets.md

@@ -130,7 +130,7 @@ Azure Machine Learning also supports attaching an Azure Virtual Machine. The VM
 
 ## <a id="synapse"></a>Apache Spark pools
 
-The Azure Synapse Analytics integration with Azure Machine Learning (preview) allows you to attach an Apache Spark pool backed by Azure Synapse for interactive data exploration and preparation. With this integration, you can have a dedicated compute for data wrangling at scale. For more information, see [How to attach Apache Spark pools powered by Azure Synapse Analytics](../how-to-link-synapse-ml-workspaces.md#attach-synapse-spark-pool-as-a-compute).
+The Azure Synapse Analytics integration with Azure Machine Learning (preview) allows you to attach an Apache Spark pool backed by Azure Synapse for interactive data exploration and preparation. With this integration, you can have a dedicated compute for data wrangling at scale. For more information, see [How to attach Apache Spark pools powered by Azure Synapse Analytics](how-to-link-synapse-ml-workspaces.md#attach-synapse-spark-pool-as-a-compute).
 
 ## Azure HDInsight 
 

articles/machine-learning/v1/how-to-data-prep-synapse-spark-pool.md

@@ -1,5 +1,5 @@
 ---
-title: Data wrangling with Apache Spark pools (preview)
+title: Data wrangling with Apache Spark pools (deprecated)
 titleSuffix: Azure Machine Learning
 description: Learn how to attach and launch Apache Spark pools for data wrangling with Azure Synapse Analytics and Azure Machine Learning.
 services: machine-learning
@@ -9,25 +9,24 @@ ms.topic: how-to
 author: ynpandey
 ms.author: franksolomon
 ms.reviewer: franksolomon
-ms.date: 08/17/2022
+ms.date: 11/28/2022
 ms.custom: devx-track-python, data4ml, synapse-azureml, contperf-fy21q4, sdkv1, event-tier1-build-2022
 #Customer intent: As a data scientist, I want to prepare my data at scale, and to train my machine learning models from a single notebook using Azure Machine Learning.
 ---
 
-# Data wrangling with Apache Spark pools (preview) 
+# Data wrangling with Apache Spark pools (deprecated) 
 
 [!INCLUDE [sdk v1](../../../includes/machine-learning-sdk-v1.md)]
 
+> [!WARNING]
+> The Azure Synapse Analytics integration with Azure Machine Learning available in Python SDK v1 is deprecated. Users can continue using Synapse workspace registered with Azure Machine Learning as a linked service. However, a new Synapse workspace can no longer be registered with Azure Machine Learning as a linked service. We recommend using Managed (Automatic) Synapse compute and attached Synapse Spark pools available in CLI v2 and Python SDK v2. Please see [https://aka.ms/aml-spark](https://aka.ms/aml-spark) for more details.
 
 In this article, you learn how to perform data wrangling tasks interactively within a dedicated Synapse session, powered by [Azure Synapse Analytics](../../synapse-analytics/overview-what-is.md), in a Jupyter notebook using the [Azure Machine Learning Python SDK](/python/api/overview/azure/ml/). 
 
 If you prefer to use Azure Machine Learning pipelines, see [How to use Apache Spark (powered by Azure Synapse Analytics) in your machine learning pipeline (preview)](how-to-use-synapsesparkstep.md).
 
 For guidance on how to use Azure Synapse Analytics with a Synapse workspace, see the [Azure Synapse Analytics get started series](../../synapse-analytics/get-started.md).
 
->[!IMPORTANT]
-> The Azure Machine Learning and Azure Synapse Analytics integration is in preview. The capabilities presented in this article employ the `azureml-synapse` package which contains [experimental](/python/api/overview/azure/ml/#stable-vs-experimental) preview features that may change at any time.
-
 ## Azure Machine Learning and Azure Synapse Analytics integration
 
 The Azure Synapse Analytics integration with Azure Machine Learning (preview) allows you to attach an Apache Spark pool backed by Azure Synapse for interactive data exploration and preparation. With this integration, you can have a dedicated compute for data wrangling at scale, all within the same Python notebook you use for training your machine learning models.
@@ -50,9 +49,9 @@ The Azure Synapse Analytics integration with Azure Machine Learning (preview) al
   pip install azureml-synapse
   ```
 
-* Link your Azure Machine Learning workspace and Azure Synapse Analytics workspace with the [Azure Machine Learning Python SDK](../how-to-link-synapse-ml-workspaces.md#link-sdk) or via the [Azure Machine Learning studio](../how-to-link-synapse-ml-workspaces.md#link-studio)
+* Link your Azure Machine Learning workspace and Azure Synapse Analytics workspace with the [Azure Machine Learning Python SDK](how-to-link-synapse-ml-workspaces.md#link-sdk) or via the [Azure Machine Learning studio](how-to-link-synapse-ml-workspaces.md#link-studio)
 
-* [Attach a Synapse Spark pool](../how-to-link-synapse-ml-workspaces.md#attach-synapse-spark-pool-as-a-compute) as a compute target.
+* [Attach a Synapse Spark pool](how-to-link-synapse-ml-workspaces.md#attach-synapse-spark-pool-as-a-compute) as a compute target.
 
 ## Launch Synapse Spark pool for data wrangling tasks
 
@@ -251,7 +250,7 @@ input1 = train_ds.as_mount()
 
 ## Use a `ScriptRunConfig` to submit an experiment run to a Synapse Spark pool
 
-If you're ready to automate and productionize your data wrangling tasks, you can submit an experiment run to [an attached Synapse Spark pool](../how-to-link-synapse-ml-workspaces.md#attach-a-pool-with-the-python-sdk) with the [ScriptRunConfig](/python/api/azureml-core/azureml.core.scriptrunconfig) object.  
+If you're ready to automate and productionize your data wrangling tasks, you can submit an experiment run to [an attached Synapse Spark pool](how-to-link-synapse-ml-workspaces.md#attach-a-pool-with-the-python-sdk) with the [ScriptRunConfig](/python/api/azureml-core/azureml.core.scriptrunconfig) object.  
 
 Similarly, if you have an Azure Machine Learning pipeline, you can use the [SynapseSparkStep to specify your Synapse Spark pool as the compute target](how-to-use-synapsesparkstep.md) for the data preparation step in your pipeline.
 

articles/machine-learning/how-to-link-synapse-ml-workspaces.md renamed to articles/machine-learning/v1/how-to-link-synapse-ml-workspaces.md

@@ -1,5 +1,5 @@
 ---
-title: Create a linked service with Synapse and Azure Machine Learning workspaces (preview)
+title: Create a linked service with Synapse and Azure Machine Learning workspaces (deprecated)
 titleSuffix: Azure Machine Learning
 description: Learn how to link Azure Synapse and Azure Machine Learning workspaces, and attach Apache Spark pools for a unified data wrangling experience. 
 services: machine-learning
@@ -8,34 +8,34 @@ ms.subservice: mldata
 ms.topic: how-to
 ms.author: jhirono
 author: jhirono
-ms.reviewer: larryfr
+ms.reviewer: franksolomon
 ms.date: 11/04/2022
 ms.custom: devx-track-python, data4ml, synapse-azureml, contperf-fy21q4, sdkv1, event-tier1-build-2022
 #Customer intent: As a workspace administrator, I want to link Azure Synapse workspaces and Azure Machine Learning workspaces and attach Apache Spark pools for a unified data wrangling experience.
 ---
 
-# Link Azure Synapse Analytics and Azure Machine Learning workspaces and attach Apache Spark pools(preview)
+# Link Azure Synapse Analytics and Azure Machine Learning workspaces and attach Apache Spark pools(deprecated)
 
-[!INCLUDE [sdk v1](../../includes/machine-learning-sdk-v1.md)]
+[!INCLUDE [sdk v1](../../../includes/machine-learning-sdk-v1.md)]
 
-In this article, you learn how to create a linked service that links your [Azure Synapse Analytics](../synapse-analytics/overview-what-is.md) workspace and [Azure Machine Learning workspace](concept-workspace.md). 
+> [!WARNING]
+> The Azure Synapse Analytics integration with Azure Machine Learning available in Python SDK v1 is deprecated. Users can continue using Synapse workspace registered with Azure Machine Learning as a linked service. However, a new Synapse workspace can no longer be registered with Azure Machine Learning as a linked service. We recommend using Managed (Automatic) Synapse compute and attached Synapse Spark pools available in CLI v2 and Python SDK v2. Please see [https://aka.ms/aml-spark](https://aka.ms/aml-spark) for more details.
+
+In this article, you learn how to create a linked service that links your [Azure Synapse Analytics](../../synapse-analytics/overview-what-is.md) workspace and [Azure Machine Learning workspace](../concept-workspace.md). 
 
 With your Azure Machine Learning workspace linked with your Azure Synapse workspace, you can attach an Apache Spark pool, powered by Azure Synapse Analytics, as a dedicated compute for data wrangling at scale or conduct model training all from the same Python notebook.
 
 You can link your ML workspace and Synapse workspace via the [Python SDK](#link-sdk) or the [Azure Machine Learning studio](#link-studio).
 
 You can also link workspaces and attach a Synapse Spark pool with a single [Azure Resource Manager (ARM) template](https://github.com/Azure/azure-quickstart-templates/blob/master/quickstarts/microsoft.machinelearningservices/machine-learning-linkedservice-create/azuredeploy.json).
 
->[!IMPORTANT]
-> The Azure Machine Learning and Azure Synapse integration is in public preview. The functionalities presented from the `azureml-synapse` package are [experimental](/python/api/overview/azure/ml/#stable-vs-experimental) preview features, and may change at any time.
-
 ## Prerequisites
 
-* [Create an Azure Machine Learning workspace](quickstart-create-resources.md).
+* [Create an Azure Machine Learning workspace](../quickstart-create-resources.md).
 
-* [Create a Synapse workspace in Azure portal](../synapse-analytics/quickstart-create-workspace.md).
+* [Create a Synapse workspace in Azure portal](../../synapse-analytics/quickstart-create-workspace.md).
 
-* [Create Apache Spark pool using Azure portal, web tools, or Synapse Studio](../synapse-analytics/quickstart-create-apache-spark-pool-studio.md)
+* [Create Apache Spark pool using Azure portal, web tools, or Synapse Studio](../../synapse-analytics/quickstart-create-apache-spark-pool-studio.md)
 
 * Install the [Azure Machine Learning Python SDK](/python/api/overview/azure/ml/intro)
 
@@ -74,7 +74,7 @@ linked_service = LinkedService.register(workspace = ws,
 ```
 
 > [!IMPORTANT] 
-> A managed identity, `system_assigned_identity_principal_id`, is created for each linked service. This managed identity must be granted the **Synapse Apache Spark Administrator** role of the Synapse workspace before you start your Synapse session. [Assign the Synapse Apache Spark Administrator role to the managed identity in the Synapse Studio](../synapse-analytics/security/how-to-manage-synapse-rbac-role-assignments.md).
+> A managed identity, `system_assigned_identity_principal_id`, is created for each linked service. This managed identity must be granted the **Synapse Apache Spark Administrator** role of the Synapse workspace before you start your Synapse session. [Assign the Synapse Apache Spark Administrator role to the managed identity in the Synapse Studio](../../synapse-analytics/security/how-to-manage-synapse-rbac-role-assignments.md).
 >
 > To find the `system_assigned_identity_principal_id` of a specific linked service, use `LinkedService.get('<your-mlworkspace-name>', '<linked-service-name>')`.
 
@@ -145,7 +145,7 @@ Follow these steps:
 1. Select **Attach**. 
 1. Select your Apache Spark pool from the list and provide a name.  
     1. This list identifies the available Synapse Spark pools that can be attached to your compute. 
-    1. To create a new Synapse Spark pool, see [Create Apache Spark pool with the Synapse Studio](../synapse-analytics/quickstart-create-apache-spark-pool-portal.md)
+    1. To create a new Synapse Spark pool, see [Create Apache Spark pool with the Synapse Studio](../../synapse-analytics/quickstart-create-apache-spark-pool-portal.md)
 1. Select **Attach selected**. 
 
 ### Attach a pool with the Python SDK
@@ -188,7 +188,7 @@ ws.compute_targets['Synapse Spark pool alias']
 
 ## Next steps
 
-* [How to data wrangle with Azure Synapse (preview)](v1/how-to-data-prep-synapse-spark-pool.md).
-* [How to use Apache Spark in your machine learning pipeline with Azure Synapse (preview)](v1/how-to-use-synapsesparkstep.md)
-* [Train a model](v1/how-to-set-up-training-targets.md).
-* [How to securely integrate Azure Synapse and Azure Machine Learning workspaces](how-to-private-endpoint-integration-synapse.md).
+* [How to data wrangle with Azure Synapse (preview)](how-to-data-prep-synapse-spark-pool.md).
+* [How to use Apache Spark in your machine learning pipeline with Azure Synapse (preview)](how-to-use-synapsesparkstep.md)
+* [Train a model](how-to-set-up-training-targets.md).
+* [How to securely integrate Azure Synapse and Azure Machine Learning workspaces](../how-to-private-endpoint-integration-synapse.md).

articles/machine-learning/v1/how-to-use-synapsesparkstep.md

@@ -1,30 +1,29 @@
 ---
-title: Use Apache Spark in a machine learning pipeline (preview)
+title: Use Apache Spark in a machine learning pipeline (deprecated)
 titleSuffix: Azure Machine Learning
 description: Link your Azure Synapse Analytics workspace to your Azure machine learning pipeline to use Apache Spark for data manipulation.
 services: machine-learning
 ms.service: machine-learning
 ms.subservice: mldata
 ms.author: zhanxia
 author: xiaoharper
-ms.date: 11/04/2022
+ms.reviewer: franksolomon
+ms.date: 11/28/2022
 ms.topic: how-to
 ms.custom: synapse-azureml, sdkv1, event-tier1-build-2022
 #Customer intent: As a user of both Azure Machine Learning pipelines and Azure Synapse Analytics, I'd like to use Apache Spark for the data preparation of my pipeline
 ---
 
-# How to use Apache Spark (powered by Azure Synapse Analytics) in your machine learning pipeline (preview)
+# How to use Apache Spark (powered by Azure Synapse Analytics) in your machine learning pipeline (deprecated)
 
 
 [!INCLUDE [sdk v1](../../../includes/machine-learning-sdk-v1.md)]
 
-
-[!INCLUDE [preview disclaimer](../../../includes/machine-learning-preview-generic-disclaimer.md)]
+> [!WARNING]
+> The Azure Synapse Analytics integration with Azure Machine Learning available in Python SDK v1 is deprecated. Users can continue using Synapse workspace registered with Azure Machine Learning as a linked service. However, a new Synapse workspace can no longer be registered with Azure Machine Learning as a linked service. We recommend using Managed (Automatic) Synapse compute and attached Synapse Spark pools available in CLI v2 and Python SDK v2. Please see [https://aka.ms/aml-spark](https://aka.ms/aml-spark) for more details.
 
 In this article, you'll learn how to use Apache Spark pools powered by Azure Synapse Analytics as the compute target for a data preparation step in an Azure Machine Learning pipeline. You'll learn how a single pipeline can use compute resources suited for the specific step, such as data preparation or training. You'll see how data is prepared for the Spark step and how it's passed to the next step. 
 
-
-
 ## Prerequisites
 
 * Create an [Azure Machine Learning workspace](../quickstart-create-resources.md) to hold all your pipeline resources.
@@ -35,10 +34,10 @@ In this article, you'll learn how to use Apache Spark pools powered by Azure Syn
 
 ## Link your Azure Machine Learning workspace and Azure Synapse Analytics workspace 
 
-You create and administer your Apache Spark pools in an Azure Synapse Analytics workspace. To integrate an Apache Spark pool with an Azure Machine Learning workspace, you must [link to the Azure Synapse Analytics workspace](../how-to-link-synapse-ml-workspaces.md). 
+You create and administer your Apache Spark pools in an Azure Synapse Analytics workspace. To integrate an Apache Spark pool with an Azure Machine Learning workspace, you must [link to the Azure Synapse Analytics workspace](how-to-link-synapse-ml-workspaces.md). 
 
 Once your Azure Machine Learning workspace and your Azure Synapse Analytics workspaces are linked, you can attach an Apache Spark pool via 
-* [Azure Machine Learning studio](../how-to-link-synapse-ml-workspaces.md#attach-a-pool-via-the-studio)
+* [Azure Machine Learning studio](how-to-link-synapse-ml-workspaces.md#attach-a-pool-via-the-studio)
 * Python SDK ([as elaborated below](#attach-your-apache-spark-pool-as-a-compute-target-for-azure-machine-learning))
 * Azure Resource Manager (ARM) template (see this [Example ARM template](https://github.com/Azure/azure-quickstart-templates/blob/master/quickstarts/microsoft.machinelearningservices/machine-learning-linkedservice-create/azuredeploy.json)). 
     * You can use the command line to follow the ARM template, add the linked service, and attach the Apache Spark pool with the following code:

articles/machine-learning/v1/toc.yml

@@ -125,7 +125,7 @@
       displayName: AKS, inference
       href: how-to-create-attach-kubernetes.md
     - name: Link to Azure Synapse Analytics workspace
-      href: ../how-to-link-synapse-ml-workspaces.md
+      href: ../v1/how-to-link-synapse-ml-workspaces.md
   - name: Security
     items:
     - name: Use managed identities for access control

articles/sentinel/notebooks-with-synapse-export-data.md

@@ -126,5 +126,5 @@ For more information, see:
 - [Blog post: Export Historical Log Data from Microsoft Sentinel](https://techcommunity.microsoft.com/t5/microsoft-sentinel-blog/export-historical-log-data-from-microsoft-sentinel/ba-p/3413418)
 - [Use Jupyter notebooks to hunt for security threats](notebooks.md)
 - [Tutorial: Get started with Jupyter notebooks and MSTICPy in Microsoft Sentinel](notebook-get-started.md)
-- [Link Azure Synapse Analytics and Azure Machine Learning workspaces and attach Apache Spark pools(preview)](../machine-learning/how-to-link-synapse-ml-workspaces.md)
+- [Link Azure Synapse Analytics and Azure Machine Learning workspaces and attach Apache Spark pools(preview)](../machine-learning/v1/how-to-link-synapse-ml-workspaces.md)
 - [Create your first Microsoft Sentinel notebook](https://techcommunity.microsoft.com/t5/microsoft-sentinel-blog/creating-your-first-microsoft-sentinel-notebook/ba-p/2977745) (Blog series)