Ability to embed ERDs on dbdocs.io

Hello!

I want to programmatically generate ERDs for my database and API schemas. The CI integration pattern in dbdocs is perfect for being able to auto-generate these ERDs. However, I would like to embed those ERDs in other HTML pages. I noticed this is currently possible with dbdiagram.io but it’s not clear whether it’s possible in dbdocs.io.

Are there any workarounds to achieve this?

Thanks for asking Sherif. This is indeed an interesting use of dbdocs.

Could you share a little bit more details about your use case: Where do you want to embed it into? Who are the users of the HTML pages? etc… This helps us understand and plan for it better.

@huy I work at airbyte.com . We build integrations with external APIs and offer a data movement (ETL) product. Our product allows customers to move data from APIs like Stripe and databases like Postgres to warehouses like Snowflake. I would like to programmatically generate ERDs for each of my integrations so that I can show users what to expect in the destination database when they move data from a given API (instead of just redirecting them to e.g the Stripe API docs).

Functionally speaking I am looking for exactly the same embedding functionality available in dbdiagram today, but instead to embed the ERD from dbdocs project because I can programmatically generate ERDs in dbdocs. Using embedded links from dbdiagram is intractable because I would need to manually keep each of them up to date.

Does this help? Is there any way to achieve this today?

2 Likes

@huy @Thi_Nguyen any updates on this?

Thanks for the remind Sherif. This is indeed an interesting use case. And you also highlight clearly the pros/cons between dbdiagram and dbdocs: dbdiagram supports embedding but doesn’t have CLI/API and the wiki view of dbdocs.

We’re actually looking into merging these 2 products together, so that all functionalties will be available in a single place: Edit diagram/doc, API to update diagram/doc, wiki view + ERD view, embedding.

Right now the ETA/timeline for this is still unclear as we’re still hashing out the details.

Are you looking to integrate this for your OSS version or the SaaS/cloud offering?

hey huy!
Leti from the Airbyte team too!
We would like to integrate it for both offerings. Are there any updates or ETA on this feature?
Thanks!

Hi @letiescanciano,

We are now in the design phase of combining these two products. The announcement will be made soon. You’ll get more information and a timeline for the merger.

Thank you.

1 Like

Awesome!!
Thanks for the good news.

This would be an awesome feature to have on dbdocs! Is it still being considered?

1 Like

Hi @wkrill,

This is Patrick from dbdocs.io.

This embedding feature is in our roadmap and is highly prioritized. Though the release timeline is uncertain for now, but your feedbacks are extremely helpful for us:

  • (1) What are the tools are you looking to embed dbdocs into? (Notion, Confluence, etc.)
  • (2) Aside from ERDs, which other section of dbdocs do you want to embed? (The whole project, a table view, the diagram, etc.?)

If you want to contribute ideas to this feature, please feel free to have quick chitchat with me by booking a meeting via this link.

Hi there,

I’m also interested in this feature.

  1. We want to embed on our public docs (for example SurveyMonkey | Airbyte Documentation), which is hosted on Docusaurus.

  2. We are only currently considering embedding the Entity Relationship Diagram that shows the visualization of relationships between those tables.

Are you still open to booking time? I would be happy to chat more about our use case.

Hi Natalie,

dbdocs currently does not have embedding feature yet, we’re still developing it (roadmap).

For ERDs embedding, you can use dbdiagram instead - combined with dbdiagram’s API if you want some automation. Please let me know if it works for you.

If you’re still having questions related to this, feel free to book me a call via this link.

Have a nice day :blush:

Hi @Natalie_Kwong, @letiescanciano, @wkrill, @Sherif_Nada

Good news for you!

We have launched the embedded views features here: New Feature: Embedded Views

Please check it out and let me know what you think :yum:

Patrick