Skip to content

docs: schema handling - #237

Merged
wolf4ood merged 1 commit into
eclipse-edc:mainfrom
wolf4ood:docs/database_schemas
Nov 2, 2026
Merged

wolf4ood merged 1 commit into
eclipse-edc:mainfrom
wolf4ood:docs/database_schemas

Conversation

@wolf4ood

@wolf4ood wolf4ood commented Nov 2, 2026 •

Copy link
Copy Markdown
Contributor

What this PR changes/adds

Adds a "Database Schemas" page to the adopter documentation (Distributions, Deployment, and Operations):

  • where the SQL schemas come from (the store modules' *-schema.sql, BOMs, datasources);
  • what edc.sql.schema.autocreate does and doesn't do: it creates missing tables and indexes, it never changes
    existing tables, and it isn't a migration tool;
  • production setup: apply the schemas with a DDL user, run the runtime with a DML-only user, manage changes with a migration tool;
  • why schema changes must not run from replicas that serve traffic;

Why it does that

The documentation didn't say how the schema is meant to be created or upgraded.

Further notes

List other areas of code that have changed but are not necessarily linked to the main feature. This could be method
signature changes, package declarations, bugs that were encountered and were fixed inline, etc.

Who will sponsor this feature?

Please @-mention the committer that will sponsor your feature.

Linked Issue(s)

Closes # <-- insert Issue number if one exists

Please be sure to take a look at the contributing guidelines and our etiquette for pull requests.

@wolf4ood
wolf4ood marked this pull request as ready for review November 2, 2026 08:23
@wolf4ood
wolf4ood requested a review from a team as a code owner November 2, 2026 08:23
@wolf4ood
wolf4ood merged commit 0978a4f into eclipse-edc:main Nov 2, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants