Skip to main content

Adding table calculations in the Explore view

๐Ÿง What are table calculations?โ€‹

Table calculations make it easy to create metrics on the fly (for example, aggregating the data in your table over some window, or getting a running total of a column). You add table calculations in the Explore view and they appear as green columns in your results table (remember, dimensions are blue, and metrics are orange).

Table calculations are built using raw SQL. That means you can use table calculations to build mathematical, True/False, text, and date-based calculations (basically, anything you can do in SQL, you can do in table calculations).

๐Ÿงฎ When to use table calculationsโ€‹

Typically, in your Lightdash project, you'll have one or more Tables that you've pre-defined in your dbt project (this is probably done by the data analysts/engineers/analytics engineers). But sometimes, you'll need particular logic which hasn't been defined as a dimension or metric in your dbt project - maybe because you have a new kind of question or use case.

This is when you might need a table calculation.

Watch out: table calculations can be easier to create than regular metrics/dimensions, but they are not as easy to manage. If you find yourself creating the same table calculation over and over again when you're using a Table, then it might be worth adding it in as a more permanent metric in your dbt project! You can read more about adding metrics to your dbt project here.

๐Ÿ›  Creating table calculationsโ€‹

1. Before you create a table calculation, you need to add some dimensions and/or metrics to your results table.โ€‹

Table calculations can only be built using the dimensions + metrics that you've included in your results table. So, to create a table calculation, first, you need to add the dimensions and/or metrics for your table calculation to your results table.

2. To add a table calculation just click on + Table calculation in the Results tabโ€‹

Once you've got some data in your results table, you can create a table calculation by clicking on the + Table calculation in the Results tab of the Explore view:

3. Write the SQL for your table calculation in the pop-up boxโ€‹

Your table calculation is defined using raw SQL that you write up in this pop up box. If you're not sure what to write here, you can check out some of our table calculation SQL templates.

To reference the metrics and dimensions in your results table, you can either use the autocomplete, or you can manually write the full field name using the format ${table_name.field_name}.

4. Once you've saved your new table calculation, hit run query to see the resultsโ€‹

Once you've created a new table calculation, you need to hit run query to see the values in your results table. And voilร !

5. To delete or edit your table calculation, just click on the gear icon by the field nameโ€‹

If you need to edit or delete a table calculation, you can just click on the gear icon beside the field and do what you need to do!

๐Ÿ“ Table calculation SQL templatesโ€‹

I'm not sure about you, but I definitely rely on copy-pasting old SQL code to write 90% of my new SQL queries. So, we thought it might be useful to give you some snippets of SQL code to help you get started with your most common table calculations.

You can check out our table calculation SQL templates here.