Skip to content

Commit c0ab11f

Browse files
committed
Addressing Acrolinx feedback
1 parent 0efe15d commit c0ab11f

File tree

1 file changed

+15
-15
lines changed

1 file changed

+15
-15
lines changed

articles/synapse-analytics/sql/tutorial-load-data-using-entra-id.md

Lines changed: 15 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -11,35 +11,35 @@ ms.author: periclesrocha
1111
ms.reviewer: WilliamDAssafMSFT
1212
---
1313

14-
# Tutorial: load data using EntraID
14+
# Tutorial: load data using Entra ID
1515

1616
Applies to: Azure Synapse Analytics
1717

18-
This article explains how to create external tables using EntraID passthrough.
18+
This article explains how to create external tables using Entra ID passthrough.
1919

2020
## Prerequisites:
2121

22-
This tutorial requires the following resources to be in place:
22+
The following resources are required to complete this tutorial:
2323

2424
* An Azure Synapse Analytics workspace and a dedicated SQL Pool
2525

26-
## Give the EntraID account access to the storage account
26+
## Give the Entra ID account access to the storage account
2727

28-
This examples uses an EntraID account (or group) to authenticate to the source data.
28+
This example uses an Entra ID account (or group) to authenticate to the source data.
2929

30-
To enable access to data on ADLS Gen2 accounts, you need to give your EntraID account (or group) access to the source account. To grant the proper permissions, follow these steps:
30+
To enable access to data on Azure Data Lake Storage (ADLS) Gen2 accounts, you need to give your Entra ID account (or group) access to the source account. To grant the proper permissions, follow these steps:
3131

32-
1. In the Azure Portal, find your storage account.
32+
1. In the Azure portal, find your storage account.
3333
2. Select **Data storage -> Containers**, and navigate to the folder where the source data the external table needs access to is.
3434
3. Select **Access control (IAM)**.
3535
4. Select **Add -> Add role assignment**.
3636
5. In the list of job function roles, select **Storage Blob Data Reader** and select **Next**.
37-
6. In the Add role assignment page, select **+ Select members**. The Select members pane opens in the right-hand corner.
38-
7. Type the name of the desired EntraID account or group until it is displayed. Pick your desired EntraID account and chose **Select**.
39-
8. Back to the Add role assignment page, make sure the list of Members include your desired EntraID account. Once verified, select **Review + assign**.
37+
6. In the Add role assignment page, select **+ Select members**. The **Select members** pane opens in the right-hand corner.
38+
7. Type the name of the desired Entra ID account. When displayed, pick your desired Entra ID account and chose **Select**.
39+
8. In the the **Add role assignment** page, make sure the list of Members include your desired Entra ID account. Once verified, select **Review + assign**.
4040
9. In the confirmation page, review the changes and select **Review + assign**.
4141

42-
The EntraID account or group is now a member of the Storage Blob Data Reader role and has access to the source folder.
42+
The Entra ID account or group is now a member of the Storage Blob Data Reader role and has access to the source folder.
4343

4444
# Create the required database objects
4545

@@ -49,7 +49,7 @@ External tables require the following objects to be created:
4949
2. An external file format that defines the format of the source files.
5050
3. An external table definition that is used for queries.
5151

52-
To follow these steps, you will need to use the SQL editor in the Azure Synapse Workspace, or your preferred SQL client connected to your dedicated SQL Pool. Let’s look at these steps in detail.
52+
To follow these steps, you need to use the SQL editor in the Azure Synapse Workspace, or your preferred SQL client connected to your dedicated SQL Pool. Let’s look at these steps in detail.
5353

5454
### Create the external data source
5555

@@ -97,11 +97,11 @@ Where:
9797
9898
* \<FileFormatName> is the name you want to use for your external file format
9999
100-
In the example above, adjust parameters such as FIELD\_TERMINATOR, STRING\_DELIMITER, FIRST\_ROW and others as needed in accordance with your source data. For more formatting options and to learn more about EXTERNAL FILE FORMAT, visit <https://learn.microsoft.com/en-us/sql/t-sql/statements/create-external-file-format-transact-sql?view=azure-sqldw-latest&tabs=delimited>.
100+
In this example, adjust parameters such as FIELD_TERMINATOR, STRING_DELIMITER, FIRST_ROW and others as needed in accordance with your source data. For more formatting options and to learn more about EXTERNAL FILE FORMAT, visit <https://learn.microsoft.com/en-us/sql/t-sql/statements/create-external-file-format-transact-sql?view=azure-sqldw-latest&tabs=delimited>.
101101
102102
### Create the external table
103103
104-
Now that we’ve created all the necessary objects that hold the metadata to securely access external data, it is time to create the external table. To create the external table, use the following command:
104+
Now that the necessary objects that hold the metadata to securely access external data are created, it's time to create the external table. To create the external table, use the following command:
105105
106106
```sql
107107
-- Adjust the table name and columns to your desired name and external table schema
@@ -127,7 +127,7 @@ Where:
127127
128128
Make sure to adjust the table name and schema to the desired name and the schema of the data in your source files.
129129
130-
At this point, all the metadata required to access the external table has been created. To test your external table, use a simple query such as the one below:
130+
At this point, all the metadata required to access the external table are created. To test your external table, use a query such as the following one to validate your work:
131131
132132
```sql
133133
SELECT TOP 10 Col1, Col2 FROM <ExternalTableName>

0 commit comments

Comments
 (0)