Skip to content

Commit 32ee073

Browse files
author
markzegarelli
authored
Remove images from doc, vale edits (#3887)
1 parent 78810cc commit 32ee073

File tree

1 file changed

+10
-24
lines changed
  • src/connections/storage/catalog/snowflake

1 file changed

+10
-24
lines changed

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

Lines changed: 10 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ redirect_from:
99

1010
## Getting Started
1111

12-
There are six steps to get started using Snowflake with Segment. Make sure that you are running the commands in each step while logged in as an `ACCOUNTADMIN`, or an account that has `MANAGE GRANTS`. While we are using predefined user (`SEGMENT_USER`), role (`SEGMENT`), warehouse (`SEGMENT_WAREHOUSE`) and database (`SEGMENT_EVENTS`) names, you can use any names you like.
12+
There are six steps to get started using Snowflake with Segment. Make sure that you are running the commands in each step while logged in as an `ACCOUNTADMIN`, or an account that has `MANAGE GRANTS`. While Segment uses predefined user (`SEGMENT_USER`), role (`SEGMENT`), warehouse (`SEGMENT_WAREHOUSE`) and database (`SEGMENT_EVENTS`) names, you can use any names you like.
1313

1414
1. Create Virtual Warehouse
1515
2. Create Database
@@ -20,9 +20,7 @@ There are six steps to get started using Snowflake with Segment. Make sure that
2020

2121
### Create Virtual Warehouse
2222

23-
The Segment Snowflake destination requires a Snowflake [virtual warehouse](https://docs.snowflake.net/manuals/user-guide/warehouses.html) to load data in to. To avoid conflicts with other regular operations in your cluster, we recommend creating a new warehouse just for Segment loads, but this is not mandatory. An X-Small warehouse works for most customers when starting.
24-
25-
![](images/create_virtual_warehouse.png)
23+
The Segment Snowflake destination requires a Snowflake [virtual warehouse](https://docs.snowflake.net/manuals/user-guide/warehouses.html){:target="_blank"} to load data in to. To avoid conflicts with other regular operations in your cluster, Segment recommends that you create a new warehouse just for Segment loads, but this is not mandatory. An X-Small warehouse works for most customers when starting.
2624

2725
```sql
2826
CREATE WAREHOUSE "SEGMENT_WAREHOUSE"
@@ -38,8 +36,6 @@ Make sure `AUTO_SUSPEND` is set to ~10 minutes in the UI (or 600 if using SQL) a
3836

3937
The Segment Snowflake destination creates its own schemas and tables, so it's recommended to create a new database for this purpose to avoid name conflicts with existing data.
4038

41-
![](images/create_database.png)
42-
4339
```sql
4440
CREATE DATABASE "SEGMENT_EVENTS";
4541
```
@@ -48,7 +44,7 @@ CREATE DATABASE "SEGMENT_EVENTS";
4844

4945
You need to run these commands rather than creating a role with the "Create Role" dialog in the UI.
5046

51-
This role will be attached to Segment's user and it gives just enough permissions for loading data in your database. We recommend not reusing this role for other operations.
47+
This role will be attached to Segment's user and it gives just enough permissions for loading data in your database. Segment recommends that you not reuse this role for other operations.
5248

5349
1. Click on to Worksheets;
5450
2. Select SEGMENT_EVENTS under database objects
@@ -74,12 +70,6 @@ GRANT CREATE SCHEMA ON DATABASE "SEGMENT_EVENTS" TO ROLE "SEGMENT";
7470

7571
Finally, you need to create the user that will be connected to Segment. Be sure to use a strong, unique password.
7672

77-
![](images/create_user_1.png)
78-
79-
![](images/create_user_2.png)
80-
81-
![](images/create_user_3.png)
82-
8373
```sql
8474
CREATE USER "SEGMENT_USER"
8575
MUST_CHANGE_PASSWORD = FALSE
@@ -92,12 +82,11 @@ GRANT ROLE "SEGMENT" TO USER "SEGMENT_USER";
9282

9383
Before you continue, test and validate the new user and credentials. When you can run the following commands successfully, you can connect Snowflake to Segment.
9484

95-
We use [snowsql](https://docs.snowflake.net/manuals/user-guide/snowsql.html) to run these verification steps.
85+
Segment uses [snowsql](https://docs.snowflake.net/manuals/user-guide/snowsql.html){:target="_blank"} to run these verification steps.
9686
To install and verify your accounts:
9787

98-
1. Download [snowsql](https://docs.snowflake.net/manuals/user-guide/snowsql.html);
99-
100-
2. Open the Installer and follow instructions;
88+
1. Download [snowsql](https://docs.snowflake.net/manuals/user-guide/snowsql.html){:target="_blank"}
89+
2. Open the Installer and follow instructions
10190
3. Once the installation is complete, run the following command, replacing "account" and "user" with your Snowflake Account and username:
10291

10392
```
@@ -159,12 +148,10 @@ After creating a Snowflake warehouse, the next step is to connect Segment.
159148
3. Add your credentials as follows:
160149
- User - The user name (as created above).
161150
- Password - The password for the user.
162-
- Account - The account id of your cluster, not the url (e.g. url: `my-business.snowflakecomputing.com`, account-id: `my-business`. **Note:** If you are using Snowflake on AWS, the account id includes the region, for example your url might look like: `my-business.us-east-1.snowflakecomputing.com/` and your accound-id would be: `my-business.us-east-1`)
151+
- Account - The account id of your cluster, not the url (for example, url: `my-business.snowflakecomputing.com`, account-id: `my-business`. **Note:** If you are using Snowflake on AWS, the account id includes the region, for example your url might look like: `my-business.us-east-1.snowflakecomputing.com/` and your accound-id would be: `my-business.us-east-1`)
163152
- Database - The database name (as created above).
164153
- Warehouse - The warehouse name (as created above).
165154

166-
![](images/connect_snowflake.png)
167-
168155
## Security
169156

170157
### Whitelisting IPs
@@ -181,15 +168,14 @@ At this time, the Segment Snowflake destination is not compatible with Snowflake
181168

182169
Set `AUTO_SUSPEND` to ~10 minutes in the UI (or 600 if using SQL) to avoid credit consumption by the Segment syncing process.
183170

184-
![](images/auto_suspend.png)
185171

186172
### Auto Resume
187173

188-
If you enable the `AUTO_SUSPEND` feature, we recommend that you also enable `AUTO-RESUME`. This will ensure that your Snowflake warehouse automatically resumes when Segment loads data. Otherwise, Segment will not be able to load data unless you [manually resume your Snowflake warehouse](https://docs.snowflake.net/manuals/user-guide/warehouses-considerations.html#automating-warehouse-resumption).
174+
If you enable the `AUTO_SUSPEND` feature, Segment recommends that you also enable `AUTO-RESUME`. This will ensure that your Snowflake warehouse automatically resumes when Segment loads data. Otherwise, Segment will not be able to load data unless you [manually resume your Snowflake warehouse](https://docs.snowflake.net/manuals/user-guide/warehouses-considerations.html#automating-warehouse-resumption){:target="_blank"}.
189175

190176
### Unique Warehouse, Database, and Role
191177

192-
We strongly recommend creating a unique Warehouse, Database and Role for the Segment Snowflake connection to your Snowflake instance.
178+
Segment recommends creating a unique Warehouse, Database and Role for the Segment Snowflake connection to your Snowflake instance.
193179

194180
## Troubleshooting
195181

@@ -220,7 +206,7 @@ Most customers have the best luck starting with a X-Small instance.
220206
A `rollback` is issued at the end of each session to make sure there's no "in-flight" processes hanging out that could block other processes later.
221207

222208
### Does Segment use transactions for loading data?
223-
We don't open transactions explicitly because that would lock resources. However, if autocommit is enabled, each statement functions as it's own transaction, and a silent commit is issued after each.
209+
Segment doesn't open transactions explicitly because that would lock resources. However, if autocommit is enabled, each statement functions as it's own transaction, and a silent commit is issued after each.
224210

225211
### What privileges do I need to grant?
226212
You shouldn't need to grant any additional privileges. However, you may need to confirm that the USAGE privilege on those schemas is granted to the same role granted to the user connecting to Snowflake through data bricks.

0 commit comments

Comments
 (0)