Making dbt Cloud API calls using dbt-cloud-cli

[stumelius]

What's your key point? Discuss the topics that we agreed together with Amy and Jason. Also see the initial idea https://github.com/dbt-labs/dbt-technical-blog-writing/discussions/62.

Prior art:

• https://discourse.getdbt.com/t/triggering-a-dbt-cloud-job-in-your-automated-workflow-with-python/2573
• https://discourse.getdbt.com/t/making-dbt-cloud-api-calls-using-the-dbt-cloud-cli/3543

Link to notes / outline / draft: https://docs.google.com/document/d/1_BhfeA36YyTtaydRXUkl-SZp1zplhDR5IjhoGIWXOiU/edit?usp=sharing

Estimated first draft date: Leave blank if you already shared a draft above.

Any open questions / requests for help from the group?

I'm not yet sure how the example use case "Creating a data catalog from dbt Cloud artifacts" will be constructed and I'd love to hear your thoughts and ideas on the topic!

[stumelius]

I added a link to the draft that I just wrote. It's still missing a short intro at the beginning and the "Creating a data catalog from dbt Cloud artifacts" use case. The section titles are still WIP and I feel that the "How I got here?" section is a bit too long. @jasnonaz Please let me know what you think :)

[amychen1776]

@stumelius Could you provide comment rights to anyone with a link to the doc? It helps us review :)

[stumelius]

@amychen1776 The permissions are now updated so that everyone can comment. Let me know if you still have problems adding comments

[amychen1776]

@stumelius I just had first pass at the doc. Let me know what you think/if you have any comments but great start! I'm excited to get this posted

[stumelius]

@amychen1776 Thanks for your comments and ideas! :) I made the changes you proposed and added some content to the example.

Regarding the example: Since I'm talking so much about click and pydantic in the blog post I could demonstrate how to use them to write a simple catalog exploration CLI tool. What do you think?

Oh, and the titles are still WIP...

[amychen1776]

Thanks @stumelius! I think that's a great idea (I love the expansion of the topic to further than the tool you created).

Let me know when you're ready for another review. Once you have written the remaining sections, we can bring it up in our developer blog meeting and get more eyes on it :)

[stumelius]

@amychen1776 Thanks again for your comments! I've addressed them and amended the example with code gists and a high-level walkthrough of what's happening in the code. I've included the demo app in the latest dbt-cloud-cli release and added instructions for running the app.

I still haven't touched the titles nor the introduction. I'll get to those next week. Apologies for the slow progress!

[amychen1776]

No worries! Let me know when the blog post is fully written and we can get it reviewed and closer to publishing step.

[stumelius]

@amychen1776 I just added the intro so all the content is now there. You can go ahead and start the review and then we'll polish the blog post so that it's ready for publishing. I'm open to all suggestions, especially regarding the titles. PS. I'm a lousy title maker :D

[stumelius]

@amychen1776 did you have a chance to take a deeper look at the post yet?

[amychen1776]

@stumelius Apologies for the delay! We are currently restructuring how we are approaching developer blog posts so let me follow up with the team and get back to you. You should see a response from me early next week.

[stumelius]

Got it, no worries!