docs(intent): renamedFrom / dropped - evolving a table that already holds data - #254
Merged
Merged
Conversation
…olds data Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Documents the two intent keys for evolving the table of an entity whose application already holds data (expand/contract), shipped in eclipse-dirigible/dirigible#7674 (issue eclipse-dirigible/dirigible#7635):
renamedFrom: <old field name>- the publish renames the live column in place, so the values move with the new name; it acts only while the old column exists and the new one does not, so it is harmless to leave in the file. On SQL Server (no in-place rename) the new column is added nullable, the values are copied, and the old column is kept.dropped: [names]- former field / to-one relation names whose columns the publish removes, data included.orphanColumnson theartefactshealth component at/actuator/health, a kept NOT NULL column relaxed to nullable on H2/PostgreSQL/Snowflake and left NOT NULL with a WARN on MySQL/MariaDB/SQL Server/HANA;DIRIGIBLE_DATABASE_DROP_UNDECLARED_COLUMNS=trueas the dev-instance opt-in (a::: tip).::: warning).Changes: a new section
renamedFrom / dropped - evolving a table that already holds dataindocs/help/intent/dsl-reference.md(beforedefaultValue), its index row, and arenamedFromrow in the field table ofdocs/help/intent/intent-file.md.npm run docs:buildis green; the built HTML carriesid="renamedfrom-dropped-evolving-a-table-that-already-holds-data"and the index and intent-file links resolve to it. No em/en dashes in the diff.The neutral specification counterparts: IntentFile/intent-specification#96 and IntentFile/intentfile.github.io#65.
🤖 Generated with Claude Code