cockroachdb / docs

CockroachDB user documentation
https://cockroachlabs.com/docs
Creative Commons Attribution 4.0 International
188 stars 456 forks source link

Check options list & reference to SQL diagrams across bulk/cdc docs #12144

Open kathancox opened 2 years ago

kathancox commented 2 years ago

Kathryn Hancox (kathancox) commented:

@livlobo has highlighted that often we're referencing kv_option_list on the bulk page when referring to the options. However both BACKUP & RESTORE have sql diagrams that refer to the option param as backup_options_list and restore_options_list. Then on the IMPORT pages this also diverges. SHOW BACKUP page is another place where kv_option_list is used.

For each of these statements the option isn't necessarily directly stated as WITH option = "value"

This issue is to investigate if diagrams need updating, if there is a historical reason for backup and restore pages differing. etc. Should also check CDC too.

Also see: https://www.cockroachlabs.com/docs/v21.1/sql-grammar.html#backup_options

Jira Issue: DOC-1149

github-actions[bot] commented 1 year ago

We have marked this issue as stale because it has been inactive for 18 months. If this issue is still relevant, removing the stale label or adding a comment will keep it active. Otherwise, we'll close it in 10 days to keep the issue queue tidy. Thank you for your contribution to CockroachDB docs!