Building your data model

Now you have your BigQuery project and warehouse credentials, you’re going to set up your Dataform project using Dataform Web. In this step you'll create a project, connect your warehouse and build out your first dataset.

Create a Dataform project

To create a new project in Dataform:

1. Create a Dataform account here.

2. Follow the sign up flow:

   • We will ask you for a bit of information about yourself and what you’re hoping to achieve with Dataform.
   • As part of the sign up flow we will create a new project for you. Give it the name Dataform Tutorial .
   • If you already have an account, you can create a new project by going to the homepage and clicking New Project .

Connecting a warehouse

As part of the project creation flow you'll be asked to connect to a warehouse. You’re going to use the credentials you generated in the earlier part of this tutorial to connect:

1. On the Configure Warehouse modal click Connect .

2. Select Google BigQuery from the drop down menu.

3. Enter your Project ID.

   • This can be found by going to the BigQuery console and looking at the Project info box.

4. Browse for the service account key JSON file you created in the Setting Up part of this tutorial and upload it.

5. Check your connection is working:

   • Press Test Connection to check that the connection is working.
   • Once this is successful, you can press Save Connection .

Creating a dataset

Now that you've created your project and connected a warehouse, you're ready to start defining your data model.

1. Make sure you are in a development branch:

   • By default you should already be in a development branch called yourname_dev .
   • However, if you would like to create a new branch, click Develop and select New Branch .
   • Give your branch a name.

2. Create a new dataset:

   • Click on the New Dataset button in the left hand side bar.
   • Choose whether you want your dataset to be a table, view or incremental table. In this case we want to create a table.
   • Name the table order_stats and click Create Table .

3. Define the dataset:

   • To create your table use the below query which joins orders information from Shopify, payment details from Stripe and also applies some filters to the data:

1SELECT
2  orders.date AS order_date,
3  orders.id AS id,
4  orders.customer_id AS customer_id,
5  orders.status AS order_status,
6  charges.status AS payment_status,
7  charges.payment_method AS payment_method,
8  SUM(orders.item_count) AS item_count,
9  SUM(charges.amount) AS amount
10
11FROM
12  dataform-demos.dataform_tutorial.shopify_orders AS orders
13  LEFT JOIN dataform-demos.dataform_tutorial.stripe_payments AS charges
14    ON orders.payment_id = charges.id
15
16WHERE
17  orders.id <= 999
18  AND orders.item_count > 0
19  AND orders.status <> 'internal'
20  AND charges.payment_method IN ('debit_card', 'subscription', 'coupon')
21
22GROUP BY 1, 2, 3, 4, 5, 6

• Paste the query into order_stats.sqlx below the config block.
• Dataform will automatically validate your query and check for any errors
• Once you see that the query is valid you can click Preview Results to check that the data looks correct

3. Create the table in your warehouse:

   • Click Publish Table to create the table in your warehouse
   • This will take the SQLX that we’ve written, compile it into the SQL syntax of your warehouse (in this case, BigQuery), and then execute that SQL in your warehouse with the correct boilerplate code to create a table

4. Check Run Logs:

   • You can see the progress of the run in the header menu.
   • Once you see that it has been successful, you can view Run Logs by clicking on the hamburger menu in the top left hand corner.
   • In Run Logs you can see all the past runs in the project. You can see their status, as well as how and when they were triggered.
   • For each run you can see the exact SQL run against the warehouse to create your datasets by clicking the Details button.

You now have a new table called order_stats which has been created in your warehouse and you're ready to add to your data model!

For more detailed info on publishing datasets in Dataform, see our [docs].(https://docs.dataform.co/guides/datasets/publish)

Sitemap