Add known limitation: bulkmerge: distributed merge fails when a participating SQL instance goes down#23212
Merged
Conversation
…when a participating SQL instance goes down Fixes DOC-16673
✅ Deploy Preview for cockroachdb-api-docs canceled.
|
Files changed:
|
✅ Deploy Preview for cockroachdb-interactivetutorials-docs canceled.
|
✅ Netlify Preview
To edit notification comments on pull requests, go to your Netlify project configuration. |
mw5h
reviewed
Apr 24, 2026
| - After importing into an existing table, [constraints]({% link {{ page.version.version }}/constraints.md %}) will be un-validated and need to be [re-validated]({% link {{ page.version.version }}/alter-table.md %}#validate-constraint). | ||
| - Imported rows must not conflict with existing rows in the table or any unique secondary indexes. | ||
| - `IMPORT INTO` works for only a single existing table. | ||
| - When `IMPORT INTO` uses distributed merge, it stores intermediate SST files on participating SQL instances' local storage. If one of those SQL instances becomes unavailable during the merge phase, the job fails with a permanent error and must be restarted after that SQL instance becomes available again. |
There was a problem hiding this comment.
I believe the error is only permanent if the instance doesn't become available again, otherwise the job waits for the instance to come back up.
Contributor
Author
There was a problem hiding this comment.
thanks @mw5h - updated to
When
IMPORT INTOuses distributed merge, it stores intermediate SST files on participating SQL instances' local storage. If one of those SQL instances becomes unavailable during the merge phase, the job waits for that SQL instance to become available again. If the SQL instance does not become available again, the job fails with a permanent error.
PTAL!
rmloveland
changed the title
Contributor
Author
|
ok, merging this so we have it in place for Monday's release. If the wording update still needs tweaks, happy to do more going forward! |
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
3 participants
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.
Fixes DOC-16673