Skip to content

Commit f7f8d1c

Browse files
committed
First pass of bigquery edits
1 parent 988e2f9 commit f7f8d1c

File tree

2 files changed

+15
-19
lines changed

2 files changed

+15
-19
lines changed

src/_includes/content/warehouse-sync-sched.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
Your data will be available in Warehouses between 24 and 48 hours from your first sync. Your warehouse then syncs once, or twice a day depending on your [Segment Plan](https://segment.com/pricing).
1+
Your data will be available in Warehouses between 24 and 48 hours from your first sync. Your warehouse then syncs once or twice a day depending on your [Segment Plan](https://segment.com/pricing).
22

33
Segment allows Business Tier (BT) customers to schedule the time and frequency of warehouse data syncs.
44

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

Lines changed: 14 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -16,10 +16,6 @@ process to pull raw events and objects and load them into your BigQuery cluster.
1616
Using BigQuery through Segment means you'll get a fully managed data pipeline
1717
loaded into one of the most powerful and cost-effective data warehouses today.
1818

19-
If you notice any gaps,
20-
out-dated information or want to leave some feedback to help us improve
21-
our documentation, [let us know](https://segment.com/help/contact)!
22-
2319
## Getting Started
2420

2521
First, you'll want to enable BigQuery for your Google Cloud project. Then, you
@@ -32,7 +28,7 @@ warehouse in Segment.
3228
2. Configure [Cloud Platform](https://console.cloud.google.com/):
3329
- If you don't have a project already, [create one](https://support.google.com/cloud/answer/6251787?hl=en&ref_topic=6158848).
3430
- If you have an existing project, you will need to [enable the BigQuery API](https://cloud.google.com/bigquery/quickstart-web-ui).
35-
Once you've done so, you should see BigQuery in the ["Resources" section](https://cl.ly/0W2i2I2B2R0M) of Cloud Platform.
31+
Once you've done so, you should see BigQuery in the "Resources" section of Cloud Platform.
3632
- **Note:** make sure [billing is enabled](https://support.google.com/cloud/answer/6293499#enable-billing) on your project,
3733
otherwise Segment will not be able to write into the cluster.
3834
3. Copy your project ID, as you will need it later.
@@ -56,11 +52,11 @@ The downloaded file will be used to create your warehouse in the next section.
5652
1. In Segment, go to **Workspace** > **Add destination** > Search for "BigQuery"
5753
2. Select **BigQuery**
5854
3. Enter your project ID in the **Project** field
59-
4. Copy the contents of the credentials (the JSON key) into the **Credentials** field
60-
5. (Optional) Enter a [region code](https://cloud.google.com/compute/docs/regions-zones/) in the **Location** field (the default will be "US")
55+
4. Copy the contents of the credentials (the JSON key) into the **Credentials** field <br/>
56+
**Optional:** Enter a [region code](https://cloud.google.com/compute/docs/regions-zones/) in the **Location** field (the default will be "US")
6157
6. Click **Connect**
62-
7. if Segment is able to successfully connect with the **Project ID** and **Credentials**,
63-
the warehouse will be created and your first sync should begin shortly
58+
7. if Segment is able to successfully connect with the provided **Project ID** and **Credentials**,
59+
a warehouse will be created and your first sync should begin shortly
6460

6561
### Schema
6662

@@ -108,17 +104,17 @@ from <project-id>.<source-name>.<collection-name>_view
108104

109105
For early customers using BigQuery with Segment, rather than providing Segment
110106
with credentials, access was granted to a shared Service Account
111-
(`[email protected]`). While convenient early
112-
adopters, this presents potential security risks that we would prefer to address
107+
(`[email protected]`). While convenient for early
108+
adopters, this presents potential security risks that Segment would prefer to address
113109
proactively.
114110

115-
Starting in **March 2019**, we're going to start requiring BigQuery customers to
116-
create their own Service Accounts and provide us with those credentials instead.
111+
As of **March 2019**, Segment requires BigQuery customers to
112+
create their own Service Accounts and provide the app with those credentials instead.
117113
In addition, any attempts to update warehouse connection settings will also
118114
require these credentials. This effectively deprecates the shared Service
119-
Account, and in the future it will be deactivated completely.
115+
Account.
120116

121-
In order to stay ahead of this, make sure to migrate your warehouse by following
117+
In order to stay ahead of this change, make sure to migrate your warehouse by following
122118
the instructions in the "Create a Service Account for Segment" section above.
123119
Then, head to your warehouse's connection settings and update with the
124120
**Credentials** you created along the way.
@@ -159,7 +155,7 @@ querying sub-sets of tables.
159155
Absolutely! You will just need to modify one of the references to 60 in the view
160156
definition to the number of days of your choosing.
161157

162-
We chose 60 days as it suits the needs for most of our customers. However,
158+
We chose 60 days as it suits the needs of most of our customers. However,
163159
you're welcome to update the definition of the view as long as the name stays
164160
the same.
165161

@@ -196,8 +192,8 @@ costs.
196192
You can connect to BigQuery using a BI tool like Mode or Looker, or query
197193
directly from the BigQuery console.
198194

199-
BigQuery now supports standard SQL, which you can enable using their query UI.
200-
This does not work with views, or with a query that utilizes table range
195+
BigQuery now supports standard SQL, which you can enable using their query UI.
196+
This does not work with views, or with a query that uses table range
201197
functions.
202198

203199
### Does Segment support streaming inserts?

0 commit comments

Comments
 (0)