Skip to content

Say how a host that supplies its own Transactions gets OpenSharing's schema - #201

Merged
littlegrasscao merged 2 commits into
mainfrom
docs/host-schema-migrations
Nov 16, 2026
Merged

littlegrasscao merged 2 commits into
mainfrom
docs/host-schema-migrations

Conversation

@littlegrasscao

@littlegrasscao littlegrasscao commented Nov 16, 2026 •

Copy link
Copy Markdown
Collaborator

RELEASE.md says the schema is created by Flyway on startup and that "a host must not create or alter OpenSharing's tables itself". But the Flyway migrations and JpaTransactions ship only in opensharing-server. A host that embeds opensharing-server-core and supplies its own Transactions never runs them, so it has to create the tables itself.

This rewords the paragraph:

  • The standalone server creates and migrates the schema with Flyway, from the migrations in opensharing-server's db/migration.
  • A host that supplies its own Transactions creates the tables in its own migrations, exactly as those migrations define them, and adds each new one when it upgrades.

Documentation only; no code changes.

This pull request and its description were written by Isaac.

…schema

The Flyway migrations and JpaTransactions ship only in opensharing-server, so a
host that embeds opensharing-server-core with its own Transactions has to create
the tables itself. RELEASE.md said a host must not.

Co-authored-by: Isaac <no-reply@databricks.com>
Signed-off-by: Sun Cao <sun.cao+data@databricks.com>
@github-actions

Copy link
Copy Markdown

✅ OpenCodeReview: Review skipped: no items were selected.

Co-authored-by: Isaac <no-reply@databricks.com>
Signed-off-by: Sun Cao <sun.cao+data@databricks.com>
@littlegrasscao
littlegrasscao enabled auto-merge (squash) November 16, 2026 18:36
@littlegrasscao
littlegrasscao merged commit 3583876 into main Nov 16, 2026
5 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