Merge pull request #280649 from whhender/synapse-freshness-july-2024

Synapse Author Updates - 1

Author: v-dirichards

articles/storage/blobs/storage-blob-inventory-report-analytics.md

@@ -44,7 +44,7 @@ You might have to wait up to 24 hours after enabling inventory reports for your
    > [!NOTE]
    > As part of creating the workspace, you'll create a storage account that has a hierarchical namespace. Azure Synapse stores Spark tables and application logs to this account. Azure Synapse refers to this account as the _primary storage account_. To avoid confusion, this article uses the term _inventory report account_ to refer to the account which contains inventory reports.
 
-2. In the Synapse workspace, assign the **Contributor** role to your user identity. See [Azure RBAC: Owner role for the workspace](../../synapse-analytics/get-started-add-admin.md#azure-rbac-owner-role-for-the-workspace).
+2. In the Synapse workspace, assign the **Contributor** role to your user identity. See [Azure RBAC: Owner role for the workspace](../../synapse-analytics/get-started-add-admin.md#azure-role-based-access-control-owner-role-for-the-workspace).
 
 3. Give the Synapse workspace permission to access the inventory reports in your storage account by navigating to your inventory report account, and then assigning the **Storage Blob Data Contributor** role to the system managed identity of the workspace. See [Assign Azure roles using the Azure portal](../../role-based-access-control/role-assignments-portal.yml).
 
@@ -54,7 +54,7 @@ You might have to wait up to 24 hours after enabling inventory reports for your
 
 1. Open your Synapse workspace in Synapse Studio. See [Open Synapse Studio](../../synapse-analytics/get-started-create-workspace.md#open-synapse-studio).
 
-2. In Synapse Studio, Make sure that your identity is assigned the role of **Synapse Administrator**. See [Synapse RBAC: Synapse Administrator role for the workspace](../../synapse-analytics/get-started-add-admin.md#synapse-rbac-synapse-administrator-role-for-the-workspace).
+2. In Synapse Studio, Make sure that your identity is assigned the role of **Synapse Administrator**. See [Synapse RBAC: Synapse Administrator role for the workspace](../../synapse-analytics/get-started-add-admin.md#synapse-role-based-access-control-synapse-administrator-role-for-the-workspace).
 
 3. Create an Apache Spark pool. See [Create a serverless Apache Spark pool](../../synapse-analytics/get-started-analyze-spark.md#create-a-serverless-apache-spark-pool).
 
@@ -189,4 +189,4 @@ In this section, you'll generate statistical data that you'll visualize in a rep
 
   [Estimate the cost of archiving data](archive-cost-estimation.md)
 
-  [Optimize costs by automatically managing the data lifecycle](lifecycle-management-overview.md)
+  [Optimize costs by automatically managing the data lifecycle](lifecycle-management-overview.md)

articles/synapse-analytics/get-started-add-admin.md

@@ -1,8 +1,8 @@
 ---
 title: 'Quickstart: Get started add an Administrator' 
 description: In this tutorial, you'll learn how to add another administrative user to your workspace.
-author: saveenr
-ms.author: saveenr
+author: whhender
+ms.author: whhender
 ms.reviewer: sngun
 ms.service: synapse-analytics
 ms.subservice: workspace
@@ -13,13 +13,13 @@ ms.custom: subject-rbac-steps
 
 # Add an administrator to your Synapse workspace
 
-In this tutorial, you'll learn how to add an administrator to your Synapse workspace. This user will have full control over the workspace.
+In this tutorial, you'll learn how to add an administrator to your Synapse workspace. This user has full control over the workspace.
 
 ## Overview
 
-So far in the get started guide, we've focused on activities *you* do in the workspace. Because you created the workspace in STEP 1, you are an administrator of the Synapse workspace. Now, we will make another user Ryan (`[email protected]`) an administrator. When we are done, Ryan will be able to do everything you can do in the workspace.
+So far in the get started guide, we've focused on activities *you* do in the workspace. Because you created the workspace in STEP 1, you're an administrator of the Synapse workspace. Now, we'll make another user Ryan (`[email protected]`) an administrator. When we're done, Ryan will be able to do everything you can do in the workspace.
 
-## Azure RBAC: Owner role for the workspace
+## Azure role-based access control: Owner role for the workspace
 
 1. Open the Azure portal and open your Synapse workspace.
 1. On the left side, select **Access control (IAM)**.
@@ -36,10 +36,9 @@ So far in the get started guide, we've focused on activities *you* do in the wor
 
 1. Select **Save**. 
 
- 
-## Synapse RBAC: Synapse Administrator role for the workspace
+## Synapse role-based access control: Synapse Administrator role for the workspace
 
-Assign to `[email protected]` to Synapse RBAC **Synapse Administrator** role on the workspace.
+Assign to `[email protected]` to the **Synapse Administrator** role on the workspace.
 
 1. Open your workspace in Synapse Studio.
 1. On the left side, select  **Manage** to open the Manage hub.
@@ -49,7 +48,7 @@ Assign to `[email protected]` to Synapse RBAC **Synapse Administrator** role on t
 1. Add `[email protected]` to the **Synapse Administrator** role. 
 1. Then select **Apply**.
 
-## Azure RBAC: Role assignments on the workspace's primary storage account
+## Azure role-based access control: Role assignments on the workspace's primary storage account
 
 1. Open the workspace's primary storage account in the Azure portal.
 1. On the left side, select **Access control (IAM)**.

articles/synapse-analytics/get-started-analyze-spark.md

@@ -1,8 +1,8 @@
 ---
 title: 'Quickstart: Get started analyzing with Spark' 
 description: In this tutorial, you'll learn to analyze data with Apache Spark.
-author: saveenr
-ms.author: saveenr
+author: whhender
+ms.author: whhender
 ms.reviewer: sngun
 ms.service: synapse-analytics
 ms.subservice: spark

articles/synapse-analytics/get-started-analyze-sql-on-demand.md

@@ -1,8 +1,8 @@
 ---
 title: 'Tutorial: Get started analyze data with a serverless SQL pool' 
 description: In this tutorial, you'll learn how to analyze data with a serverless SQL pool using data located in Spark databases.
-author: saveenr
-ms.author: saveenr
+author: whhender
+ms.author: whhender
 ms.reviewer: sngun, wiassaf
 ms.service: synapse-analytics
 ms.subservice: sql

articles/synapse-analytics/get-started-analyze-sql-pool.md

@@ -1,8 +1,8 @@
 ---
 title: "Tutorial: Get started analyze data with dedicated SQL pools"
 description: In this tutorial, use the NYC Taxi sample data to explore SQL pool's analytic capabilities.
-author: saveenr
-ms.author: saveenr
+author: whhender
+ms.author: whhender
 ms.reviewer: sngun, wiassaf
 ms.date: 10/16/2023
 ms.service: synapse-analytics

articles/synapse-analytics/get-started-analyze-storage.md

@@ -1,8 +1,8 @@
 ---
 title: 'Tutorial: Get started analyze data in Storage accounts' 
 description: In this tutorial, you'll learn how to analyze data located in a storage account.
-author: saveenr
-ms.author: saveenr
+author: whhender
+ms.author: whhender
 ms.reviewer: sngun
 ms.service: synapse-analytics
 ms.subservice: workspace
@@ -35,12 +35,12 @@ df.write.mode("overwrite").parquet("/NYCTaxi/PassengerCountStats_parquetformat")
 
 ### Analyze data in a storage account
 
-You can analyze the data in your workspace default ADLS Gen2 account or you can link an ADLS Gen2 or Blob storage account to your workspace through "**Manage**" > "**Linked Services**" > "**New**" (The steps below will refer to the primary ADLS Gen2 account).
+You can analyze the data in your workspace default Azure Data Lake Storage (ADLS) Gen2 account or you can link an ADLS Gen2 or Blob storage account to your workspace through "**Manage**" > "**Linked Services**" > "**New**" (The next steps will refer to the primary ADLS Gen2 account).
 
 1. In Synapse Studio, go to the **Data** hub, and then select **Linked**.
 1. Go to **Azure Data Lake Storage Gen2** > **myworkspace (Primary - contosolake)**.
 1. Select **users (Primary)**. You should see the **NYCTaxi** folder. Inside you should see two folders called **PassengerCountStats_csvformat** and **PassengerCountStats_parquetformat**.
-1. Open the **PassengerCountStats_parquetformat** folder. Inside, you'll see a parquet file with a name like `part-00000-2638e00c-0790-496b-a523-578da9a15019-c000.snappy.parquet`.
+1. Open the **PassengerCountStats_parquetformat** folder. Inside, there's a parquet file with a name like `part-00000-2638e00c-0790-496b-a523-578da9a15019-c000.snappy.parquet`.
 1. Right-click **.parquet**, then select **New notebook**, then select **Load to DataFrame**. A new notebook is created with a cell like this:
 
     ```py
@@ -50,7 +50,7 @@ You can analyze the data in your workspace default ADLS Gen2 account or you can
     display(df.limit(10))
     ```
 
-1. Attach to the Spark pool named **Spark1**. Run the cell. If you run into an error related to lack of cores, this spark pool may be used by another session. Cancel all the existing sessions and retry.
+1. Attach to the Spark pool named **Spark1**. Run the cell. If you run into an error related to lack of cores, another session could be using this spark pool this spark pool. Cancel all the existing sessions and retry.
 1. Select back to the **users** folder. Right-click the **.parquet** file again, and then select **New SQL script** > **SELECT TOP 100 rows**. It creates a SQL script like this:
 
     ```sql

articles/synapse-analytics/get-started-create-workspace.md

@@ -1,8 +1,8 @@
 ---
 title: 'Quickstart: Get started - create a Synapse workspace' 
 description: In this tutorial, you'll learn how to create a Synapse workspace, a dedicated SQL pool, and a serverless Apache Spark pool.
-author: saveenr
-ms.author: saveenr
+author: whhender
+ms.author: whhender
 ms.reviewer: sngun
 ms.service: synapse-analytics
 ms.subservice: workspace
@@ -16,7 +16,7 @@ In this tutorial, you'll learn how to create a Synapse workspace, a dedicated SQ
 
 ## Prerequisites
 
-To complete this tutorial's steps, you need to have access to a resource group for which you are assigned the **Owner** role. Create the Synapse workspace in this resource group.
+To complete this tutorial's steps, you need to have access to a resource group for which you're assigned the **Owner** role. Create the Synapse workspace in this resource group.
 
 ## Create a Synapse workspace in the Azure portal
 
@@ -36,7 +36,7 @@ Fill in the following fields:
 Fill in the following fields:
 
 1. **Workspace name** - Pick any globally unique name. In this tutorial, we'll use **myworkspace**.
-1. **Region** - Pick the region where you have placed your client applications/services (for example, Azure VM, Power BI, Azure Analysis Service) and storages that contain data (for example Azure Data Lake storage, Azure Cosmos DB analytical storage).
+1. **Region** - Pick the region where you have placed your client applications/services (for example, Azure Virtual Machine, Power BI, Azure Analysis Service) and storages that contain data (for example Azure Data Lake storage, Azure Cosmos DB analytical storage).
 
 > [!NOTE]
 > A workspace that is not co-located with the client applications or storage can be the root cause of many performance issues. If your data or the clients are placed in multiple regions, you can create separate workspaces in different regions co-located with your data and clients.
@@ -66,17 +66,17 @@ After your Azure Synapse workspace is created, you have two ways to open Synapse
 > To sign into your workspace, there are two **Account selection methods**. One is from **Azure subscription**, the other is from **Enter manually**. If you have the Synapse Azure role or higher level Azure roles, you can use both methods to log into the workspace. If you don't have the related Azure roles, and you were granted as the Synapse RBAC role, **Enter manually** is the only way to log into the workspace. To learn more about the Synapse RBAC, refer to [What is Synapse role-based access control (RBAC)](./security/synapse-workspace-synapse-rbac.md).
 
 ## Place sample data into the primary storage account
-We are going to use a small 100K row sample dataset of NYC Taxi Cab data for many examples in this getting started guide. We begin by placing it in the primary storage account you created for the workspace.
+We're going to use a small 100 K row sample dataset of NYC Taxi Cab data for many examples in this getting started guide. We begin by placing it in the primary storage account you created for the workspace.
 
-* Download the [NYC Taxi - green trip dataset](../open-datasets/dataset-taxi-green.md?tabs=azureml-opendatasets#additional-information) to your computer. Navigate to the [original dataset location](https://www.nyc.gov/site/tlc/about/tlc-trip-record-data.page) from the above link, choose a specific year and download the Green taxi trip records in Parquet format.
+* Download the [NYC Taxi - green trip dataset](../open-datasets/dataset-taxi-green.md?tabs=azureml-opendatasets#additional-information) to your computer. Navigate to the [original dataset location](https://www.nyc.gov/site/tlc/about/tlc-trip-record-data.page) from the link, choose a specific year and download the Green taxi trip records in Parquet format.
 * Rename the downloaded file to *NYCTripSmall.parquet*.
 * In Synapse Studio, navigate to the **Data** Hub.
 * Select **Linked**.
-* Under the category **Azure Data Lake Storage Gen2** you'll see an item with a name like **myworkspace ( Primary - contosolake )**.
+* Under the category Azure Data Lake Storage Gen2,** you'll see an item with a name like **myworkspace ( Primary - contosolake )**.
 * Select the container named **users (Primary)**.
 * Select **Upload** and select the `NYCTripSmall.parquet` file you downloaded.
 
-Once the parquet file is uploaded it is available through two equivalent URIs:
+Once the parquet file is uploaded, it's available through two equivalent URIs:
 * `https://contosolake.dfs.core.windows.net/users/NYCTripSmall.parquet` 
 * `abfss://[email protected]/NYCTripSmall.parquet`
 

articles/synapse-analytics/get-started-knowledge-center.md

@@ -1,8 +1,8 @@
 ---
 title: 'Tutorial: Get started explore the Synapse Knowledge center' 
 description: In this tutorial, you'll learn how to use the Synapse Knowledge center.
-author: saveenr
-ms.author: saveenr
+author: whhender
+ms.author: whhender
 ms.reviewer: sngun
 ms.service: synapse-analytics
 ms.subservice: workspace
@@ -18,14 +18,14 @@ In this tutorial, you'll learn how to use the Synapse Studio **Knowledge center*
 
 There are two ways of finding the **Knowledge center** in Synapse Studio:
 
-  1. In the Home hub, near the top-right of the page click on **Learn**.
-  2. In the menu bar at the top, click **?** and then **Knowledge center**.
+  1. In the Home hub, near the top-right of the page, select **Learn**.
+  2. In the menu bar at the top, select **?** and then **Knowledge center**.
 
 Pick either method and open the **Knowledge center**.
 
 ## Exploring the Knowledge center
 
-Once it is visible, you will see that the **Knowledge center** allows you to do three things:
+Once it's visible, you'll see that the **Knowledge center** allows you to do three things:
 * **Use samples immediately**. If you want a quick example of how Synapse works, choose this option.
 * **Browse gallery**. This option lets you link sample data sets and add sample code in the form of SQL scripts, notebooks, and pipelines.
 * **Tour Synapse Studio**. This option takes you on a brief tour of the basic parts of Synapse Studio. This is useful if you have never used Synapse Studio before.
@@ -37,23 +37,23 @@ There are three items in this section:
 * Query data with SQL
 * Create external table with SQL
 
-1. In the **Knowledge center**, click **Use samples immediately**.
+1. In the **Knowledge center**, select **Use samples immediately**.
 1. Select **Query data with SQL**.
-1. Click **Use sample**.
+1. Select **Use sample**.
 1. A new sample SQL script will open.
 1. Scroll to the first query (lines 28 to 32) and select the query text.
-1. Click Run. It will run only code you have selected.
+1. select Run. It will run only code you have selected.
 
 ## Gallery: A collection of sample datasets and sample code
 
-1. Go to the **Knowledge center**, click **Browse gallery**.
+1. Go to the **Knowledge center**, select **Browse gallery**.
 1. Select the **SQL scripts** tab at the top.
-1. Select **Load the New York Taxicab dataset** Data ingestion sample, click **Continue**.
+1. Select **Load the New York Taxicab dataset** Data ingestion sample, select **Continue**.
 1. Under **SQL pool**, choose **Select an existing pool** and select **SQLPOOL1**, and select the **SQLPOOL1** database you created earlier.
-1. Click **Open Script**.
+1. Select **Open Script**.
 1. A new sample SQL script will open.
-1. Click **Run**
-1. This will create several tables for all of the NYC Taxi data and load them using the T-SQL COPY command. If you had created these tables in the previous quick start steps, select and execute only code to CREATE and COPY for tables that do not exist.
+1. Select **Run**
+1. This will create several tables for all of the NYC Taxi data and load them using the T-SQL COPY command. If you had created these tables in the previous quick start steps, select and execute only code to CREATE and COPY for tables that don't exist.
 
     > [!NOTE] 
     > When using the sample gallery for SQL script with a dedicated SQL pool (formerly SQL DW), you will only be able to use an existing dedicated SQL pool (formerly SQL DW).

articles/synapse-analytics/get-started-monitor.md

@@ -1,8 +1,8 @@
 ---
 title: 'Tutorial: Get started with Azure Synapse Analytics - monitor your Synapse workspace'
 description: In this tutorial, you'll learn how to monitor activities in your Synapse workspace.
-author: saveenr
-ms.author: saveenr
+author: whhender
+ms.author: whhender
 ms.reviewer: sngun
 ms.service: synapse-analytics
 ms.subservice: monitoring

articles/synapse-analytics/get-started-pipelines.md

@@ -1,8 +1,8 @@
 ---
 title: 'Tutorial: Get started integrate with pipelines' 
 description: In this tutorial, you'll learn how to integrate pipelines and activities using Synapse Studio.
-author: saveenr
-ms.author: saveenr
+author: whhender
+ms.author: whhender
 ms.reviewer: sngun
 ms.service: synapse-analytics
 ms.subservice: pipeline