Skip to content
Merged
Show file tree
Hide file tree
Changes from 5 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
36 changes: 18 additions & 18 deletions src/connections/storage/catalog/azuresqldw/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -56,24 +56,24 @@ To connect your Azure database to Segment, [give Segment access to your SQL Data
EXEC sp_set_firewall_rule N'<rule name>', '52.25.130.38', '52.25.130.38';
```

### Configure an Azure Synapse Analytics Destination in Segment

In order to set up the Azure Synapse Analytics destination in Segment, you'll need the following pieces of information:

- **Server Name:** the name of the SQL Server resource that houses your SQL Data Warehouse
- **Database:** the name of the SQL Data Warehouse database resource
- **Username:** the name of the user you created above
- **Password:** the password of the user you created above

To add a Azure Synapse Analytics destination in the Segment app:
1. Log in to Segment and select the **Connections** tab. Click **Add Destination**.
2. Select the **Storage Destinations** tab and click the **Azure SQL Data Warehouse** destination.
3. Select the source(s) you want to sync with the Azure SQL Data Warehouse destination, and click **Next**.
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`.
5. Click **Connect**.

> warning "Initial sync timeline"
> The first sync after you configure your Azure Synapse destination with Segment can take up to 24 hours to complete.
### Connect Azure to Segment

> info "Unified warehouse credentials in public beta"
> With unified warehouse credientials you can create warehouse credentials and use them across Segment warehouse products. Segment is actively working on this feature. Some functionality may change before it becomes generally available.

To connect Azure to Segment:
1. Navigate to your product area in the Segment app.
* For storage destinations, navigate to **Connections > Destinations** and select the **Storage** tab. Click **+ Add storage destination**.
* For Profiles Sync, navigate to **Unify > Profiles Sync**.
2. Select *Azure* as your warehouse.
3. Select an existing warehouse credential or create a new warehouse credential by completing the following fields for your Azure instance.
* **Server**: Your Azure dedicated SQL pool server.
* **Port**: The port used for connecting to your Azure dedicated SQL pool. The default port for Azure dedicated SQL pool is 1433, but your port may be different.
* **Database name**: The name of your Azure dedicated SQL pool that Segment uses in order to sync data.
* **Username**: The Azure user that Segment uses to run SQL in your warehouse.
* **Password**: The password of the user above.
4. Test your connection.
5. Click **Save**.

## Best Practices

Expand Down
28 changes: 15 additions & 13 deletions src/connections/storage/catalog/bigquery/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -47,19 +47,21 @@ The downloaded file will be used to create your warehouse in the Segment app.

If you have trouble creating a new service account, refer to [Google Cloud's documentation about service accounts](https://cloud.google.com/iam/docs/creating-managing-service-accounts){:target="_blank"} for more information.

### Create the Warehouse in Segment

To create the warehouse in Segment:
1. From the homepage of the Segment app, select **Connections > Add Destination** and search for **BigQuery**.
2. Click **BigQuery**.
3. Select the source(s) you'd like to sync with the BigQuery destination, and click **Next**.
3. Enter a name for your destination in the **Name your destination** field.
4. Enter your Project ID in the **Project ID** field.
<br/>*Optional:* Enter a [region code](https://cloud.google.com/compute/docs/regions-zones/){:target="_blank"} in the **Location** field (the default is *US*.)
5. Copy the contents of the JSON key that you created for the Segment service account into the **Credentials** field.
6. Click **Connect**.

If Segment is able to connect to your project, a warehouse will be created and your first sync will begin shortly.
### Connect BigQuery to Segment

> info "Unified warehouse credentials in public beta"
> With unified warehouse credientials you can create warehouse credentials and use them across Segment warehouse products. Segment is actively working on this feature. Some functionality may change before it becomes generally available.

1. Navigate to the product area in the Segment app.
* For Storage destinations, navigate to **Connections > Destinations** and select the **Storage**tab. Click **+ Add storage destination**.
* For Profiles Sync, navigate to **Unify > Profiles Sync**.
2. Select *BigQuery* as your warehouse.
3. Select an existing warehouse credential or create a new warehouse credential by completing the following fields for your BigQuery instance.
* **Project ID**: The Google Cloud project where your BigQuery database resides. Project IDs start with a letter and contain 6 – 63 lowercase letters, digits or dashes. Some project IDs also include domain name separated by a colon
* **Location**: The region where you want your BigQuery datasets to reside
* **Service account credentials**: The JSON credential that Segment will use to load data into your BigQuery database. Create a service account just for Segment to use
4. Test your connection.
5. Click **Save**.

## Schema

Expand Down
21 changes: 21 additions & 0 deletions src/connections/storage/catalog/databricks/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -43,6 +43,27 @@ Use the following steps to set up Databricks in Segment:
4. (Optional) Select a source(s) to connect to the destination.
5. Follow the steps below to [connect your Databricks warehouse](#connect-your-databricks-warehouse).

## Connect Databricks to Segment

> info "Unified warehouse credentials in public beta"
> With unified warehouse credientials you can create warehouse credentials and use them across Segment warehouse products. Segment is actively working on this feature. Some functionality may change before it becomes generally available.

To connect Databricks to Segment:

1. Navigate to your product area in the Segment app.
* For Storage destinations, navigate to **Connections > Destinations** and select the **Storage** tab. Click **+ Add storage destination**.
* For Profiles Sync, navigate to **Unify > Profiles Sync**.
2. Select *Databricks* as your warehouse.
3. Select an existing warehouse credential or create a new warehouse credential by completing the following fields for your Databricks instance:
* **Hostname**: URL of your Databricks server
* **HTTP path**: URL of your Databricks compute resources
* **Port**: The port used for connecting to your Databricks warehouse. The default port for Databricks is 443, but your port may be different
* **Unity Catalog name**: The catalog that Segment uses in order to sync data
* **Service principal client ID**: The client ID used for accessing your Databricks warehouse
* **Password**: The OAuth secret used to connect to your Databricks warehouse
4. Test your connection.
5. Click **Save**.

## Connect your Databricks warehouse

Use the five steps below to connect to your Databricks warehouse.
Expand Down
33 changes: 18 additions & 15 deletions src/connections/storage/catalog/db2/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -43,21 +43,24 @@ To grant the Segment user access to your database:
```
3. Click **Run All** to execute the `GRANT` command.

### Create Segment Db2 Destination

To set up an IBM Db2 destination in the Segment app:

1. Open the Segment app, navigate to **Connections** and click **Add Destination**.
2. Search for and select **IBM Db2 Warehouse**.
3. Select the sources you want to connect to the IBM Db2 warehouse, and click **Next**.
4. Enter a name for your destination, and enter the following credentials:
- Host (You can find this in your Db2 instance, under Administration > Connections)
- Port (50001 is the default for Db2)
- Database name (You can find this in your Db2 instance, under Administration > Connections)
- User (This is the User ID that you created above)
- Password (This is the password that you created above)
- Security ([Enter "SSL" in this field](#ssltls))
5. Click **Connect** to connect your Db2 warehouse to Segment.
### Connect IBM Db2 to Segment

> info "Unified warehouse credentials in public beta"
> With unified warehouse credientials you can create warehouse credentials and use them across Segment warehouse products. Segment is actively working on this feature. Some functionality may change before it becomes generally available.

To connect IBM Db2 to Segment:

1. Navigate to **Connections > Destinations** and select the **Storage** tab in the Segment app. Click **+Add storage destination**.
2. Select *IBM Db2* as your warehouse.
3. Select an existing warehouse credential or create a new warehouse credential by completing the following fields for your Db2 instance:
* **Hostname**: The Db2 hostname (You can find this in your Db2 instance, under Administration > Connections)
* **Port**: The port used for connecting to your Db2 warehouse. The default port for Db2 is 50001, but your port may be different
* **Database name**: The database that Segment uses in order to sync data (You can find this in your Db2 instance, under Administration > Connections)
* **Security**: Enter “SSL” in this field
* **Username**: The Db2 user that Segment uses to run SQL in your warehouse
* **Password**: The password of the user above
4. Test your connection.
5. Click **Save**.

## Security

Expand Down
20 changes: 20 additions & 0 deletions src/connections/storage/catalog/postgres/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -88,6 +88,26 @@ To create a new inbound rule:

8. Click **Save rules**.

## Connect Postgres to Segment

> info "Unified warehouse credentials in public beta"
> With unified warehouse credientials you can create warehouse credentials and use them across Segment warehouse products. Segment is actively working on this feature. Some functionality may change before it becomes generally available.

To connect Postgres to Segment:

1. Navigate to your product area in the Segment app:
* For Storage destinations, navigate to **Connections > Destinations** and select the **Storage** tab. Click **+ Add storage destination**.
* For Profiles Sync, navigate to **Unify > Profiles Sync**.
2. Select *Postgres* as your warehouse.
3. Select an existing warehouse credential or create a new warehouse credential by completing the following fields for your Postgres instance:
* **Hostname**: The Postgres hostname
* **Port**: The port used for connecting to your Postgres warehouse
* **Database name**: The database that Segment uses in order to sync data
* **Username**: The Postgres user that Segment uses to run SQL in your warehouse
* **Password**: The password of the user above
4. Test your connection.
5. Click **Save**.

## Sync schedule

{% include content/warehouse-sync-sched.md %}
Expand Down
23 changes: 17 additions & 6 deletions src/connections/storage/catalog/redshift/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -59,12 +59,23 @@ When you configure your warehouse in Segment, use the username/password you've c

## Connect Redshift to Segment

After creating a Redshift warehouse, the next step is to connect Segment:

1. In the Segment App, navigate to the Connections tab and click **Add Destination**
2. Search for and select `Redshift`
3. Add the necessary connection details, add your Redshift credentials
4. Select which sources and collections/properties will sync to this Warehouse
> info "Unified warehouse credentials in public beta"
> With unified warehouse credientials you can create warehouse credentials and use them across Segment warehouse products. Segment is actively working on this feature. Some functionality may change before it becomes generally available.

To connect Redshift to Segment:

1. Navigate to your product area in the Segment app:
* For Storage destinations, navigate to **Connections > Destinations** and select the **Storage** tab. Click **+ Add storage destination**.
* For Profiles Sync, navigate to **Unify > Profiles Sync**.
2. Select *Redshift* as your warehouse.
3. Select an existing warehouse credential or create a new warehouse credential by completing the following fields for your Redshift instance:
* **Hostname**: The Redshift URL
* **Port**: The port used for connecting to your Redshift warehouse
* **Database name**: The database that Segment uses in order to sync data
* **Username**: The Redshift user that Segment uses to run SQL in your warehouse
* **Password**: The password of the user above
4. Test your connection.
5. Click **Save**.

## Security

Expand Down
37 changes: 19 additions & 18 deletions src/connections/storage/catalog/snowflake/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -221,27 +221,28 @@ USE DATABASE "SEGMENT_EVENTS";

### Step 6: Connect Snowflake to Segment

After configuring your Snowflake resources, connect them to Segment.

1. In the Segment App, select Add Destination.
2. Search for and select "Snowflake".
3. Enter a name for your destination.
4. Enter your Snowflake credentials as follows:
- **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 be: `my-business.us-east-1.snowflakecomputing.com/` and your account-id would be: `my-business.us-east-1`)
- **Warehouse**: The name of the warehouse that you created in [Step 1: Create a virtual warehouse](#step-1-create-a-virtual-warehouse)
- **Database**: The database name that you created in [Step 2: Create database](#step-2-create-database)
- **Username**: The username that you created in [Step 4: Create a user for Segment](#step-4-create-user-for-segment)
- **Authentication method**: Select the authentication method that you used when creating a user in [Step 4: Create a user for Segment](#step-4-create-user-for-segment). You can select either Key pair or Password.

If you selected Key pair as your authentication method:
- **Private key**: Upload your private key (stored in .p8 format) that you created in [Step 4: Create a user for Segment](#step-4-create-user-for-segment)
- **Passphrase** _(Optional)_ : If you created an encrypted key, enter the passphrase you created in [Step 4: Create a user for Segment](#step-4-create-user-for-segment)
> info "Unified warehouse credentials in public beta"
> With unified warehouse credientials you can create warehouse credentials and use them across Segment warehouse products. Segment is actively working on this feature. Some functionality may change before it becomes generally available.

To connect Snowflake to Segment:

1. Navigate to your product area:
* For Storage destinations, navigate to **Connections > Destinations** and select the **Storage** tab. Click **+ Add storage destination**.
* For Profiles Sync, navigate to **Unify > Profiles Sync**.
2. Select *Snowflake* as your warehouse.
3. Select an existing warehouse credential or create a new warehouse credential by completing the following fields for your Snowflake instance.
* Account ID: The Snowflake account ID that uniquely identifies your organization account, including a region suffix if applicable.
* Database name: The database that Segment uses in order to sync data
* Warehouse: The warehouse in your Snowflake account that Segment uses to run SQL
* Username: The Snowflake user that Segment uses to run in your warehouse
* Authentication
* Private key: View Snowflake’s key pair set up doc.You can upload .p8 file format. Key length must be at least 2048-bit. An encrypted key is recommended but not required.
4. Test your connection.
5. Click **Save**.

> info "Segment supports uploading one key at a time"
> Although you can create up to two keys in Snowflake, Segment only supports authenticating with one key at a time. To change the key that is in Segment, return to your Snowflake destination's settings and upload a new key in the **Private Key** field.

If you selected Password as your authentication method:
- **Password**: The password that you set in [Step 4: Create a user for Segment](#step-4-create-user-for-segment)


## Security

Expand Down