From fcdb45d69e39ac56d4a090773939ce784b1c4dbc Mon Sep 17 00:00:00 2001 From: Natalie Fiann Date: Mon, 8 Jul 2024 09:54:13 +0100 Subject: [PATCH 001/160] Updating doc --- website/docs/guides/codespace-qs.md | 36 +++++++++++++++++++++++++---- 1 file changed, 32 insertions(+), 4 deletions(-) diff --git a/website/docs/guides/codespace-qs.md b/website/docs/guides/codespace-qs.md index 5f874661313..0cf446ca314 100644 --- a/website/docs/guides/codespace-qs.md +++ b/website/docs/guides/codespace-qs.md @@ -1,6 +1,8 @@ --- -title: Quickstart for dbt Core using GitHub Codespaces -id: codespace +title: Quickstart for dbt Core using DuckDB +id: DuckDB +description: "Learn to use dbt Core using DuckDB." +hoverSnippet: "Learn to use dbt Core using DuckDB." platform: 'dbt-core' icon: 'fa-github' level: 'Beginner' @@ -12,9 +14,33 @@ tags: ['dbt Core','Quickstart'] ## Introduction -In this quickstart guide, you’ll learn how to create a codespace and be able to execute the `dbt build` command from it in _less than 5 minutes_. +In this quickstart guide, you’ll learn how to install dbt Core for the use of DuckDB. + +We'll also touch on creating a codespace executing the `dbt build` command from it in _less than 5 minutes_. + + +### Installation + +Further down is a step-by-step explanation of the steps to install DuckDB + +On a Mac, copy & paste the following to your terminal (standalone or with an IDE like VS Code). +STEPS HERE + + +On Windows, use either Powershell or the command line prompt: + +Windows cmd.exe +STEPS HERE + + +Windows PowerShell +STEPS HERE + + + + + -dbt Labs provides a [GitHub Codespace](https://docs.github.com/en/codespaces/overview) template that you (and anyone else) can reuse to create a complete dbt environment with a working and runnable project. When you create the codespace, the [dev container](https://docs.github.com/en/codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/introduction-to-dev-containers) creates a fully functioning dbt environment, connects to a DuckDB database, and loads a year of data from our fictional Jaffle Shop café, which sells food and beverages in several US cities. The [README](https://github.com/dbt-labs/jaffle-shop-template#readme) for the Jaffle Shop template also provides instructions on how to do this, along with animated GIFs. ### Prerequisites @@ -29,6 +55,8 @@ dbt Labs provides a [GitHub Codespace](https://docs.github.com/en/codespaces/ove - [Schedule a job](/guides/manual-install?step=5) - Learn more with [dbt Learn courses](https://learn.getdbt.com) +dbt Labs provides a [GitHub Codespace](https://docs.github.com/en/codespaces/overview) template that you (and anyone else) can reuse to create a complete dbt environment with a working and runnable project. When you create the codespace, the [dev container](https://docs.github.com/en/codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/introduction-to-dev-containers) creates a fully functioning dbt environment, connects to a DuckDB database, and loads a year of data from our fictional Jaffle Shop café, which sells food and beverages in several US cities. The [README](https://github.com/dbt-labs/jaffle-shop-template#readme) for the Jaffle Shop template also provides instructions on how to do this, along with animated GIFs. + ## Create a codespace 1. Go to the `jaffle-shop-template` [repository](https://github.com/dbt-labs/jaffle-shop-template) after you log in to your GitHub account. From d99bbe8b59aeed5b7e66789279c640397d04e338 Mon Sep 17 00:00:00 2001 From: Natalie Fiann Date: Mon, 8 Jul 2024 11:16:25 +0100 Subject: [PATCH 002/160] Updating doc add steps to install duck DB --- website/docs/guides/codespace-qs.md | 41 ++++++++++++++++++++++++++--- 1 file changed, 38 insertions(+), 3 deletions(-) diff --git a/website/docs/guides/codespace-qs.md b/website/docs/guides/codespace-qs.md index 0cf446ca314..99b7782003e 100644 --- a/website/docs/guides/codespace-qs.md +++ b/website/docs/guides/codespace-qs.md @@ -24,18 +24,53 @@ We'll also touch on creating a codespace executing the `dbt build` command from Further down is a step-by-step explanation of the steps to install DuckDB On a Mac, copy & paste the following to your terminal (standalone or with an IDE like VS Code). -STEPS HERE +```shell +git clone https://github.com/dbt-labs/jaffle_shop_duckdb.git +cd jaffle_shop_duckdb +python3 -m venv venv +source venv/bin/activate +python3 -m pip install --upgrade pip +python3 -m pip install -r requirements.txt +source venv/bin/activate +dbt build +dbt docs generate +dbt docs serve +``` On Windows, use either Powershell or the command line prompt: Windows cmd.exe -STEPS HERE +```shell +git clone https://github.com/dbt-labs/docs-duckdb.git +cd docs-duckdb +python -m venv venv +venv\Scripts\activate.bat +python -m pip install --upgrade pip +python -m pip install -r requirements.txt +venv\Scripts\activate.bat +dbt deps +dbt build +dbt docs generate +dbt docs serve +``` Windows PowerShell -STEPS HERE +```shell +git clone https://github.com/dbt-labs/docs-duckdb.git — Clones the repo locally +cd docs-duckdb — Changes directory to the repo +python3 -m venv venv — Creates a Python virtual environment called "venv" +source venv/bin/activate — Activates the Pythong virtual environment +python3 -m pip install --upgrade pip — Ensures Pip is up to date +python3 -m pip install -r requirements.txt — Installs the programs and dependencies defined in the file +source venv/bin/activate — Ensures the virtual environment is activated +dbt deps — Installs dbt packages +dbt build — Seeds data to the Duckdb database and builds models and dependecies +dbt docs generate — Compiles the projects docs +dbt docs serve — Displays the docs in your open or default browser. +``` From 6c406b5382306917452554fa08499d60916319b5 Mon Sep 17 00:00:00 2001 From: Natalie Fiann Date: Tue, 9 Jul 2024 11:43:15 +0100 Subject: [PATCH 003/160] Added DuckDB logo --- website/static/img/icons/duckdb-seeklogo.svg | 1 + 1 file changed, 1 insertion(+) create mode 100644 website/static/img/icons/duckdb-seeklogo.svg diff --git a/website/static/img/icons/duckdb-seeklogo.svg b/website/static/img/icons/duckdb-seeklogo.svg new file mode 100644 index 00000000000..c6d5d2f0729 --- /dev/null +++ b/website/static/img/icons/duckdb-seeklogo.svg @@ -0,0 +1 @@ + \ No newline at end of file From daa366458ef2d6799d5301317253a82669c427ed Mon Sep 17 00:00:00 2001 From: Natalie Fiann Date: Tue, 9 Jul 2024 11:43:31 +0100 Subject: [PATCH 004/160] Added DuckDB logo --- website/static/img/icons/white/duckdb-seeklogo.svg | 1 + 1 file changed, 1 insertion(+) create mode 100644 website/static/img/icons/white/duckdb-seeklogo.svg diff --git a/website/static/img/icons/white/duckdb-seeklogo.svg b/website/static/img/icons/white/duckdb-seeklogo.svg new file mode 100644 index 00000000000..c6d5d2f0729 --- /dev/null +++ b/website/static/img/icons/white/duckdb-seeklogo.svg @@ -0,0 +1 @@ + \ No newline at end of file From dfd2d7db62e8959ddc46389d52ad07c0adc82b0f Mon Sep 17 00:00:00 2001 From: Natalie Fiann Date: Tue, 9 Jul 2024 11:43:51 +0100 Subject: [PATCH 005/160] Updated QS doc --- website/docs/guides/codespace-qs.md | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/website/docs/guides/codespace-qs.md b/website/docs/guides/codespace-qs.md index 99b7782003e..29e1cb4c1b3 100644 --- a/website/docs/guides/codespace-qs.md +++ b/website/docs/guides/codespace-qs.md @@ -72,6 +72,7 @@ dbt docs generate — Compiles the projects docs dbt docs serve — Displays the docs in your open or default browser. ``` +Fore more information on the setup of DuckDB, you can refer to [DuckDBsetup](/docs/core/connect-data-platform/duckdb-setup). @@ -79,19 +80,24 @@ dbt docs serve — Displays the docs in your open or default browser. ### Prerequisites -- To use the dbt command-line interface (CLI), it's important that you know some basics of the terminal. In particular, you should understand `cd`, `ls` , and `pwd` to navigate through the directory structure of your computer easily. +When using DuckDB with dbt Core, you'll need to use the dbt command-line interface (CLI). + +- It's important that you know some basics of the terminal. In particular, you should understand `cd`, `ls` , and `pwd` to navigate through the directory structure of your computer easily. - You have a [GitHub account](https://github.com/join). ## Related content +- [DuckDBsetup](/docs/core/connect-data-platform/duckdb-setup) - [Create a GitHub repository](/guides/manual-install?step=2) - [Build your first models](/guides/manual-install?step=3) - [Test and document your project](/guides/manual-install?step=4) - [Schedule a job](/guides/manual-install?step=5) - Learn more with [dbt Learn courses](https://learn.getdbt.com) + dbt Labs provides a [GitHub Codespace](https://docs.github.com/en/codespaces/overview) template that you (and anyone else) can reuse to create a complete dbt environment with a working and runnable project. When you create the codespace, the [dev container](https://docs.github.com/en/codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/introduction-to-dev-containers) creates a fully functioning dbt environment, connects to a DuckDB database, and loads a year of data from our fictional Jaffle Shop café, which sells food and beverages in several US cities. The [README](https://github.com/dbt-labs/jaffle-shop-template#readme) for the Jaffle Shop template also provides instructions on how to do this, along with animated GIFs. + ## Create a codespace 1. Go to the `jaffle-shop-template` [repository](https://github.com/dbt-labs/jaffle-shop-template) after you log in to your GitHub account. From 9e124e9bc3a5ee81a76187eaa8498cce9f8fd8a8 Mon Sep 17 00:00:00 2001 From: Natalie Fiann Date: Tue, 9 Jul 2024 14:12:14 +0100 Subject: [PATCH 006/160] Updated docs --- website/docs/guides/codespace-qs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/guides/codespace-qs.md b/website/docs/guides/codespace-qs.md index 29e1cb4c1b3..aacb6359703 100644 --- a/website/docs/guides/codespace-qs.md +++ b/website/docs/guides/codespace-qs.md @@ -4,7 +4,7 @@ id: DuckDB description: "Learn to use dbt Core using DuckDB." hoverSnippet: "Learn to use dbt Core using DuckDB." platform: 'dbt-core' -icon: 'fa-github' +icon: 'duckdb-seeklogo' level: 'Beginner' hide_table_of_contents: true tags: ['dbt Core','Quickstart'] From 82f1fab5ef779c986699c8cbfc648042cd0b7f12 Mon Sep 17 00:00:00 2001 From: Natalie Fiann Date: Mon, 15 Jul 2024 11:17:08 +0100 Subject: [PATCH 007/160] Updated doc with tabs, changed file name and added content --- website/docs/guides/duckdb-qs.md | 329 +++++++++++++++++++++++++++++++ 1 file changed, 329 insertions(+) create mode 100644 website/docs/guides/duckdb-qs.md diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md new file mode 100644 index 00000000000..9065b461157 --- /dev/null +++ b/website/docs/guides/duckdb-qs.md @@ -0,0 +1,329 @@ +--- +title: Quickstart for dbt Core using DuckDB +id: DuckDB +description: "Learn to use dbt Core using DuckDB." +hoverSnippet: "Learn to use dbt Core using DuckDB." +platform: 'dbt-core' +icon: 'duckdb-seeklogo' +level: 'Beginner' +hide_table_of_contents: true +tags: ['dbt Core','Quickstart'] +--- + +
+ +## Introduction + +In this quickstart guide, you’ll learn how to install dbt Core for the use of DuckDB. + +We'll also touch on creating a codespace executing the `dbt build` command from it in _less than 5 minutes_. + + +### What is DuckDB? + + + + + + + +DuckDB is an open-source database management system which is designed for analytical workloads. It is designed to provide fast and easy access to large datasets, making it well-suited for data analytics tasks. + +Here's a list of some of the main features of DuckDB: + +- In-Process Database: Unlike traditional databases that run as a separate server process, DuckDB runs within the host application process. This allows for tight integration and low-latency data access. + +- SQL Support: DuckDB supports standard SQL, making it accessible to users familiar with SQL syntax and enabling the use of complex queries for data analysis. + +- Columnar Storage: DuckDB uses a columnar storage format, which is efficient for analytical queries that often need to scan large amounts of data but only a few columns. This design improves performance for read-heavy operations. + +- OLAP (Online Analytical Processing) Focused: While traditional relational databases are optimized for OLTP (Online Transaction Processing) workloads, DuckDB is optimized for OLAP workloads, which involve complex queries and data analysis. + +- Embeddable: Being embeddable means DuckDB can be included as a library in applications, making it a good choice for scenarios where a lightweight, high-performance database is needed without the overhead of a separate database server. + +- Cross-Platform: DuckDB works on multiple operating systems, including Windows, macOS, and Linux. + +- Easy Integration: It can be easily integrated with other data processing tools and environments, such as Python, R, and various data science and machine learning frameworks. + +- No External Dependencies: DuckDB does not rely on external services or infrastructure, making it easy to deploy and use in a wide range of environments. + + + + + + +dbt Labs provides a [GitHub Codespace](https://docs.github.com/en/codespaces/overview) template that you (and anyone else) can reuse to create a complete dbt environment with a working and runnable project. When you create the codespace, the [dev container](https://docs.github.com/en/codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/introduction-to-dev-containers) creates a fully functioning dbt environment, connects to a DuckDB database, and loads a year of data from our fictional Jaffle Shop café, which sells food and beverages in several US cities. The [README](https://github.com/dbt-labs/jaffle-shop-template#readme) for the Jaffle Shop template also provides instructions on how to do this, along with animated GIFs. + + + + + + + +## Install DuckDB + +Further down is a step-by-step explanation of the steps to install DuckDB + + +### Prerequisites + +When using DuckDB with dbt Core, you'll need to use the dbt command-line interface (CLI). + +- It's important that you know some basics of the terminal. In particular, you should understand `cd`, `ls` , and `pwd` to navigate through the directory structure of your computer easily. +- You have a [GitHub account](https://github.com/join). + + + +On a Mac, copy & paste the following to your terminal (standalone or with an IDE like VS Code). + +```shell +git clone https://github.com/dbt-labs/jaffle_shop_duckdb.git +cd jaffle_shop_duckdb +python3 -m venv venv +source venv/bin/activate +python3 -m pip install --upgrade pip +python3 -m pip install -r requirements.txt +source venv/bin/activate +dbt build +dbt docs generate +dbt docs serve +``` + +On Windows, use either Powershell or the command line prompt: + +Windows cmd.exe + +```shell +git clone https://github.com/dbt-labs/docs-duckdb.git +cd docs-duckdb +python -m venv venv +venv\Scripts\activate.bat +python -m pip install --upgrade pip +python -m pip install -r requirements.txt +venv\Scripts\activate.bat +dbt deps +dbt build +dbt docs generate +dbt docs serve +``` + +Windows PowerShell + +```shell +git clone https://github.com/dbt-labs/docs-duckdb.git — Clones the repo locally +cd docs-duckdb — Changes directory to the repo +python3 -m venv venv — Creates a Python virtual environment called "venv" +source venv/bin/activate — Activates the Pythong virtual environment +python3 -m pip install --upgrade pip — Ensures Pip is up to date +python3 -m pip install -r requirements.txt — Installs the programs and dependencies defined in the file +source venv/bin/activate — Ensures the virtual environment is activated +dbt deps — Installs dbt packages +dbt build — Seeds data to the Duckdb database and builds models and dependecies +dbt docs generate — Compiles the projects docs +dbt docs serve — Displays the docs in your open or default browser. +``` + +Fore more information on the setup of DuckDB, you can refer to [DuckDBsetup](/docs/core/connect-data-platform/duckdb-setup). + + +:::info DuckDB Support + +Currently, DuckDB is not supported in dbt Cloud. + +::: + + +## Related content + +- [DuckDBsetup](/docs/core/connect-data-platform/duckdb-setup) +- [Create a GitHub repository](/guides/manual-install?step=2) +- [Build your first models](/guides/manual-install?step=3) +- [Test and document your project](/guides/manual-install?step=4) +- [Schedule a job](/guides/manual-install?step=5) +- Learn more with [dbt Learn courses](https://learn.getdbt.com) + + + +## Setting up DuckDB for dbt Core + + +Below you'll find a step by step guide on getting up and running with this project. + + + + + + +1. First, you'll need to clone this repository. + +2. Change into the docs-duckdb directory from the command line: + +```Jinja + +cd docs-duckdb + +``` + +3. Install dbt and DuckDB in a virtual environment. + +If you're using MAC, you can copy and paste the below: + +```Jinja + +python3 -m venv venv +source venv/bin/activate +python3 -m pip install --upgrade pip +python3 -m pip install -r requirements.txt +source venv/bin/activate + +``` + +Windows cmd.exe + +```Jinja + +python -m venv venv +venv\Scripts\activate.bat +python -m pip install --upgrade pip +python -m pip install -r requirements.txt +venv\Scripts\activate.bat + +``` + +Windows PowerShell + +```Jinja + +python -m venv venv +venv\Scripts\Activate.ps1 +python -m pip install --upgrade pip +python -m pip install -r requirements.txt +venv\Scripts\Activate.ps1 + +``` + +4. Ensure your profile is setup correctly from the command line: + +```Jinja + +dbt --version +dbt debug + +``` + +5. Load the CSVs with the demo data set, run the models, and test the output of the models using the dbt build command: + +```Jinja + +dbt build + +``` + +6. Generate and view the documentation for the project: + +```Jinja + +dbt docs generate +dbt docs serve + +``` + +### Running build steps independently + +1. Load the CSVs with the demo data set. This materializes the CSVs as tables in your target schema. Note that a typical dbt project does not require this step since dbt assumes your raw data is already in your warehouse. + +```Jinja + +dbt seed + +``` +2. Run the models: + +```Jinja + +dbt run + +``` + +:::note Note. + +NOTE: If you decide to run this project in your own data warehouse (outside of this DuckDB demo) and steps fail, it might mean that you need to make small changes to the SQL in the models folder to adjust for the flavor of SQL of your target database. Definitely consider this if you are using a community-contributed adapter. + +::: + +3. Test the output of the models using the test command: + +```Jinja + +dbt test + +``` + +### Troubleshooting + +You may get an error like the one in the example below, in which case you will need to disconnect from any sessions that are locking the database: + +```Jinja + +IO Error: Could not set lock on file "jaffle_shop.duckdb": Resource temporarily unavailable + +``` + +This is a known issue in DuckDB. If you are using DBeaver, this means shutting down DBeaver (merely disconnecting didn't work for me). + +As a last esort, deleting the database file will get you back in action (BUT you will lose all your data). + + + + + + +1. Go to the `jaffle-shop-template` [repository](https://github.com/dbt-labs/jaffle-shop-template) after you log in to your GitHub account. +1. Click **Use this template** at the top of the page and choose **Create new repository**. +1. Click **Create repository from template** when you’re done setting the options for your new repository. +1. Click **Code** (at the top of the new repository’s page). Under the **Codespaces** tab, choose **Create codespace on main**. Depending on how you've configured your computer's settings, this either opens a new browser tab with the Codespace development environment with VSCode running in it or opens a new VSCode window with the codespace in it. +1. Wait for the codespace to finish building by waiting for the `postCreateCommand` command to complete; this can take several minutes: + + + + When this command completes, you can start using the codespace development environment. The terminal the command ran in will close and you will get a prompt in a brand new terminal. + +1. At the terminal's prompt, you can execute any dbt command you want. For example: + + ```shell + /workspaces/test (main) $ dbt build + ``` + + You can also use the [duckcli](https://github.com/dbcli/duckcli) to write SQL against the warehouse from the command line or build reports in the [Evidence](https://evidence.dev/) project provided in the `reports` directory. + + For complete information, refer to the [dbt command reference](https://docs.getdbt.com/reference/dbt-commands). Common commands are: + + - [dbt compile](https://docs.getdbt.com/reference/commands/compile) — generates executable SQL from your project source files + - [dbt run](https://docs.getdbt.com/reference/commands/run) — compiles and runs your project + - [dbt test](https://docs.getdbt.com/reference/commands/test) — compiles and tests your project + - [dbt build](https://docs.getdbt.com/reference/commands/build) — compiles, runs, and tests your project + + + + + + +## Generate a larger data set + +If you'd like to work with a larger selection of Jaffle Shop data, you can generate an arbitrary number of years of fictitious data from within your codespace. + +1. Install the Python package called [jafgen](https://pypi.org/project/jafgen/). At the terminal's prompt, run: + + ```shell + /workspaces/test (main) $ python -m pip install jafgen + ``` + +1. When installation is done, run: + ```shell + /workspaces/test (main) $ jafgen --years NUMBER_OF_YEARS + ``` + Replace `NUMBER_OF_YEARS` with the number of years you want to simulate. This command builds the CSV files and stores them in the `jaffle-data` folder, and is automatically sourced based on the `sources.yml` file and the [dbt-duckdb](/docs/core/connect-data-platform/duckdb-setup) adapter. + +As you increase the number of years, it takes exponentially more time to generate the data because the Jaffle Shop stores grow in size and number. For a good balance of data size and time to build, dbt Labs suggests a maximum of 6 years. + +
\ No newline at end of file From b5e9e4edeb2ba2fb7bf59a0e73c1fc0c31fbc6ab Mon Sep 17 00:00:00 2001 From: Natalie Fiann Date: Mon, 15 Jul 2024 11:17:50 +0100 Subject: [PATCH 008/160] Updated file name to duckdb-qs --- website/docs/guides/codespace-qs.md | 146 ---------------------------- 1 file changed, 146 deletions(-) delete mode 100644 website/docs/guides/codespace-qs.md diff --git a/website/docs/guides/codespace-qs.md b/website/docs/guides/codespace-qs.md deleted file mode 100644 index aacb6359703..00000000000 --- a/website/docs/guides/codespace-qs.md +++ /dev/null @@ -1,146 +0,0 @@ ---- -title: Quickstart for dbt Core using DuckDB -id: DuckDB -description: "Learn to use dbt Core using DuckDB." -hoverSnippet: "Learn to use dbt Core using DuckDB." -platform: 'dbt-core' -icon: 'duckdb-seeklogo' -level: 'Beginner' -hide_table_of_contents: true -tags: ['dbt Core','Quickstart'] ---- - -
- -## Introduction - -In this quickstart guide, you’ll learn how to install dbt Core for the use of DuckDB. - -We'll also touch on creating a codespace executing the `dbt build` command from it in _less than 5 minutes_. - - -### Installation - -Further down is a step-by-step explanation of the steps to install DuckDB - -On a Mac, copy & paste the following to your terminal (standalone or with an IDE like VS Code). - -```shell -git clone https://github.com/dbt-labs/jaffle_shop_duckdb.git -cd jaffle_shop_duckdb -python3 -m venv venv -source venv/bin/activate -python3 -m pip install --upgrade pip -python3 -m pip install -r requirements.txt -source venv/bin/activate -dbt build -dbt docs generate -dbt docs serve -``` - -On Windows, use either Powershell or the command line prompt: - -Windows cmd.exe - -```shell -git clone https://github.com/dbt-labs/docs-duckdb.git -cd docs-duckdb -python -m venv venv -venv\Scripts\activate.bat -python -m pip install --upgrade pip -python -m pip install -r requirements.txt -venv\Scripts\activate.bat -dbt deps -dbt build -dbt docs generate -dbt docs serve -``` - -Windows PowerShell - -```shell -git clone https://github.com/dbt-labs/docs-duckdb.git — Clones the repo locally -cd docs-duckdb — Changes directory to the repo -python3 -m venv venv — Creates a Python virtual environment called "venv" -source venv/bin/activate — Activates the Pythong virtual environment -python3 -m pip install --upgrade pip — Ensures Pip is up to date -python3 -m pip install -r requirements.txt — Installs the programs and dependencies defined in the file -source venv/bin/activate — Ensures the virtual environment is activated -dbt deps — Installs dbt packages -dbt build — Seeds data to the Duckdb database and builds models and dependecies -dbt docs generate — Compiles the projects docs -dbt docs serve — Displays the docs in your open or default browser. -``` - -Fore more information on the setup of DuckDB, you can refer to [DuckDBsetup](/docs/core/connect-data-platform/duckdb-setup). - - - - - -### Prerequisites - -When using DuckDB with dbt Core, you'll need to use the dbt command-line interface (CLI). - -- It's important that you know some basics of the terminal. In particular, you should understand `cd`, `ls` , and `pwd` to navigate through the directory structure of your computer easily. -- You have a [GitHub account](https://github.com/join). - -## Related content - -- [DuckDBsetup](/docs/core/connect-data-platform/duckdb-setup) -- [Create a GitHub repository](/guides/manual-install?step=2) -- [Build your first models](/guides/manual-install?step=3) -- [Test and document your project](/guides/manual-install?step=4) -- [Schedule a job](/guides/manual-install?step=5) -- Learn more with [dbt Learn courses](https://learn.getdbt.com) - - -dbt Labs provides a [GitHub Codespace](https://docs.github.com/en/codespaces/overview) template that you (and anyone else) can reuse to create a complete dbt environment with a working and runnable project. When you create the codespace, the [dev container](https://docs.github.com/en/codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/introduction-to-dev-containers) creates a fully functioning dbt environment, connects to a DuckDB database, and loads a year of data from our fictional Jaffle Shop café, which sells food and beverages in several US cities. The [README](https://github.com/dbt-labs/jaffle-shop-template#readme) for the Jaffle Shop template also provides instructions on how to do this, along with animated GIFs. - - -## Create a codespace - -1. Go to the `jaffle-shop-template` [repository](https://github.com/dbt-labs/jaffle-shop-template) after you log in to your GitHub account. -1. Click **Use this template** at the top of the page and choose **Create new repository**. -1. Click **Create repository from template** when you’re done setting the options for your new repository. -1. Click **Code** (at the top of the new repository’s page). Under the **Codespaces** tab, choose **Create codespace on main**. Depending on how you've configured your computer's settings, this either opens a new browser tab with the Codespace development environment with VSCode running in it or opens a new VSCode window with the codespace in it. -1. Wait for the codespace to finish building by waiting for the `postCreateCommand` command to complete; this can take several minutes: - - - - When this command completes, you can start using the codespace development environment. The terminal the command ran in will close and you will get a prompt in a brand new terminal. - -1. At the terminal's prompt, you can execute any dbt command you want. For example: - - ```shell - /workspaces/test (main) $ dbt build - ``` - - You can also use the [duckcli](https://github.com/dbcli/duckcli) to write SQL against the warehouse from the command line or build reports in the [Evidence](https://evidence.dev/) project provided in the `reports` directory. - - For complete information, refer to the [dbt command reference](https://docs.getdbt.com/reference/dbt-commands). Common commands are: - - - [dbt compile](https://docs.getdbt.com/reference/commands/compile) — generates executable SQL from your project source files - - [dbt run](https://docs.getdbt.com/reference/commands/run) — compiles and runs your project - - [dbt test](https://docs.getdbt.com/reference/commands/test) — compiles and tests your project - - [dbt build](https://docs.getdbt.com/reference/commands/build) — compiles, runs, and tests your project - -## Generate a larger data set - -If you'd like to work with a larger selection of Jaffle Shop data, you can generate an arbitrary number of years of fictitious data from within your codespace. - -1. Install the Python package called [jafgen](https://pypi.org/project/jafgen/). At the terminal's prompt, run: - - ```shell - /workspaces/test (main) $ python -m pip install jafgen - ``` - -1. When installation is done, run: - ```shell - /workspaces/test (main) $ jafgen --years NUMBER_OF_YEARS - ``` - Replace `NUMBER_OF_YEARS` with the number of years you want to simulate. This command builds the CSV files and stores them in the `jaffle-data` folder, and is automatically sourced based on the `sources.yml` file and the [dbt-duckdb](/docs/core/connect-data-platform/duckdb-setup) adapter. - -As you increase the number of years, it takes exponentially more time to generate the data because the Jaffle Shop stores grow in size and number. For a good balance of data size and time to build, dbt Labs suggests a maximum of 6 years. - -
\ No newline at end of file From b5f877e8bea2c69b21ddc3ecd450c0075bed4e1d Mon Sep 17 00:00:00 2001 From: Natalie Fiann Date: Mon, 15 Jul 2024 13:37:35 +0100 Subject: [PATCH 009/160] Corrected grammar and punctuation --- website/docs/guides/duckdb-qs.md | 27 +++++++++++++-------------- 1 file changed, 13 insertions(+), 14 deletions(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 9065b461157..a88d76533b5 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -60,9 +60,19 @@ dbt Labs provides a [GitHub Codespace](https://docs.github.com/en/codespaces/ove +## Related content + +- [DuckDBsetup](/docs/core/connect-data-platform/duckdb-setup) +- [Create a GitHub repository](/guides/manual-install?step=2) +- [Build your first models](/guides/manual-install?step=3) +- [Test and document your project](/guides/manual-install?step=4) +- [Schedule a job](/guides/manual-install?step=5) +- Learn more with [dbt Learn courses](https://learn.getdbt.com) + + ## Install DuckDB -Further down is a step-by-step explanation of the steps to install DuckDB +Further down is a step-by-step explanation of the steps to install DuckDB. ### Prerequisites @@ -133,17 +143,6 @@ Currently, DuckDB is not supported in dbt Cloud. ::: -## Related content - -- [DuckDBsetup](/docs/core/connect-data-platform/duckdb-setup) -- [Create a GitHub repository](/guides/manual-install?step=2) -- [Build your first models](/guides/manual-install?step=3) -- [Test and document your project](/guides/manual-install?step=4) -- [Schedule a job](/guides/manual-install?step=5) -- Learn more with [dbt Learn courses](https://learn.getdbt.com) - - - ## Setting up DuckDB for dbt Core @@ -269,9 +268,9 @@ IO Error: Could not set lock on file "jaffle_shop.duckdb": Resource temporarily ``` -This is a known issue in DuckDB. If you are using DBeaver, this means shutting down DBeaver (merely disconnecting didn't work for me). +This is a known issue in DuckDB. If you are using DBeaver, this means shutting down DBeaver (disconnecting doesn't always work). -As a last esort, deleting the database file will get you back in action (BUT you will lose all your data). +As a last resort, deleting the database file will get you back in action (_BUT_ you will lose all your data). From 8e87af07d3d41fa1f3f0486ffc5dcad8fee4e22a Mon Sep 17 00:00:00 2001 From: Natalie Fiann Date: Mon, 15 Jul 2024 14:27:32 +0100 Subject: [PATCH 010/160] Added redirects --- website/vercel.json | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/website/vercel.json b/website/vercel.json index 706525b0f14..de5a98c5772 100644 --- a/website/vercel.json +++ b/website/vercel.json @@ -2,6 +2,26 @@ "cleanUrls": true, "trailingSlash": false, "redirects": [ + { + "source": "/guides/codespace?step=4", + "destination": "/guides/DuckDB?step=5", + "permanent": true + }, + { + "source": "/guides/codespace?step=3", + "destination": "/guides/DuckDB?step=3", + "permanent": true + }, + { + "source": "/guides/codespace?step=2", + "destination": "/guides/DuckDB?step=2", + "permanent": true + }, + { + "source": "/guides/codespace?step=1", + "destination": "/guides/DuckDB?step=1", + "permanent": true + }, { "source": "/best-practices/how-we-mesh/mesh-4-faqs", "destination": "/best-practices/how-we-mesh/mesh-5-faqs", From b93d5a7d4a184f11993afc82d1ae371b93fd85cd Mon Sep 17 00:00:00 2001 From: Ly Nguyen Date: Tue, 16 Jul 2024 16:10:45 -0700 Subject: [PATCH 011/160] Fix build error --- website/docs/docs/get-started-dbt.md | 2 +- website/vercel.json | 8 ++++---- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/website/docs/docs/get-started-dbt.md b/website/docs/docs/get-started-dbt.md index b040fb2bb24..df71a1d5b4d 100644 --- a/website/docs/docs/get-started-dbt.md +++ b/website/docs/docs/get-started-dbt.md @@ -73,7 +73,7 @@ Learn more about [dbt Cloud features](/docs/cloud/about-cloud/dbt-cloud-feature Refer to the following quickstarts to get started with dbt Core: - [dbt Core from a manual install](/guides/manual-install) to learn how to install dbt Core and set up a project. -- [dbt Core using GitHub Codespace](/guides/codespace?step=1) to learn how to create a codespace and execute the `dbt build` command. +- [dbt Core using GitHub Codespace](/guides/DuckDB?step=1) to learn how to create a codespace and execute the `dbt build` command. ## Related docs diff --git a/website/vercel.json b/website/vercel.json index de5a98c5772..0729bc16c15 100644 --- a/website/vercel.json +++ b/website/vercel.json @@ -6,22 +6,22 @@ "source": "/guides/codespace?step=4", "destination": "/guides/DuckDB?step=5", "permanent": true - }, + }, { "source": "/guides/codespace?step=3", "destination": "/guides/DuckDB?step=3", "permanent": true - }, + }, { "source": "/guides/codespace?step=2", "destination": "/guides/DuckDB?step=2", "permanent": true - }, + }, { "source": "/guides/codespace?step=1", "destination": "/guides/DuckDB?step=1", "permanent": true - }, + }, { "source": "/best-practices/how-we-mesh/mesh-4-faqs", "destination": "/best-practices/how-we-mesh/mesh-5-faqs", From 737826a9642b09ea83ca1c9b1f70135102bbaf6c Mon Sep 17 00:00:00 2001 From: Ly Nguyen Date: Tue, 16 Jul 2024 16:24:18 -0700 Subject: [PATCH 012/160] Fix build error --- website/docs/docs/get-started-dbt.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/docs/get-started-dbt.md b/website/docs/docs/get-started-dbt.md index 6bc445b18b2..11d912ec06f 100644 --- a/website/docs/docs/get-started-dbt.md +++ b/website/docs/docs/get-started-dbt.md @@ -73,7 +73,7 @@ Learn more about [dbt Cloud features](/docs/cloud/about-cloud/dbt-cloud-feature Refer to the following quickstarts to get started with dbt Core: - [dbt Core from a manual install](/guides/manual-install) to learn how to install dbt Core and set up a project. -- [dbt Core using GitHub Codespace](/guides/DuckDB?step=1) to learn how to create a codespace and execute the `dbt build` command. +- [dbt Core using DuckDB](/guides/DuckDB?step=1) to learn how to connect to DuckDB and execute the `dbt build` command. ## Related docs From ecc46448e9b8d522cc4d14ba7119d402791d10ec Mon Sep 17 00:00:00 2001 From: john-rock Date: Wed, 17 Jul 2024 09:14:45 -0400 Subject: [PATCH 013/160] trigger deploy From 2cbd39dc7d9a3257c5670329c5945459204927b1 Mon Sep 17 00:00:00 2001 From: Ly Nguyen Date: Thu, 18 Jul 2024 08:02:32 -0700 Subject: [PATCH 014/160] Fix build error --- website/vercel.json | 3 +++ 1 file changed, 3 insertions(+) diff --git a/website/vercel.json b/website/vercel.json index f4bd967067b..3ef7a8ba0ce 100644 --- a/website/vercel.json +++ b/website/vercel.json @@ -20,6 +20,9 @@ { "source": "/guides/codespace?step=1", "destination": "/guides/DuckDB?step=1", + "permanent": true + }, + { "source": "/docs/dbt-versions/core-upgrade/upgrading-to-dbt-utils-v1.0.md", "destination": "/docs/dbt-versions/core-upgrade/Older%20versions/upgrading-to-dbt-utils-v1.0.md", "permanent": true From 95da0ef5242c9780895ec7960f99656c7b7e2136 Mon Sep 17 00:00:00 2001 From: john-rock Date: Thu, 18 Jul 2024 13:52:32 -0400 Subject: [PATCH 015/160] trigger rebuild From bc67c4307417213a473912a7fef2198f72fa93a4 Mon Sep 17 00:00:00 2001 From: john-rock Date: Thu, 18 Jul 2024 14:01:31 -0400 Subject: [PATCH 016/160] remove link to test build --- website/docs/docs/introduction.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/docs/introduction.md b/website/docs/docs/introduction.md index 5301dae396d..9ab4439385e 100644 --- a/website/docs/docs/introduction.md +++ b/website/docs/docs/introduction.md @@ -34,7 +34,7 @@ Learn more about [dbt Cloud features](/docs/cloud/about-cloud/dbt-cloud-features ### dbt Core -[dbt Core](/docs/core/about-core-setup) is an open-source tool that enables data practitioners to transform data and is suitable for users who prefer to manually set up dbt and locally maintain it. You can [install dbt Core](/docs/core/installation-overview) through the command line. Learn more with the [quickstart for dbt Core](https://docs.getdbt.com/guides/codespace?step=1). +[dbt Core](/docs/core/about-core-setup) is an open-source tool that enables data practitioners to transform data and is suitable for users who prefer to manually set up dbt and locally maintain it. You can [install dbt Core](/docs/core/installation-overview) through the command line. Learn more with the quickstart for dbt Core. For more information on dbt Cloud and dbt Core, refer to [How dbt Cloud compares with dbt Core](https://www.getdbt.com/product/dbt-core-vs-dbt-cloud). From a85abe7946c17ca6275756e5003740479ff265b9 Mon Sep 17 00:00:00 2001 From: john-rock Date: Thu, 18 Jul 2024 14:02:36 -0400 Subject: [PATCH 017/160] revert changes --- website/docs/docs/introduction.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/docs/introduction.md b/website/docs/docs/introduction.md index 9ab4439385e..5301dae396d 100644 --- a/website/docs/docs/introduction.md +++ b/website/docs/docs/introduction.md @@ -34,7 +34,7 @@ Learn more about [dbt Cloud features](/docs/cloud/about-cloud/dbt-cloud-features ### dbt Core -[dbt Core](/docs/core/about-core-setup) is an open-source tool that enables data practitioners to transform data and is suitable for users who prefer to manually set up dbt and locally maintain it. You can [install dbt Core](/docs/core/installation-overview) through the command line. Learn more with the quickstart for dbt Core. +[dbt Core](/docs/core/about-core-setup) is an open-source tool that enables data practitioners to transform data and is suitable for users who prefer to manually set up dbt and locally maintain it. You can [install dbt Core](/docs/core/installation-overview) through the command line. Learn more with the [quickstart for dbt Core](https://docs.getdbt.com/guides/codespace?step=1). For more information on dbt Cloud and dbt Core, refer to [How dbt Cloud compares with dbt Core](https://www.getdbt.com/product/dbt-core-vs-dbt-cloud). From 4bed10f9fc2df64f085c674cbe95aa28cb9ad82b Mon Sep 17 00:00:00 2001 From: john-rock Date: Thu, 18 Jul 2024 14:14:15 -0400 Subject: [PATCH 018/160] test removing redirects --- website/vercel.json | 20 -------------------- 1 file changed, 20 deletions(-) diff --git a/website/vercel.json b/website/vercel.json index 3ef7a8ba0ce..0eb0ea516e9 100644 --- a/website/vercel.json +++ b/website/vercel.json @@ -2,26 +2,6 @@ "cleanUrls": true, "trailingSlash": false, "redirects": [ - { - "source": "/guides/codespace?step=4", - "destination": "/guides/DuckDB?step=5", - "permanent": true - }, - { - "source": "/guides/codespace?step=3", - "destination": "/guides/DuckDB?step=3", - "permanent": true - }, - { - "source": "/guides/codespace?step=2", - "destination": "/guides/DuckDB?step=2", - "permanent": true - }, - { - "source": "/guides/codespace?step=1", - "destination": "/guides/DuckDB?step=1", - "permanent": true - }, { "source": "/docs/dbt-versions/core-upgrade/upgrading-to-dbt-utils-v1.0.md", "destination": "/docs/dbt-versions/core-upgrade/Older%20versions/upgrading-to-dbt-utils-v1.0.md", From aa474785e9ad0bcddae288ead8c75b8f2001b9bf Mon Sep 17 00:00:00 2001 From: john-rock Date: Thu, 18 Jul 2024 14:16:12 -0400 Subject: [PATCH 019/160] update redirects --- website/vercel.json | 48 +++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 48 insertions(+) diff --git a/website/vercel.json b/website/vercel.json index 0eb0ea516e9..96409b98678 100644 --- a/website/vercel.json +++ b/website/vercel.json @@ -2,6 +2,54 @@ "cleanUrls": true, "trailingSlash": false, "redirects": [ + { + "source": "/guides/codespace", + "destination": "/guides/DuckDB", + "has": [ + { + "type": "query", + "key": "step", + "value": "4" + } + ], + "permanent": true + }, + { + "source": "/guides/codespace", + "destination": "/guides/DuckDB", + "has": [ + { + "type": "query", + "key": "step", + "value": "3" + } + ], + "permanent": true + }, + { + "source": "/guides/codespace", + "destination": "/guides/DuckDB", + "has": [ + { + "type": "query", + "key": "step", + "value": "2" + } + ], + "permanent": true + }, + { + "source": "/guides/codespace", + "destination": "/guides/DuckDB", + "has": [ + { + "type": "query", + "key": "step", + "value": "1" + } + ], + "permanent": true + }, { "source": "/docs/dbt-versions/core-upgrade/upgrading-to-dbt-utils-v1.0.md", "destination": "/docs/dbt-versions/core-upgrade/Older%20versions/upgrading-to-dbt-utils-v1.0.md", From 77a9a56e1c87748c387ed1e74bce3d44476f8b63 Mon Sep 17 00:00:00 2001 From: john-rock Date: Thu, 18 Jul 2024 14:28:25 -0400 Subject: [PATCH 020/160] adjust redirect again --- website/vercel.json | 43 ------------------------------------------- 1 file changed, 43 deletions(-) diff --git a/website/vercel.json b/website/vercel.json index 96409b98678..69a83aa4d82 100644 --- a/website/vercel.json +++ b/website/vercel.json @@ -5,49 +5,6 @@ { "source": "/guides/codespace", "destination": "/guides/DuckDB", - "has": [ - { - "type": "query", - "key": "step", - "value": "4" - } - ], - "permanent": true - }, - { - "source": "/guides/codespace", - "destination": "/guides/DuckDB", - "has": [ - { - "type": "query", - "key": "step", - "value": "3" - } - ], - "permanent": true - }, - { - "source": "/guides/codespace", - "destination": "/guides/DuckDB", - "has": [ - { - "type": "query", - "key": "step", - "value": "2" - } - ], - "permanent": true - }, - { - "source": "/guides/codespace", - "destination": "/guides/DuckDB", - "has": [ - { - "type": "query", - "key": "step", - "value": "1" - } - ], "permanent": true }, { From 3595de94f79e1d1d2feb7be67cfe773cd4f130c1 Mon Sep 17 00:00:00 2001 From: john-rock Date: Thu, 18 Jul 2024 14:31:17 -0400 Subject: [PATCH 021/160] consolidate redirects --- website/vercel.json | 1 + 1 file changed, 1 insertion(+) diff --git a/website/vercel.json b/website/vercel.json index 69a83aa4d82..ba26b34bd28 100644 --- a/website/vercel.json +++ b/website/vercel.json @@ -3521,3 +3521,4 @@ } ] } + From 67df5d1b31e6430e38e6591242ca54d43ab939ef Mon Sep 17 00:00:00 2001 From: john-rock Date: Thu, 18 Jul 2024 14:34:56 -0400 Subject: [PATCH 022/160] add redirect for step 4 --- website/vercel.json | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/website/vercel.json b/website/vercel.json index ba26b34bd28..8bc2a371676 100644 --- a/website/vercel.json +++ b/website/vercel.json @@ -7,6 +7,18 @@ "destination": "/guides/DuckDB", "permanent": true }, + { + "source": "/guides/codespace", + "has": [ + { + "type": "query", + "key": "step", + "value": "4" + } + ], + "destination": "/guides/DuckDB?step=5", + "permanent": true + }, { "source": "/docs/dbt-versions/core-upgrade/upgrading-to-dbt-utils-v1.0.md", "destination": "/docs/dbt-versions/core-upgrade/Older%20versions/upgrading-to-dbt-utils-v1.0.md", From d5a484d80293d956ddb470640b32204e7e8b3f66 Mon Sep 17 00:00:00 2001 From: john-rock Date: Fri, 19 Jul 2024 09:35:41 -0400 Subject: [PATCH 023/160] move step 4 redirect up --- website/vercel.json | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/website/vercel.json b/website/vercel.json index 8bc2a371676..6cacf59da6b 100644 --- a/website/vercel.json +++ b/website/vercel.json @@ -2,11 +2,6 @@ "cleanUrls": true, "trailingSlash": false, "redirects": [ - { - "source": "/guides/codespace", - "destination": "/guides/DuckDB", - "permanent": true - }, { "source": "/guides/codespace", "has": [ @@ -19,6 +14,11 @@ "destination": "/guides/DuckDB?step=5", "permanent": true }, + { + "source": "/guides/codespace", + "destination": "/guides/DuckDB", + "permanent": true + }, { "source": "/docs/dbt-versions/core-upgrade/upgrading-to-dbt-utils-v1.0.md", "destination": "/docs/dbt-versions/core-upgrade/Older%20versions/upgrading-to-dbt-utils-v1.0.md", From 014c807874dcfb9de8046f2444849cf7295e5dfe Mon Sep 17 00:00:00 2001 From: Natalie Fiann Date: Fri, 26 Jul 2024 11:05:03 +0100 Subject: [PATCH 024/160] Updated tabs and changed order of guide --- website/docs/guides/duckdb-qs.md | 31 ++++++++++++++++--------------- 1 file changed, 16 insertions(+), 15 deletions(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index a88d76533b5..4f9b3110679 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -1,6 +1,6 @@ --- title: Quickstart for dbt Core using DuckDB -id: DuckDB +id: duckDB description: "Learn to use dbt Core using DuckDB." hoverSnippet: "Learn to use dbt Core using DuckDB." platform: 'dbt-core' @@ -18,6 +18,11 @@ In this quickstart guide, you’ll learn how to install dbt Core for the use of We'll also touch on creating a codespace executing the `dbt build` command from it in _less than 5 minutes_. +It will show you how to: + +- Provide a summary of DuckDB +- Install DuckDB + ### What is DuckDB? @@ -25,7 +30,7 @@ We'll also touch on creating a codespace executing the `dbt build` command from - + DuckDB is an open-source database management system which is designed for analytical workloads. It is designed to provide fast and easy access to large datasets, making it well-suited for data analytics tasks. @@ -50,7 +55,7 @@ Here's a list of some of the main features of DuckDB: - + dbt Labs provides a [GitHub Codespace](https://docs.github.com/en/codespaces/overview) template that you (and anyone else) can reuse to create a complete dbt environment with a working and runnable project. When you create the codespace, the [dev container](https://docs.github.com/en/codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/introduction-to-dev-containers) creates a fully functioning dbt environment, connects to a DuckDB database, and loads a year of data from our fictional Jaffle Shop café, which sells food and beverages in several US cities. The [README](https://github.com/dbt-labs/jaffle-shop-template#readme) for the Jaffle Shop template also provides instructions on how to do this, along with animated GIFs. @@ -60,8 +65,6 @@ dbt Labs provides a [GitHub Codespace](https://docs.github.com/en/codespaces/ove -## Related content - - [DuckDBsetup](/docs/core/connect-data-platform/duckdb-setup) - [Create a GitHub repository](/guides/manual-install?step=2) - [Build your first models](/guides/manual-install?step=3) @@ -70,19 +73,17 @@ dbt Labs provides a [GitHub Codespace](https://docs.github.com/en/codespaces/ove - Learn more with [dbt Learn courses](https://learn.getdbt.com) -## Install DuckDB - -Further down is a step-by-step explanation of the steps to install DuckDB. - - ### Prerequisites -When using DuckDB with dbt Core, you'll need to use the dbt command-line interface (CLI). - +- When using DuckDB with dbt Core, you'll need to use the dbt command-line interface (CLI). - It's important that you know some basics of the terminal. In particular, you should understand `cd`, `ls` , and `pwd` to navigate through the directory structure of your computer easily. - You have a [GitHub account](https://github.com/join). +## Install DuckDB + +Further down is a step-by-step explanation of the steps to install DuckDB. + On a Mac, copy & paste the following to your terminal (standalone or with an IDE like VS Code). @@ -143,7 +144,7 @@ Currently, DuckDB is not supported in dbt Cloud. ::: -## Setting up DuckDB for dbt Core +## Set up DuckDB for dbt Core Below you'll find a step by step guide on getting up and running with this project. @@ -227,7 +228,7 @@ dbt docs serve ``` -### Running build steps independently +### Run build steps independently 1. Load the CSVs with the demo data set. This materializes the CSVs as tables in your target schema. Note that a typical dbt project does not require this step since dbt assumes your raw data is already in your warehouse. @@ -258,7 +259,7 @@ dbt test ``` -### Troubleshooting +### Troubleshoot You may get an error like the one in the example below, in which case you will need to disconnect from any sessions that are locking the database: From 35da07106a286baf8ee2dff2c663d6705dfb094f Mon Sep 17 00:00:00 2001 From: Natalie Fiann Date: Fri, 26 Jul 2024 15:16:15 +0100 Subject: [PATCH 025/160] updating doc --- website/docs/guides/duckdb-qs.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 4f9b3110679..c67adcc2967 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -20,8 +20,10 @@ We'll also touch on creating a codespace executing the `dbt build` command from It will show you how to: -- Provide a summary of DuckDB - Install DuckDB +- Create a larger dataset +- How to use DuckDB + ### What is DuckDB? From 3bef3815072db0b6811ffbb6bf7afff89c786cf3 Mon Sep 17 00:00:00 2001 From: Natalie Fiann Date: Mon, 29 Jul 2024 14:38:58 +0100 Subject: [PATCH 026/160] updated doc --- website/docs/guides/duckdb-qs.md | 119 ++++++++----------------------- 1 file changed, 29 insertions(+), 90 deletions(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index c67adcc2967..e1521c2d827 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -1,6 +1,6 @@ --- title: Quickstart for dbt Core using DuckDB -id: duckDB +id: duckdb description: "Learn to use dbt Core using DuckDB." hoverSnippet: "Learn to use dbt Core using DuckDB." platform: 'dbt-core' @@ -18,11 +18,10 @@ In this quickstart guide, you’ll learn how to install dbt Core for the use of We'll also touch on creating a codespace executing the `dbt build` command from it in _less than 5 minutes_. -It will show you how to: +The guide will show you how to: - Install DuckDB - Create a larger dataset -- How to use DuckDB @@ -57,7 +56,7 @@ Here's a list of some of the main features of DuckDB: - + dbt Labs provides a [GitHub Codespace](https://docs.github.com/en/codespaces/overview) template that you (and anyone else) can reuse to create a complete dbt environment with a working and runnable project. When you create the codespace, the [dev container](https://docs.github.com/en/codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/introduction-to-dev-containers) creates a fully functioning dbt environment, connects to a DuckDB database, and loads a year of data from our fictional Jaffle Shop café, which sells food and beverages in several US cities. The [README](https://github.com/dbt-labs/jaffle-shop-template#readme) for the Jaffle Shop template also provides instructions on how to do this, along with animated GIFs. @@ -67,6 +66,9 @@ dbt Labs provides a [GitHub Codespace](https://docs.github.com/en/codespaces/ove +### Related content + + - [DuckDBsetup](/docs/core/connect-data-platform/duckdb-setup) - [Create a GitHub repository](/guides/manual-install?step=2) - [Build your first models](/guides/manual-install?step=3) @@ -82,69 +84,6 @@ dbt Labs provides a [GitHub Codespace](https://docs.github.com/en/codespaces/ove - You have a [GitHub account](https://github.com/join). -## Install DuckDB - -Further down is a step-by-step explanation of the steps to install DuckDB. - - -On a Mac, copy & paste the following to your terminal (standalone or with an IDE like VS Code). - -```shell -git clone https://github.com/dbt-labs/jaffle_shop_duckdb.git -cd jaffle_shop_duckdb -python3 -m venv venv -source venv/bin/activate -python3 -m pip install --upgrade pip -python3 -m pip install -r requirements.txt -source venv/bin/activate -dbt build -dbt docs generate -dbt docs serve -``` - -On Windows, use either Powershell or the command line prompt: - -Windows cmd.exe - -```shell -git clone https://github.com/dbt-labs/docs-duckdb.git -cd docs-duckdb -python -m venv venv -venv\Scripts\activate.bat -python -m pip install --upgrade pip -python -m pip install -r requirements.txt -venv\Scripts\activate.bat -dbt deps -dbt build -dbt docs generate -dbt docs serve -``` - -Windows PowerShell - -```shell -git clone https://github.com/dbt-labs/docs-duckdb.git — Clones the repo locally -cd docs-duckdb — Changes directory to the repo -python3 -m venv venv — Creates a Python virtual environment called "venv" -source venv/bin/activate — Activates the Pythong virtual environment -python3 -m pip install --upgrade pip — Ensures Pip is up to date -python3 -m pip install -r requirements.txt — Installs the programs and dependencies defined in the file -source venv/bin/activate — Ensures the virtual environment is activated -dbt deps — Installs dbt packages -dbt build — Seeds data to the Duckdb database and builds models and dependecies -dbt docs generate — Compiles the projects docs -dbt docs serve — Displays the docs in your open or default browser. -``` - -Fore more information on the setup of DuckDB, you can refer to [DuckDBsetup](/docs/core/connect-data-platform/duckdb-setup). - - -:::info DuckDB Support - -Currently, DuckDB is not supported in dbt Cloud. - -::: - ## Set up DuckDB for dbt Core @@ -154,7 +93,7 @@ Below you'll find a step by step guide on getting up and running with this proje - + 1. First, you'll need to clone this repository. @@ -204,48 +143,39 @@ venv\Scripts\Activate.ps1 ``` -4. Ensure your profile is setup correctly from the command line: +4. Ensure your profile is setup correctly from the command line by running the following: -```Jinja -dbt --version -dbt debug +- [dbt --version](/reference/project-configs/require-dbt-version) - to restrict your project to only work with a range of dbt versions. +- [dbt debug](/reference/commands/debug) - to test the database connection and display information for debugging purposes. -``` 5. Load the CSVs with the demo data set, run the models, and test the output of the models using the dbt build command: -```Jinja -dbt build +- [dbt build](/reference/commands/run) — compiles and runs your project. -``` 6. Generate and view the documentation for the project: -```Jinja -dbt docs generate -dbt docs serve +- [dbt docs generate](/reference/commands/cmd-docs#dbt-docs-generate) - to generate your project's documentation. +- [dbt docs serve](/reference/commands/cmd-docs#dbt-docs-serve) - starts a webserver on port 8080 to serve your documentation locally and opens the documentation site in your default browser. -``` ### Run build steps independently 1. Load the CSVs with the demo data set. This materializes the CSVs as tables in your target schema. Note that a typical dbt project does not require this step since dbt assumes your raw data is already in your warehouse. -```Jinja -dbt seed +- [dbt seed](/reference/commands/seed) - loads `csv` files located in the `seed-paths` directory of your dbt project into your data warehouse. + -``` 2. Run the models: -```Jinja -dbt run +- [dbt run](/reference/commands/run) - compiles and runs your project. -``` :::note Note. @@ -255,11 +185,9 @@ NOTE: If you decide to run this project in your own data warehouse (outside of t 3. Test the output of the models using the test command: -```Jinja -dbt test +- [dbt test](/reference/commands/test) - compiles and tests your project. -``` ### Troubleshoot @@ -278,7 +206,7 @@ As a last resort, deleting the database file will get you back in action (_BUT_ - + 1. Go to the `jaffle-shop-template` [repository](https://github.com/dbt-labs/jaffle-shop-template) after you log in to your GitHub account. 1. Click **Use this template** at the top of the page and choose **Create new repository**. @@ -310,6 +238,17 @@ As a last resort, deleting the database file will get you back in action (_BUT_ + +Fore more information on the setup of DuckDB, you can refer to [DuckDBsetup](/docs/core/connect-data-platform/duckdb-setup). + + +:::info DuckDB Support + +Currently, DuckDB is not supported in dbt Cloud. + +::: + + ## Generate a larger data set If you'd like to work with a larger selection of Jaffle Shop data, you can generate an arbitrary number of years of fictitious data from within your codespace. From 4fe47e063f60eaf6a10411847476c4e2e93d7bbe Mon Sep 17 00:00:00 2001 From: Natalie Fiann Date: Mon, 29 Jul 2024 15:31:31 +0100 Subject: [PATCH 027/160] Updated intro --- website/docs/guides/duckdb-qs.md | 1 + 1 file changed, 1 insertion(+) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index e1521c2d827..cbab297e43c 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -21,6 +21,7 @@ We'll also touch on creating a codespace executing the `dbt build` command from The guide will show you how to: - Install DuckDB +- Troubleshoot errors - Create a larger dataset From 16f30e9ae51285a8ac297342dba1d5dc31071fa9 Mon Sep 17 00:00:00 2001 From: Natalie Fiann Date: Tue, 30 Jul 2024 11:46:08 +0100 Subject: [PATCH 028/160] removed redirects --- website/vercel.json | 17 ----------------- 1 file changed, 17 deletions(-) diff --git a/website/vercel.json b/website/vercel.json index 6cacf59da6b..bd5824f004e 100644 --- a/website/vercel.json +++ b/website/vercel.json @@ -2,23 +2,6 @@ "cleanUrls": true, "trailingSlash": false, "redirects": [ - { - "source": "/guides/codespace", - "has": [ - { - "type": "query", - "key": "step", - "value": "4" - } - ], - "destination": "/guides/DuckDB?step=5", - "permanent": true - }, - { - "source": "/guides/codespace", - "destination": "/guides/DuckDB", - "permanent": true - }, { "source": "/docs/dbt-versions/core-upgrade/upgrading-to-dbt-utils-v1.0.md", "destination": "/docs/dbt-versions/core-upgrade/Older%20versions/upgrading-to-dbt-utils-v1.0.md", From 13ab42640c3241eda283cfdb23bf007cdb3fbaef Mon Sep 17 00:00:00 2001 From: Natalie Fiann Date: Thu, 1 Aug 2024 16:08:14 +0100 Subject: [PATCH 029/160] Updated intro for doc --- website/docs/guides/duckdb-qs.md | 13 ++++++------- 1 file changed, 6 insertions(+), 7 deletions(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index cbab297e43c..37bcdeddfb2 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -14,15 +14,14 @@ tags: ['dbt Core','Quickstart'] ## Introduction -In this quickstart guide, you’ll learn how to install dbt Core for the use of DuckDB. +In this quickstart guide, you will discover how to use dbt Core with DuckDB. This guide will demonstrate how to: -We'll also touch on creating a codespace executing the `dbt build` command from it in _less than 5 minutes_. +- Create a GitHub Codespace using a template provided by dbt Labs. + - This sets up a fully functional dbt environment with an operational and executable project. The codespace automatically connects to the DuckDB database and loads a year's worth of data from our fictional Jaffle Shop café, which sells food and beverages in several US cities. +- Run any dbt command from the environment’s terminal. +- Generate a larger dataset for the Jaffle Shop café (for example, 5 years of data instead of just one). -The guide will show you how to: - -- Install DuckDB -- Troubleshoot errors -- Create a larger dataset +For additional information, refer to the [README](https://github.com/gwenwindflower/octocatalog) for the Jaffle Shop template. It includes instructions on how to do this, along with animated GIFs. From 01a44ba984ab39c5fecbffdd57885c9342c156c5 Mon Sep 17 00:00:00 2001 From: Natalie Fiann Date: Fri, 2 Aug 2024 15:53:31 +0100 Subject: [PATCH 030/160] updated doc --- website/docs/guides/duckdb-qs.md | 62 ++++++++++++-------------------- 1 file changed, 22 insertions(+), 40 deletions(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 37bcdeddfb2..3d7de5e1732 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -35,23 +35,7 @@ For additional information, refer to the [README](https://github.com/gwenwindflo DuckDB is an open-source database management system which is designed for analytical workloads. It is designed to provide fast and easy access to large datasets, making it well-suited for data analytics tasks. -Here's a list of some of the main features of DuckDB: - -- In-Process Database: Unlike traditional databases that run as a separate server process, DuckDB runs within the host application process. This allows for tight integration and low-latency data access. - -- SQL Support: DuckDB supports standard SQL, making it accessible to users familiar with SQL syntax and enabling the use of complex queries for data analysis. - -- Columnar Storage: DuckDB uses a columnar storage format, which is efficient for analytical queries that often need to scan large amounts of data but only a few columns. This design improves performance for read-heavy operations. - -- OLAP (Online Analytical Processing) Focused: While traditional relational databases are optimized for OLTP (Online Transaction Processing) workloads, DuckDB is optimized for OLAP workloads, which involve complex queries and data analysis. - -- Embeddable: Being embeddable means DuckDB can be included as a library in applications, making it a good choice for scenarios where a lightweight, high-performance database is needed without the overhead of a separate database server. - -- Cross-Platform: DuckDB works on multiple operating systems, including Windows, macOS, and Linux. - -- Easy Integration: It can be easily integrated with other data processing tools and environments, such as Python, R, and various data science and machine learning frameworks. - -- No External Dependencies: DuckDB does not rely on external services or infrastructure, making it easy to deploy and use in a wide range of environments. +For more information, please refer to the [Duck DB](https://duckdb.org/) website. @@ -83,12 +67,14 @@ dbt Labs provides a [GitHub Codespace](https://docs.github.com/en/codespaces/ove - It's important that you know some basics of the terminal. In particular, you should understand `cd`, `ls` , and `pwd` to navigate through the directory structure of your computer easily. - You have a [GitHub account](https://github.com/join). +Currently, DuckDB is not supported in dbt Cloud. + ## Set up DuckDB for dbt Core -Below you'll find a step by step guide on getting up and running with this project. +The following will provide a step by step guide on setting up DuckDB for both local and web browser. @@ -107,7 +93,7 @@ cd docs-duckdb 3. Install dbt and DuckDB in a virtual environment. -If you're using MAC, you can copy and paste the below: + ```Jinja @@ -119,7 +105,10 @@ source venv/bin/activate ``` -Windows cmd.exe + + + + ```Jinja @@ -131,7 +120,10 @@ venv\Scripts\activate.bat ``` -Windows PowerShell + + + + ```Jinja @@ -143,23 +135,19 @@ venv\Scripts\Activate.ps1 ``` -4. Ensure your profile is setup correctly from the command line by running the following: - - -- [dbt --version](/reference/project-configs/require-dbt-version) - to restrict your project to only work with a range of dbt versions. -- [dbt debug](/reference/commands/debug) - to test the database connection and display information for debugging purposes. - - -5. Load the CSVs with the demo data set, run the models, and test the output of the models using the dbt build command: - + -- [dbt build](/reference/commands/run) — compiles and runs your project. -6. Generate and view the documentation for the project: +For detailed information, refer to the dbt command reference. Frequently used commands include: +4. Ensure your profile is setup correctly from the command line by running the following: -- [dbt docs generate](/reference/commands/cmd-docs#dbt-docs-generate) - to generate your project's documentation. +- [dbt compile](https://docs.getdbt.com/reference/commands/compile) — generates executable SQL from your project source files +- [dbt run](https://docs.getdbt.com/reference/commands/run) — compiles and runs your project +- [dbt test](https://docs.getdbt.com/reference/commands/test) — compiles and tests your project +- [dbt build](https://docs.getdbt.com/reference/commands/build) — compiles, runs, and tests your project +- [dbt docs generate](/reference/commands/cmd-docs#dbt-docs-generate) - generates your project's documentation. - [dbt docs serve](/reference/commands/cmd-docs#dbt-docs-serve) - starts a webserver on port 8080 to serve your documentation locally and opens the documentation site in your default browser. @@ -201,7 +189,7 @@ IO Error: Could not set lock on file "jaffle_shop.duckdb": Resource temporarily This is a known issue in DuckDB. If you are using DBeaver, this means shutting down DBeaver (disconnecting doesn't always work). -As a last resort, deleting the database file will get you back in action (_BUT_ you will lose all your data). +As a last resort, deleting the database file will get you back in action (_but_ you will lose all your data). @@ -242,12 +230,6 @@ As a last resort, deleting the database file will get you back in action (_BUT_ Fore more information on the setup of DuckDB, you can refer to [DuckDBsetup](/docs/core/connect-data-platform/duckdb-setup). -:::info DuckDB Support - -Currently, DuckDB is not supported in dbt Cloud. - -::: - ## Generate a larger data set From c99ee4596092b57f2607850a5e7c87859f00909d Mon Sep 17 00:00:00 2001 From: Natalie Fiann Date: Tue, 6 Aug 2024 10:59:13 +0100 Subject: [PATCH 031/160] Updated guide --- website/docs/guides/duckdb-qs.md | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 3d7de5e1732..4481820e284 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -14,7 +14,7 @@ tags: ['dbt Core','Quickstart'] ## Introduction -In this quickstart guide, you will discover how to use dbt Core with DuckDB. This guide will demonstrate how to: +In this quickstart guide, you'll learn how to use dbt Core with DuckDB, enabling you to get set up quickly and efficiently. This guide will demonstrate how to: - Create a GitHub Codespace using a template provided by dbt Labs. - This sets up a fully functional dbt environment with an operational and executable project. The codespace automatically connects to the DuckDB database and loads a year's worth of data from our fictional Jaffle Shop café, which sells food and beverages in several US cities. @@ -42,7 +42,7 @@ For more information, please refer to the [Duck DB](https://duckdb.org/) website -dbt Labs provides a [GitHub Codespace](https://docs.github.com/en/codespaces/overview) template that you (and anyone else) can reuse to create a complete dbt environment with a working and runnable project. When you create the codespace, the [dev container](https://docs.github.com/en/codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/introduction-to-dev-containers) creates a fully functioning dbt environment, connects to a DuckDB database, and loads a year of data from our fictional Jaffle Shop café, which sells food and beverages in several US cities. The [README](https://github.com/dbt-labs/jaffle-shop-template#readme) for the Jaffle Shop template also provides instructions on how to do this, along with animated GIFs. +dbt Labs offers a [GitHub Codespace](https://docs.github.com/en/codespaces/overview) template that allows you and others to set up a comprehensive dbt environment with a functional and executable project. Upon creating the codespace, the [dev container](https://docs.github.com/en/codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/introduction-to-dev-containers) establishes a fully operational dbt environment, connects to a DuckDB database, and imports a year's worth of data from our fictional Jaffle Shop café, which operates in various US cities. The [README](https://github.com/dbt-labs/jaffle-shop-template#readme) file for the Jaffle Shop template includes detailed instructions and animated GIFs to guide you through the process. @@ -93,7 +93,7 @@ cd docs-duckdb 3. Install dbt and DuckDB in a virtual environment. - + ```Jinja @@ -105,10 +105,10 @@ source venv/bin/activate ``` - + - + ```Jinja @@ -120,10 +120,10 @@ venv\Scripts\activate.bat ``` - + - + ```Jinja @@ -135,13 +135,13 @@ venv\Scripts\Activate.ps1 ``` - + +4. Ensure your profile is setup correctly from the command line by running the following: -For detailed information, refer to the dbt command reference. Frequently used commands include: +For detailed information, refer to the [dbt command reference](/reference/dbt-commands). Frequently used commands include: -4. Ensure your profile is setup correctly from the command line by running the following: - [dbt compile](https://docs.getdbt.com/reference/commands/compile) — generates executable SQL from your project source files - [dbt run](https://docs.getdbt.com/reference/commands/run) — compiles and runs your project From 6b7c7f3b9cfe6873aba74ec0029b0d8a06e909aa Mon Sep 17 00:00:00 2001 From: Ly Nguyen Date: Tue, 6 Aug 2024 09:08:35 -0700 Subject: [PATCH 032/160] Big rocks feedback --- website/docs/guides/duckdb-qs.md | 74 ++++++++++++-------------------- 1 file changed, 27 insertions(+), 47 deletions(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 4481820e284..f9d215bea1b 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -14,41 +14,18 @@ tags: ['dbt Core','Quickstart'] ## Introduction -In this quickstart guide, you'll learn how to use dbt Core with DuckDB, enabling you to get set up quickly and efficiently. This guide will demonstrate how to: +In this quickstart guide, you'll learn how to use dbt Core with DuckDB, enabling you to get set up quickly and efficiently. [DuckDB](https://duckdb.org/) is an open-source database management system which is designed for analytical workloads. It is designed to provide fast and easy access to large datasets, making it well-suited for data analytics tasks. + + +This guide will demonstrate how to: - Create a GitHub Codespace using a template provided by dbt Labs. - This sets up a fully functional dbt environment with an operational and executable project. The codespace automatically connects to the DuckDB database and loads a year's worth of data from our fictional Jaffle Shop café, which sells food and beverages in several US cities. + - For additional information, refer to the [README](https://github.com/gwenwindflower/octocatalog) for the Jaffle Shop template. It includes instructions on how to do this, along with animated GIFs. - Run any dbt command from the environment’s terminal. - Generate a larger dataset for the Jaffle Shop café (for example, 5 years of data instead of just one). -For additional information, refer to the [README](https://github.com/gwenwindflower/octocatalog) for the Jaffle Shop template. It includes instructions on how to do this, along with animated GIFs. - - - -### What is DuckDB? - - - - - - - -DuckDB is an open-source database management system which is designed for analytical workloads. It is designed to provide fast and easy access to large datasets, making it well-suited for data analytics tasks. - -For more information, please refer to the [Duck DB](https://duckdb.org/) website. - - - - - - -dbt Labs offers a [GitHub Codespace](https://docs.github.com/en/codespaces/overview) template that allows you and others to set up a comprehensive dbt environment with a functional and executable project. Upon creating the codespace, the [dev container](https://docs.github.com/en/codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/introduction-to-dev-containers) establishes a fully operational dbt environment, connects to a DuckDB database, and imports a year's worth of data from our fictional Jaffle Shop café, which operates in various US cities. The [README](https://github.com/dbt-labs/jaffle-shop-template#readme) file for the Jaffle Shop template includes detailed instructions and animated GIFs to guide you through the process. - - - - - - +[Placeholder: Check if Core (vs Codespace) walks users through the same workflow as above ^. If not, consider adding a second bullet list for it below. ] ### Related content @@ -63,17 +40,12 @@ dbt Labs offers a [GitHub Codespace](https://docs.github.com/en/codespaces/overv ### Prerequisites -- When using DuckDB with dbt Core, you'll need to use the dbt command-line interface (CLI). +- When using DuckDB with dbt Core, you'll need to use the dbt command-line interface (CLI). Currently, DuckDB is not supported in dbt Cloud. - It's important that you know some basics of the terminal. In particular, you should understand `cd`, `ls` , and `pwd` to navigate through the directory structure of your computer easily. - You have a [GitHub account](https://github.com/join). -Currently, DuckDB is not supported in dbt Cloud. - - - ## Set up DuckDB for dbt Core - The following will provide a step by step guide on setting up DuckDB for both local and web browser. @@ -83,6 +55,8 @@ The following will provide a step by step guide on setting up DuckDB for both lo 1. First, you'll need to clone this repository. +[review: consider adding `git clone` command as an example for step 1] + 2. Change into the docs-duckdb directory from the command line: ```Jinja @@ -93,22 +67,22 @@ cd docs-duckdb 3. Install dbt and DuckDB in a virtual environment. - + -```Jinja + ```Jinja -python3 -m venv venv -source venv/bin/activate -python3 -m pip install --upgrade pip -python3 -m pip install -r requirements.txt -source venv/bin/activate + python3 -m venv venv + source venv/bin/activate + python3 -m pip install --upgrade pip + python3 -m pip install -r requirements.txt + source venv/bin/activate -``` + ``` - + - + ```Jinja @@ -123,7 +97,7 @@ venv\Scripts\activate.bat - + ```Jinja @@ -142,6 +116,7 @@ venv\Scripts\Activate.ps1 For detailed information, refer to the [dbt command reference](/reference/dbt-commands). Frequently used commands include: +[review comment: consider reconstructing above two sentences so there's only one colon] - [dbt compile](https://docs.getdbt.com/reference/commands/compile) — generates executable SQL from your project source files - [dbt run](https://docs.getdbt.com/reference/commands/run) — compiles and runs your project @@ -150,9 +125,12 @@ For detailed information, refer to the [dbt command reference](/reference/dbt-co - [dbt docs generate](/reference/commands/cmd-docs#dbt-docs-generate) - generates your project's documentation. - [dbt docs serve](/reference/commands/cmd-docs#dbt-docs-serve) - starts a webserver on port 8080 to serve your documentation locally and opens the documentation site in your default browser. +[review comment: per nat's callout during meeting, indent list above for better alignment with step 4 when page is rendered] ### Run build steps independently +[review comment: consider if this whole section is necessary. some of the commands listed within it is mentioned in step 4. compare how the Codespace content is organized (primary) and other Cloud qs guides (secondary).] + 1. Load the CSVs with the demo data set. This materializes the CSVs as tables in your target schema. Note that a typical dbt project does not require this step since dbt assumes your raw data is already in your warehouse. @@ -179,6 +157,8 @@ NOTE: If you decide to run this project in your own data warehouse (outside of t ### Troubleshoot +[review comment: love this section. consider using expandable/detail for issue below. this is a bit of "future proofing" so if another item needs to be added later, it'll be easy to just add another list-like item to section] + You may get an error like the one in the example below, in which case you will need to disconnect from any sessions that are locking the database: ```Jinja @@ -229,7 +209,7 @@ As a last resort, deleting the database file will get you back in action (_but_ Fore more information on the setup of DuckDB, you can refer to [DuckDBsetup](/docs/core/connect-data-platform/duckdb-setup). - +[review comment: as part of how to organize content, consider moving this sentence to the introduction part of the "Set up DuckDB for dbt Core" section.] ## Generate a larger data set From 50dadb3331f9c7da1b70be559d10682117e29086 Mon Sep 17 00:00:00 2001 From: Ly Nguyen Date: Wed, 7 Aug 2024 08:37:31 -0700 Subject: [PATCH 033/160] Indent Windows tab to align with step --- website/docs/guides/duckdb-qs.md | 19 +++++++++---------- 1 file changed, 9 insertions(+), 10 deletions(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index f9d215bea1b..fad783d7873 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -81,20 +81,19 @@ cd docs-duckdb + - - -```Jinja + ```Jinja -python -m venv venv -venv\Scripts\activate.bat -python -m pip install --upgrade pip -python -m pip install -r requirements.txt -venv\Scripts\activate.bat + python -m venv venv + venv\Scripts\activate.bat + python -m pip install --upgrade pip + python -m pip install -r requirements.txt + venv\Scripts\activate.bat -``` + ``` - + From 4d880c52868e4011ee51772e211fce4ccf28189e Mon Sep 17 00:00:00 2001 From: Natalie Fiann Date: Thu, 8 Aug 2024 13:31:45 +0100 Subject: [PATCH 034/160] Cleaned up doc --- website/docs/guides/duckdb-qs.md | 94 +++++++++++--------------------- 1 file changed, 33 insertions(+), 61 deletions(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index f9d215bea1b..5b9fa3dc891 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -25,7 +25,6 @@ This guide will demonstrate how to: - Run any dbt command from the environment’s terminal. - Generate a larger dataset for the Jaffle Shop café (for example, 5 years of data instead of just one). -[Placeholder: Check if Core (vs Codespace) walks users through the same workflow as above ^. If not, consider adding a second bullet list for it below. ] ### Related content @@ -46,7 +45,9 @@ This guide will demonstrate how to: ## Set up DuckDB for dbt Core -The following will provide a step by step guide on setting up DuckDB for both local and web browser. +The following will provide a step by step guide on setting up DuckDB for both local and web browser. + +For more information on the setup of DuckDB, you can refer to [DuckDBsetup](/docs/core/connect-data-platform/duckdb-setup). @@ -78,70 +79,47 @@ cd docs-duckdb source venv/bin/activate ``` - + - - -```Jinja + ```Jinja -python -m venv venv -venv\Scripts\activate.bat -python -m pip install --upgrade pip -python -m pip install -r requirements.txt -venv\Scripts\activate.bat + python -m venv venv + venv\Scripts\activate.bat + python -m pip install --upgrade pip + python -m pip install -r requirements.txt + venv\Scripts\activate.bat -``` - - + ``` + - + -```Jinja - -python -m venv venv -venv\Scripts\Activate.ps1 -python -m pip install --upgrade pip -python -m pip install -r requirements.txt -venv\Scripts\Activate.ps1 + ```Jinja -``` + python -m venv venv + venv\Scripts\Activate.ps1 + python -m pip install --upgrade pip + python -m pip install -r requirements.txt + venv\Scripts\Activate.ps1 - + ``` + 4. Ensure your profile is setup correctly from the command line by running the following: -For detailed information, refer to the [dbt command reference](/reference/dbt-commands). Frequently used commands include: - -[review comment: consider reconstructing above two sentences so there's only one colon] - -- [dbt compile](https://docs.getdbt.com/reference/commands/compile) — generates executable SQL from your project source files -- [dbt run](https://docs.getdbt.com/reference/commands/run) — compiles and runs your project -- [dbt test](https://docs.getdbt.com/reference/commands/test) — compiles and tests your project -- [dbt build](https://docs.getdbt.com/reference/commands/build) — compiles, runs, and tests your project -- [dbt docs generate](/reference/commands/cmd-docs#dbt-docs-generate) - generates your project's documentation. -- [dbt docs serve](/reference/commands/cmd-docs#dbt-docs-serve) - starts a webserver on port 8080 to serve your documentation locally and opens the documentation site in your default browser. - -[review comment: per nat's callout during meeting, indent list above for better alignment with step 4 when page is rendered] - -### Run build steps independently -[review comment: consider if this whole section is necessary. some of the commands listed within it is mentioned in step 4. compare how the Codespace content is organized (primary) and other Cloud qs guides (secondary).] - -1. Load the CSVs with the demo data set. This materializes the CSVs as tables in your target schema. Note that a typical dbt project does not require this step since dbt assumes your raw data is already in your warehouse. - - -- [dbt seed](/reference/commands/seed) - loads `csv` files located in the `seed-paths` directory of your dbt project into your data warehouse. - - -2. Run the models: - - -- [dbt run](/reference/commands/run) - compiles and runs your project. + - [dbt compile](https://docs.getdbt.com/reference/commands/compile) — generates executable SQL from your project source files + - [dbt run](https://docs.getdbt.com/reference/commands/run) — compiles and runs your project + - [dbt test](https://docs.getdbt.com/reference/commands/test) — compiles and tests your project + - [dbt build](https://docs.getdbt.com/reference/commands/build) — compiles, runs, and tests your project + - [dbt docs generate](/reference/commands/cmd-docs#dbt-docs-generate) - generates your project's documentation. + - [dbt docs serve](/reference/commands/cmd-docs#dbt-docs-serve) - starts a webserver on port 8080 to serve your documentation locally and opens the documentation site in your default browser. +For detailed information, refer to the [dbt command reference](/reference/dbt-commands). :::note Note. @@ -149,18 +127,14 @@ NOTE: If you decide to run this project in your own data warehouse (outside of t ::: -3. Test the output of the models using the test command: - - -- [dbt test](/reference/commands/test) - compiles and tests your project. - ### Troubleshoot -[review comment: love this section. consider using expandable/detail for issue below. this is a bit of "future proofing" so if another item needs to be added later, it'll be easy to just add another list-like item to section] - You may get an error like the one in the example below, in which case you will need to disconnect from any sessions that are locking the database: + + + ```Jinja IO Error: Could not set lock on file "jaffle_shop.duckdb": Resource temporarily unavailable @@ -171,6 +145,8 @@ This is a known issue in DuckDB. If you are using DBeaver, this means shutting d As a last resort, deleting the database file will get you back in action (_but_ you will lose all your data). + + @@ -207,10 +183,6 @@ As a last resort, deleting the database file will get you back in action (_but_ -Fore more information on the setup of DuckDB, you can refer to [DuckDBsetup](/docs/core/connect-data-platform/duckdb-setup). - -[review comment: as part of how to organize content, consider moving this sentence to the introduction part of the "Set up DuckDB for dbt Core" section.] - ## Generate a larger data set If you'd like to work with a larger selection of Jaffle Shop data, you can generate an arbitrary number of years of fictitious data from within your codespace. From 5da68111e89b046da671722874b883c302f746c9 Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Fri, 9 Aug 2024 13:14:07 +0100 Subject: [PATCH 035/160] Update website/docs/docs/get-started-dbt.md --- website/docs/docs/get-started-dbt.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/docs/get-started-dbt.md b/website/docs/docs/get-started-dbt.md index 11d912ec06f..61a69b94c8d 100644 --- a/website/docs/docs/get-started-dbt.md +++ b/website/docs/docs/get-started-dbt.md @@ -73,7 +73,7 @@ Learn more about [dbt Cloud features](/docs/cloud/about-cloud/dbt-cloud-feature Refer to the following quickstarts to get started with dbt Core: - [dbt Core from a manual install](/guides/manual-install) to learn how to install dbt Core and set up a project. -- [dbt Core using DuckDB](/guides/DuckDB?step=1) to learn how to connect to DuckDB and execute the `dbt build` command. +- [dbt Core using DuckDB](/guides/duckdb?step=1) to learn how to connect to DuckDB and execute the `dbt build` command. ## Related docs From 52df75926811ee0b0d471c842bda9c9b83ab6424 Mon Sep 17 00:00:00 2001 From: Natalie Fiann Date: Mon, 12 Aug 2024 16:14:21 +0100 Subject: [PATCH 036/160] Updated doc --- website/docs/guides/duckdb-qs.md | 36 ++++++++++++++++++++++++++++---- 1 file changed, 32 insertions(+), 4 deletions(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 5b9fa3dc891..6801a83dfab 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -19,12 +19,14 @@ In this quickstart guide, you'll learn how to use dbt Core with DuckDB, enabling This guide will demonstrate how to: -- Create a GitHub Codespace using a template provided by dbt Labs. +- Create an online development environment using a template provided by dbt Labs. - This sets up a fully functional dbt environment with an operational and executable project. The codespace automatically connects to the DuckDB database and loads a year's worth of data from our fictional Jaffle Shop café, which sells food and beverages in several US cities. - For additional information, refer to the [README](https://github.com/gwenwindflower/octocatalog) for the Jaffle Shop template. It includes instructions on how to do this, along with animated GIFs. - Run any dbt command from the environment’s terminal. - Generate a larger dataset for the Jaffle Shop café (for example, 5 years of data instead of just one). +You can learn [dbt Learn courses](https://learn.getdbt.com) through high-quality courses and workshops. + ### Related content @@ -34,7 +36,6 @@ This guide will demonstrate how to: - [Build your first models](/guides/manual-install?step=3) - [Test and document your project](/guides/manual-install?step=4) - [Schedule a job](/guides/manual-install?step=5) -- Learn more with [dbt Learn courses](https://learn.getdbt.com) ### Prerequisites @@ -45,7 +46,7 @@ This guide will demonstrate how to: ## Set up DuckDB for dbt Core -The following will provide a step by step guide on setting up DuckDB for both local and web browser. +The following will provide a step-by-step guide on setting up DuckDB for use in both local environments and web browsers. For more information on the setup of DuckDB, you can refer to [DuckDBsetup](/docs/core/connect-data-platform/duckdb-setup). @@ -56,7 +57,34 @@ For more information on the setup of DuckDB, you can refer to [DuckDBsetup](/doc 1. First, you'll need to clone this repository. -[review: consider adding `git clone` command as an example for step 1] +- You can add a `git clone` command for cloning a repository. You can follow these steps to achieve this: + + - Open your terminal and navigate to the directory where you want to clone the repository. Use the `cd` command to change directories. + - Go to the Git hosting service where the repository is hosted. Find the repository you want to clone and copy its URL. This URL is usually found by clicking the code or clone button on the repository's main page. + - Type `git clone` in the terminal, followed by the URL you copied. The command should look like this: + + +```Jinja + + git clone https://github.com/username/repository-name.git + +``` + +As a note, you'll need to replace https://github.com/username/repository-name.git with the actual URL of the repository you want to clone. + + - Following this, press Enter. Git will clone the repository into a new directory with the same name as the repository. This new directory will be created in the location you specified earlier. + - Once the repository is cloned, you may want to navigate into the new directory to start working on the project. Use the cd command to do this: + +```Jinja + +cd repository-name + +``` + +You'll need to replace repository name with the actual name of the cloned directory. + + - That's it! You've successfully added and executed a git clone command to clone a repository. + 2. Change into the docs-duckdb directory from the command line: From 6581ca49df2e843095933292b226037946d16ef4 Mon Sep 17 00:00:00 2001 From: Ly Nguyen Date: Tue, 13 Aug 2024 21:52:05 -0700 Subject: [PATCH 037/160] Review feedback on git clone --- website/docs/guides/duckdb-qs.md | 31 +++---------------------------- 1 file changed, 3 insertions(+), 28 deletions(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 2b733cdcf0a..b4afe938d67 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -57,34 +57,9 @@ For more information on the setup of DuckDB, you can refer to [DuckDBsetup](/doc 1. First, you'll need to clone this repository. -- You can add a `git clone` command for cloning a repository. You can follow these steps to achieve this: - - - Open your terminal and navigate to the directory where you want to clone the repository. Use the `cd` command to change directories. - - Go to the Git hosting service where the repository is hosted. Find the repository you want to clone and copy its URL. This URL is usually found by clicking the code or clone button on the repository's main page. - - Type `git clone` in the terminal, followed by the URL you copied. The command should look like this: - - -```Jinja - - git clone https://github.com/username/repository-name.git - -``` - -As a note, you'll need to replace https://github.com/username/repository-name.git with the actual URL of the repository you want to clone. - - - Following this, press Enter. Git will clone the repository into a new directory with the same name as the repository. This new directory will be created in the location you specified earlier. - - Once the repository is cloned, you may want to navigate into the new directory to start working on the project. Use the cd command to do this: - -```Jinja - -cd repository-name - -``` - -You'll need to replace repository name with the actual name of the cloned directory. - - - That's it! You've successfully added and executed a git clone command to clone a repository. - + ```bash + git clone + ``` 2. Change into the docs-duckdb directory from the command line: From 6086855426a1f4773d672c52049cfdfdcf36fece Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Wed, 14 Aug 2024 11:26:32 +0100 Subject: [PATCH 038/160] Update website/docs/guides/duckdb-qs.md Co-authored-by: Ly Nguyen <107218380+nghi-ly@users.noreply.github.com> --- website/docs/guides/duckdb-qs.md | 1 - 1 file changed, 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index b4afe938d67..207a2526d48 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -94,7 +94,6 @@ cd docs-duckdb python -m pip install -r requirements.txt venv\Scripts\activate.bat - ``` ``` From 9f05b09fac8d60cbd98dba7c7a79d602046f1f5c Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Wed, 14 Aug 2024 11:28:03 +0100 Subject: [PATCH 039/160] Update website/docs/guides/duckdb-qs.md Co-authored-by: Ly Nguyen <107218380+nghi-ly@users.noreply.github.com> --- website/docs/guides/duckdb-qs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 207a2526d48..f6f043d3bf8 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -115,7 +115,7 @@ cd docs-duckdb 4. Ensure your profile is setup correctly from the command line by running the following: - - [dbt compile](https://docs.getdbt.com/reference/commands/compile) — generates executable SQL from your project source files + - [dbt compile](https://docs.getdbt.com/reference/commands/compile) — generates executable SQL from your project source files - [dbt run](https://docs.getdbt.com/reference/commands/run) — compiles and runs your project - [dbt test](https://docs.getdbt.com/reference/commands/test) — compiles and tests your project - [dbt build](https://docs.getdbt.com/reference/commands/build) — compiles, runs, and tests your project From 77bc71d987e816bd114b1d802c37858ef34b360a Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Wed, 14 Aug 2024 11:30:35 +0100 Subject: [PATCH 040/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index f6f043d3bf8..2bd0f21fb4c 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -116,7 +116,7 @@ cd docs-duckdb - [dbt compile](https://docs.getdbt.com/reference/commands/compile) — generates executable SQL from your project source files - - [dbt run](https://docs.getdbt.com/reference/commands/run) — compiles and runs your project + - [dbt run](https://docs.getdbt.com/reference/commands/run) — compiles and runs your project - [dbt test](https://docs.getdbt.com/reference/commands/test) — compiles and tests your project - [dbt build](https://docs.getdbt.com/reference/commands/build) — compiles, runs, and tests your project - [dbt docs generate](/reference/commands/cmd-docs#dbt-docs-generate) - generates your project's documentation. From ac1dfe9b1cf9beb2fb0d921ce2f53119a7d6f21f Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Wed, 14 Aug 2024 11:30:58 +0100 Subject: [PATCH 041/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 2bd0f21fb4c..e4d06c486c3 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -117,7 +117,7 @@ cd docs-duckdb - [dbt compile](https://docs.getdbt.com/reference/commands/compile) — generates executable SQL from your project source files - [dbt run](https://docs.getdbt.com/reference/commands/run) — compiles and runs your project - - [dbt test](https://docs.getdbt.com/reference/commands/test) — compiles and tests your project + - [dbt test](https://docs.getdbt.com/reference/commands/test) — compiles and tests your project - [dbt build](https://docs.getdbt.com/reference/commands/build) — compiles, runs, and tests your project - [dbt docs generate](/reference/commands/cmd-docs#dbt-docs-generate) - generates your project's documentation. - [dbt docs serve](/reference/commands/cmd-docs#dbt-docs-serve) - starts a webserver on port 8080 to serve your documentation locally and opens the documentation site in your default browser. From d8b3160f095e617851ed2af4709f305f1a96793c Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Wed, 14 Aug 2024 11:31:24 +0100 Subject: [PATCH 042/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index e4d06c486c3..a812fb2e06e 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -118,7 +118,7 @@ cd docs-duckdb - [dbt compile](https://docs.getdbt.com/reference/commands/compile) — generates executable SQL from your project source files - [dbt run](https://docs.getdbt.com/reference/commands/run) — compiles and runs your project - [dbt test](https://docs.getdbt.com/reference/commands/test) — compiles and tests your project - - [dbt build](https://docs.getdbt.com/reference/commands/build) — compiles, runs, and tests your project + - [dbt build](https://docs.getdbt.com/reference/commands/build) — compiles, runs, and tests your project - [dbt docs generate](/reference/commands/cmd-docs#dbt-docs-generate) - generates your project's documentation. - [dbt docs serve](/reference/commands/cmd-docs#dbt-docs-serve) - starts a webserver on port 8080 to serve your documentation locally and opens the documentation site in your default browser. From 2ff2a2bf35c666c3baa94637a698060a3fddcffc Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Wed, 14 Aug 2024 11:31:55 +0100 Subject: [PATCH 043/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index a812fb2e06e..5a2b5e9aea9 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -119,7 +119,7 @@ cd docs-duckdb - [dbt run](https://docs.getdbt.com/reference/commands/run) — compiles and runs your project - [dbt test](https://docs.getdbt.com/reference/commands/test) — compiles and tests your project - [dbt build](https://docs.getdbt.com/reference/commands/build) — compiles, runs, and tests your project - - [dbt docs generate](/reference/commands/cmd-docs#dbt-docs-generate) - generates your project's documentation. + - [dbt docs generate](/reference/commands/cmd-docs#dbt-docs-generate) — generates your project's documentation. - [dbt docs serve](/reference/commands/cmd-docs#dbt-docs-serve) - starts a webserver on port 8080 to serve your documentation locally and opens the documentation site in your default browser. For detailed information, refer to the [dbt command reference](/reference/dbt-commands). From c4f939c6b5b81d1dc1d08dcbedf93f84f01bb58f Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Wed, 14 Aug 2024 11:32:21 +0100 Subject: [PATCH 044/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 5a2b5e9aea9..db9dd4ff2f3 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -120,7 +120,7 @@ cd docs-duckdb - [dbt test](https://docs.getdbt.com/reference/commands/test) — compiles and tests your project - [dbt build](https://docs.getdbt.com/reference/commands/build) — compiles, runs, and tests your project - [dbt docs generate](/reference/commands/cmd-docs#dbt-docs-generate) — generates your project's documentation. - - [dbt docs serve](/reference/commands/cmd-docs#dbt-docs-serve) - starts a webserver on port 8080 to serve your documentation locally and opens the documentation site in your default browser. + - [dbt docs serve](/reference/commands/cmd-docs#dbt-docs-serve) — starts a webserver on port 8080 to serve your documentation locally and opens the documentation site in your default browser. For detailed information, refer to the [dbt command reference](/reference/dbt-commands). From 10d6a2013ec666b55a737c42a64ce27f28e2baaa Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Wed, 14 Aug 2024 11:32:39 +0100 Subject: [PATCH 045/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index db9dd4ff2f3..3ce74c1bd29 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -116,7 +116,7 @@ cd docs-duckdb - [dbt compile](https://docs.getdbt.com/reference/commands/compile) — generates executable SQL from your project source files - - [dbt run](https://docs.getdbt.com/reference/commands/run) — compiles and runs your project + - [dbt run](https://docs.getdbt.com/reference/commands/run) — compiles and runs your project - [dbt test](https://docs.getdbt.com/reference/commands/test) — compiles and tests your project - [dbt build](https://docs.getdbt.com/reference/commands/build) — compiles, runs, and tests your project - [dbt docs generate](/reference/commands/cmd-docs#dbt-docs-generate) — generates your project's documentation. From 854db2827da3f66eef53405ff8cdc832a99d386d Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Wed, 14 Aug 2024 11:33:13 +0100 Subject: [PATCH 046/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 3ce74c1bd29..23b20edf9dd 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -117,7 +117,7 @@ cd docs-duckdb - [dbt compile](https://docs.getdbt.com/reference/commands/compile) — generates executable SQL from your project source files - [dbt run](https://docs.getdbt.com/reference/commands/run) — compiles and runs your project - - [dbt test](https://docs.getdbt.com/reference/commands/test) — compiles and tests your project + - [dbt test](https://docs.getdbt.com/reference/commands/test) — compiles and tests your project - [dbt build](https://docs.getdbt.com/reference/commands/build) — compiles, runs, and tests your project - [dbt docs generate](/reference/commands/cmd-docs#dbt-docs-generate) — generates your project's documentation. - [dbt docs serve](/reference/commands/cmd-docs#dbt-docs-serve) — starts a webserver on port 8080 to serve your documentation locally and opens the documentation site in your default browser. From eccb75becad8245f70479205f2cc8d7f219e1611 Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Wed, 14 Aug 2024 11:33:30 +0100 Subject: [PATCH 047/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 23b20edf9dd..87e6f74d1d0 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -118,7 +118,7 @@ cd docs-duckdb - [dbt compile](https://docs.getdbt.com/reference/commands/compile) — generates executable SQL from your project source files - [dbt run](https://docs.getdbt.com/reference/commands/run) — compiles and runs your project - [dbt test](https://docs.getdbt.com/reference/commands/test) — compiles and tests your project - - [dbt build](https://docs.getdbt.com/reference/commands/build) — compiles, runs, and tests your project + - [dbt build](https://docs.getdbt.com/reference/commands/build) — compiles, runs, and tests your project - [dbt docs generate](/reference/commands/cmd-docs#dbt-docs-generate) — generates your project's documentation. - [dbt docs serve](/reference/commands/cmd-docs#dbt-docs-serve) — starts a webserver on port 8080 to serve your documentation locally and opens the documentation site in your default browser. From 5de815aa9a2abe4e05369c2dd8f8757c3acaed2c Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Wed, 14 Aug 2024 11:34:01 +0100 Subject: [PATCH 048/160] Update website/docs/guides/duckdb-qs.md Co-authored-by: Ly Nguyen <107218380+nghi-ly@users.noreply.github.com> --- website/docs/guides/duckdb-qs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 87e6f74d1d0..71dc31dded6 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -122,7 +122,7 @@ cd docs-duckdb - [dbt docs generate](/reference/commands/cmd-docs#dbt-docs-generate) — generates your project's documentation. - [dbt docs serve](/reference/commands/cmd-docs#dbt-docs-serve) — starts a webserver on port 8080 to serve your documentation locally and opens the documentation site in your default browser. -For detailed information, refer to the [dbt command reference](/reference/dbt-commands). +For complete details, refer to the [dbt command reference](/reference/dbt-commands). :::note Note. From 41e19126d58ac51c7f80c159eca89f1608889ca7 Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Wed, 14 Aug 2024 11:34:19 +0100 Subject: [PATCH 049/160] Update website/docs/guides/duckdb-qs.md Co-authored-by: Ly Nguyen <107218380+nghi-ly@users.noreply.github.com> --- website/docs/guides/duckdb-qs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 71dc31dded6..cdd5fa53b44 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -144,7 +144,7 @@ IO Error: Could not set lock on file "jaffle_shop.duckdb": Resource temporarily ``` -This is a known issue in DuckDB. If you are using DBeaver, this means shutting down DBeaver (disconnecting doesn't always work). +This is a known issue in DuckDB. Try disconnecting from any sessions that are locking the database. If you are using DBeaver, this means shutting down DBeaver (disconnecting doesn't always work). As a last resort, deleting the database file will get you back in action (_but_ you will lose all your data). From 54800e274e71985fcde287982b3c14cf5fed80e4 Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Wed, 14 Aug 2024 11:35:09 +0100 Subject: [PATCH 050/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index cdd5fa53b44..0abf7ed535d 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -175,7 +175,7 @@ As a last resort, deleting the database file will get you back in action (_but_ For complete information, refer to the [dbt command reference](https://docs.getdbt.com/reference/dbt-commands). Common commands are: - - [dbt compile](https://docs.getdbt.com/reference/commands/compile) — generates executable SQL from your project source files + - [dbt compile](https://docs.getdbt.com/reference/commands/compile) — generates executable SQL from your project source files - [dbt run](https://docs.getdbt.com/reference/commands/run) — compiles and runs your project - [dbt test](https://docs.getdbt.com/reference/commands/test) — compiles and tests your project - [dbt build](https://docs.getdbt.com/reference/commands/build) — compiles, runs, and tests your project From 2362f8fb97195003511737254aa4e435975a5d5f Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Wed, 14 Aug 2024 11:35:28 +0100 Subject: [PATCH 051/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 0abf7ed535d..bfeb4e833b9 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -176,7 +176,7 @@ As a last resort, deleting the database file will get you back in action (_but_ For complete information, refer to the [dbt command reference](https://docs.getdbt.com/reference/dbt-commands). Common commands are: - [dbt compile](https://docs.getdbt.com/reference/commands/compile) — generates executable SQL from your project source files - - [dbt run](https://docs.getdbt.com/reference/commands/run) — compiles and runs your project + - [dbt run](https://docs.getdbt.com/reference/commands/run) — compiles and runs your project - [dbt test](https://docs.getdbt.com/reference/commands/test) — compiles and tests your project - [dbt build](https://docs.getdbt.com/reference/commands/build) — compiles, runs, and tests your project From 1aa255c420b34eb2478bc549ba5100b57b5e6177 Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Wed, 14 Aug 2024 11:35:50 +0100 Subject: [PATCH 052/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index bfeb4e833b9..9123abcd423 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -177,7 +177,7 @@ As a last resort, deleting the database file will get you back in action (_but_ - [dbt compile](https://docs.getdbt.com/reference/commands/compile) — generates executable SQL from your project source files - [dbt run](https://docs.getdbt.com/reference/commands/run) — compiles and runs your project - - [dbt test](https://docs.getdbt.com/reference/commands/test) — compiles and tests your project + - [dbt test](https://docs.getdbt.com/reference/commands/test) — compiles and tests your project - [dbt build](https://docs.getdbt.com/reference/commands/build) — compiles, runs, and tests your project From c2fea76da8f7a7cbd1ac0302d70d6b8fedefc29b Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Wed, 14 Aug 2024 11:36:09 +0100 Subject: [PATCH 053/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 9123abcd423..d2cb9b68864 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -178,7 +178,7 @@ As a last resort, deleting the database file will get you back in action (_but_ - [dbt compile](https://docs.getdbt.com/reference/commands/compile) — generates executable SQL from your project source files - [dbt run](https://docs.getdbt.com/reference/commands/run) — compiles and runs your project - [dbt test](https://docs.getdbt.com/reference/commands/test) — compiles and tests your project - - [dbt build](https://docs.getdbt.com/reference/commands/build) — compiles, runs, and tests your project + - [dbt build](https://docs.getdbt.com/reference/commands/build) — compiles, runs, and tests your project From 6b3f4dcc700f7a8bc28e874fb702379af93f62a0 Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Wed, 14 Aug 2024 11:36:42 +0100 Subject: [PATCH 054/160] Update website/docs/guides/duckdb-qs.md Co-authored-by: Ly Nguyen <107218380+nghi-ly@users.noreply.github.com> --- website/docs/guides/duckdb-qs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index d2cb9b68864..c4ec527206d 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -124,7 +124,7 @@ cd docs-duckdb For complete details, refer to the [dbt command reference](/reference/dbt-commands). -:::note Note. +:::note NOTE: If you decide to run this project in your own data warehouse (outside of this DuckDB demo) and steps fail, it might mean that you need to make small changes to the SQL in the models folder to adjust for the flavor of SQL of your target database. Definitely consider this if you are using a community-contributed adapter. From 449e38c35eb24a081cbe4b8b2ce259919845c835 Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Wed, 14 Aug 2024 11:37:00 +0100 Subject: [PATCH 055/160] Update website/docs/guides/duckdb-qs.md Co-authored-by: Ly Nguyen <107218380+nghi-ly@users.noreply.github.com> --- website/docs/guides/duckdb-qs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index c4ec527206d..711af503af0 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -126,7 +126,7 @@ For complete details, refer to the [dbt command reference](/reference/dbt-comman :::note -NOTE: If you decide to run this project in your own data warehouse (outside of this DuckDB demo) and steps fail, it might mean that you need to make small changes to the SQL in the models folder to adjust for the flavor of SQL of your target database. Definitely consider this if you are using a community-contributed adapter. +If you decide to run this project in your own data warehouse (outside of this DuckDB demo) and steps fail, it might mean that you need to make small changes to the SQL in the models folder to adjust for the flavor of SQL of your target database. Definitely consider this if you are using a community-contributed adapter. ::: From f4e204b76f3581656c294bc85f24b43990a19554 Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Wed, 14 Aug 2024 11:37:21 +0100 Subject: [PATCH 056/160] Update website/docs/guides/duckdb-qs.md Co-authored-by: Ly Nguyen <107218380+nghi-ly@users.noreply.github.com> --- website/docs/guides/duckdb-qs.md | 1 - 1 file changed, 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 711af503af0..a6d64240160 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -133,7 +133,6 @@ If you decide to run this project in your own data warehouse (outside of this Du ### Troubleshoot -You may get an error like the one in the example below, in which case you will need to disconnect from any sessions that are locking the database: From 9d25f13fe5e2c608890ba63f6a00429500a150ab Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Thu, 15 Aug 2024 10:10:49 +0100 Subject: [PATCH 057/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index a6d64240160..e458301349f 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -19,7 +19,7 @@ In this quickstart guide, you'll learn how to use dbt Core with DuckDB, enabling This guide will demonstrate how to: -- Create an online development environment using a template provided by dbt Labs. +- Create an virtual development environment using a template provided by dbt Labs. - This sets up a fully functional dbt environment with an operational and executable project. The codespace automatically connects to the DuckDB database and loads a year's worth of data from our fictional Jaffle Shop café, which sells food and beverages in several US cities. - For additional information, refer to the [README](https://github.com/gwenwindflower/octocatalog) for the Jaffle Shop template. It includes instructions on how to do this, along with animated GIFs. - Run any dbt command from the environment’s terminal. From 6997420b1b948892abddfb12ff45021ca1267713 Mon Sep 17 00:00:00 2001 From: Natalie Fiann Date: Thu, 15 Aug 2024 10:28:24 +0100 Subject: [PATCH 058/160] Updated docs --- website/docs/guides/duckdb-qs.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index b4afe938d67..18b992eb277 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -63,11 +63,11 @@ For more information on the setup of DuckDB, you can refer to [DuckDBsetup](/doc 2. Change into the docs-duckdb directory from the command line: -```Jinja + ```Jinja -cd docs-duckdb + cd docs-duckdb -``` + ``` 3. Install dbt and DuckDB in a virtual environment. From 4c1303abf8faf8d5a9ea125884109c23a7627464 Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Thu, 15 Aug 2024 11:41:06 +0100 Subject: [PATCH 059/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 4f3831bf254..c653dca82d6 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -19,7 +19,7 @@ In this quickstart guide, you'll learn how to use dbt Core with DuckDB, enabling This guide will demonstrate how to: -- Create an virtual development environment using a template provided by dbt Labs. +- Create a virtual development environment using a template provided by dbt Labs. - This sets up a fully functional dbt environment with an operational and executable project. The codespace automatically connects to the DuckDB database and loads a year's worth of data from our fictional Jaffle Shop café, which sells food and beverages in several US cities. - For additional information, refer to the [README](https://github.com/gwenwindflower/octocatalog) for the Jaffle Shop template. It includes instructions on how to do this, along with animated GIFs. - Run any dbt command from the environment’s terminal. From 77870119b74c2cc3c56d8fdff7f2c70031d84851 Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Thu, 15 Aug 2024 12:00:16 +0100 Subject: [PATCH 060/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 1 - 1 file changed, 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index c653dca82d6..c5d8eb58cd5 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -59,7 +59,6 @@ For more information on the setup of DuckDB, you can refer to [DuckDBsetup](/doc ```bash git clone - ``` 2. Change into the docs-duckdb directory from the command line: From ab914d59a5d9e508512027dc116b2a1296026edb Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Thu, 15 Aug 2024 12:00:40 +0100 Subject: [PATCH 061/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 1 - 1 file changed, 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index c5d8eb58cd5..24355101a99 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -57,7 +57,6 @@ For more information on the setup of DuckDB, you can refer to [DuckDBsetup](/doc 1. First, you'll need to clone this repository. - ```bash git clone 2. Change into the docs-duckdb directory from the command line: From 4d886b4c9cba9e0aea686426f5973fcaffeb78e0 Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Thu, 15 Aug 2024 12:03:41 +0100 Subject: [PATCH 062/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 24355101a99..8c94b2dfc37 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -57,7 +57,7 @@ For more information on the setup of DuckDB, you can refer to [DuckDBsetup](/doc 1. First, you'll need to clone this repository. - git clone +For more information, read the [Git Guide](https://github.com/git-guides/git-clone) 2. Change into the docs-duckdb directory from the command line: From f7db06a78ead843e3ff7399b4e6051fca9517931 Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Thu, 15 Aug 2024 13:56:37 +0100 Subject: [PATCH 063/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 8c94b2dfc37..93b0d0d0fd4 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -59,6 +59,10 @@ For more information on the setup of DuckDB, you can refer to [DuckDBsetup](/doc For more information, read the [Git Guide](https://github.com/git-guides/git-clone) +You can access the repository for DuckDB by following the URL: + +```bash +https://github.com/duckdb/duckdb.git 2. Change into the docs-duckdb directory from the command line: ```Jinja From 2458acc270baa9d997ca8f9b42c5f5fd3d37a408 Mon Sep 17 00:00:00 2001 From: Natalie Fiann Date: Fri, 16 Aug 2024 12:01:59 +0100 Subject: [PATCH 064/160] Added indentation and updates --- website/docs/guides/duckdb-qs.md | 36 ++++++++++++++++++-------------- 1 file changed, 20 insertions(+), 16 deletions(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 93b0d0d0fd4..a9455df5be5 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -57,19 +57,23 @@ For more information on the setup of DuckDB, you can refer to [DuckDBsetup](/doc 1. First, you'll need to clone this repository. -For more information, read the [Git Guide](https://github.com/git-guides/git-clone) - You can access the repository for DuckDB by following the URL: ```bash https://github.com/duckdb/duckdb.git + +``` + 2. Change into the docs-duckdb directory from the command line: - ```Jinja +```Jinja - cd docs-duckdb +cd docs-duckdb + +``` + +For more information, read the [Git Guide](https://github.com/git-guides/git-clone). - ``` 3. Install dbt and DuckDB in a virtual environment. @@ -124,32 +128,32 @@ https://github.com/duckdb/duckdb.git - [dbt docs generate](/reference/commands/cmd-docs#dbt-docs-generate) — generates your project's documentation. - [dbt docs serve](/reference/commands/cmd-docs#dbt-docs-serve) — starts a webserver on port 8080 to serve your documentation locally and opens the documentation site in your default browser. -For complete details, refer to the [dbt command reference](/reference/dbt-commands). + For complete details, refer to the [dbt command reference](/reference/dbt-commands). -:::note + :::note -If you decide to run this project in your own data warehouse (outside of this DuckDB demo) and steps fail, it might mean that you need to make small changes to the SQL in the models folder to adjust for the flavor of SQL of your target database. Definitely consider this if you are using a community-contributed adapter. + If you decide to run this project in your own data warehouse (outside of this DuckDB demo) and steps fail, it might mean that you need to make small changes to the SQL in the models folder to adjust for the flavor of SQL of your target database. Definitely consider this if you are using a community-contributed adapter. -::: + ::: ### Troubleshoot - + -```Jinja + ```Jinja -IO Error: Could not set lock on file "jaffle_shop.duckdb": Resource temporarily unavailable + IO Error: Could not set lock on file "jaffle_shop.duckdb": Resource temporarily unavailable -``` + ``` -This is a known issue in DuckDB. Try disconnecting from any sessions that are locking the database. If you are using DBeaver, this means shutting down DBeaver (disconnecting doesn't always work). + This is a known issue in DuckDB. Try disconnecting from any sessions that are locking the database. If you are using DBeaver, this means shutting down DBeaver (disconnecting doesn't always work). -As a last resort, deleting the database file will get you back in action (_but_ you will lose all your data). + As a last resort, deleting the database file will get you back in action (_but_ you will lose all your data). - + From 00b70da25afb709297b42cfe53d78b369ae508b0 Mon Sep 17 00:00:00 2001 From: Natalie Fiann Date: Fri, 16 Aug 2024 15:19:51 +0100 Subject: [PATCH 065/160] Further indentation and updates --- website/docs/guides/duckdb-qs.md | 26 +++++++++++++------------- 1 file changed, 13 insertions(+), 13 deletions(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index a9455df5be5..e58358315ea 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -57,22 +57,22 @@ For more information on the setup of DuckDB, you can refer to [DuckDBsetup](/doc 1. First, you'll need to clone this repository. -You can access the repository for DuckDB by following the URL: + You can access the repository for DuckDB by following the URL: -```bash -https://github.com/duckdb/duckdb.git + ```bash + https://github.com/duckdb/duckdb.git -``` + ``` 2. Change into the docs-duckdb directory from the command line: -```Jinja + ```Jinja -cd docs-duckdb + cd docs-duckdb -``` + ``` -For more information, read the [Git Guide](https://github.com/git-guides/git-clone). + For a more comprehensive understanding and additional information, refer to the [Git Guide](https://github.com/git-guides/git-clone). 3. Install dbt and DuckDB in a virtual environment. @@ -130,11 +130,11 @@ For more information, read the [Git Guide](https://github.com/git-guides/git-clo For complete details, refer to the [dbt command reference](/reference/dbt-commands). - :::note +:::note - If you decide to run this project in your own data warehouse (outside of this DuckDB demo) and steps fail, it might mean that you need to make small changes to the SQL in the models folder to adjust for the flavor of SQL of your target database. Definitely consider this if you are using a community-contributed adapter. +If you decide to run this project in your own data warehouse (outside of this DuckDB demo) and steps fail, it might mean that you need to make small changes to the SQL in the models folder to adjust for the flavor of SQL of your target database. Definitely consider this if you are using a community-contributed adapter. - ::: +::: ### Troubleshoot @@ -156,9 +156,9 @@ For more information, read the [Git Guide](https://github.com/git-guides/git-clo - + - + 1. Go to the `jaffle-shop-template` [repository](https://github.com/dbt-labs/jaffle-shop-template) after you log in to your GitHub account. 1. Click **Use this template** at the top of the page and choose **Create new repository**. From 7990ade58552f2942b89122b2f5e08d46aaf75dd Mon Sep 17 00:00:00 2001 From: Natalie Fiann Date: Mon, 19 Aug 2024 14:05:58 +0100 Subject: [PATCH 066/160] Updated section 2 clone repo --- website/docs/guides/duckdb-qs.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index e58358315ea..2df54b63b5a 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -57,10 +57,12 @@ For more information on the setup of DuckDB, you can refer to [DuckDBsetup](/doc 1. First, you'll need to clone this repository. + For a more comprehensive understanding and additional information, refer to the [Git Guide](https://github.com/git-guides/git-clone). + You can access the repository for DuckDB by following the URL: ```bash - https://github.com/duckdb/duckdb.git + git clone https://github.com.dbt-labs/jaffle_shop_duckdb.git ``` @@ -68,12 +70,10 @@ For more information on the setup of DuckDB, you can refer to [DuckDBsetup](/doc ```Jinja - cd docs-duckdb + cd jaffle_shop_duck_db ``` - For a more comprehensive understanding and additional information, refer to the [Git Guide](https://github.com/git-guides/git-clone). - 3. Install dbt and DuckDB in a virtual environment. From fdfec1dcd4149ff15b767d666c8a556fc7b97125 Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Mon, 19 Aug 2024 20:47:14 +0100 Subject: [PATCH 067/160] Update website/docs/guides/duckdb-qs.md Co-authored-by: Matt Shaver <60105315+matthewshaver@users.noreply.github.com> --- website/docs/guides/duckdb-qs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 2df54b63b5a..cdf5b482266 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -68,7 +68,7 @@ For more information on the setup of DuckDB, you can refer to [DuckDBsetup](/doc 2. Change into the docs-duckdb directory from the command line: - ```Jinja + ```shell cd jaffle_shop_duck_db From 28db5a45666d04d43352e3993bec9d4cfbfa874e Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Mon, 19 Aug 2024 20:47:52 +0100 Subject: [PATCH 068/160] Update website/docs/guides/duckdb-qs.md Co-authored-by: Matt Shaver <60105315+matthewshaver@users.noreply.github.com> --- website/docs/guides/duckdb-qs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index cdf5b482266..27167c44fe7 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -23,7 +23,7 @@ This guide will demonstrate how to: - This sets up a fully functional dbt environment with an operational and executable project. The codespace automatically connects to the DuckDB database and loads a year's worth of data from our fictional Jaffle Shop café, which sells food and beverages in several US cities. - For additional information, refer to the [README](https://github.com/gwenwindflower/octocatalog) for the Jaffle Shop template. It includes instructions on how to do this, along with animated GIFs. - Run any dbt command from the environment’s terminal. -- Generate a larger dataset for the Jaffle Shop café (for example, 5 years of data instead of just one). +- Generate a larger dataset for the Jaffle Shop café (for example, five years of data instead of just one). You can learn [dbt Learn courses](https://learn.getdbt.com) through high-quality courses and workshops. From 727e442013f2ae253406f39c781f439e695b7346 Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Mon, 19 Aug 2024 20:48:13 +0100 Subject: [PATCH 069/160] Update website/docs/guides/duckdb-qs.md Co-authored-by: Matt Shaver <60105315+matthewshaver@users.noreply.github.com> --- website/docs/guides/duckdb-qs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 27167c44fe7..238d20132f0 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -55,7 +55,7 @@ For more information on the setup of DuckDB, you can refer to [DuckDBsetup](/doc -1. First, you'll need to clone this repository. +1. First, you'll need to [clone](https://github.com/git-guides/git-clone) the Jaffle Shop repository by running the following command in your terminal: For a more comprehensive understanding and additional information, refer to the [Git Guide](https://github.com/git-guides/git-clone). From 1a1ae4b67f2da507cdaf01ce819b83dbe256ce42 Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Mon, 19 Aug 2024 20:48:38 +0100 Subject: [PATCH 070/160] Update website/docs/guides/duckdb-qs.md Co-authored-by: Matt Shaver <60105315+matthewshaver@users.noreply.github.com> --- website/docs/guides/duckdb-qs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 238d20132f0..2ea96b30671 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -25,7 +25,7 @@ This guide will demonstrate how to: - Run any dbt command from the environment’s terminal. - Generate a larger dataset for the Jaffle Shop café (for example, five years of data instead of just one). -You can learn [dbt Learn courses](https://learn.getdbt.com) through high-quality courses and workshops. +You can learn more through high-quality [dbt Learn courses and workshops](https://learn.getdbt.com). ### Related content From c2c23f86d59752bc6ffa530bc5b1d88e20c0a213 Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Mon, 19 Aug 2024 20:48:52 +0100 Subject: [PATCH 071/160] Update website/docs/guides/duckdb-qs.md Co-authored-by: Matt Shaver <60105315+matthewshaver@users.noreply.github.com> --- website/docs/guides/duckdb-qs.md | 1 - 1 file changed, 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 2ea96b30671..697e5a58645 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -57,7 +57,6 @@ For more information on the setup of DuckDB, you can refer to [DuckDBsetup](/doc 1. First, you'll need to [clone](https://github.com/git-guides/git-clone) the Jaffle Shop repository by running the following command in your terminal: - For a more comprehensive understanding and additional information, refer to the [Git Guide](https://github.com/git-guides/git-clone). You can access the repository for DuckDB by following the URL: From b1030c96b7df4773941f559e78d112360eb1275f Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Mon, 19 Aug 2024 20:49:14 +0100 Subject: [PATCH 072/160] Update website/docs/guides/duckdb-qs.md Co-authored-by: Matt Shaver <60105315+matthewshaver@users.noreply.github.com> --- website/docs/guides/duckdb-qs.md | 1 - 1 file changed, 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 697e5a58645..574c54d600d 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -58,7 +58,6 @@ For more information on the setup of DuckDB, you can refer to [DuckDBsetup](/doc 1. First, you'll need to [clone](https://github.com/git-guides/git-clone) the Jaffle Shop repository by running the following command in your terminal: - You can access the repository for DuckDB by following the URL: ```bash git clone https://github.com.dbt-labs/jaffle_shop_duckdb.git From 1233c9140e02e92c9de70513489e48756b1f4034 Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Mon, 19 Aug 2024 20:49:37 +0100 Subject: [PATCH 073/160] Update website/docs/guides/duckdb-qs.md Co-authored-by: Matt Shaver <60105315+matthewshaver@users.noreply.github.com> --- website/docs/guides/duckdb-qs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 574c54d600d..c3cc90d1d5c 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -73,7 +73,7 @@ For more information on the setup of DuckDB, you can refer to [DuckDBsetup](/doc ``` -3. Install dbt and DuckDB in a virtual environment. +3. Install dbt Core and DuckDB in a virtual environment. From 4881a8c210fd4cd4fb2671223076113f4d1a27b2 Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Mon, 19 Aug 2024 20:50:16 +0100 Subject: [PATCH 074/160] Update website/docs/guides/duckdb-qs.md Co-authored-by: Matt Shaver <60105315+matthewshaver@users.noreply.github.com> --- website/docs/guides/duckdb-qs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index c3cc90d1d5c..b39173b9552 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -130,7 +130,7 @@ For more information on the setup of DuckDB, you can refer to [DuckDBsetup](/doc :::note -If you decide to run this project in your own data warehouse (outside of this DuckDB demo) and steps fail, it might mean that you need to make small changes to the SQL in the models folder to adjust for the flavor of SQL of your target database. Definitely consider this if you are using a community-contributed adapter. +The steps will fail if you decide to run this project in your data warehouse (outside of this DuckDB demo). You will need to reconfigure the project files for your warehouse. Definitely consider this if you are using a community-contributed adapter. ::: From 59c81d5604d84f1dc2dbe2b1840ac13f57b6d75a Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Mon, 19 Aug 2024 20:50:34 +0100 Subject: [PATCH 075/160] Update website/docs/guides/duckdb-qs.md Co-authored-by: Matt Shaver <60105315+matthewshaver@users.noreply.github.com> --- website/docs/guides/duckdb-qs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index b39173b9552..b0e6f9107ec 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -46,7 +46,7 @@ You can learn more through high-quality [dbt Learn courses and workshops](https: ## Set up DuckDB for dbt Core -The following will provide a step-by-step guide on setting up DuckDB for use in both local environments and web browsers. +The following provides a step-by-step guide for setting up DuckDB for use in local (Mac and Windows) environments and web browsers. For more information on the setup of DuckDB, you can refer to [DuckDBsetup](/docs/core/connect-data-platform/duckdb-setup). From 438ff114b0f28370560b33b9d11a617ad3c28d71 Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Mon, 19 Aug 2024 20:50:57 +0100 Subject: [PATCH 076/160] Update website/docs/guides/duckdb-qs.md Co-authored-by: Matt Shaver <60105315+matthewshaver@users.noreply.github.com> --- website/docs/guides/duckdb-qs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index b0e6f9107ec..0f8fbe6c690 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -77,7 +77,7 @@ For more information on the setup of DuckDB, you can refer to [DuckDBsetup](/doc - ```Jinja + ```shell python3 -m venv venv source venv/bin/activate From 54df96fc32a3eddf661ebe8f638120a944c55331 Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Mon, 19 Aug 2024 20:51:07 +0100 Subject: [PATCH 077/160] Update website/docs/guides/duckdb-qs.md Co-authored-by: Matt Shaver <60105315+matthewshaver@users.noreply.github.com> --- website/docs/guides/duckdb-qs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 0f8fbe6c690..a0d033ef517 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -90,7 +90,7 @@ For more information on the setup of DuckDB, you can refer to [DuckDBsetup](/doc - ```Jinja + ```shell python -m venv venv venv\Scripts\activate.bat From 8def9ac567503ef0e48cbcb9c571001cedac3a0a Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Mon, 19 Aug 2024 20:51:22 +0100 Subject: [PATCH 078/160] Update website/docs/guides/duckdb-qs.md Co-authored-by: Matt Shaver <60105315+matthewshaver@users.noreply.github.com> --- website/docs/guides/duckdb-qs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index a0d033ef517..af888672c7e 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -104,7 +104,7 @@ For more information on the setup of DuckDB, you can refer to [DuckDBsetup](/doc - ```Jinja + ```shell python -m venv venv venv\Scripts\Activate.ps1 From ccabf79fa0a870ab024990306d173b1a8bdec916 Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Mon, 19 Aug 2024 20:51:35 +0100 Subject: [PATCH 079/160] Update website/docs/guides/duckdb-qs.md Co-authored-by: Matt Shaver <60105315+matthewshaver@users.noreply.github.com> --- website/docs/guides/duckdb-qs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index af888672c7e..465d5a7c250 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -75,7 +75,7 @@ For more information on the setup of DuckDB, you can refer to [DuckDBsetup](/doc 3. Install dbt Core and DuckDB in a virtual environment. - + ```shell From 0a38455c7d3b20c08b2fffed796a5c8885c61450 Mon Sep 17 00:00:00 2001 From: Natalie Fiann Date: Tue, 20 Aug 2024 12:56:36 +0100 Subject: [PATCH 080/160] Add requirements.txt section --- website/docs/guides/duckdb-qs.md | 19 ++++++++++++++++++- 1 file changed, 18 insertions(+), 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 465d5a7c250..de437c0a117 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -46,9 +46,26 @@ You can learn more through high-quality [dbt Learn courses and workshops](https: ## Set up DuckDB for dbt Core +The `requirements.txt` file is used to install dbt Core, DuckDB, and all other necessary dependencies. You can check this file to see what will be installed on your machine. It's typically located in the root directory of your project. + +The `requirements.txt` file is placed at the top level of your dbt project directory, alongside other key files like `dbt_project.yml`: + + +```shell + +/my_dbt_project/ +├── dbt_project.yml +├── models/ +│ ├── my_model.sql +├── tests/ +│ ├── my_test.sql +└── requirements.txt + +``` + The following provides a step-by-step guide for setting up DuckDB for use in local (Mac and Windows) environments and web browsers. -For more information on the setup of DuckDB, you can refer to [DuckDBsetup](/docs/core/connect-data-platform/duckdb-setup). +For more information on the setup of DuckDB, you can refer to [DuckDB setup](/docs/core/connect-data-platform/duckdb-setup). From 02cb68fbf42789cffe4ef7d8be60284e6eb682bb Mon Sep 17 00:00:00 2001 From: Natalie Fiann Date: Wed, 21 Aug 2024 11:40:50 +0100 Subject: [PATCH 081/160] Updated requirements.txt section --- website/docs/guides/duckdb-qs.md | 9 ++++----- 1 file changed, 4 insertions(+), 5 deletions(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index de437c0a117..efa81386765 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -31,7 +31,7 @@ You can learn more through high-quality [dbt Learn courses and workshops](https: ### Related content -- [DuckDBsetup](/docs/core/connect-data-platform/duckdb-setup) +- [DuckDB setup](/docs/core/connect-data-platform/duckdb-setup) - [Create a GitHub repository](/guides/manual-install?step=2) - [Build your first models](/guides/manual-install?step=3) - [Test and document your project](/guides/manual-install?step=4) @@ -46,7 +46,9 @@ You can learn more through high-quality [dbt Learn courses and workshops](https: ## Set up DuckDB for dbt Core -The `requirements.txt` file is used to install dbt Core, DuckDB, and all other necessary dependencies. You can check this file to see what will be installed on your machine. It's typically located in the root directory of your project. +This section will provide a step-by-step guide for setting up DuckDB for use in local (Mac and Windows) environments and web browsers. + +In the repository, there's a [`requirements.txt`](https://github.com/dbt-labs/jaffle_shop_duckdb) file which is used to install dbt Core, DuckDB, and all other necessary dependencies. You can check this file to see what will be installed on your machine. It's typically located in the root directory of your project. The `requirements.txt` file is placed at the top level of your dbt project directory, alongside other key files like `dbt_project.yml`: @@ -63,11 +65,8 @@ The `requirements.txt` file is placed at the top level of your dbt project direc ``` -The following provides a step-by-step guide for setting up DuckDB for use in local (Mac and Windows) environments and web browsers. - For more information on the setup of DuckDB, you can refer to [DuckDB setup](/docs/core/connect-data-platform/duckdb-setup). - From d0bb6228b8aa181e6da1ed91b4d3bd9a14e3a4a1 Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Wed, 11 Sep 2024 14:50:51 +0100 Subject: [PATCH 082/160] Update website/docs/guides/duckdb-qs.md Co-authored-by: Ly Nguyen <107218380+nghi-ly@users.noreply.github.com> --- website/docs/guides/duckdb-qs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index efa81386765..39423cc7c89 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -71,7 +71,7 @@ For more information on the setup of DuckDB, you can refer to [DuckDB setup](/do -1. First, you'll need to [clone](https://github.com/git-guides/git-clone) the Jaffle Shop repository by running the following command in your terminal: +1. First, [clone](https://git-scm.com/docs/git-clone/en) the Jaffle Shop git repository by running the following command in your terminal: From e8ace068a2c84ea2c38da5183acbd80c7a938338 Mon Sep 17 00:00:00 2001 From: Natalie Fiann Date: Tue, 1 Oct 2024 16:09:43 +0100 Subject: [PATCH 083/160] Reviewed gist changes --- website/docs/guides/duckdb-qs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 39423cc7c89..dfc0ee364c0 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -223,4 +223,4 @@ If you'd like to work with a larger selection of Jaffle Shop data, you can gener As you increase the number of years, it takes exponentially more time to generate the data because the Jaffle Shop stores grow in size and number. For a good balance of data size and time to build, dbt Labs suggests a maximum of 6 years. - \ No newline at end of file + From aa25afda1ea7fa532866606c325d317ca5068b4f Mon Sep 17 00:00:00 2001 From: Natalie Fiann Date: Mon, 14 Oct 2024 15:02:13 +0100 Subject: [PATCH 084/160] Added redirects --- website/vercel.json | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/website/vercel.json b/website/vercel.json index 9cf623319d1..4d5a61c81ac 100644 --- a/website/vercel.json +++ b/website/vercel.json @@ -2,6 +2,26 @@ "cleanUrls": true, "trailingSlash": false, "redirects": [ + { + "source": "/guides/codespace?step=4", + "destination": "/guides/duckdb?step=3", + "permanent": true + }, + { + "source": "/guides/codespace?step=3", + "destination": "/guides/duckdb?step=2", + "permanent": true + }, + { + "source": "/guides/codespace?step=2", + "destination": "/guides/duckdb?step=1", + "permanent": true + }, + { + "source": "/guides/codespace?step=1", + "destination": "/guides/duckdb?step=1", + "permanent": true + }, { "source": "/docs/dbt-cloud-apis/sl-manifest", "destination": "/reference/artifacts/sl-manifest", From 6d935f03c95c965fcbc9121007d366f025621787 Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Mon, 14 Oct 2024 16:11:34 +0100 Subject: [PATCH 085/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index dfc0ee364c0..2125451e3f3 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -38,7 +38,7 @@ You can learn more through high-quality [dbt Learn courses and workshops](https: - [Schedule a job](/guides/manual-install?step=5) -### Prerequisites +## Prerequisites - When using DuckDB with dbt Core, you'll need to use the dbt command-line interface (CLI). Currently, DuckDB is not supported in dbt Cloud. - It's important that you know some basics of the terminal. In particular, you should understand `cd`, `ls` , and `pwd` to navigate through the directory structure of your computer easily. From 5f1b12ea854551191172c1f4136eb4bcce1d5085 Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Mon, 14 Oct 2024 16:13:18 +0100 Subject: [PATCH 086/160] Update website/docs/guides/duckdb-qs.md Co-authored-by: Mirna Wong <89008547+mirnawong1@users.noreply.github.com> --- website/docs/guides/duckdb-qs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 2125451e3f3..601503d4598 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -76,7 +76,7 @@ For more information on the setup of DuckDB, you can refer to [DuckDB setup](/do ```bash - git clone https://github.com.dbt-labs/jaffle_shop_duckdb.git + git clone https://github.com/dbt-labs/jaffle_shop_duckdb.git ``` From c7857ed0e0d0a4753f8466f8b769be06175b1f84 Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Mon, 14 Oct 2024 16:18:24 +0100 Subject: [PATCH 087/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 601503d4598..5f796d75220 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -71,7 +71,7 @@ For more information on the setup of DuckDB, you can refer to [DuckDB setup](/do -1. First, [clone](https://git-scm.com/docs/git-clone/en) the Jaffle Shop git repository by running the following command in your terminal: +1. First, [clone](https://git-scm.com/docs/git-clone) the Jaffle Shop git repository by running the following command in your terminal: From 5f7b929d0fb2f275e98028e4337141c4f442f180 Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Mon, 14 Oct 2024 16:19:41 +0100 Subject: [PATCH 088/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 5f796d75220..c3defbe89a9 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -174,7 +174,7 @@ The steps will fail if you decide to run this project in your data warehouse (ou -1. Go to the `jaffle-shop-template` [repository](https://github.com/dbt-labs/jaffle-shop-template) after you log in to your GitHub account. +1. Go to the `jaffle-shop-template` [repository](https://github.com/gwenwindflower/octocatalog) after you log in to your GitHub account. 1. Click **Use this template** at the top of the page and choose **Create new repository**. 1. Click **Create repository from template** when you’re done setting the options for your new repository. 1. Click **Code** (at the top of the new repository’s page). Under the **Codespaces** tab, choose **Create codespace on main**. Depending on how you've configured your computer's settings, this either opens a new browser tab with the Codespace development environment with VSCode running in it or opens a new VSCode window with the codespace in it. From 814802f8976071183dd5feef32f675bdc4867bc1 Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Mon, 14 Oct 2024 17:00:35 +0100 Subject: [PATCH 089/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 24 +++++++++++++++++++++++- 1 file changed, 23 insertions(+), 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index c3defbe89a9..1a87f825a10 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -141,7 +141,29 @@ For more information on the setup of DuckDB, you can refer to [DuckDB setup](/do - [dbt build](https://docs.getdbt.com/reference/commands/build) — compiles, runs, and tests your project - [dbt docs generate](/reference/commands/cmd-docs#dbt-docs-generate) — generates your project's documentation. - [dbt docs serve](/reference/commands/cmd-docs#dbt-docs-serve) — starts a webserver on port 8080 to serve your documentation locally and opens the documentation site in your default browser. - +Here's what a successful output will look like: + +```jinja + +(venv) ➜ jaffle_shop_duckdb git:(duckdb) dbt build +15:10:12 Running with dbt=1.8.1 +15:10:13 Registered adapter: duckdb=1.8.1 +15:10:13 Found 5 models, 3 seeds, 20 data tests, 416 macros +15:10:13 +15:10:14 Concurrency: 24 threads (target='dev') +15:10:14 +15:10:14 1 of 28 START seed file main.raw_customers ..................................... [RUN] +15:10:14 2 of 28 START seed file main.raw_orders ........................................ [RUN] +15:10:14 3 of 28 START seed file main.raw_payments ...................................... [RUN] +.... + +15:10:15 27 of 28 PASS relationships_orders_customer_id__customer_id__ref_customers_ .... [PASS in 0.32s] +15:10:15 +15:10:15 Finished running 3 seeds, 3 view models, 20 data tests, 2 table models in 0 hours 0 minutes and 1.52 seconds (1.52s). +15:10:15 +15:10:15 Completed successfully +15:10:15 +15:10:15 Done. PASS=28 WARN=0 ERROR=0 SKIP=0 TOTAL=28 For complete details, refer to the [dbt command reference](/reference/dbt-commands). :::note From 7266ac4a14790346619e38c4fdaef32075ab58bb Mon Sep 17 00:00:00 2001 From: Natalie Fiann Date: Mon, 14 Oct 2024 17:04:11 +0100 Subject: [PATCH 090/160] Added successful output code example --- website/docs/guides/duckdb-qs.md | 53 ++++++++++++++++++++++++++++++++ 1 file changed, 53 insertions(+) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index dfc0ee364c0..594dd0124cd 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -142,6 +142,32 @@ For more information on the setup of DuckDB, you can refer to [DuckDB setup](/do - [dbt docs generate](/reference/commands/cmd-docs#dbt-docs-generate) — generates your project's documentation. - [dbt docs serve](/reference/commands/cmd-docs#dbt-docs-serve) — starts a webserver on port 8080 to serve your documentation locally and opens the documentation site in your default browser. +Here's what a successful output will look like: + +```jinja + +(venv) ➜ jaffle_shop_duckdb git:(duckdb) dbt build +15:10:12 Running with dbt=1.8.1 +15:10:13 Registered adapter: duckdb=1.8.1 +15:10:13 Found 5 models, 3 seeds, 20 data tests, 416 macros +15:10:13 +15:10:14 Concurrency: 24 threads (target='dev') +15:10:14 +15:10:14 1 of 28 START seed file main.raw_customers ..................................... [RUN] +15:10:14 2 of 28 START seed file main.raw_orders ........................................ [RUN] +15:10:14 3 of 28 START seed file main.raw_payments ...................................... [RUN] +.... + +15:10:15 27 of 28 PASS relationships_orders_customer_id__customer_id__ref_customers_ .... [PASS in 0.32s] +15:10:15 +15:10:15 Finished running 3 seeds, 3 view models, 20 data tests, 2 table models in 0 hours 0 minutes and 1.52 seconds (1.52s). +15:10:15 +15:10:15 Completed successfully +15:10:15 +15:10:15 Done. PASS=28 WARN=0 ERROR=0 SKIP=0 TOTAL=28 + +``` + For complete details, refer to the [dbt command reference](/reference/dbt-commands). :::note @@ -204,6 +230,33 @@ The steps will fail if you decide to run this project in your data warehouse (ou +```suggestion +Here's what a successful output will look like: + +```jinja + +(venv) ➜ jaffle_shop_duckdb git:(duckdb) dbt build +15:10:12 Running with dbt=1.8.1 +15:10:13 Registered adapter: duckdb=1.8.1 +15:10:13 Found 5 models, 3 seeds, 20 data tests, 416 macros +15:10:13 +15:10:14 Concurrency: 24 threads (target='dev') +15:10:14 +15:10:14 1 of 28 START seed file main.raw_customers ..................................... [RUN] +15:10:14 2 of 28 START seed file main.raw_orders ........................................ [RUN] +15:10:14 3 of 28 START seed file main.raw_payments ...................................... [RUN] +.... + +15:10:15 27 of 28 PASS relationships_orders_customer_id__customer_id__ref_customers_ .... [PASS in 0.32s] +15:10:15 +15:10:15 Finished running 3 seeds, 3 view models, 20 data tests, 2 table models in 0 hours 0 minutes and 1.52 seconds (1.52s). +15:10:15 +15:10:15 Completed successfully +15:10:15 +15:10:15 Done. PASS=28 WARN=0 ERROR=0 SKIP=0 TOTAL=28 + +``` + ## Generate a larger data set From f733b80a05e62c9af18da905167e52615c0c314f Mon Sep 17 00:00:00 2001 From: Matt Shaver <60105315+matthewshaver@users.noreply.github.com> Date: Wed, 11 Dec 2024 11:10:22 -0500 Subject: [PATCH 091/160] Update website/docs/docs/get-started-dbt.md Co-authored-by: Anders --- website/docs/docs/get-started-dbt.md | 1 + 1 file changed, 1 insertion(+) diff --git a/website/docs/docs/get-started-dbt.md b/website/docs/docs/get-started-dbt.md index 61a69b94c8d..f3d022ccb6c 100644 --- a/website/docs/docs/get-started-dbt.md +++ b/website/docs/docs/get-started-dbt.md @@ -74,6 +74,7 @@ Refer to the following quickstarts to get started with dbt Core: - [dbt Core from a manual install](/guides/manual-install) to learn how to install dbt Core and set up a project. - [dbt Core using DuckDB](/guides/duckdb?step=1) to learn how to connect to DuckDB and execute the `dbt build` command. +- [dbt Core using DuckDB (Github Codespace)](/guides/codespace?step=1) to use a pre-configued GitHub codespaces that streamlines the above quickestart's setup. ## Related docs From 245a5c3a4533d7f29612dd8a2643a068ce29798b Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Mon, 16 Dec 2024 15:42:10 +0000 Subject: [PATCH 092/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 1a87f825a10..fe89c961bf8 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -48,7 +48,7 @@ You can learn more through high-quality [dbt Learn courses and workshops](https: This section will provide a step-by-step guide for setting up DuckDB for use in local (Mac and Windows) environments and web browsers. -In the repository, there's a [`requirements.txt`](https://github.com/dbt-labs/jaffle_shop_duckdb) file which is used to install dbt Core, DuckDB, and all other necessary dependencies. You can check this file to see what will be installed on your machine. It's typically located in the root directory of your project. +In the repository, there's a [`requirements.txt`](https://github.com/dbt-labs/jaffle_shop_duckdb/blob/duckdb/requirements.txt) file which is used to install dbt Core, DuckDB, and all other necessary dependencies. You can check this file to see what will be installed on your machine. It's typically located in the root directory of your project. The `requirements.txt` file is placed at the top level of your dbt project directory, alongside other key files like `dbt_project.yml`: From ff9a7649c6030f748af9d76cfd9082345178a196 Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Mon, 16 Dec 2024 15:44:39 +0000 Subject: [PATCH 093/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index fe89c961bf8..64eb82e0c40 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -196,7 +196,7 @@ The steps will fail if you decide to run this project in your data warehouse (ou -1. Go to the `jaffle-shop-template` [repository](https://github.com/gwenwindflower/octocatalog) after you log in to your GitHub account. +1. Go to the `jaffle-shop-template` [repository](https://github.com/dbt-labs/jaffle_shop_duckdb) after you log in to your GitHub account. 1. Click **Use this template** at the top of the page and choose **Create new repository**. 1. Click **Create repository from template** when you’re done setting the options for your new repository. 1. Click **Code** (at the top of the new repository’s page). Under the **Codespaces** tab, choose **Create codespace on main**. Depending on how you've configured your computer's settings, this either opens a new browser tab with the Codespace development environment with VSCode running in it or opens a new VSCode window with the codespace in it. From 3000b1314a349f582f2ab516b4ef900bfa992bc5 Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Tue, 17 Dec 2024 16:00:43 +0000 Subject: [PATCH 094/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 64eb82e0c40..f33e25cc101 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -21,7 +21,7 @@ This guide will demonstrate how to: - Create a virtual development environment using a template provided by dbt Labs. - This sets up a fully functional dbt environment with an operational and executable project. The codespace automatically connects to the DuckDB database and loads a year's worth of data from our fictional Jaffle Shop café, which sells food and beverages in several US cities. - - For additional information, refer to the [README](https://github.com/gwenwindflower/octocatalog) for the Jaffle Shop template. It includes instructions on how to do this, along with animated GIFs. + - For additional information, refer to the [README](https://github.com/dbt-labs/jaffle-shop?tab=readme-ov-file#-the-jaffle-shop-) for the Jaffle Shop template. It includes instructions on how to do this, along with animated GIFs. - Run any dbt command from the environment’s terminal. - Generate a larger dataset for the Jaffle Shop café (for example, five years of data instead of just one). From 3268c044d9d0c07f4bef554333f3df6d805abe06 Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Fri, 20 Dec 2024 19:53:42 +0000 Subject: [PATCH 095/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index eb4db74d1a9..ed75c3cf8be 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -21,7 +21,7 @@ This guide will demonstrate how to: - Create a virtual development environment using a template provided by dbt Labs. - This sets up a fully functional dbt environment with an operational and executable project. The codespace automatically connects to the DuckDB database and loads a year's worth of data from our fictional Jaffle Shop café, which sells food and beverages in several US cities. - - For additional information, refer to the [README](https://github.com/gwenwindflower/octocatalog) for the Jaffle Shop template. It includes instructions on how to do this, along with animated GIFs. + - For additional information, refer to the [README](https://github.com/dbt-labs/jaffle_shop_duckdb) for the Jaffle Shop template. It includes instructions on how to do this, along with animated GIFs. - Run any dbt command from the environment’s terminal. - Generate a larger dataset for the Jaffle Shop café (for example, five years of data instead of just one). From ea7306e63df69b6d9759a45f150b2ade98b51364 Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Fri, 20 Dec 2024 19:54:35 +0000 Subject: [PATCH 096/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index ed75c3cf8be..95d7d350713 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -48,7 +48,7 @@ You can learn more through high-quality [dbt Learn courses and workshops](https: This section will provide a step-by-step guide for setting up DuckDB for use in local (Mac and Windows) environments and web browsers. -In the repository, there's a [`requirements.txt`](https://github.com/dbt-labs/jaffle_shop_duckdb) file which is used to install dbt Core, DuckDB, and all other necessary dependencies. You can check this file to see what will be installed on your machine. It's typically located in the root directory of your project. +In the repository, there's a [`requirements.txt`](https://github.com/dbt-labs/jaffle_shop_duckdb/blob/duckdb/requirements.txt) file which is used to install dbt Core, DuckDB, and all other necessary dependencies. You can check this file to see what will be installed on your machine. It's typically located in the root directory of your project. The `requirements.txt` file is placed at the top level of your dbt project directory, alongside other key files like `dbt_project.yml`: From f5b053fd0f863b48e1a6ba44e04c96e4494501a7 Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Fri, 20 Dec 2024 19:58:13 +0000 Subject: [PATCH 097/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 95d7d350713..f8e4fbf186b 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -196,7 +196,7 @@ The steps will fail if you decide to run this project in your data warehouse (ou -1. Go to the `jaffle-shop-template` [repository](https://github.com/gwenwindflower/octocatalog) after you log in to your GitHub account. +1. Go to the `jaffle-shop-template` [repository](https://github.com/dbt-labs/jaffle_shop_duckdb) after you log in to your GitHub account. 1. Click **Use this template** at the top of the page and choose **Create new repository**. 1. Click **Create repository from template** when you’re done setting the options for your new repository. 1. Click **Code** (at the top of the new repository’s page). Under the **Codespaces** tab, choose **Create codespace on main**. Depending on how you've configured your computer's settings, this either opens a new browser tab with the Codespace development environment with VSCode running in it or opens a new VSCode window with the codespace in it. From 4a3fe0c2473aafe1c73d6c497758b37089b0c8c0 Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Fri, 20 Dec 2024 19:58:49 +0000 Subject: [PATCH 098/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index f8e4fbf186b..dac6133ae70 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -21,7 +21,7 @@ This guide will demonstrate how to: - Create a virtual development environment using a template provided by dbt Labs. - This sets up a fully functional dbt environment with an operational and executable project. The codespace automatically connects to the DuckDB database and loads a year's worth of data from our fictional Jaffle Shop café, which sells food and beverages in several US cities. - - For additional information, refer to the [README](https://github.com/dbt-labs/jaffle_shop_duckdb) for the Jaffle Shop template. It includes instructions on how to do this, along with animated GIFs. + - For additional information, refer to the [README](https://github.com/dbt-labs/jaffle_shop_duckdb/blob/duckdb/README.md) for the Jaffle Shop template. It includes instructions on how to do this, along with animated GIFs. - Run any dbt command from the environment’s terminal. - Generate a larger dataset for the Jaffle Shop café (for example, five years of data instead of just one). From 45d31b9a8c66ba1ee3116571f47b6be2c8227233 Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Fri, 20 Dec 2024 20:03:11 +0000 Subject: [PATCH 099/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 1 + 1 file changed, 1 insertion(+) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index dac6133ae70..f2f5999e444 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -68,6 +68,7 @@ The `requirements.txt` file is placed at the top level of your dbt project direc For more information on the setup of DuckDB, you can refer to [DuckDB setup](/docs/core/connect-data-platform/duckdb-setup). + From 63f6e5dffcbef87ac7dada1f39d54a4ddf406244 Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Fri, 20 Dec 2024 20:06:13 +0000 Subject: [PATCH 100/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index f2f5999e444..53ac2441e03 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -193,7 +193,8 @@ The steps will fail if you decide to run this project in your data warehouse (ou - + + From b7bf003efd1ddcfeec0b528d6a0fdb6a3246a2d7 Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Fri, 20 Dec 2024 20:06:55 +0000 Subject: [PATCH 101/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 1 - 1 file changed, 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 53ac2441e03..8b0b646f84a 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -194,7 +194,6 @@ The steps will fail if you decide to run this project in your data warehouse (ou - From 903993339052d290850c9fd27dc093a4f305d355 Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Fri, 20 Dec 2024 20:08:46 +0000 Subject: [PATCH 102/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 1 - 1 file changed, 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 8b0b646f84a..4cea476e02a 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -70,7 +70,6 @@ For more information on the setup of DuckDB, you can refer to [DuckDB setup](/do - 1. First, [clone](https://git-scm.com/docs/git-clone) the Jaffle Shop git repository by running the following command in your terminal: From 7de7230767c700c673b68b5387a37d46825e79e9 Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Fri, 20 Dec 2024 20:16:10 +0000 Subject: [PATCH 103/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 4cea476e02a..58ae84cac6d 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -194,7 +194,7 @@ The steps will fail if you decide to run this project in your data warehouse (ou - + 1. Go to the `jaffle-shop-template` [repository](https://github.com/dbt-labs/jaffle_shop_duckdb) after you log in to your GitHub account. 1. Click **Use this template** at the top of the page and choose **Create new repository**. From 19cc4422508f554401e993bf6515888679822013 Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Fri, 20 Dec 2024 20:16:36 +0000 Subject: [PATCH 104/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 58ae84cac6d..db8b0c1246f 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -194,7 +194,7 @@ The steps will fail if you decide to run this project in your data warehouse (ou - + 1. Go to the `jaffle-shop-template` [repository](https://github.com/dbt-labs/jaffle_shop_duckdb) after you log in to your GitHub account. 1. Click **Use this template** at the top of the page and choose **Create new repository**. From e2fe381d7f6b3f70ff40958afc252cc90725deac Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Fri, 20 Dec 2024 20:17:37 +0000 Subject: [PATCH 105/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 1 + 1 file changed, 1 insertion(+) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index db8b0c1246f..181d5a6c3a2 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -223,6 +223,7 @@ The steps will fail if you decide to run this project in your data warehouse (ou + From 4d0e17a91d0f43a339bbc7cdf31b87c58051cdb9 Mon Sep 17 00:00:00 2001 From: "Leona B. Campbell" <3880403+runleonarun@users.noreply.github.com> Date: Fri, 20 Dec 2024 12:55:06 -0800 Subject: [PATCH 106/160] Update vercel.json --- website/vercel.json | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/website/vercel.json b/website/vercel.json index 7f6801f36dc..3cf05e95c08 100644 --- a/website/vercel.json +++ b/website/vercel.json @@ -3,22 +3,22 @@ "trailingSlash": false, "redirects": [ { - "source": "/guides/codespace?step=4", + "source": "/guides/codespace-qs?step=4", "destination": "/guides/duckdb?step=3", "permanent": true }, { - "source": "/guides/codespace?step=3", + "source": "/guides/codespace-qs?step=3", "destination": "/guides/duckdb?step=2", "permanent": true }, { - "source": "/guides/codespace?step=2", + "source": "/guides/codespace-qs?step=2", "destination": "/guides/duckdb?step=1", "permanent": true }, { - "source": "/guides/codespace?step=1", + "source": "/guides/codespace-qs?step=1", "destination": "/guides/duckdb?step=1", "permanent": true }, From 9125eb85927b533b0108a8afa8c5b8cf053b8ca8 Mon Sep 17 00:00:00 2001 From: "Leona B. Campbell" <3880403+runleonarun@users.noreply.github.com> Date: Fri, 20 Dec 2024 12:58:59 -0800 Subject: [PATCH 107/160] Update website/docs/docs/get-started-dbt.md --- website/docs/docs/get-started-dbt.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/docs/get-started-dbt.md b/website/docs/docs/get-started-dbt.md index fa3ef71fd53..303e1a76525 100644 --- a/website/docs/docs/get-started-dbt.md +++ b/website/docs/docs/get-started-dbt.md @@ -87,7 +87,7 @@ Learn more about [dbt Cloud features](/docs/cloud/about-cloud/dbt-cloud-feature From 638752759e927ac79df60d904175574d54f9e939 Mon Sep 17 00:00:00 2001 From: "Leona B. Campbell" <3880403+runleonarun@users.noreply.github.com> Date: Fri, 20 Dec 2024 13:04:26 -0800 Subject: [PATCH 108/160] Update vercel.json --- website/vercel.json | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/website/vercel.json b/website/vercel.json index 3cf05e95c08..295625958f3 100644 --- a/website/vercel.json +++ b/website/vercel.json @@ -4,22 +4,22 @@ "redirects": [ { "source": "/guides/codespace-qs?step=4", - "destination": "/guides/duckdb?step=3", + "destination": "/guides/duckdb-qs?step=3", "permanent": true }, { "source": "/guides/codespace-qs?step=3", - "destination": "/guides/duckdb?step=2", + "destination": "/guides/duckdb-qs?step=2", "permanent": true }, { "source": "/guides/codespace-qs?step=2", - "destination": "/guides/duckdb?step=1", + "destination": "/guides/duckdb-qs?step=1", "permanent": true }, { "source": "/guides/codespace-qs?step=1", - "destination": "/guides/duckdb?step=1", + "destination": "/guides/duckdb-qs?step=1", "permanent": true }, { From d7ad0644a688c7ed3f91b967ff9675e51b8d50c8 Mon Sep 17 00:00:00 2001 From: "Leona B. Campbell" <3880403+runleonarun@users.noreply.github.com> Date: Fri, 20 Dec 2024 13:04:52 -0800 Subject: [PATCH 109/160] Update website/vercel.json --- website/vercel.json | 1 - 1 file changed, 1 deletion(-) diff --git a/website/vercel.json b/website/vercel.json index 295625958f3..d3720abd7d9 100644 --- a/website/vercel.json +++ b/website/vercel.json @@ -3671,4 +3671,3 @@ } ] } - From 28c238e2c312ea5c91075c8949006a56e3c41671 Mon Sep 17 00:00:00 2001 From: "Leona B. Campbell" <3880403+runleonarun@users.noreply.github.com> Date: Fri, 20 Dec 2024 13:13:38 -0800 Subject: [PATCH 110/160] Update vercel.json --- website/vercel.json | 14 ++------------ 1 file changed, 2 insertions(+), 12 deletions(-) diff --git a/website/vercel.json b/website/vercel.json index d3720abd7d9..0cde74eb006 100644 --- a/website/vercel.json +++ b/website/vercel.json @@ -3,18 +3,8 @@ "trailingSlash": false, "redirects": [ { - "source": "/guides/codespace-qs?step=4", - "destination": "/guides/duckdb-qs?step=3", - "permanent": true - }, - { - "source": "/guides/codespace-qs?step=3", - "destination": "/guides/duckdb-qs?step=2", - "permanent": true - }, - { - "source": "/guides/codespace-qs?step=2", - "destination": "/guides/duckdb-qs?step=1", + "source": "/guides/codespace", + "destination": "/guides/duckdb", "permanent": true }, { From ea086a3c0cd0faedf196824a5a3f4cd24fa23cd4 Mon Sep 17 00:00:00 2001 From: "Leona B. Campbell" <3880403+runleonarun@users.noreply.github.com> Date: Fri, 20 Dec 2024 13:16:06 -0800 Subject: [PATCH 111/160] Update vercel.json --- website/vercel.json | 13 +++++++++---- 1 file changed, 9 insertions(+), 4 deletions(-) diff --git a/website/vercel.json b/website/vercel.json index 0cde74eb006..85f0a775b30 100644 --- a/website/vercel.json +++ b/website/vercel.json @@ -3,13 +3,18 @@ "trailingSlash": false, "redirects": [ { - "source": "/guides/codespace", - "destination": "/guides/duckdb", + "source": "/faqs/API/rotate-token", + "destination": "/docs/dbt-cloud-apis/service-tokens#service-token-update", + "permanent": true + }, + { + "source": "/styles", + "destination": "https://github.com/dbt-labs/docs.getdbt.com/blob/current/contributing/adding-page-components.md", "permanent": true }, { - "source": "/guides/codespace-qs?step=1", - "destination": "/guides/duckdb-qs?step=1", + "source": "/guides/codespace", + "destination": "/guides/duckdb", "permanent": true }, { From 692e46a8988aa96f80b32e13453609f44ba376f6 Mon Sep 17 00:00:00 2001 From: "Leona B. Campbell" <3880403+runleonarun@users.noreply.github.com> Date: Fri, 20 Dec 2024 13:22:06 -0800 Subject: [PATCH 112/160] Update website/docs/docs/get-started-dbt.md --- website/docs/docs/get-started-dbt.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/docs/get-started-dbt.md b/website/docs/docs/get-started-dbt.md index 303e1a76525..e1a873a5f97 100644 --- a/website/docs/docs/get-started-dbt.md +++ b/website/docs/docs/get-started-dbt.md @@ -87,7 +87,7 @@ Learn more about [dbt Cloud features](/docs/cloud/about-cloud/dbt-cloud-feature From e1a45a6de2ccf6053d7b2ce5a3f9fbcd84f06a3e Mon Sep 17 00:00:00 2001 From: runleonarun Date: Fri, 20 Dec 2024 13:35:15 -0800 Subject: [PATCH 113/160] fixing missing backtiks --- website/docs/docs/dbt-cloud-apis/user-tokens.md | 2 +- website/docs/guides/duckdb-qs.md | 4 +++- 2 files changed, 4 insertions(+), 2 deletions(-) diff --git a/website/docs/docs/dbt-cloud-apis/user-tokens.md b/website/docs/docs/dbt-cloud-apis/user-tokens.md index b7bf4fdce28..bde58793481 100644 --- a/website/docs/docs/dbt-cloud-apis/user-tokens.md +++ b/website/docs/docs/dbt-cloud-apis/user-tokens.md @@ -6,7 +6,7 @@ pagination_next: "docs/dbt-cloud-apis/service-tokens" # Account-scoped personal access tokens -:::Warning +:::warning User API tokens have been deprecated and will no longer work. [Migrate](#migrate-deprecated-user-api-keys-to-personal-access-tokens) to personal access tokens to resume services. diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 181d5a6c3a2..c06f1bdefe4 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -165,7 +165,9 @@ Here's what a successful output will look like: 15:10:15 Completed successfully 15:10:15 15:10:15 Done. PASS=28 WARN=0 ERROR=0 SKIP=0 TOTAL=28 - + +``` + For complete details, refer to the [dbt command reference](/reference/dbt-commands). :::note From 3d221a2b80bb766291aa277444587399b2b51757 Mon Sep 17 00:00:00 2001 From: Jason Karlavige Date: Fri, 20 Dec 2024 16:38:39 -0500 Subject: [PATCH 114/160] remove extra closing tag --- website/docs/guides/duckdb-qs.md | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index c06f1bdefe4..983739e173f 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -225,10 +225,8 @@ The steps will fail if you decide to run this project in your data warehouse (ou - - - + Here's what a successful output will look like: From dba1f6591a2cb6281e67093854c9af0df253c4fa Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Mon, 23 Dec 2024 12:16:37 +0000 Subject: [PATCH 115/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 1 - 1 file changed, 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 983739e173f..5ff53b340bd 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -228,7 +228,6 @@ The steps will fail if you decide to run this project in your data warehouse (ou -Here's what a successful output will look like: ```Jinja From 2342c1a54b85ad0f07c43e289b4716454753bb9c Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Mon, 23 Dec 2024 12:17:06 +0000 Subject: [PATCH 116/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 1 - 1 file changed, 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 5ff53b340bd..bccf439bd25 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -229,7 +229,6 @@ The steps will fail if you decide to run this project in your data warehouse (ou -```Jinja (venv) ➜ jaffle_shop_duckdb git:(duckdb) dbt build 15:10:12 Running with dbt=1.8.1 From f520d94ef86e7e82631435564aa2dc8f8fb738bc Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Mon, 23 Dec 2024 12:17:30 +0000 Subject: [PATCH 117/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 1 - 1 file changed, 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index bccf439bd25..efef4c4fb5b 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -230,7 +230,6 @@ The steps will fail if you decide to run this project in your data warehouse (ou -(venv) ➜ jaffle_shop_duckdb git:(duckdb) dbt build 15:10:12 Running with dbt=1.8.1 15:10:13 Registered adapter: duckdb=1.8.1 15:10:13 Found 5 models, 3 seeds, 20 data tests, 416 macros From 5e6dd1ab119a64166e15b908377dcea18091d30d Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Mon, 23 Dec 2024 12:17:46 +0000 Subject: [PATCH 118/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 1 - 1 file changed, 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index efef4c4fb5b..8d74d427274 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -230,7 +230,6 @@ The steps will fail if you decide to run this project in your data warehouse (ou -15:10:12 Running with dbt=1.8.1 15:10:13 Registered adapter: duckdb=1.8.1 15:10:13 Found 5 models, 3 seeds, 20 data tests, 416 macros 15:10:13 From 5a35400a8cb4c7d46316849a08e819a753e031bd Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Mon, 23 Dec 2024 12:18:02 +0000 Subject: [PATCH 119/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 1 - 1 file changed, 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 8d74d427274..fd977793e1c 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -230,7 +230,6 @@ The steps will fail if you decide to run this project in your data warehouse (ou -15:10:13 Registered adapter: duckdb=1.8.1 15:10:13 Found 5 models, 3 seeds, 20 data tests, 416 macros 15:10:13 15:10:14 Concurrency: 24 threads (target='dev') From 9fff3af08a785a1ad08594f460458888583aba2f Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Mon, 23 Dec 2024 12:18:18 +0000 Subject: [PATCH 120/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 1 - 1 file changed, 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index fd977793e1c..42acdb9006e 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -230,7 +230,6 @@ The steps will fail if you decide to run this project in your data warehouse (ou -15:10:13 Found 5 models, 3 seeds, 20 data tests, 416 macros 15:10:13 15:10:14 Concurrency: 24 threads (target='dev') 15:10:14 From 4c5e8b2b583aba88e4021ba1196794cbb1600fc2 Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Mon, 23 Dec 2024 12:18:34 +0000 Subject: [PATCH 121/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 1 - 1 file changed, 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 42acdb9006e..12b06b4e74d 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -230,7 +230,6 @@ The steps will fail if you decide to run this project in your data warehouse (ou -15:10:13 15:10:14 Concurrency: 24 threads (target='dev') 15:10:14 15:10:14 1 of 28 START seed file main.raw_customers ..................................... [RUN] From 888426a9e521ca9d2c1bf0c971b03f0543f8ecb9 Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Mon, 23 Dec 2024 12:18:57 +0000 Subject: [PATCH 122/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 1 - 1 file changed, 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 12b06b4e74d..b2530cb4e21 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -230,7 +230,6 @@ The steps will fail if you decide to run this project in your data warehouse (ou -15:10:14 Concurrency: 24 threads (target='dev') 15:10:14 15:10:14 1 of 28 START seed file main.raw_customers ..................................... [RUN] 15:10:14 2 of 28 START seed file main.raw_orders ........................................ [RUN] From 0164950b73bc3097c5875207da83f7540a923f73 Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Mon, 23 Dec 2024 12:19:17 +0000 Subject: [PATCH 123/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 1 - 1 file changed, 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index b2530cb4e21..19284eaeeee 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -230,7 +230,6 @@ The steps will fail if you decide to run this project in your data warehouse (ou -15:10:14 15:10:14 1 of 28 START seed file main.raw_customers ..................................... [RUN] 15:10:14 2 of 28 START seed file main.raw_orders ........................................ [RUN] 15:10:14 3 of 28 START seed file main.raw_payments ...................................... [RUN] From 0e7d0d69beb6dbad08e0ef3401fa7b9e127608a5 Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Mon, 23 Dec 2024 12:19:36 +0000 Subject: [PATCH 124/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 1 - 1 file changed, 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 19284eaeeee..b79059cdc1c 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -230,7 +230,6 @@ The steps will fail if you decide to run this project in your data warehouse (ou -15:10:14 1 of 28 START seed file main.raw_customers ..................................... [RUN] 15:10:14 2 of 28 START seed file main.raw_orders ........................................ [RUN] 15:10:14 3 of 28 START seed file main.raw_payments ...................................... [RUN] .... From a5ace973f5db96fb3e34b62f39bbecd3bb0f8e21 Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Mon, 23 Dec 2024 12:19:53 +0000 Subject: [PATCH 125/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 1 - 1 file changed, 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index b79059cdc1c..62d5130609c 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -230,7 +230,6 @@ The steps will fail if you decide to run this project in your data warehouse (ou -15:10:14 2 of 28 START seed file main.raw_orders ........................................ [RUN] 15:10:14 3 of 28 START seed file main.raw_payments ...................................... [RUN] .... From e5290e10f73891de100c2c87f7d59273256938e3 Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Mon, 23 Dec 2024 12:20:21 +0000 Subject: [PATCH 126/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 1 - 1 file changed, 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 62d5130609c..4846107aa92 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -230,7 +230,6 @@ The steps will fail if you decide to run this project in your data warehouse (ou -15:10:14 3 of 28 START seed file main.raw_payments ...................................... [RUN] .... 15:10:15 27 of 28 PASS relationships_orders_customer_id__customer_id__ref_customers_ .... [PASS in 0.32s] From 11316ddabecba8d2aafd7be4308136272916987a Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Mon, 23 Dec 2024 12:20:43 +0000 Subject: [PATCH 127/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 1 - 1 file changed, 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 4846107aa92..d776969cd5f 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -230,7 +230,6 @@ The steps will fail if you decide to run this project in your data warehouse (ou -.... 15:10:15 27 of 28 PASS relationships_orders_customer_id__customer_id__ref_customers_ .... [PASS in 0.32s] 15:10:15 From 4c3f18e9532503d90b392cacd8fe2e7e72370857 Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Mon, 23 Dec 2024 12:21:07 +0000 Subject: [PATCH 128/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 1 - 1 file changed, 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index d776969cd5f..60b78712803 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -231,7 +231,6 @@ The steps will fail if you decide to run this project in your data warehouse (ou -15:10:15 27 of 28 PASS relationships_orders_customer_id__customer_id__ref_customers_ .... [PASS in 0.32s] 15:10:15 15:10:15 Finished running 3 seeds, 3 view models, 20 data tests, 2 table models in 0 hours 0 minutes and 1.52 seconds (1.52s). 15:10:15 From a2a273ae884f550b432b65a18f7ab82a20ec99b2 Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Mon, 23 Dec 2024 12:21:26 +0000 Subject: [PATCH 129/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 1 - 1 file changed, 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 60b78712803..a74e1f33d9e 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -231,7 +231,6 @@ The steps will fail if you decide to run this project in your data warehouse (ou -15:10:15 15:10:15 Finished running 3 seeds, 3 view models, 20 data tests, 2 table models in 0 hours 0 minutes and 1.52 seconds (1.52s). 15:10:15 15:10:15 Completed successfully From f41bc9e5489cb63c50081646d4dd40ef8c2d54e7 Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Mon, 23 Dec 2024 12:21:42 +0000 Subject: [PATCH 130/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 1 - 1 file changed, 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index a74e1f33d9e..6949cafa17f 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -231,7 +231,6 @@ The steps will fail if you decide to run this project in your data warehouse (ou -15:10:15 Finished running 3 seeds, 3 view models, 20 data tests, 2 table models in 0 hours 0 minutes and 1.52 seconds (1.52s). 15:10:15 15:10:15 Completed successfully 15:10:15 From 705f791cef97171e8c00ddc8cf38a4aacaa8e413 Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Mon, 23 Dec 2024 12:21:57 +0000 Subject: [PATCH 131/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 1 - 1 file changed, 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 6949cafa17f..23a6114c426 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -231,7 +231,6 @@ The steps will fail if you decide to run this project in your data warehouse (ou -15:10:15 15:10:15 Completed successfully 15:10:15 15:10:15 Done. PASS=28 WARN=0 ERROR=0 SKIP=0 TOTAL=28 From 1ddcc5669ce4c8ce090c44e7c0736f42c87c751d Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Mon, 23 Dec 2024 12:22:20 +0000 Subject: [PATCH 132/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 1 - 1 file changed, 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 23a6114c426..c9a328110e5 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -231,7 +231,6 @@ The steps will fail if you decide to run this project in your data warehouse (ou -15:10:15 Completed successfully 15:10:15 15:10:15 Done. PASS=28 WARN=0 ERROR=0 SKIP=0 TOTAL=28 From b05f73e5bb88e0bac93a56a45692800b47fbe5c9 Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Mon, 23 Dec 2024 12:22:36 +0000 Subject: [PATCH 133/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 1 - 1 file changed, 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index c9a328110e5..be363a2b3fc 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -231,7 +231,6 @@ The steps will fail if you decide to run this project in your data warehouse (ou -15:10:15 15:10:15 Done. PASS=28 WARN=0 ERROR=0 SKIP=0 TOTAL=28 ``` From 3153185cc69211124f4b8f6f57e3837a1605f921 Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Mon, 23 Dec 2024 12:22:52 +0000 Subject: [PATCH 134/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 1 - 1 file changed, 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index be363a2b3fc..16dc0e930d8 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -231,7 +231,6 @@ The steps will fail if you decide to run this project in your data warehouse (ou -15:10:15 Done. PASS=28 WARN=0 ERROR=0 SKIP=0 TOTAL=28 ``` From 1627fa73bba39040827a415a5b6369351e374e63 Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Mon, 23 Dec 2024 12:23:07 +0000 Subject: [PATCH 135/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 1 - 1 file changed, 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 16dc0e930d8..2e1bcc5ec5b 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -232,7 +232,6 @@ The steps will fail if you decide to run this project in your data warehouse (ou -``` ## Generate a larger data set From 613402271a4e554be63e4a155def0d97d0712d02 Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Mon, 23 Dec 2024 16:29:06 +0000 Subject: [PATCH 136/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 2e1bcc5ec5b..45d6c755953 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -19,7 +19,7 @@ In this quickstart guide, you'll learn how to use dbt Core with DuckDB, enabling This guide will demonstrate how to: -- Create a virtual development environment using a template provided by dbt Labs. +- [Create a virtual development environment](/docs/core/pip-install#using-virtual-environments) using a template provided by dbt Labs. - This sets up a fully functional dbt environment with an operational and executable project. The codespace automatically connects to the DuckDB database and loads a year's worth of data from our fictional Jaffle Shop café, which sells food and beverages in several US cities. - For additional information, refer to the [README](https://github.com/dbt-labs/jaffle_shop_duckdb/blob/duckdb/README.md) for the Jaffle Shop template. It includes instructions on how to do this, along with animated GIFs. - Run any dbt command from the environment’s terminal. From b57ea5ef31621162bfbd8097166569633c856228 Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Mon, 23 Dec 2024 16:29:34 +0000 Subject: [PATCH 137/160] Update website/docs/guides/duckdb-qs.md Co-authored-by: Mirna Wong <89008547+mirnawong1@users.noreply.github.com> --- website/docs/guides/duckdb-qs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 45d6c755953..f0106be17dc 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -132,7 +132,7 @@ For more information on the setup of DuckDB, you can refer to [DuckDB setup](/do -4. Ensure your profile is setup correctly from the command line by running the following: +4. Ensure your profile is setup correctly from the command line by running the following [dbt commands](/reference/dbt-commands). - [dbt compile](https://docs.getdbt.com/reference/commands/compile) — generates executable SQL from your project source files From edb3a5b2559e825368bfb776ac7e43d22709674c Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Mon, 23 Dec 2024 16:29:48 +0000 Subject: [PATCH 138/160] Update website/docs/guides/duckdb-qs.md Co-authored-by: Mirna Wong <89008547+mirnawong1@users.noreply.github.com> --- website/docs/guides/duckdb-qs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index f0106be17dc..a1319f32976 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -135,7 +135,7 @@ For more information on the setup of DuckDB, you can refer to [DuckDB setup](/do 4. Ensure your profile is setup correctly from the command line by running the following [dbt commands](/reference/dbt-commands). - - [dbt compile](https://docs.getdbt.com/reference/commands/compile) — generates executable SQL from your project source files + - [dbt compile](/reference/commands/compile) — generates executable SQL from your project source files - [dbt run](https://docs.getdbt.com/reference/commands/run) — compiles and runs your project - [dbt test](https://docs.getdbt.com/reference/commands/test) — compiles and tests your project - [dbt build](https://docs.getdbt.com/reference/commands/build) — compiles, runs, and tests your project From 7d89447fe9681eec4e2304f17d5113dd73866b6e Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Mon, 23 Dec 2024 16:32:28 +0000 Subject: [PATCH 139/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index a1319f32976..8ba1433ea45 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -141,7 +141,7 @@ For more information on the setup of DuckDB, you can refer to [DuckDB setup](/do - [dbt build](https://docs.getdbt.com/reference/commands/build) — compiles, runs, and tests your project - [dbt docs generate](/reference/commands/cmd-docs#dbt-docs-generate) — generates your project's documentation. - [dbt docs serve](/reference/commands/cmd-docs#dbt-docs-serve) — starts a webserver on port 8080 to serve your documentation locally and opens the documentation site in your default browser. - +For complete details, refer to the [dbt command reference](/reference/dbt-commands). Here's what a successful output will look like: ```jinja From aa2b1c619b81370e902f0c31f3a989e30dacfb58 Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Mon, 23 Dec 2024 16:32:39 +0000 Subject: [PATCH 140/160] Update website/docs/guides/duckdb-qs.md Co-authored-by: Mirna Wong <89008547+mirnawong1@users.noreply.github.com> --- website/docs/guides/duckdb-qs.md | 1 - 1 file changed, 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 8ba1433ea45..36221ac36f9 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -168,7 +168,6 @@ Here's what a successful output will look like: ``` -For complete details, refer to the [dbt command reference](/reference/dbt-commands). :::note From dee0bb0950576182dd48ec291f4ae561bf247055 Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Mon, 23 Dec 2024 16:37:58 +0000 Subject: [PATCH 141/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 36221ac36f9..965cbe8c624 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -213,7 +213,7 @@ The steps will fail if you decide to run this project in your data warehouse (ou /workspaces/test (main) $ dbt build ``` - You can also use the [duckcli](https://github.com/dbcli/duckcli) to write SQL against the warehouse from the command line or build reports in the [Evidence](https://evidence.dev/) project provided in the `reports` directory. + You can also use the [duckcli](https://duckdb.org/docs/api/cli/overview.html) to write SQL against the warehouse from the command line or build reports in the [Evidence](https://evidence.dev/) project provided in the `reports` directory. For complete information, refer to the [dbt command reference](https://docs.getdbt.com/reference/dbt-commands). Common commands are: From 5d94f1c31c3597a73dae62b1b8204b327b1aecdc Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Mon, 23 Dec 2024 16:38:15 +0000 Subject: [PATCH 142/160] Update website/docs/guides/duckdb-qs.md Co-authored-by: Mirna Wong <89008547+mirnawong1@users.noreply.github.com> --- website/docs/guides/duckdb-qs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 965cbe8c624..3d7a0109b02 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -217,7 +217,7 @@ The steps will fail if you decide to run this project in your data warehouse (ou For complete information, refer to the [dbt command reference](https://docs.getdbt.com/reference/dbt-commands). Common commands are: - - [dbt compile](https://docs.getdbt.com/reference/commands/compile) — generates executable SQL from your project source files + - [dbt compile](/reference/commands/compile) — generates executable SQL from your project source files - [dbt run](https://docs.getdbt.com/reference/commands/run) — compiles and runs your project - [dbt test](https://docs.getdbt.com/reference/commands/test) — compiles and tests your project - [dbt build](https://docs.getdbt.com/reference/commands/build) — compiles, runs, and tests your project From 9fd0d674878f537d139880f21aed22239e8e3b88 Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Mon, 23 Dec 2024 16:43:51 +0000 Subject: [PATCH 143/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 3d7a0109b02..785bb1dda6a 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -240,7 +240,7 @@ If you'd like to work with a larger selection of Jaffle Shop data, you can gener 1. Install the Python package called [jafgen](https://pypi.org/project/jafgen/). At the terminal's prompt, run: ```shell - /workspaces/test (main) $ python -m pip install jafgen + python -m pip install jafgen ``` 1. When installation is done, run: From 4bea0220dc112dd560171e3ac5f5693791ef982c Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Mon, 23 Dec 2024 16:45:24 +0000 Subject: [PATCH 144/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 1 - 1 file changed, 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 785bb1dda6a..b839843781f 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -35,7 +35,6 @@ You can learn more through high-quality [dbt Learn courses and workshops](https: - [Create a GitHub repository](/guides/manual-install?step=2) - [Build your first models](/guides/manual-install?step=3) - [Test and document your project](/guides/manual-install?step=4) -- [Schedule a job](/guides/manual-install?step=5) ## Prerequisites From 32f30734f03888528aeb51a02832c3753b254e35 Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Tue, 24 Dec 2024 13:10:52 +0000 Subject: [PATCH 145/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index b839843781f..e80b778e632 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -166,7 +166,11 @@ Here's what a successful output will look like: 15:10:15 Done. PASS=28 WARN=0 ERROR=0 SKIP=0 TOTAL=28 ``` +To query data, some useful commands you can run from the command line: +- [`dbt show`](/reference/commands/show) — run a query against the data warehouse and preview the results in the terminal. +- [`dbt source`](/reference/commands/source) — provides subcommands such as [`dbt source freshness`](/reference/commands/source#dbt-source-freshness) that are useful when working with source data. + - `dbt source freshness` — checks the freshness (how up to date) a specific source table is. :::note From 3baa7452aca9d0eb17c81fe9b3ebb1217893b6ae Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Tue, 24 Dec 2024 13:18:16 +0000 Subject: [PATCH 146/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index e80b778e632..2d61bed7d80 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -248,7 +248,7 @@ If you'd like to work with a larger selection of Jaffle Shop data, you can gener 1. When installation is done, run: ```shell - /workspaces/test (main) $ jafgen --years NUMBER_OF_YEARS + jafgen [number of years to generate] # e.g. jafgen 6 ``` Replace `NUMBER_OF_YEARS` with the number of years you want to simulate. This command builds the CSV files and stores them in the `jaffle-data` folder, and is automatically sourced based on the `sources.yml` file and the [dbt-duckdb](/docs/core/connect-data-platform/duckdb-setup) adapter. From 0ff2e75e39740decc409867c3b685ac811373505 Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Tue, 24 Dec 2024 14:00:21 +0000 Subject: [PATCH 147/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 2d61bed7d80..ce2e7d5428c 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -253,5 +253,16 @@ If you'd like to work with a larger selection of Jaffle Shop data, you can gener Replace `NUMBER_OF_YEARS` with the number of years you want to simulate. This command builds the CSV files and stores them in the `jaffle-data` folder, and is automatically sourced based on the `sources.yml` file and the [dbt-duckdb](/docs/core/connect-data-platform/duckdb-setup) adapter. As you increase the number of years, it takes exponentially more time to generate the data because the Jaffle Shop stores grow in size and number. For a good balance of data size and time to build, dbt Labs suggests a maximum of 6 years. +## Next steps +Now that you understand the basics of using dbt Core with DuckDB, consider optimizing your setup by documenting a project, committing changes and, scheduling a job. + +### Document a job + + + +### Commit changes + + +### Schedule a job From 4d103914890dfebc611524d6761cfeeb48fc8104 Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Tue, 24 Dec 2024 14:05:40 +0000 Subject: [PATCH 148/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index ce2e7d5428c..7a4dcd904ed 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -255,7 +255,15 @@ If you'd like to work with a larger selection of Jaffle Shop data, you can gener As you increase the number of years, it takes exponentially more time to generate the data because the Jaffle Shop stores grow in size and number. For a good balance of data size and time to build, dbt Labs suggests a maximum of 6 years. ## Next steps -Now that you understand the basics of using dbt Core with DuckDB, consider optimizing your setup by documenting a project, committing changes and, scheduling a job. +Now that you've got dbt Core, DuckDB, and the Jaffle Shop data up and running, you can explore dbt's capabilities. Refer to these materials to get a better understanding of dbt projects and commands: + +- The [About projects](/docs/build/projects) page guides you through the structure of a dbt project and its components. +- [dbt command reference](/reference/dbt-commands) explains the various commands available and what they do. +- [dbt Labs courses](https://courses.getdbt.com/collections) offer a variety of beginner, intermediate, and advanced learning modules designed to help you become a dbt expert. +- Once you see the potential of dbt and what it can do for your organization, sign up for a free trial of [dbt Cloud](https://www.getdbt.com/signup). It's the fastest and easiest way to deploy dbt today! +- Check out the other [quickstart guides](/quickstarts) to begin integrating into your existing data warehouse. + +Additionally, with your new understanding of the basics of using dbt Core with DuckDB, consider optimizing your setup by documenting a project, committing changes and, scheduling a job. ### Document a job From d4031c64c18ddfeeb5402b6a904b6a87fca6c3f2 Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Tue, 24 Dec 2024 14:21:44 +0000 Subject: [PATCH 149/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 7a4dcd904ed..fba41c1f9d6 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -269,7 +269,16 @@ Additionally, with your new understanding of the basics of using dbt Core with D -### Commit changes +### Commit your changes + +Commit your changes to ensure the repository is up to date with the latest code. + +In the GitHub repository you created for your project, run the following commands in Terminal. + +```shell +git add +git commit -m "Your commit message" +git push ### Schedule a job From 1ba4da927abf7d85c96192ab13ac9c0f9d709cd7 Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Tue, 24 Dec 2024 14:24:26 +0000 Subject: [PATCH 150/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index fba41c1f9d6..38c3a949cc8 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -263,7 +263,7 @@ Now that you've got dbt Core, DuckDB, and the Jaffle Shop data up and running, y - Once you see the potential of dbt and what it can do for your organization, sign up for a free trial of [dbt Cloud](https://www.getdbt.com/signup). It's the fastest and easiest way to deploy dbt today! - Check out the other [quickstart guides](/quickstarts) to begin integrating into your existing data warehouse. -Additionally, with your new understanding of the basics of using dbt Core with DuckDB, consider optimizing your setup by documenting a project, committing changes and, scheduling a job. +Additionally, with your new understanding of the basics of using dbt Core with DuckDB, consider optimizing your setup by documenting a project, committing your changes and, scheduling a job. ### Document a job From a6e06bcd3ea52e70d232271db7bec77a4018cbc4 Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Tue, 24 Dec 2024 14:25:13 +0000 Subject: [PATCH 151/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 38c3a949cc8..07b3484cf97 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -265,7 +265,7 @@ Now that you've got dbt Core, DuckDB, and the Jaffle Shop data up and running, y Additionally, with your new understanding of the basics of using dbt Core with DuckDB, consider optimizing your setup by documenting a project, committing your changes and, scheduling a job. -### Document a job +### Document your project From 834f2e6abbfb9a607033b4eb512db1895654308e Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Tue, 24 Dec 2024 14:25:38 +0000 Subject: [PATCH 152/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 07b3484cf97..1ddbac6b34f 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -263,7 +263,7 @@ Now that you've got dbt Core, DuckDB, and the Jaffle Shop data up and running, y - Once you see the potential of dbt and what it can do for your organization, sign up for a free trial of [dbt Cloud](https://www.getdbt.com/signup). It's the fastest and easiest way to deploy dbt today! - Check out the other [quickstart guides](/quickstarts) to begin integrating into your existing data warehouse. -Additionally, with your new understanding of the basics of using dbt Core with DuckDB, consider optimizing your setup by documenting a project, committing your changes and, scheduling a job. +Additionally, with your new understanding of the basics of using dbt Core with DuckDB, consider optimizing your setup by documenting your project, committing your changes and, scheduling a job. ### Document your project From ec2ef300921f9ee162e11b20e1cc25b92627e01f Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Tue, 24 Dec 2024 14:40:47 +0000 Subject: [PATCH 153/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 1ddbac6b34f..179dc4f7cc9 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -282,4 +282,11 @@ git push ### Schedule a job + +1. Ensure dbt Core is installed and configured to connect to your DuckDB instance. +2. Create a dbt project and define your [`models`](/docs/build/models), [`seeds`](/reference/seed-properties), and [`tests`](/reference/commands/test). +3. Use a scheduler such [Prefect](/docs/deploy/deployment-tools#prefect) to schedule your dbt runs. You can create a DAG (Directed Acyclic Graph) that triggers dbt commands at specified intervals. +4. Write a script that runs your dbt commands, such as [`dbt run`](/reference/commands/run), `dbt test` and more so. +5. Use your chosen scheduler to run the script at your desired frequency. + From c8f9a5f43bb7f49bbca7c14d5a287418ba48e59d Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Tue, 24 Dec 2024 14:45:02 +0000 Subject: [PATCH 154/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 179dc4f7cc9..8b779a08063 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -273,7 +273,7 @@ Additionally, with your new understanding of the basics of using dbt Core with D Commit your changes to ensure the repository is up to date with the latest code. -In the GitHub repository you created for your project, run the following commands in Terminal. +In the GitHub repository you created for your project, run the following commands in the terminal. ```shell git add From f30869eaee48dfbcd8425217299122912608a04a Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Tue, 24 Dec 2024 15:23:30 +0000 Subject: [PATCH 155/160] Update duckdb-qs.md Added backticks --- website/docs/guides/duckdb-qs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 8b779a08063..63fe1ed1946 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -279,7 +279,7 @@ In the GitHub repository you created for your project, run the following command git add git commit -m "Your commit message" git push - +``` ### Schedule a job From 116b6fde9c937fce4bf8595a73a3329feb37d596 Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Tue, 24 Dec 2024 15:24:53 +0000 Subject: [PATCH 156/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 63fe1ed1946..e5e5f97d6ff 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -267,7 +267,11 @@ Additionally, with your new understanding of the basics of using dbt Core with D ### Document your project +To document your dbt projects with DuckDB, follow the steps: +- Use the `dbt docs generate` command to compile information about your dbt project and warehouse into `manifest.json` and `catalog.json` files +- Run the [`dbt docs serve`](/reference/commands/cmd-docs#dbt-docs-serve) command to create a local website using the generated `.json` files. This allows you to view your project's documentation in a web browser. +- Enhance your documentation by adding [descriptions](/reference/resource-properties/description) to models, columns, and sources using the `description` key in your YAML files. ### Commit your changes From 9316fa1ac7e540294b90a05c7197c9f05a8205e8 Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Tue, 24 Dec 2024 15:28:58 +0000 Subject: [PATCH 157/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index e5e5f97d6ff..89e782d4a7c 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -287,6 +287,13 @@ git push ### Schedule a job +1. Ensure dbt Core is installed and configured to connect to your DuckDB instance. +2. Create a dbt project and define your [`models`](/docs/build/models), [`seeds`](/reference/seed-properties), and [`tests`](/reference/commands/test). +3. Use a scheduler such [Prefect](/docs/deploy/deployment-tools#prefect) to schedule your dbt runs. You can create a DAG (Directed Acyclic Graph) that triggers dbt commands at specified intervals. +4. Write a script that runs your dbt commands, such as [`dbt run`](/reference/commands/run), `dbt test` and more so. +5. Use your chosen scheduler to run the script at your desired frequency. + + 1. Ensure dbt Core is installed and configured to connect to your DuckDB instance. 2. Create a dbt project and define your [`models`](/docs/build/models), [`seeds`](/reference/seed-properties), and [`tests`](/reference/commands/test). 3. Use a scheduler such [Prefect](/docs/deploy/deployment-tools#prefect) to schedule your dbt runs. You can create a DAG (Directed Acyclic Graph) that triggers dbt commands at specified intervals. From 367d7bb2ed6445724aebf6189ed0a187d4319f82 Mon Sep 17 00:00:00 2001 From: Natalie Fiann Date: Tue, 24 Dec 2024 16:14:26 +0000 Subject: [PATCH 158/160] Added some sections to the guide and confetti --- website/docs/guides/duckdb-qs.md | 24 +++++++++++++++--------- 1 file changed, 15 insertions(+), 9 deletions(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 89e782d4a7c..25083a549f3 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -64,7 +64,7 @@ The `requirements.txt` file is placed at the top level of your dbt project direc ``` -For more information on the setup of DuckDB, you can refer to [DuckDB setup](/docs/core/connect-data-platform/duckdb-setup). +For more information, refer to the [DuckDB setup](/docs/core/connect-data-platform/duckdb-setup). @@ -140,7 +140,9 @@ For more information on the setup of DuckDB, you can refer to [DuckDB setup](/do - [dbt build](https://docs.getdbt.com/reference/commands/build) — compiles, runs, and tests your project - [dbt docs generate](/reference/commands/cmd-docs#dbt-docs-generate) — generates your project's documentation. - [dbt docs serve](/reference/commands/cmd-docs#dbt-docs-serve) — starts a webserver on port 8080 to serve your documentation locally and opens the documentation site in your default browser. + For complete details, refer to the [dbt command reference](/reference/dbt-commands). + Here's what a successful output will look like: ```jinja @@ -255,7 +257,7 @@ If you'd like to work with a larger selection of Jaffle Shop data, you can gener As you increase the number of years, it takes exponentially more time to generate the data because the Jaffle Shop stores grow in size and number. For a good balance of data size and time to build, dbt Labs suggests a maximum of 6 years. ## Next steps -Now that you've got dbt Core, DuckDB, and the Jaffle Shop data up and running, you can explore dbt's capabilities. Refer to these materials to get a better understanding of dbt projects and commands: +Now that you have dbt Core, DuckDB, and the Jaffle Shop data up and running, you can explore dbt's capabilities. Refer to these materials to get a better understanding of dbt projects and commands: - The [About projects](/docs/build/projects) page guides you through the structure of a dbt project and its components. - [dbt command reference](/reference/dbt-commands) explains the various commands available and what they do. @@ -263,7 +265,7 @@ Now that you've got dbt Core, DuckDB, and the Jaffle Shop data up and running, y - Once you see the potential of dbt and what it can do for your organization, sign up for a free trial of [dbt Cloud](https://www.getdbt.com/signup). It's the fastest and easiest way to deploy dbt today! - Check out the other [quickstart guides](/quickstarts) to begin integrating into your existing data warehouse. -Additionally, with your new understanding of the basics of using dbt Core with DuckDB, consider optimizing your setup by documenting your project, committing your changes and, scheduling a job. +Additionally, with your new understanding of the basics of using DuckDB, consider optimizing your setup by [documenting your project](/guides/duckdb#document-your-project), [commit your changes](/guides/duckdb#commit-your-changes) and, [schedule a job](/guides/duckdb#schedule-a-job). ### Document your project @@ -277,7 +279,7 @@ To document your dbt projects with DuckDB, follow the steps: Commit your changes to ensure the repository is up to date with the latest code. -In the GitHub repository you created for your project, run the following commands in the terminal. +1. In the GitHub repository you created for your project, run the following commands in the terminal: ```shell git add @@ -285,6 +287,8 @@ git commit -m "Your commit message" git push ``` +2. Go back to your GitHub repository to verify your new files have been added. + ### Schedule a job 1. Ensure dbt Core is installed and configured to connect to your DuckDB instance. @@ -293,11 +297,13 @@ git push 4. Write a script that runs your dbt commands, such as [`dbt run`](/reference/commands/run), `dbt test` and more so. 5. Use your chosen scheduler to run the script at your desired frequency. + -1. Ensure dbt Core is installed and configured to connect to your DuckDB instance. -2. Create a dbt project and define your [`models`](/docs/build/models), [`seeds`](/reference/seed-properties), and [`tests`](/reference/commands/test). -3. Use a scheduler such [Prefect](/docs/deploy/deployment-tools#prefect) to schedule your dbt runs. You can create a DAG (Directed Acyclic Graph) that triggers dbt commands at specified intervals. -4. Write a script that runs your dbt commands, such as [`dbt run`](/reference/commands/run), `dbt test` and more so. -5. Use your chosen scheduler to run the script at your desired frequency. +Congratulations on making it through the guide 🎉! + + + + + From 5cb9f84486874bbf9f23faf067bc96d0fef6b2bb Mon Sep 17 00:00:00 2001 From: nataliefiann <120089939+nataliefiann@users.noreply.github.com> Date: Tue, 24 Dec 2024 16:22:54 +0000 Subject: [PATCH 159/160] Update website/docs/guides/duckdb-qs.md --- website/docs/guides/duckdb-qs.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md index 25083a549f3..38d02b48381 100644 --- a/website/docs/guides/duckdb-qs.md +++ b/website/docs/guides/duckdb-qs.md @@ -263,7 +263,7 @@ Now that you have dbt Core, DuckDB, and the Jaffle Shop data up and running, you - [dbt command reference](/reference/dbt-commands) explains the various commands available and what they do. - [dbt Labs courses](https://courses.getdbt.com/collections) offer a variety of beginner, intermediate, and advanced learning modules designed to help you become a dbt expert. - Once you see the potential of dbt and what it can do for your organization, sign up for a free trial of [dbt Cloud](https://www.getdbt.com/signup). It's the fastest and easiest way to deploy dbt today! -- Check out the other [quickstart guides](/quickstarts) to begin integrating into your existing data warehouse. +- Check out the other [quickstart guides](/guides?tags=Quickstart) to begin integrating into your existing data warehouse. Additionally, with your new understanding of the basics of using DuckDB, consider optimizing your setup by [documenting your project](/guides/duckdb#document-your-project), [commit your changes](/guides/duckdb#commit-your-changes) and, [schedule a job](/guides/duckdb#schedule-a-job). From 28778fbd93f8c6c24313055582f13ef26e8c8052 Mon Sep 17 00:00:00 2001 From: Natalie Fiann Date: Tue, 24 Dec 2024 20:31:05 +0000 Subject: [PATCH 160/160] Updated logo --- website/static/img/icons/duckdb-seeklogo.svg | 2 +- website/static/img/icons/white/duckdb-seeklogo.svg | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/website/static/img/icons/duckdb-seeklogo.svg b/website/static/img/icons/duckdb-seeklogo.svg index c6d5d2f0729..1d684f4253c 100644 --- a/website/static/img/icons/duckdb-seeklogo.svg +++ b/website/static/img/icons/duckdb-seeklogo.svg @@ -1 +1 @@ - \ No newline at end of file + \ No newline at end of file diff --git a/website/static/img/icons/white/duckdb-seeklogo.svg b/website/static/img/icons/white/duckdb-seeklogo.svg index c6d5d2f0729..1d684f4253c 100644 --- a/website/static/img/icons/white/duckdb-seeklogo.svg +++ b/website/static/img/icons/white/duckdb-seeklogo.svg @@ -1 +1 @@ - \ No newline at end of file + \ No newline at end of file