Merge pull request #309448 from markjbrown/deprecate-synapse-link-cosmosdb

update synapse link cosmos db

Author: v-ccolin

articles/synapse-analytics/how-to-analyze-complex-schema.md

@@ -5,14 +5,16 @@ author: im-microsoft
 ms.service: azure-synapse-analytics
 ms.topic: how-to
 ms.subservice: spark
-ms.date: 06/15/2020
+ms.date: 12/08/2025
 ms.author: imotiwala
 ms.custom: sfi-image-nochange
 
 ---
 
 # Analyze complex data types in Azure Synapse Analytics
 
+[!INCLUDE[](./includes/appliesto-cosmos-synapse-link.md)]
+
 This article is relevant for Parquet files and containers in [Azure Synapse Link for Azure Cosmos DB](.\synapse-link\how-to-connect-synapse-link-cosmos-db.md). You can use Spark or SQL to read or transform data with complex schemas such as arrays or nested structures. The following example is completed with a single document, but it can easily scale to billions of documents with Spark or SQL. The code included in this article uses PySpark (Python).
 
 ## Use case

articles/synapse-analytics/includes/appliesto-cosmos-synapse-link.md

@@ -0,0 +1,10 @@
+---
+ms.date: 12/08/2025
+ms.service: azure-cosmos-db
+ms.topic: include
+---
+
+> [!IMPORTANT]
+> Synapse Link for Cosmos DB is no longer supported for new projects. Don't use this feature.
+>
+> Please use Azure Cosmos DB Mirroring for Microsoft Fabric which is now GA. Mirroring provides the same zero-ETL benefits and is fully integrated with Microsoft Fabric. Learn more at [Cosmos DB Mirroring Overview](/fabric/database/mirrored-database/azure-cosmos-db).

articles/synapse-analytics/overview-faq.yml

@@ -6,7 +6,7 @@ metadata:
   ms.service: azure-synapse-analytics
   ms.topic: faq
   ms.subservice: overview
-  ms.date: 11/16/2022
+  ms.date: 12/08/2025
   ms.author: ajagadish
 title: Azure Synapse Analytics frequently asked questions
 summary: In this guide, you'll find the most frequently asked questions for Azure Synapse Analytics.
@@ -65,7 +65,7 @@ sections:
       - question: |
           Is Azure Synapse Link to Azure Cosmos DB generally available?
         answer: |
-          Azure Synapse Analytics currently supports Azure Synapse Link from Azure Cosmos DB to Synapse Apache Spark and serverless SQL pool. Azure Synapse Link for Apache Spark is GA. Synapse Link for serverless SQL pool is in preview. For more information, see [Azure Synapse Link for Azure Cosmos DB](/azure/cosmos-db/synapse-link).
+          [!INCLUDE[](./includes/appliesto-cosmos-synapse-link.md)]
 
       - question: |
           Is Azure Synapse Link for SQL generally available?

articles/synapse-analytics/quickstart-connect-synapse-link-cosmos-db.md

@@ -7,7 +7,7 @@ ms.reviewer: sidandrews, yexu
 ms.service: azure-synapse-analytics
 ms.subservice: synapse-link
 ms.topic: quickstart
-ms.date: 10/31/2025
+ms.date: 12/08/2025
 ms.update-cycle: 1825-days
 ms.custom: cosmos-db, mode-other
 ---
@@ -16,12 +16,7 @@ ms.custom: cosmos-db, mode-other
 
 This article describes how to access an Azure Cosmos DB database from Azure Synapse Analytics studio with Synapse Link. 
 
-> [!IMPORTANT]
-> **Mirroring to Microsoft Fabric is now available.** Mirroring to Fabric provides all the capabilities of Azure Synapse Link with better analytical performance, the ability to unify your data estate with OneLake in Fabric, and open access to your data in Delta Parquet format. Instead of Azure Synapse Link, use Fabric Mirroring. 
->
-> With Mirroring to Microsoft Fabric, you can continuously replicate your existing data estate directly into OneLake in Fabric, including data from Cosmos DB, SQL Server 2016+, Azure SQL Database, Azure SQL Managed Instance, Oracle, Snowflake, and more. 
-> 
-> For more information, see [Microsoft Fabric mirrored databases](/fabric/database/mirrored-database/overview).
+[!INCLUDE[](./includes/appliesto-cosmos-synapse-link.md)]
 
 ## Prerequisites
 

articles/synapse-analytics/sql/query-cosmos-db-analytical-store.md

@@ -5,14 +5,16 @@ author: jovanpop-msft
 ms.service: azure-synapse-analytics
 ms.topic: how-to
 ms.subservice: sql
-ms.date: 01/31/2025
+ms.date: 12/08/2025
 ms.author: jovanpop
 ms.reviewer: sidandrews
 ms.custom: cosmos-db
 ---
 
 # Query Azure Cosmos DB data using a serverless SQL pool
 
+[!INCLUDE[](../includes/appliesto-cosmos-synapse-link.md)]
+
 A serverless SQL pool allows you to analyze data in your Azure Cosmos DB containers that are enabled with [Azure Synapse Link](/azure/cosmos-db/synapse-link) in near real time without affecting the performance of your transactional workloads. It offers a familiar Transact-SQL (T-SQL) syntax to query data from the [analytical store](/azure/cosmos-db/analytical-store-introduction) and integrated connectivity to a wide range of business intelligence (BI) and ad-hoc querying tools via the T-SQL interface.
 
 For querying Azure Cosmos DB, the full [SELECT](/sql/t-sql/queries/select-transact-sql?view=azure-sqldw-latest&preserve-view=true) surface area is supported through the [OPENROWSET](develop-openrowset.md) function, which includes most [SQL functions and operators](overview-features.md). You can also store results of the query that reads data from Azure Cosmos DB along with data in Azure Blob Storage or Azure Data Lake Storage by using [create external table as select (CETAS)](develop-tables-cetas.md#cetas-in-serverless-sql-pool). You can't currently store serverless SQL pool query results to Azure Cosmos DB by using CETAS.

articles/synapse-analytics/synapse-link/concept-synapse-link-cosmos-db-support.md

@@ -7,13 +7,15 @@ ms.reviewer: sidandrews, yexu
 ms.service: azure-synapse-analytics
 ms.topic: conceptual
 ms.subservice: synapse-link
-ms.date: 10/31/2025
+ms.date: 12/08/2025
 ms.update-cycle: 1825-days
 ms.custom: cosmos-db
 ---
 
 # Azure Synapse Link for Azure Cosmos DB supported features
 
+[!INCLUDE[](../includes/appliesto-cosmos-synapse-link.md)]
+
 This article describes the functionalities that are currently supported in Azure Synapse Link for Azure Cosmos DB.
 
 > [!IMPORTANT]

articles/synapse-analytics/synapse-link/how-to-connect-synapse-link-cosmos-db.md

@@ -7,7 +7,7 @@ ms.reviewer: sidandrews, yexu
 ms.service: azure-synapse-analytics
 ms.topic: quickstart
 ms.subservice: synapse-link
-ms.date: 10/31/2025
+ms.date: 12/08/2025
 ms.update-cycle: 1825-days
 ms.custom: cosmos-db, mode-other
 ---
@@ -16,12 +16,7 @@ ms.custom: cosmos-db, mode-other
 
 This article describes how to access an Azure Cosmos DB database from Azure Synapse Analytics Studio with Azure Synapse Link.
 
-> [!IMPORTANT]
-> **Mirroring to Microsoft Fabric is now available.** Mirroring to Fabric provides all the capabilities of Azure Synapse Link with better analytical performance, the ability to unify your data estate with OneLake in Fabric, and open access to your data in Delta Parquet format. Instead of Azure Synapse Link, use Fabric Mirroring. 
->
-> With Mirroring to Microsoft Fabric, you can continuously replicate your existing data estate directly into OneLake in Fabric, including data from SQL Server 2016+, Azure SQL Database, Azure SQL Managed Instance, Oracle, Snowflake, Cosmos DB, and more. 
-> 
-> For more information, see [Microsoft Fabric mirrored databases](/fabric/database/mirrored-database/overview).
+[!INCLUDE[](../includes/appliesto-cosmos-synapse-link.md)]
 
 ## Prerequisites
 

articles/synapse-analytics/synapse-link/how-to-query-analytical-store-spark-3.md

@@ -7,21 +7,16 @@ ms.reviewer: sidandrews
 ms.service: azure-synapse-analytics
 ms.topic: quickstart
 ms.subservice: synapse-link
-ms.date: 10/31/2025
+ms.date: 12/08/2025
 ms.update-cycle: 1825-days
 ms.custom: cosmos-db, mode-other
 ---
 
 # Interact with Azure Cosmos DB using Apache Spark 3 in Azure Synapse Link
 
-In this article, you learn how to interact with Azure Cosmos DB using Synapse Apache Spark 3. Customers can use Scala, Python, SparkSQL, and C#, for analytics, data engineering, data science, and data exploration scenarios in [Azure Synapse Link for Azure Cosmos DB](/azure/cosmos-db/synapse-link).
+[!INCLUDE[](../includes/appliesto-cosmos-synapse-link.md)]
 
-> [!IMPORTANT]
-> **Mirroring to Microsoft Fabric is now available.** Mirroring to Fabric provides all the capabilities of Azure Synapse Link with better analytical performance, the ability to unify your data estate with OneLake in Fabric, and open access to your data in Delta Parquet format. Instead of Azure Synapse Link, use Fabric Mirroring. 
->
-> With Mirroring to Microsoft Fabric, you can continuously replicate your existing data estate directly into OneLake in Fabric, including data from Cosmos DB, SQL Server 2016+, Azure SQL Database, Azure SQL Managed Instance, Oracle, Snowflake, and more. 
-> 
-> For more information, see [Microsoft Fabric mirrored databases](/fabric/database/mirrored-database/overview).
+In this article, you learn how to interact with Azure Cosmos DB using Synapse Apache Spark 3. Customers can use Scala, Python, SparkSQL, and C#, for analytics, data engineering, data science, and data exploration scenarios in [Azure Synapse Link for Azure Cosmos DB](/azure/cosmos-db/synapse-link).
 
 The following capabilities are supported while interacting with Azure Cosmos DB:
 * Synapse Apache Spark 3 allows you to analyze data in your Azure Cosmos DB containers that are enabled with Azure Synapse Link in near real-time without impacting the performance of your transactional workloads. The following two options are available to query the Azure Cosmos DB [analytical store](/azure/cosmos-db/analytical-store-introduction) from Spark:

articles/synapse-analytics/synapse-link/how-to-query-analytical-store-spark.md

@@ -7,25 +7,20 @@ ms.reviewer: sidandrews
 ms.service: azure-synapse-analytics
 ms.topic: quickstart
 ms.subservice: synapse-link
-ms.date: 10/31/2025
+ms.date: 12/08/2025
 ms.update-cycle: 1825-days
 ms.custom: cosmos-db, mode-other
 ---
 
 # Interact with Azure Cosmos DB using Apache Spark 2 in Azure Synapse Link
 
+[!INCLUDE[](../includes/appliesto-cosmos-synapse-link.md)]
+
 > [!NOTE]
 > For Azure Synapse Link for Azure Cosmos DB using Spark 3, refer to this article [Azure Synapse Link for Azure Cosmos DB on Spark 3](how-to-query-analytical-store-spark-3.md)
 
 In this article, you'll learn how to interact with Azure Cosmos DB using Synapse Apache Spark 2. With its full support for Scala, Python, SparkSQL, and C#, Synapse Apache Spark is central to analytics, data engineering, data science, and data exploration scenarios in [Azure Synapse Link for Azure Cosmos DB](/azure/cosmos-db/synapse-link).
 
-> [!IMPORTANT]
-> **Mirroring to Microsoft Fabric is now available.** Mirroring to Fabric provides all the capabilities of Azure Synapse Link with better analytical performance, the ability to unify your data estate with OneLake in Fabric, and open access to your data in Delta Parquet format. Instead of Azure Synapse Link, use Fabric Mirroring. 
->
-> With Mirroring to Microsoft Fabric, you can continuously replicate your existing data estate directly into OneLake in Fabric, including data from Cosmos DB, SQL Server 2016+, Azure SQL Database, Azure SQL Managed Instance, Oracle, Snowflake, and more. 
-> 
-> For more information, see [Microsoft Fabric mirrored databases](/fabric/database/mirrored-database/overview).
-
 The following capabilities are supported while interacting with Azure Cosmos DB:
 * Synapse Apache Spark allows you to analyze data in your Azure Cosmos DB containers that are enabled with Azure Synapse Link in near real-time without impacting the performance of your transactional workloads. The following two options are available to query the Azure Cosmos DB [analytical store](/azure/cosmos-db/analytical-store-introduction) from Spark:
     + Load to Spark DataFrame