buster init
, buster generate
, or any command that relies on dbt metadata.
To onboard manually, follow these steps:
Manual Onboarding Steps
- Connect your data source in the Buster UI: You can do this at https://platform.buster.so/app/settings/datasources/add. For more detailed instructions on connecting data sources, please refer to our Data Sources Overview.
-
Build your
buster.yml
file: After connecting your data source, you’ll need to create and configure yourbuster.yml
file. -
Organize your project folders:
It’s recommended to create a folder for each database or schema. Each of these will be configured as a separate project for Buster to reference in the
buster.yml
file. - Create your Semantic Models: Within each project folder, you will need to create your Semantic Models. These models should align with the tables in your database or data warehouse.
-
Deploy your models:
Once your data source is connected and your
buster.yml
and semantic models are configured, you can parse and deploy your project. Use the following commands:
buster parse
and buster deploy
commands.
Example Project Structure
Here is an example of how you might structure your project:Example buster.yml
This buster.yml
file defines three projects, corresponding to the folders in the example structure above.
Example Semantic Models
Here are a couple of simplified semantic model examples that would reside in the respectivesemantic_models
folders.