edit pass

Author: julieMSFT

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

@@ -1,5 +1,5 @@
 ---
-title: Query Azure Cosmos DB analytical store with Synapse Spark
+title: Query Azure Cosmos DB Analytical Store with Synapse Spark
 description: How to query Cosmos DB analytical with Synapse Spark
 services: synapse-analytics 
 author: ArnoMicrosoft
@@ -11,13 +11,13 @@ ms.author: acomet
 ms.reviewer: jrasnick
 ---
 
-# Query Azure Cosmos DB analytical store with Synapse Spark
+# Query Azure Cosmos DB Analytical Store with Synapse Spark
 
-This 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.
+This 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.
 
 ## Load to DataFrame
 
-In this step, you will read data from Azure Cosmos DB analytical store in a Spark DataFrame. It will display 10 rows from the DataFrame called ***df***. Once your data is into dataframe, you can perform additional analysis. This operation does not impact the transactional store.
+In this step, you will read data from Azure Cosmos DB Analytical Store in a Spark DataFrame. It will display 10 rows from the DataFrame called ***df***. Once your data is in a dataframe, you can perform additional analysis. This operation does not impact the transactional store.
 
 ```python
 # To select a preferred list of regions in a multi-region Cosmos DB account, add .option("spark.cosmos.preferredRegions", "<Region1>,<Region2>")
@@ -42,7 +42,7 @@ val df_olap = spark.read.format("cosmos.olap").
 
 ## Create Spark table
 
-In this gesture, you will create a Spark table pointing to the container you selected. That operation does not incur any data movement. If you decide to delete that table, the underlying container (and corresponding analytical store) won't be impacted. This scenario is convenient to reuse tables through third-party tools and provide accessibility to the data for the run-time.
+In this gesture, you will create a Spark table pointing to the container you selected. This operation does not incur any data movement. If you decide to delete the table, the underlying container (and corresponding Analytical Store) won't be impacted. This scenario is convenient to reuse tables through third-party tools and provide accessibility to the data at run-time.
 
 ```sql
 %%sql
@@ -55,7 +55,8 @@ create table call_center using cosmos.olap options (
 ```
 
 ## Write DataFrame to container
-In this gesture, you will write a dataframe into a container. This operation will impact the transactional performance and consume Request Units. Using Azure Cosmos DB transactional performance is ideal for write transactions. Make sure that you replace **YOURDATAFRAME** by the dataframe that you want to write back.
+
+In this gesture, you will write a dataframe into a container. This operation will impact the transactional performance and consume Request Units. Using Azure Cosmos DB transactional performance is ideal for write transactions. Make sure that you replace **YOURDATAFRAME** by the dataframe that you want to write back to.
 
 ```python
 # Write a Spark DataFrame into a Cosmos DB container
@@ -85,7 +86,8 @@ df.write.format("cosmos.oltp").
 ```
 
 ## Load streaming DataFrame from container
-In this gesture, you will use Spark Streaming capability to load data from a container into a dataframe. The data will be stored into the primary data lake account (and file system) that you connected to the workspace. If the folder /localReadCheckpointFolder is not created, it will be automatically created. This operation will impact the transactional performance of Cosmos DB.
+
+In this gesture, you will use Spark Streaming capability to load data from a container into a dataframe. The data will be stored into the primary data lake account (and file system) that you connected to the workspace. If the folder /localReadCheckpointFolder does not exist, it will be automatically created. This operation will impact the transactional performance of Cosmos DB.
 
 ```python
 # To select a preferred list of regions in a multi-region Cosmos DB account, add .option("spark.cosmos.preferredRegions", "<Region1>,<Region2>")
@@ -117,7 +119,8 @@ val dfStream = spark.readStream.
 ```
 
 ## Write streaming DataFrame to container
-In this gesture, you will write a streaming dataframe into the Cosmos DB container you selected. If the folder /localReadCheckpointFolder is not created, it will be automatically created. This operation will impact the transactional performance of Cosmos DB.
+
+In this gesture, you will write a streaming dataframe into the Cosmos DB container you selected. If the folder /localReadCheckpointFolder does not exist, it will be automatically created. This operation will impact the transactional performance of Cosmos DB.
 
 ```python
 # To select a preferred list of regions in a multi-region Cosmos DB account, add .option("spark.cosmos.preferredRegions", "<Region1>,<Region2>")
@@ -150,4 +153,9 @@ val query = dfStream.
             start()
 
 query.awaitTermination()
-```
+```
+
+## Next steps
+
+- [Learn more about Cosmos DB Analytical Store]
+<!-- (../cosmos-db/analytical-store-introduction) -->