docs: add cookbook recipe for copying a schema between instances - #550
Merged
Conversation
|
🚀 Build success! Latest successful preview: https://preview-550--questdb-documentation.netlify.app/docs/ Commit SHA: be5c540
|
javier
added a commit
that referenced
this pull request
Sep 9, 2026
## Summary Follow-up to #550. Adds a manual alternative to the copy-schema recipe: the Web Console schema explorer can put the DDL for selected objects on the clipboard with no scripting, via Select Mode → Select all → Copy schemas to clipboard. Includes a warning that this path is not dependency-ordered. The console groups statements by object type and sorts alphabetically within each group, so a materialized view built on another materialized view can be emitted before its own base. `SHOW CREATE DATABASE` remains the recommended path since it emits dependency order. Extends the existing changelog bullet rather than adding a second one, as the page is already listed as new under September.
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
1 participant
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.
Summary
New cookbook recipe under Operations covering how to recreate one instance's schema on another using
SHOW CREATE DATABASE.The dump comes back as a result set with one DDL statement per row, so the page walks from the statement itself, to fetching it as JSON over the REST API, to the two useful outcomes: writing a
.sqlfile, or replaying it straight onto a target. Statements are sent one at a time because/executeis a GET endpoint and a whole schema in a single request would exceed the maximum request size.Enterprise section covers
INCLUDE (SCHEMA)andINCLUDE (ACL)for separating structure from permissions, since the default dump carries both.Verified end to end: replayed the demo schema into a local OSS 10.0.1 instance, all 19 statements returned
{"ddl":"OK"}, and a round-tripSHOW CREATE DATABASEoff the target came back byte-identical to the source in the same order.Also adds cross-links from the existing "Copy data between instances" recipe and the
SHOW CREATE DATABASEsection of the SHOW reference, plus a changelog entry.