[SPARK-28809][DOC][SQL]Document SHOW TABLE in SQL Reference #25632
Conversation
|
@dilipbiswal @gatorsmile |
|
@gatorsmile Can you please look at the attached screen shot ? The output kind of scrolls and does not look as pretty ? Any advice on how we should display this ? |
srowen
left a comment
srowen
left a comment
There was a problem hiding this comment.
(I'm not concerned about the long table display)
There was a problem hiding this comment.
Back-tick quote SHOW TABLE EXTENDED?
There was a problem hiding this comment.
"for the table name"
"is present. It will output"
There was a problem hiding this comment.
Is it a full regex? we should say a little more about what's allowed here.
There was a problem hiding this comment.
updated the details
|
@shivusondur are you able to update? |
shivusondur
force-pushed
the
jiraSHOWTABLE
branch
from
4242185 to
b81aaf2
Compare
shivusondur
left a comment
shivusondur
left a comment
There was a problem hiding this comment.
@srowen
I handled all your comments, please check
| `Created By`, `Type`, `Provider`, `Table Properties`, `Location`, `Serde Library`, `InputFormat`, | ||
| `OutputFormat`, `Storage Properties`, `Partition Provider`, `Partition Columns` and `Schema`. | ||
|
|
||
| Users cannot use regular expression for the table name if a partition specification is present. It will output |
There was a problem hiding this comment.
Last nit: a regular expression. But how about:
"If a partition specification is present, it outputs the given partition's ... Note that a table regex cannot be used with a partition specification."
There was a problem hiding this comment.
@srowen
If the PARTITION key present in the query, the pattern mentioned in LIKE will not be treated as a regex. It will be treated as normal name.
for example. If we mention the regex with LIKE and PARTITION keyword, it fails like below.
But if mention the full name like below it works
Is it better to mention this exception scenario in the examples section?
There was a problem hiding this comment.
Yes, I think that agrees with the text I suggested? there's no problem documenting this in the docs here.
There was a problem hiding this comment.
Yes, but I don't think you changed this sentence. I'm suggesting a typo fix and rewrite right here.
There was a problem hiding this comment.
@srowen
Sorry for late, I updated it according to your suggestion.
|
Test build #4915 has finished for PR 25632 at commit
|
|
Merged to master |
5 participants
What changes were proposed in this pull request?
Added the document reference for SHOW TABLE EXTENDED sql command
Why are the changes needed?
For User reference
Does this PR introduce any user-facing change?
yes, it provides document reference for SHOW TABLE EXTENDED sql command
How was this patch tested?
verified in snap
Attached the Snap