Merge pull request #224815 from v-lanjunli/linkedservice

add linked service for azure synapse analytics artifacts linked

Author: JamesJBarnett

articles/data-factory/TOC.yml

@@ -442,6 +442,9 @@ items:
     - name: Azure Synapse Analytics
       href: connector-azure-sql-data-warehouse.md
       displayName: polybase
+    - name: Azure Synapse Analytics (Artifacts)
+      href: connector-azure-synapse-analytics-artifacts.md
+      displayName: polybase
     - name: Azure Table Storage
       href: connector-azure-table-storage.md
       displayName: timeout

articles/data-factory/compute-linked-services.md

@@ -371,7 +371,7 @@ See following articles if you are new to Azure Batch service:
 
 [!INCLUDE[ML Studio (classic) retirement](../../includes/machine-learning-studio-classic-deprecation.md)] 
 
-You create an Machine Learning Studio (classic) linked service to register a Machine Learning Studio (classic) batch scoring endpoint to a data factory or Synapse workspace.
+You create a Machine Learning Studio (classic) linked service to register a Machine Learning Studio (classic) batch scoring endpoint to a data factory or Synapse workspace.
 
 ### Example
 
@@ -574,6 +574,10 @@ You create an Azure Synapse Analytics linked service and use it with the [Stored
 
 You create a SQL Server linked service and use it with the [Stored Procedure Activity](transform-data-using-stored-procedure.md) to invoke a stored procedure from a pipeline. See [SQL Server connector](connector-sql-server.md#linked-service-properties) article for details about this linked service.
 
+## Azure Synapse Analytics (Artifacts) linked service
+
+You create an Azure Synapse Analytics (Artifacts) linked service and use it with the [Synapse Notebook Activity](transform-data-synapse-notebook.md) and [Synapse Spark job definition Activity](transform-data-synapse-spark-job-definition.md) to invoke a stored procedure from a pipeline. See [Azure Synapse Analytics (Artifacts) Connector](connector-azure-synapse-analytics-artifacts.md) article for details about this linked service.
+
 ## Azure Function linked service
 
 You create an Azure Function linked service and use it with the [Azure Function activity](control-flow-azure-function-activity.md) to run Azure Functions in a pipeline. The return type of the Azure function has to be a valid `JObject`. (Keep in mind that [JArray](https://www.newtonsoft.com/json/help/html/T_Newtonsoft_Json_Linq_JArray.htm) is *not* a `JObject`.) Any return type other than `JObject` fails and raises the user error *Response Content is not a valid JObject*.

articles/data-factory/connector-azure-synapse-analytics-artifacts.md

@@ -0,0 +1,86 @@
+---
+title:  Copy and transform data in Azure Synapse Analytics (Artifacts) by using Azure Data Factory
+titleSuffix: Azure Data Factory & Azure Synapse
+description: Learn how to Linked service "Azure Synapse Analytics (Artifacts)".
+ms.service: data-factory
+ms.subservice: tutorials
+ms.custom: synapse
+author: nabhishek
+ms.author: jejiang
+ms.topic: conceptual
+ms.date: 10/13/2022
+---
+
+# Copy and transform data in Azure Synapse Analytics (Artifacts) by using Azure Data Factory
+
+This article outlines how to use Copy Activity in Azure Data Factory pipelines to copy data to and from Azure Synapse Analytics (Artifacts). 
+
+## Supported capabilities
+
+This Azure Synapse Analytics (Artifacts) connector is supported for the following capabilities:
+
+| Supported capabilities|IR | Managed private endpoint|
+|---------| --------| --------|
+|[Copy activity](copy-activity-overview.md) (source/sink)|① ②|✓ |
+|[Mapping data flow](concepts-data-flow-overview.md) (source/sink)|① |✓ |
+|[Lookup activity](control-flow-lookup-activity.md)|① ②|✓ |
+|[GetMetadata activity](control-flow-get-metadata-activity.md)|① ②|✓ |
+|[Script activity](transform-data-using-script.md)|① ②|✓ |
+|[Stored procedure activity](transform-data-using-stored-procedure.md)|① ②|✓ |
+
+<small>*&#9312; Azure integration runtime &#9313; Self-hosted integration runtime*</small>
+
+## Create an Azure Synapse Analytics (Artifacts) linked service using UI
+
+Use the following steps to create an Azure Synapse Analytics (Artifacts) linked service in the Azure Data Factory portal UI.
+
+1. Browse to the **Manage** tab in your Azure Data Factory and select **Linked Services**, then click **New**:
+
+    > [!div class="mx-imgBorder"]
+    > ![Screenshot of creating a new linked service with Azure Data Factory UI.](./media/connector-azure-synapse-analytics-artifacts/new-linked-service.png)
+
+2. Search for *Synapse* under the Compute tab, and select the **Azure Synapse Analytics (Artifacts)** connector.
+
+    > [!div class="mx-imgBorder"]
+    > ![Screenshot of the Azure Synapse Analytics Artifacts connector.](./media/connector-azure-synapse-analytics-artifacts/azure-synapse-analytics-artifacts-connector.png)
+
+3. Configure the service details, test the connection, and create the new linked service. 
+
+    > [!div class="mx-imgBorder"]
+    > ![Screenshot of the Azure Synapse Analytics Artifacts connector configuration.](./media/connector-azure-synapse-analytics-artifacts/configure-azure-synapse-analytics-artifacts-linked-service.png)
+
+## Connector configuration details
+
+The following sections provide details about properties that define Azure Data Factory entities specific to an Azure Synapse Analytics (Artifacts) connector.
+
+## Linked service properties
+
+These generic properties are supported for an Azure Synapse Analytics (Artifacts) linked service:
+
+| Property | Description | Required |
+| :------ | :---------- | :-------- |
+| Name | Pick a valid name | Yes |
+| Description | Give some description of this linked service | No |
+| type    | The type property must be set to **AzureSynapseArtifacts**.  | Yes |
+| Connect via integration runtime| The [integration runtime](concepts-integration-runtime.md) to be used to connect to the data store. You can use Azure Integration Runtime or a self-hosted integration runtime (if your data store is located in a private network). If not specified, it uses the default Azure Integration Runtime. | Yes |
+
+
+## Linked service example that uses SQL authentication
+
+```json
+{
+    "name": "AzureSynapseArtifacts",
+    "properties": {
+        "annotations": [],
+        "type": "AzureSynapseArtifacts",
+        "typeProperties": {
+            "endpoint": "https://accessibilityverify.dev.azuresynapse.net",
+            "authentication": "MSI"
+        }
+    }
+}
+```
+
+## Next steps
+
+For a list of data stores supported as sources and sinks by Copy Activity, see [supported data stores and formats](copy-activity-overview.md#supported-data-stores-and-formats).