Skip to content

Update SHOW RANGE FOR ROW to take indexed columns#8634

Merged
jseldess merged 2 commits intomasterfrom
show-range-for-row-update
Oct 13, 2020
Merged

Update SHOW RANGE FOR ROW to take indexed columns#8634
jseldess merged 2 commits intomasterfrom
show-range-for-row-update

Conversation

@jseldess
Copy link
Copy Markdown
Contributor

Fixes #7821.

@jseldess jseldess requested a review from rohany October 12, 2020 03:53
@cockroach-teamcity
Copy link
Copy Markdown
Member

This change is Reviewable

@cockroach-teamcity
Copy link
Copy Markdown
Member

@rohany
Copy link
Copy Markdown

rohany commented Oct 12, 2020

Looks good to me, but @solongordon should give it the final stamp :)

@jseldess jseldess requested a review from solongordon October 12, 2020 04:14
Copy link
Copy Markdown
Contributor

@solongordon solongordon left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reviewable status: :shipit: complete! 0 of 0 LGTMs obtained (waiting on @jseldess, @rohany, and @solongordon)


v20.2/show-range-for-row.md, line 19 at r1 (raw file):

~~~
SHOW RANGE FROM TABLE <tablename> FOR ROW (row, value, ...)
SHOW RANGE FROM INDEX [ <tablename> @ ] <indexname> FOR ROW (row, value, ...)

Nit: I find the (row, value, ...) terminology kind of confusing. It seems to imply that the first element is a row and the second one is a value. Perhaps better to write something like (value1, value2, ...)?

@jseldess
Copy link
Copy Markdown
Contributor Author


v20.2/show-range-for-row.md, line 19 at r1 (raw file):

Previously, solongordon (Solon) wrote…

Nit: I find the (row, value, ...) terminology kind of confusing. It seems to imply that the first element is a row and the second one is a value. Perhaps better to write something like (value1, value2, ...)?

I agree. I like your suggestion better. I got this syntax directly from the CLI help text in sql.y: https://github.com/cockroachdb/cockroach/blob/master/pkg/sql/parser/sql.y#L4991.

I'll change it here and also open a cockroach PR to change the help text.

@jseldess jseldess force-pushed the show-range-for-row-update branch from ab4dd4f to 7b597e2 Compare October 13, 2020 00:29
@cockroach-teamcity
Copy link
Copy Markdown
Member

jseldess added a commit to cockroachdb/cockroach that referenced this pull request Oct 13, 2020
The SHOW RANGE FOR ROW statement now accepts the indexed values
of the row as a tuple. The help text representation of this was
previous (row, value, ...). The help text representation is
now (value1, value2, ...), which I believe is clearer.

Counterpart to this docs PR: cockroachdb/docs#8634

Release note: None
Unrelated to this PR. Somehow these broken links
made there way onto master.
@jseldess jseldess merged commit 2f7d9cc into master Oct 13, 2020
@jseldess jseldess deleted the show-range-for-row-update branch October 13, 2020 01:22
craig bot pushed a commit to cockroachdb/cockroach that referenced this pull request Nov 20, 2020
55474: sql: clarify help text for `show range` r=solongordon a=jseldess

The SHOW RANGE FOR ROW statement now accepts the indexed values
of the row as a tuple. The help text representation of this was
previous (row, value, ...). The help text representation is
now (value1, value2, ...), which I believe is clearer.

Counterpart to this docs PR: cockroachdb/docs#8634

Release note: None

Co-authored-by: Jesse Seldess <j_seldess@hotmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

sql: update the SHOW RANGE FOR ROW command to just take index cols

4 participants