Skip to content

Commit defb034

Browse files
authored
Merge pull request #594 from segmentio/repo-sync
repo sync
2 parents 97f7c36 + 10dd574 commit defb034

File tree

9 files changed

+140
-157
lines changed

9 files changed

+140
-157
lines changed

src/_data/catalog/destination_categories.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
# AUTOGENERATED FROM PUBLIC API. DO NOT EDIT
2-
# destination categories last updated 2022-09-22
2+
# destination categories last updated 2022-09-26
33
items:
44
- display_name: A/B Testing
55
slug: a-b-testing

src/_data/catalog/destinations.yml

Lines changed: 127 additions & 127 deletions
Large diffs are not rendered by default.

src/_data/catalog/regional-supported.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
# AUTOGENERATED LIST OF CONNECTIONS THAT SUPPORT REGIONAL
2-
# Last updated 2022-09-22
2+
# Last updated 2022-09-26
33
warehouses:
44
- id: WcjBCzUGff
55
display_name: Azure SQL Data Warehouse

src/_data/catalog/source_categories.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
# AUTOGENERATED FROM PUBLIC API. DO NOT EDIT
2-
# source cateogries last updated 2022-09-22
2+
# source cateogries last updated 2022-09-26
33
items:
44
- display_name: A/B Testing
55
slug: a-b-testing

src/_data/catalog/sources.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
# AUTOGENERATED FROM PUBLIC API. DO NOT EDIT
2-
# sources last updated 2022-09-22
2+
# sources last updated 2022-09-26
33
items:
44
- id: 8HWbgPTt3k
55
display_name: .NET

src/engage/audiences/computed-traits.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -207,9 +207,9 @@ You can read the [full Profile API docs](/docs/profiles/profile-api/) to learn m
207207
You can download a copy of your trait by visiting the the computed trait overview page.
208208
![Downloading a CSV file of computed traits in Segment](../images/trait_overview.png)
209209
Computed Trait CSVs are generated on demand. Before you can download the CSV, you will need to generate it. There are three different options for formatting:
210-
- **Unformatted:** Contains three columns. The first contains the user or account key, the second contains the trait value and the third is a JSON object containing the external IDs. Generating this CSV is by far the fastest of the three options. [Download example unformatted CSV](files/trait_csv_format_a.csv)
211-
- **Distinct columns for unique external IDs (with indexed columns for ID types with multiple values):** Contains the same first three columns as the unformatted CSV. Additional columns are added for each distinct external ID type. When a single row has more than one value for a given external ID type, for example a user with three email addresses, _additional columns with indexed headers are added_, (`email`, `email_1`, `email_2`). [Download example formatted CSV with indexed columns](files/trait_csv_format_b.csv)
212-
- **Distinct columns for unique external IDs (with additional rows for ID types with multiple values):** Contains the same first three columns as the unformatted CSV. Additional columns are added for each distinct external ID type. When a single row has more than one value for a given external ID type, for example a user with two email addresses, _additional rows are added with the first three columns repeated (user or account key, trait value and external IDs JSON)._ [Download example formatted CSV with additional rows](files/trait_csv_format_c.csv)
210+
- **Unformatted:** Contains three columns. The first contains the user or account key, the second contains the trait value and the third is a JSON object containing the external IDs. Generating this CSV is by far the fastest of the three options. [Download example unformatted CSV](/docs/engage/files/trait_csv_format_a.csv)
211+
- **Distinct columns for unique external IDs (with indexed columns for ID types with multiple values):** Contains the same first three columns as the unformatted CSV. Additional columns are added for each distinct external ID type. When a single row has more than one value for a given external ID type, for example a user with three email addresses, _additional columns with indexed headers are added_, (`email`, `email_1`, `email_2`). [Download example formatted CSV with indexed columns](/docs/engage/files/trait_csv_format_b.csv)
212+
- **Distinct columns for unique external IDs (with additional rows for ID types with multiple values):** Contains the same first three columns as the unformatted CSV. Additional columns are added for each distinct external ID type. When a single row has more than one value for a given external ID type, for example a user with two email addresses, _additional rows are added with the first three columns repeated (user or account key, trait value and external IDs JSON)._ [Download example formatted CSV with additional rows](/docs/engage/files/trait_csv_format_c.csv)
213213
<table>
214214
<tr>
215215
<td>![Handling large CSV file downloads](../images/large_trait_csv.png)</td>

src/engage/audiences/sql-traits.md

Lines changed: 6 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -84,38 +84,24 @@ To connect BigQuery to Segment SQL Traits, follow these instructions to create a
8484

8585
2. Click the drop down to the left of the search bar and select the project that you want to connect.
8686

87-
![Select a project to connect from the drop down menu](images/bigquery_setup1.png)
88-
8987
> **Note**: If you don't see the project you want in the menu, click the account switcher in the upper right corner, and verify that you're logged in to the right Google account for the project.
9088
9189
3. Click the menu in the upper left and select **IAM & Admin**, then **Service accounts**.
9290

93-
5. Click **Create Service Account**.
94-
95-
![Click Create Service Account on the Service accounts screen](images/bigquery_setup2.png)
96-
97-
6. Give the service account a name like `segment-sqltraits`.
98-
99-
7. Under **Project Role**, add _only_ the `BigQuery Data Viewer` and `BigQuery Job User` roles.
91+
4. Click **Create Service Account**.
10092

101-
![Select a project role](images/bigquery_setup3a.png)
93+
5. Give the service account a name like `segment-sqltraits`.
10294

103-
![Add the BigQuery Data Viewer and BigQuery Job User roles](images/bigquery_setup3b.png)
95+
6. Under **Project Role**, add _only_ the `BigQuery Data Viewer` and `BigQuery Job User` roles.
10496

10597
> IMPORTANT: Do not add any other roles to the service account. Adding other roles can prevent Segment from connecting to the account.
10698
107-
6. Click **Create Key**.
99+
7. Click **Create Key**.
108100

109-
![Click Create Key](images/bigquery_setup4.png)
110-
111-
7. Select `JSON` and click **Create**.
112-
113-
![Select Json and click Create](images/bigquery_setup5.png)
101+
8. Select `JSON` and click **Create**.
114102

115103
A file with the key is saved to your computer. Save this; you'll need it to set up the warehouse source in the next step.
116104

117-
![A file key saved to your computer](images/bigquery_setup6.png)
118-
119105
You're now ready to create a new BigQuery warehouse source, upload the JSON key you just downloaded, and complete the BigQuery setup.
120106

121107
### Step 2. Add the warehouse as a Source
@@ -219,7 +205,6 @@ Yes, Segment limits request sizes to a maximum of 16kb. Records larger than this
219205
### I'm getting a permissions error.
220206

221207
You might encounter a `permission denied for schema` error, like the following:
222-
![An example of a permission denied for schema error](images/troubleshoot1.png)
223208

224209
Segment usually displays this error because you're querying a schema and table that the current user cannot access. To check the table privileges for a specific grantee (user), view the credentials of the stored warehouse user.
225210

@@ -236,13 +221,11 @@ Learn more about granting permissions using the following links:
236221

237222
### I'm seeing a maximum columns error.
238223

239-
![An example of a maximum columns error](images/troubleshoot2.png)
240-
241224
Segment supports returning only 25 columns. [Contact Segment](https://segment.com/help/contact/){:target="_blank"} with a description of your use case if you need access to more than 25 columns.
242225

243226
### I'm seeing a duplicate `user_id` error.
244227

245-
![An example of a duplicate user_id error](images/troubleshoot3.png)
228+
![An example of a duplicate user_id error](../images/troubleshoot3.png)
246229

247230
Each query row must correspond to a unique user. Segment displays this error if it detects multiple rows with the same `user_id`. Use a `distinct` or `group by` statement to ensure that each row has a unique user_id.
248231

0 commit comments

Comments
 (0)