Merge pull request #115332 from SnehaGunda/release-build

megvanhuygen · web-flow · commit ffdbbc2c8ac9 · 2020-05-19T10:48:01.000-07:00
Adding Synapse analytics links &amp; TOC entries
diff --git a/articles/cosmos-db/TOC.yml b/articles/cosmos-db/TOC.yml
@@ -492,12 +492,14 @@
         href: change-feed-functions.md
       - name: Change feed pull model
         href: change-feed-pull-model.md
-    - name: Analytics with Synapse Link
+    - name: Analytics with Azure Synapse Link
       items:
-      - name: Synapse Link for Azure Cosmos DB
+      - name: Azure Synapse Link for Cosmos DB
         href: synapse-link.md
       - name: Analytical store - Overview
         href: analytical-store-introduction.md
+      - name: Synapse Link supported features
+        href: ../synapse-analytics/synapse-link/concept-synapse-link-cosmos-db-support.md
       - name: Synapse Link FAQ
         href: synapse-link-frequently-asked-questions.md
       - name: Synapse Link use cases
@@ -1023,10 +1025,14 @@
         href: how-to-migrate-from-change-feed-library.md
       - name: Change feed - Async Java sample
         href: create-sql-api-java-changefeed.md
-    - name: Analytics with Synapse Link
+    - name: Analytics with Azure Synapse Link
       items:
-      - name: Configure Synapse Link
+      - name: Configure Azure Synapse Link
         href: configure-synapse-link.md
+      - name: Connect to Azure Synapse Link
+        href: ../synapse-analytics/synapse-link/how-to-connect-synapse-link-cosmos-db.md
+      - name: Query with Azure Synapse Spark
+        href: ../synapse-analytics/synapse-link/how-to-query-analytical-store-spark.md
     - name: Built-in analytics with Apache Spark
       items:
       - name: Azure Databricks Spark connector
diff --git a/articles/cosmos-db/breadcrumb/TOC.yml b/articles/cosmos-db/breadcrumb/TOC.yml
@@ -90,3 +90,10 @@
     tocHref: /azure/azure-monitor/insights
     topicHref: /azure/cosmos-db/index
 
+- name: Azure
+  tocHref: /azure/
+  topicHref: /azure/index
+  items:
+  - name: Cosmos DB
+    tocHref: /azure/synapse-analytics/
+    topicHref: /azure/cosmos-db/index
diff --git a/articles/cosmos-db/configure-synapse-link.md b/articles/cosmos-db/configure-synapse-link.md
@@ -183,11 +183,11 @@ container.replace(containerProperties).block();
 
 ## <a id="connect-to-cosmos-database"></a> Connect to a Synapse workspace
 
-Use the instructions in [Connect to Azure Synapse Link]() on how to access an Azure Cosmos DB database from Azure Synapse Analytics Studio with Azure Synapse Link.
+Use the instructions in [Connect to Azure Synapse Link](../synapse-analytics/synapse-link/how-to-connect-synapse-link-cosmos-db.md) on how to access an Azure Cosmos DB database from Azure Synapse Analytics Studio with Azure Synapse Link.
 
 ## <a id="query-analytical-store"></a> Query using Synapse Spark
 
-Use the instructions in the [Query Azure Cosmos DB analytical store]() article on how to query with Synapse Spark. That article gives some examples on how you can interact with the analytical store from Synapse gestures. Those gestures are visible when you right-click on a container. With gestures, you can quickly generate code and tweak it to your needs. They are also perfect for discovering data with a single click.
+Use the instructions in the [Query Azure Cosmos DB analytical store](../synapse-analytics/synapse-link/how-to-query-analytical-store-spark.md) article on how to query with Synapse Spark. That article gives some examples on how you can interact with the analytical store from Synapse gestures. Those gestures are visible when you right-click on a container. With gestures, you can quickly generate code and tweak it to your needs. They are also perfect for discovering data with a single click.
 
 ## <a id="cosmosdb-synapse-link-samples"></a> Getting started with Azure Synpase Link - Samples
 
diff --git a/articles/cosmos-db/media/synapse-link/synapse-analytics-cosmos-db-architecture.png b/articles/cosmos-db/media/synapse-link/synapse-analytics-cosmos-db-architecture.png
diff --git a/articles/cosmos-db/performance-tips-java-sdk-v4-sql.md b/articles/cosmos-db/performance-tips-java-sdk-v4-sql.md
@@ -89,7 +89,8 @@ So if you're asking "How can I improve my database performance?" consider the fo
 
     ![Illustration of the Azure Cosmos DB connection policy](./media/performance-tips/same-region.png)
 
-    An app that interacts with a multi-region Azure Cosmos DB account needs to configure [preferred locations]() to ensure that requests are going to a collocated region.
+    An app that interacts with a multi-region Azure Cosmos DB account needs to configure 
+[preferred locations](tutorial-global-distribution-sql-api.md#preferred-locations) to ensure that requests are going to a collocated region.
 
 * **Enable Accelerated Networking on your Azure VM for lower latency.**
 
diff --git a/articles/cosmos-db/synapse-link.md b/articles/cosmos-db/synapse-link.md
@@ -94,7 +94,7 @@ This integration enables the following HTAP scenarios for different users:
 
 * A data engineer who wants to make data accessible for consumers, by creating SQL or Spark tables over Azure Cosmos DB containers without manual ETL processes.
 
-For more information on Azure Synapse Analytics runtime support for Azure Cosmos DB, see [Azure Synapse Analytics for Cosmos DB support]().
+For more information on Azure Synapse Analytics runtime support for Azure Cosmos DB, see [Azure Synapse Analytics for Cosmos DB support](../synapse-analytics/synapse-link/concept-synapse-link-cosmos-db-support.md).
 
 ## When to use Azure Synapse Link for Azure Cosmos DB?
 
@@ -119,21 +119,21 @@ Synapse Link is not recommended if you are looking for traditional data warehous
 
 * Accessing the Azure Cosmos DB analytic store with Synapse SQL serverless is currently under gated preview. To request access, email the [Azure Cosmos DB team](mailto:cosmosdbsynapselink@microsoft.com).
 
-* Accessing the Azure Cosmos DB analytics store with Synapse SQL provisioned is currently not available. 
+* Accessing the Azure Cosmos DB analytics store with Synapse SQL provisioned is currently not available.
 
 ## Pricing
 
-The billing model of Azure Synapse Link includes the costs incurred by using the Azure Cosmos DB analytical store and the Synapse runtime. To learn more, see the [Azure Cosmos DB analytical store pricing](analytical-store-introduction.md#analytical-store-pricing) and [Azure Synapse Analytics pricing]() articles.
+The billing model of Azure Synapse Link includes the costs incurred by using the Azure Cosmos DB analytical store and the Synapse runtime. To learn more, see the [Azure Cosmos DB analytical store pricing](analytical-store-introduction.md#analytical-store-pricing) and [Azure Synapse Analytics pricing](https://azure.microsoft.com/pricing/details/synapse-analytics/) articles.
 
 ## Next steps
 
 To learn more, see the following docs:
 
 * [Azure Cosmos DB analytical store overview](analytical-store-introduction.md)
 
-* [Get started with Azure Synapse Link for Azure Cosmos DB](configure-synapse-link.md) 
+* [Get started with Azure Synapse Link for Azure Cosmos DB](configure-synapse-link.md)
  
-* [What is supported in Azure Synapse Analytics run time]()
+* [What is supported in Azure Synapse Analytics run time](../synapse-analytics/synapse-link/concept-synapse-link-cosmos-db-support.md)
 
 * [Frequently asked questions about Azure Synapse Link for Azure Cosmos DB](synapse-link-frequently-asked-questions.md)
 
diff --git a/articles/cosmos-db/tutorial-global-distribution-sql-api.md b/articles/cosmos-db/tutorial-global-distribution-sql-api.md
@@ -1,6 +1,6 @@
 ---
 title: 'Tutorial: Azure Cosmos DB global distribution tutorial for the SQL API'
-description: 'Tutorial: Learn how to set up Azure Cosmos DB global distribution using the SQL API with .Net, Java, Python and various other SDKs'
+description: 'Tutorial: Learn how to set up Azure Cosmos DB global distribution using the SQL API with .NET, Java, Python and various other SDKs'
 author: markjbrown
 ms.author: mjbrown
 ms.service: cosmos-db
@@ -23,7 +23,7 @@ This article covers the following tasks:
 [!INCLUDE [cosmos-db-tutorial-global-distribution-portal](../../includes/cosmos-db-tutorial-global-distribution-portal.md)]
 
 
-## Connecting to a preferred region using the SQL API
+## <a id="preferred-locations"></a> Connecting to a preferred region using the SQL API
 
 In order to take advantage of [global distribution](distribute-data-globally.md), client applications can specify the ordered preference list of regions to be used to perform document operations. This can be done by setting the connection policy. Based on the Azure Cosmos DB account configuration, current regional availability and the preference list specified, the most optimal endpoint will be chosen by the SQL SDK to perform write and read operations.
 
