Skip to content

Commit

Permalink
add callout to explain the difference (#4340)
Browse files Browse the repository at this point in the history
adding callout to blog post explaining the different btw dbt-cloud-cli
and dbt cloud cli, powered by dbt cloud. refer to [slack
thread](https://dbt-labs.slack.com/archives/C051TUB7S9W/p1698283391215239)
  • Loading branch information
mirnawong1 authored Nov 1, 2023
2 parents 64c53e5 + 2de4815 commit 72b4672
Show file tree
Hide file tree
Showing 2 changed files with 8 additions and 1 deletion.
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,10 @@ date: 2022-05-03
is_featured: true
---

:::info Different from dbt Cloud CLI
This blog explains how to use the `dbt-cloud-cli` Python library to create a data catalog app with dbt Cloud artifacts. This is different from the [dbt Cloud CLI](/docs/cloud/cloud-cli-installation), a tool that allows you to run dbt commands against your dbt Cloud development environment from your local command line.
:::

dbt Cloud is a hosted service that many organizations use for their dbt deployments. Among other things, it provides an interface for creating and managing deployment jobs. When triggered (e.g., cron schedule, API trigger), the jobs generate various artifacts that contain valuable metadata related to the dbt project and the run results.

dbt Cloud provides a REST API for managing jobs, run artifacts and other dbt Cloud resources. Data/analytics engineers would often write custom scripts for issuing automated calls to the API using tools [cURL](https://curl.se/) or [Python Requests](https://requests.readthedocs.io/en/latest/). In some cases, the engineers would go on and copy/rewrite them between projects that need to interact with the API. Now, they have a bunch of scripts on their hands that they need to maintain and develop further if business requirements change. If only there was a dedicated tool for interacting with the dbt Cloud API that abstracts away the complexities of the API calls behind an easy-to-use interface… Oh wait, there is: [the dbt-cloud-cli](https://github.com/data-mie/dbt-cloud-cli)!
Expand Down
5 changes: 4 additions & 1 deletion website/docs/docs/cloud/cloud-cli-installation.md
Original file line number Diff line number Diff line change
Expand Up @@ -270,4 +270,7 @@ If you have dbt Core installed locally, either:
You can always uninstall the dbt Cloud CLI to return to using dbt Core.
</details>
<details>
<summary>Why am I receiving a <code>Session occupied</code> error?</summary>
If you've ran a dbt command and receive a <code>Session occupied</code> error, you can reattach to your existing session with <code>dbt reattach</code> and then press <code>Control-C</code> and choose to cancel the invocation.
</details>

0 comments on commit 72b4672

Please sign in to comment.