Make feedback changes

Author: cdpark

articles/synapse-analytics/quickstart-serverless-sql-pool.md

@@ -22,7 +22,7 @@ This quickstart shows how to query CSV, Apache Parquet, and JSON files.
 Choose a SQL client to issue queries:
 
 - [Azure Synapse Studio](./get-started-create-workspace.md) is a web tool that you can use to browse files in storage and create SQL queries.
-- [Azure Data Studio](sql/get-started-azure-data-studio.md) is a client tool that lets you run SQL queries and notebooks on your on-demand database.
+- [Visual Studio Code](https://code.visualstudio.com/docs) with the [mssql extension](https://aka.ms/mssql-marketplace) is a cross-platform lightweight developer and data tool that lets you run SQL queries and notebooks on your on-demand database.
 - [SQL Server Management Studio](sql/get-started-ssms.md) is a client tool that lets you run SQL queries on your on-demand database.
 
 This quickstart uses the following parameters:
@@ -48,19 +48,19 @@ Create your own database for demo purposes. You can use this database to create
 > [!NOTE]
 > The databases are used only for view metadata, not for actual data. Write down the database name for use later in the quickstart.
 
-Use the following command, changing `mydbname` to a name of your choice:
+Use the following T-SQL command, changing `<mydbname>` to a name of your choice:
 
 ```sql
-CREATE DATABASE mydbname
+CREATE DATABASE <mydbname>
 ```
 
 ### Create data source
 
-To run queries using serverless SQL pool, create a data source that serverless SQL pool can use to access files in storage. Execute the following code snippet to create the data source used in samples in this section:
+To run queries using serverless SQL pool, create a data source that serverless SQL pool can use to access files in storage. Execute the following code snippet to create the data source used in samples in this section. Replace `<strong-password-here>` with a strong password of your choice.
 
 ```sql
 -- create master key that will protect the credentials:
-CREATE MASTER KEY ENCRYPTION BY PASSWORD = <enter-strong-password-here>
+CREATE MASTER KEY ENCRYPTION BY PASSWORD = '<strong-password-here>'
 
 -- create credentials for containers in our demo storage account
 CREATE DATABASE SCOPED CREDENTIAL sqlondemand
@@ -145,7 +145,7 @@ Files are stored in a *json* container, using folder *books*, and contain a sing
 
 ### Sample query
 
-The following query shows how to use [JSON_VALUE](/sql/t-sql/functions/json-value-transact-sql?view=azure-sqldw-latest&preserve-view=true) to retrieve scalar values (title, publisher) from a book with the title *Probabilistic and Statistical Methods in Cryptology, An Introduction by selected topics*:
+The following query shows how to use [JSON_VALUE](/sql/t-sql/functions/json-value-transact-sql?view=azure-sqldw-latest&preserve-view=true) to retrieve scalar values (title, publisher) from a book with the title *Probabilistic and Statistical Methods in Cryptology, An Introduction*:
 
 ```sql
 SELECT
@@ -164,11 +164,11 @@ FROM OPENROWSET
 WITH
   ( jsonContent varchar(8000) ) AS [r]
 WHERE
-  JSON_VALUE(jsonContent, '$.title') = 'Probabilistic and Statistical Methods in Cryptology, An Introduction by selected topics'
+  JSON_VALUE(jsonContent, '$.title') = 'Probabilistic and Statistical Methods in Cryptology, An Introduction'
 ```
 
 > [!IMPORTANT]
-> We read the entire JSON file as a single row or column. So FIELDTERMINATOR, FIELDQUOTE, and ROWTERMINATOR are set to 0x0b because we don't expect to find it in the file.
+> We read the entire JSON file as a single row or column. So `FIELDTERMINATOR`, `FIELDQUOTE`, and `ROWTERMINATOR` are set to `0x0b` because we don't expect to find it in the file.
 
 ## Related content
 

articles/synapse-analytics/security/how-to-grant-workspace-managed-identity-permissions.md

@@ -64,7 +64,7 @@ Select that same container or file system to grant the *Storage Blob Data Contri
 
 #### Step 3: Open Access control and add role assignment
 
-1. Select **Access control (IAM)** from the left navigation.
+1. Select **Access control (IAM)** from the resource menu.
 
 1. Select **Add** > **Add role assignment** to open the **Add role assignment** page.
 

articles/synapse-analytics/sql-data-warehouse/media/sql-data-warehouse-query-ssms/connect-object-explorer1.png

@@ -25,21 +25,21 @@ For example, the optimizer selects a certain plan if it estimates that that the
 
 ## Automatic creation of statistic
 
-When the database **AUTO_CREATE_STATISTICS** option is on, dedicated SQL pool analyzes incoming user queries for missing statistics.
+When the database `AUTO_CREATE_STATISTICS` option is on, dedicated SQL pool analyzes incoming user queries for missing statistics.
 
 If statistics are missing, the query optimizer creates statistics on individual columns in the query predicate or join condition to improve cardinality estimates for the query plan.
 
 > [!NOTE]
 > Automatic creation of statistics is currently turned on by default.
 
-You can check if your dedicated SQL pool has **AUTO_CREATE_STATISTICS** configured by running the following command:
+You can check if your dedicated SQL pool has `AUTO_CREATE_STATISTICS` configured by running the following T-SQL command:
 
 ```sql
 SELECT name, is_auto_create_stats_on
 FROM sys.databases
 ```
 
-If your dedicated SQL pool doesn't have **AUTO_CREATE_STATISTICS** configured, we recommend you enable this property by running the following command:
+If your dedicated SQL pool doesn't have `AUTO_CREATE_STATISTICS` configured, we recommend you enable this property by running the following command. Replace `<your-datawarehouse-name>` with the name of your dedicated SQL pool.
 
 ```sql
 ALTER DATABASE <your-datawarehouse-name>
@@ -48,12 +48,12 @@ SET AUTO_CREATE_STATISTICS ON
 
 These statements trigger the automatic creation of statistics:
 
-- SELECT
-- INSERT-SELECT
-- CTAS
-- UPDATE
-- DELETE
-- EXPLAIN when containing a join or the presence of a predicate is detected
+- `SELECT`
+- `INSERT`... `SELECT`
+- `CREATE TABLE AS SELECT` (CTAS)
+- `UPDATE`
+- `DELETE`
+- `EXPLAIN` when containing a join or the presence of a predicate is detected
 
 > [!NOTE]
 > Automatic creation of statistics isn't performed on temporary or external tables.
@@ -71,7 +71,7 @@ When automatic statistics are created, they take the form: `_WA_Sys_<8 digit col
 DBCC SHOW_STATISTICS (<table_name>, <target>)
 ```
 
-The *table\_name* is the name of the table that contains the statistics to display. This table can't be an external table. The target is the name of the target index, statistics, or column for which to display statistics information.
+The `table_name` is the name of the table that contains the statistics to display. This table can't be an external table. The target is the name of the target index, statistics, or column for which to display statistics information.
 
 ## Update statistics
 
@@ -274,13 +274,13 @@ To create a multi-column statistics object, use the previous examples, but speci
 > [!NOTE]
 > The histogram, which is used to estimate the number of rows in the query result, is only available for the first column listed in the statistics object definition.
 
-In this example, the histogram is on *product\_category*. Cross-column statistics are calculated on *product\_category* and *product\_sub\_category*:
+In this example, the histogram is on `product_category`. Cross-column statistics are calculated on `product_category` and `product_sub_category`:
 
 ```sql
 CREATE STATISTICS stats_2cols ON table1 (product_category, product_sub_category) WHERE product_category > '2000101' AND product_category < '20001231' WITH SAMPLE = 50 PERCENT;
 ```
 
-Because there's a correlation between *product\_category* and *product\_sub\_category*, a multi-column statistics object can be useful if these columns are accessed at the same time.
+Because there's a correlation between `product_category` and `product_sub_category`, a multi-column statistics object can be useful if these columns are accessed at the same time.
 
 ### Create statistics on all columns in a table
 

articles/synapse-analytics/sql-data-warehouse/sql-data-warehouse-tables-statistics.md

@@ -23,7 +23,7 @@ You can use [SQL Server Management Studio (SSMS)](/sql/ssms/download-sql-server-
 
 > [!NOTE]
 > Supported tools for serverless SQL pool:
-> - [Azure Data Studio](/azure-data-studio/download-azure-data-studio) is fully supported starting from version 1.18.0.
+> - The [mssql extension](https://aka.ms/mssql-marketplace) for [Visual Studio Code](https://code.visualstudio.com/docs).
 > - SSMS is partially supported starting from version 18.5. You can use it to connect and query only.
 
 ## Prerequisites
@@ -48,7 +48,7 @@ To connect to Synapse SQL using dedicated SQL pool, follow these steps:
    * **Authentication**: Choose an authentication type, such as *SQL Server Authentication* or *Active Directory Integrated Authentication*.
    * **Login** and **Password**: Enter your user name and password if SQL Server Authentication was selected.
 
-1. Expand your Azure SQL Server in **Object Explorer**. You can view the databases associated with the server, such as the sample *AdventureWorksDW* database. You can expand the database to see the tables:
+1. Expand your Azure SQL Server in **Object Explorer**. You can view the databases associated with the server, such as the sample `AdventureWorksDW` database. You can expand the database to see the tables:
 
     :::image type="content" source="../sql-data-warehouse/media/sql-data-warehouse-query-ssms/explore-tables.png" alt-text="Screenshot that shows the Object Explorer window.":::
 
@@ -63,7 +63,7 @@ To connect to Synapse SQL using serverless SQL pool, follow these steps:
     :::image type="content" source="media/get-started-ssms/connect-object-explorer1.png" alt-text="Screenshot that shows the Connect to Server dialog box for serverless SQL pool.":::
 
    * **Server name**: Enter the server name previously identified.
-   * **Authentication**: Choose an authentication type, such as *SQL Server Authentication* or *Active Directory Integrated Authentication*.
+   * **Authentication**: Choose an authentication type, such as *SQL Server Authentication* or *Microsoft Entra Authentication*.
    * **Login** and **Password**: Enter your user name and password if SQL Server Authentication was selected.
 
 1. To explore, expand your Azure SQL server. You can view the databases associated with the server. Expand *demo* to see the content in your sample database.
@@ -94,7 +94,7 @@ After you establish a database connection, you can query the data.
 
     :::image type="content" source="../sql-data-warehouse/media/sql-data-warehouse-query-ssms/execute-query.png" alt-text="Screenshot of the Execute button to run the query.":::
 
-1. Look at the query results. In the following example, the *FactInternetSales* table has 60,398 rows.
+1. Look at the query results. In the following example, the `FactInternetSales` table has 60,398 rows.
 
     :::image type="content" source="../sql-data-warehouse/media/sql-data-warehouse-query-ssms/results.png" alt-text="Screenshot of the query results.":::
 
@@ -118,7 +118,7 @@ After you establish a database connection, you can query the data.
 
     :::image type="content" source="media/get-started-ssms/execute-query.png" alt-text="Screenshot of the Execute button to run the query for serverless SQL pool.":::
 
-1. Look at the query results. In this example, the *usPopulationView* view has 3,664,512 rows.
+1. Look at the query results. In this example, the `usPopulationView` view has 3,664,512 rows.
 
     :::image type="content" source="media/get-started-ssms/results.png" alt-text="Screenshot of the query results for serverless SQL pool.":::
 

articles/synapse-analytics/sql/get-started-ssms.md

@@ -117,7 +117,7 @@ This article is a step-by-step guide for getting started with Azure Synapse Link
    :::image type="content" source="../media/connect-synapse-link-sql-server-2022/adls-gen2-assign-blob-data-contributor-role.png" alt-text="Screenshot that shows how to add a role assignment.":::
 
    > [!NOTE]
-   > Make sure that you've granted your Azure Synapse workspace managed identity permissions to the Azure Data Lake Storage Gen2 storage account that's used as the landing zone. For more information, see [Grant permissions to a managed identity in an Azure Synapse workspace - Azure Synapse Analytics](../security/how-to-grant-workspace-managed-identity-permissions.md#grant-the-managed-identity-permissions-to-adls-gen2-storage-account).
+   > Make sure that you've granted your Azure Synapse workspace managed identity permissions to the Azure Data Lake Storage Gen2 storage account that's used as the landing zone. For more information, see [Grant permissions to a managed identity in an Azure Synapse workspace - Azure Synapse Analytics](../security/how-to-grant-workspace-managed-identity-permissions.md#grant-the-managed-identity-permissions-to-data-lake-storage-account).
 
 1. Open the **Manage** hub in your Azure Synapse workspace, and go to **Linked services**.