Troubleshooting

If you run into any issues, we are available to help resolve them Monday - Saturday 9 am to 9 pm US Eastern time. You can get in touch with us via the “chat with us” button at the bottom right of this page and in our VSCode settings page. We are also available via our slack community.

Here are some common issues and potential ways to address them

Before onboarding

Issue	Steps to try
All Turntable views are blank and can’t open turntable settings or login	Restart VSCode, and open a new window with exactly 1 dbt project in it.

During onboarding

Issue Steps to try

Onboarding fails in the Runtime step - Make sure you have a Python interpreter set with version 3.9 - 3.11, or 3.9-10 for dbt 1.3
- Confirm you have installed the appropriate build tools for your operating system
- Make sure you have set the dbt core version and adapter in the Environment step

Onboarding fails during the dbt Project step - Make sure you’ve added your profile directory (if custom), not the path to the profiles.yml file
- Confirm you’ve added all environmental variables required by your project
- Inspect the logs for the dbt step. These are almost always the errors printed directly from the dbt core cli. Sometimes the issue can be resolved by making a change to the project (e.g. if a model fails to compile)

Issue	Steps to try
Onboarding fails in the `Runtime` step	- Make sure you have a Python interpreter set with version 3.9 - 3.11, or 3.9-10 for dbt 1.3 - Confirm you have installed the appropriate build tools for your operating system - Make sure you have set the dbt core version and adapter in the `Environment` step
Onboarding fails during the `dbt Project` step	- Make sure you’ve added your profile directory (if custom), not the path to the `profiles.yml` file - Confirm you’ve added all environmental variables required by your project - Inspect the logs for the dbt step. These are almost always the errors printed directly from the dbt core cli. Sometimes the issue can be resolved by making a change to the project (e.g. if a model fails to compile)

After onboarding

Issue	Steps to try
All Turntable views are blank or missing and you use Windows	- Disable Restricted UNC access by doing the following; - press command/control + shift + p to access the command pallette - type settings and press enter to access VSCode settings UI. - search for “Restrict UNC” - uncheck the box for `Restrict UNCAccess` - restart VSCode
Lineage only shows up partially or seems incomplete	- See this page for more information on the limitations of lineage and what to try.