Skip to content
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

Link to comparison operators page #11026

Merged
merged 1 commit into from
Mar 4, 2022
Merged

Conversation

Jessie212
Copy link
Contributor

Description

General information

Is this change a fix, improvement, new feature, refactoring, or other?

Improvement.

Is this a change to the core query engine, a connector, client library, or the SPI interfaces? (be specific)

Documentation

How would you describe this change to a non-technical end user or system administrator?

Link to comparison operators page

Related issues, pull requests, and links

Documentation

( ) No documentation is needed.
(x) Sufficient documentation is included in this PR.
( ) Documentation PR is available with #prnumber.
( ) Documentation issue #issuenumber is filed, and can be handled later.

Release notes

(x) No release notes entries required.
( ) Release notes entries required with the following suggested text:

# Section
* Fix some things. ({issue}`5678`)

Copy link
Member

@mosabua mosabua left a comment

Choose a reason for hiding this comment

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

Once we get that sentence right .. this PR should also add it to all sort of other commands that support like with pattern e.g. show catalog, show schemas and others.. you will have to look which ones there are.

docs/src/main/sphinx/sql/show-session.rst Outdated Show resolved Hide resolved
@Jessie212 Jessie212 requested a review from mosabua February 14, 2022 22:17
@Jessie212 Jessie212 force-pushed the jt/like-pattern branch 2 times, most recently from e368c0d to 949aa4e Compare February 17, 2022 01:50
Copy link
Member

@mosabua mosabua left a comment

Choose a reason for hiding this comment

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

Update code snippets to use uppercase FROM and LIKE

Once thats done I can review the content in the paragraphs.

docs/src/main/sphinx/sql/show-catalogs.rst Outdated Show resolved Hide resolved
Copy link
Contributor

@jhlodin jhlodin left a comment

Choose a reason for hiding this comment

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

Some minor suggested changes to the text, otherwise LGTM

docs/src/main/sphinx/sql/show-catalogs.rst Outdated Show resolved Hide resolved
docs/src/main/sphinx/sql/show-catalogs.rst Outdated Show resolved Hide resolved
docs/src/main/sphinx/sql/show-columns.rst Outdated Show resolved Hide resolved
docs/src/main/sphinx/sql/show-functions.rst Outdated Show resolved Hide resolved
docs/src/main/sphinx/sql/show-schemas.rst Outdated Show resolved Hide resolved
docs/src/main/sphinx/sql/show-session.rst Outdated Show resolved Hide resolved
docs/src/main/sphinx/sql/show-tables.rst Outdated Show resolved Hide resolved
@Jessie212 Jessie212 force-pushed the jt/like-pattern branch 2 times, most recently from ddddfc5 to e405740 Compare February 24, 2022 23:09
@Jessie212 Jessie212 requested a review from hashhar February 24, 2022 23:20
Copy link
Member

@hashhar hashhar left a comment

Choose a reason for hiding this comment

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

LGTM % wording suggestion

Comment on lines 18 to 20
filter the results to the desired subset. For example, the following query
allows you to find catalogs where the first character in a value is specified.
Query results show catalogs that begin with ``t``::
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
filter the results to the desired subset. For example, the following query
allows you to find catalogs where the first character in a value is specified.
Query results show catalogs that begin with ``t``::
filter the results to the desired subset. For example, the following query
allows you to find catalogs whose names begin with ``t``::

Similar in other places too? Existing wording seems repetitive (first we describe what query does in very abstract terms and then follow with the concrete meaning).

Copy link
Member

Choose a reason for hiding this comment

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

I like that .. want to adapt to that @Jessie212 ?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Great suggestion, @hashhar. Applied.

Copy link
Member

@mosabua mosabua left a comment

Choose a reason for hiding this comment

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

One minor nit to fix .. then good to go

docs/src/main/sphinx/sql/show-session.rst Outdated Show resolved Hide resolved
Copy link
Member

@mosabua mosabua left a comment

Choose a reason for hiding this comment

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

Looks good now. Thank you!


SHOW SESSION LIKE 'query%'

See related syntax
Copy link
Member

Choose a reason for hiding this comment

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

Why the title change here? lets undo that ..

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I'll revert it because it isn't related to the task, but "See also" sounds weird. Plus, it's an incomplete action, imo. I think it should say something like, "See more session commands".

@electrum electrum merged commit cbd5ca3 into trinodb:master Mar 4, 2022
@github-actions github-actions bot added this to the 373 milestone Mar 4, 2022
@Jessie212 Jessie212 deleted the jt/like-pattern branch March 4, 2022 22:32
v-jizhang added a commit to v-jizhang/presto that referenced this pull request Mar 10, 2022
Cherry-pick of trinodb/trino#11026

Co-authored-by: Jessica <jessica.twitty-shuler@starburstdata.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Development

Successfully merging this pull request may close these issues.

6 participants