Preview projects are temporary Lightdash projects where you can safely experiment with your metrics, dimensions and charts without affecting your production project.
+ Create Preview
.
Marketing Insights
.Marketing Insights
called Marketing Insights Preview
.Marketing Insights Preview
and shares it with Priyanka.Marketing Insights
, so her permissions were copied over to Marketing Insights Preview
.Marketing Insights
projectFinance private space
.Finance private space
Marketing Insights
called Preview Marketing Insights
Finance private space
will not be copied over to his preview project (because he doesn’t have access to it).profiles.yml
file.
That means that we will use the same default connection settings that you’re using locally for development, unless you specify different options in your CLI commands.
For example:
lightdash preview
will use the profiles.yml
file located at ~/.dbt/profiles.yml
. If you want to use a different profiles.yml
file, you can specify this using the option lightdash preview --profiles-dir path/to/directory
.lightdash preview
will use whatever default target that is set in your profiles.yml
file. The database connection settings (schema, project, dataset, etc.) from this target will be used as the database connection settings for your preview project. You can override the target used to create your preview project using the flag lightdash preview --target my-target-name
Lightdash Analytics
and I create a preview of that project called Preview Lightdash Analytics
Preview Lightdash Analytics
will have the same project connection settings (warehouse connection, dbt project connection, etc.) as Lightdash Analytics
.profiles.yml
file that you’ve specified to use in your GitHub action.
If you haven’t changed anything from our default GitHub action script, then the connection settings used for your preview project should be whatever you’ve specified in your DBT_PROFILES secret.
You have three options for setting up project connections in your GitHub Actions:
prod
target. You can follow the instructions here for your data warehousedev
profiles in your dbt project) so the connection changes depending on who opened the pull request. This is useful if you use different development schemas for team members developing in dbt.Lightdash Analytics
with a chart called Revenue by source
Preview Lightdash Analytics
Preview Lightdash Analytics
project has the same chart called Revenue by source
Revenue by source
chart in Lightdash Analytics
(i.e. in the production project)Revenue by source
chart in Preview Lightdash Analytics
is not updated. It is the same chart as when the preview project was first created.lightdash preview
to generate a preview project from your CLI, then hitting Enter
from your CLI should delete the preview project.
If you use the command lightdash start-preview
to generate a preview project from your CLI, then running the command lightdash stop-preview
should delete your preview project.
For more details on the lightdash preview
CLI command, check out the docs here.
project settings
, then clicking on all projects
in the sidebar under the organization settings
header.
You’ll see a list of all of the projects in your organization. You can switch to the preview projects
tab to filter to a list of preview projects in your organization.