docs: Document cross-keyspace JOIN controls (--no-cross-keyspace-joins flag and VSchema setting)#2086
docs: Document cross-keyspace JOIN controls (--no-cross-keyspace-joins flag and VSchema setting)#2086promptless[bot] wants to merge 1 commit intoprodfrom
Conversation
… and VSchema setting)
![promptless[bot]](https://avatars.githubusercontent.com/in/979718?s=60&v=4){kind=small}
| --mysql-server-write-timeout duration connection write timeout | ||
| --mysql-slow-connect-warn-threshold duration Warn if it takes more than the given threshold for a mysql connection to establish | ||
| --mysql-tcp-version string Select tcp, tcp4, or tcp6 to control the socket type. (default "tcp") | ||
| --no-cross-keyspace-joins when set to true, the planner will fail instead of producing a plan that includes cross-keyspace joins |
There was a problem hiding this comment.
Citation: Flag description from go/flags/endtoend/vtgate.txt in PR #19668. The flag is registered in go/vt/vtgate/vtgate.go.
View source
|
|
||
| Typically, such a table has a canonical source in an unsharded keyspace, and the copies in the sharded keyspace are kept up-to-date through VReplication. | ||
|
|
||
| ## Controlling cross-keyspace JOINs |
There was a problem hiding this comment.
Citation: VSchema setting no_cross_keyspace_joins added to Keyspace proto in go/vt/proto/vschema/vschema.pb.go. Error message format from go/vt/vtgate/planbuilder/operators/join.go line 621. Precedence rules from PR description.
View source
|
|
||
| This comment directive is used to override that limitation, allowing application code to be customized to allow scatters for certain chosen use-cases, but not for the general case. | ||
|
|
||
| ## Allow cross-keyspace JOINs (`ALLOW_CROSS_KEYSPACE_JOINS`) |
There was a problem hiding this comment.
Citation: Comment directive ALLOW_CROSS_KEYSPACE_JOINS defined in go/vt/sqlparser/comments.go. Example query format from PR description and test files in go/test/endtoend/vtgate/queries/no_cross_keyspace_joins/.
View source
✅ Deploy Preview for vitess ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
Open this suggestion in Promptless to view citations and reasoning process
Documents the new feature for controlling cross-keyspace JOINs from PR #19668:
--no-cross-keyspace-joinsflagno_cross_keyspace_joinskeyspace setting and explains precedenceALLOW_CROSS_KEYSPACE_JOINSdirective for per-query overridesTrigger Events
vitessio/vitess PR #19668: `vtgate`: add controls for cross-keyspace `JOIN`s
Promptless Research (7 files, 1 GitHub PR)
.long_term_context/product_knowledge/product_overview.md.long_term_context/doc_workflow/client_instructions.md.long_term_context/style/client_style_guide.mdcontent/en/docs/24.0/reference/features/vschema.mdcontent/en/docs/24.0/reference/programs/vtgate/_index.mdcontent/en/docs/24.0/reference/features/mysql-query-extensions.mdcontent/en/docs/24.0/user-guides/configuration-advanced/comment-directives.mdAgent Response
Tip: Add or adjust Promptless's style guide in Agent Knowledge Base ✍️