Skip to content

Commit edb290a

Browse files
committed
Editing pass
1 parent cf2471c commit edb290a

File tree

1 file changed

+9
-8
lines changed
  • src/connections/storage/catalog/azuresqldw

1 file changed

+9
-8
lines changed

src/connections/storage/catalog/azuresqldw/index.md

Lines changed: 9 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -20,24 +20,25 @@ To connect your Azure database to Segment once you've provisioned your dedicated
2020

2121
### Give Segment access to your SQL Data Warehouse
2222

23-
1. Create a server login for Segment to use. This can be accomplished by running the following SQL command on your SQL Server's `master` database.
23+
1. Create a server login for Segment to use. This can be accomplished by running the following SQL command on your SQL Server's `master` database:
2424
```sql
2525
CREATE LOGIN Segment WITH PASSWORD = '<strong password>';
2626
```
2727

2828
2. Connect to your Azure database.
2929

30-
3. Segment uses Azure Blob Storage to hold data that is being loaded into Azure Synapse Analytics. In order to facilitate this, a `MASTER KEY` is needed in order for credentials that Segment saves to the database to be encrypted. If you are using your Azure Synapse Analytics instance for more than just a Segment integration, it is possible you already have a master key. Running the command more than once will not create a new master key.
30+
3. Segment uses Azure Blob Storage to hold data that is being loaded into Azure Synapse Analytics. In order to facilitate this, a `MASTER KEY` is needed in order for credentials that Segment saves to the database to be encrypted. If you are using your Azure Synapse Analytics instance for more than just a Segment integration, it is possible you already have a master key. Running the command more than once will not create a new master key.
31+
To create a master key, run the following command:
3132
```sql
3233
CREATE MASTER KEY;
3334
```
3435

35-
4. Create a new database user using the server login that was created previously:
36+
4. Create a new database user using the server login that you created in a previous step:
3637
```sql
3738
CREATE USER Segment FOR LOGIN Segment;
3839
```
3940

40-
5. This new user will need permissions to load data, and manage the resources it needs:
41+
5. This new user will need database-level permissions to load data and manage the resources it needs:
4142
```sql
4243
GRANT CONTROL TO Segment;
4344
```
@@ -55,15 +56,15 @@ To connect your Azure database to Segment once you've provisioned your dedicated
5556

5657
### Configure an Azure Synapse Analytics Destination in Segment
5758

58-
In order to set up the necessary destination in Segment, you'll need the following pieces of information:
59+
In order to set up the Azure Synapse Analytics destination in Segment, you'll need the following pieces of information:
5960

60-
- **Server Name:** the name of the SQL Server resource that houses your SQL Data Warehouse.
61+
- **Server Name:** the name of the SQL Server resource that houses your SQL Data Warehouse
6162
- **Database:** the name of the SQL Data Warehouse database resource
6263
- **Username:** the name of the user you created above
6364
- **Password:** the password of the user you created above
6465

6566
To add a Azure Synapse Analytics destination in the Segment app:
66-
1. Log in to Segment and select the **Connections** tab. Select **Add Destination**.
67+
1. Log in to Segment and select the **Connections** tab. Click **Add Destination**.
6768
2. Select the **Storage Destinations** tab and click the **Azure SQL Data Warehouse** destination.
6869
3. Select the source(s) you want to sync with the Azure SQL Data Warehouse destination, and click **Next**.
6970
4. Provide a name for your destination, and then enter data into each of the fields in the "Enter your Credentials" section. For the **Server Name** field, enter only the part of the server name prior to `.database.windows.net`.
@@ -86,4 +87,4 @@ Users with a Business Tier plan can enable Selective Sync for their Azure Synaps
8687

8788
### Segment is not able to connect to Azure Synapse Analytics
8889

89-
Make sure you configure a [server-level firewall rule](https://docs.microsoft.com/en-us/azure/sql-data-warehouse/create-data-warehouse-portal#create-a-server-level-firewall-rule){:target="_blank"} that allows connections from the [Segment IPs](/docs/connections/storage/warehouses/faq/#which-ips-should-i-allowlist).
90+
If you encounter this error, create a [server-level firewall rule](https://docs.microsoft.com/en-us/azure/sql-data-warehouse/create-data-warehouse-portal#create-a-server-level-firewall-rule){:target="_blank"} that allows connections from the [Segment IPs](/docs/connections/storage/warehouses/faq/#which-ips-should-i-allowlist).

0 commit comments

Comments
 (0)