-
Notifications
You must be signed in to change notification settings - Fork 2
Add migration guide for Persistent Query Settings #11
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Conversation
Documented the procedure for migrating Persistent Query Settings between clusters, including export and import steps with examples.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Pull Request Overview
This PR adds a new migration guide for Persistent Query Settings, providing step-by-step instructions for transferring query settings between MongoDB clusters to maintain consistent query performance during migrations.
- Added comprehensive migration documentation with export and import procedures
- Included practical examples showing both
representativeQueryandqueryShapeHashapproaches - Provided sample JSON output and MongoDB commands for real-world implementation
Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.
docs/reference/pqs.md
Outdated
| "queryShapeHash": "8B401B2B", | ||
| "representativeQuery": { | ||
| "find": "users", | ||
| "filter": { "signup_date": { "$gte": new Date("2024-01-01T00:00:00.000Z") } }, |
Copilot
AI
Oct 3, 2025
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The JSON example contains new Date() which is JavaScript syntax, not valid JSON. In actual JSON output, this would be an ISODate string or timestamp object. Consider showing the actual JSON format that would be exported.
| "filter": { "signup_date": { "$gte": new Date("2024-01-01T00:00:00.000Z") } }, | |
| "filter": { "signup_date": { "$gte": "2024-01-01T00:00:00.000Z" } }, |
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Added a note regarding version compatibility for migration.
Updated examples in the Persistent Query Settings documentation to reflect changes in query structure and settings.
|
Examples and commands verified. |
|
Why is the doc in reference? It's a usage instruction, not a reference material from my perspective. Upstream has it in reference too, but maybe they are wrong? |
Added a glossary item Improved formatting
Documented the procedure for migrating Persistent Query Settings between clusters, including export and import steps with examples.