Skip to content

docs: Add EXPLAIN CREATE TABLE documentation#27214

Merged
steveburnett merged 13 commits intoprestodb:masterfrom
garimauttam:docs/update-explain-rst-documentation
Mar 13, 2026
Merged

docs: Add EXPLAIN CREATE TABLE documentation#27214
steveburnett merged 13 commits intoprestodb:masterfrom
garimauttam:docs/update-explain-rst-documentation

Conversation

@garimauttam
Copy link
Copy Markdown
Contributor

@garimauttam garimauttam commented Feb 26, 2026

Resolves #27148

Changes

Added EXPLAIN CREATE TABLE syntax to explain.rst
Add examples including IF NOT EXISTS
Clarify that EXPLAIN returns a summary and does not execute the DDL

== NO RELEASE NOTE ==

@garimauttam garimauttam requested review from a team, elharo and steveburnett as code owners February 26, 2026 11:52
@sourcery-ai
Copy link
Copy Markdown
Contributor

sourcery-ai bot commented Feb 26, 2026

🧙 Sourcery has finished reviewing your pull request!


Tips and commands

Interacting with Sourcery

  • Trigger a new review: Comment @sourcery-ai review on the pull request.
  • Continue discussions: Reply directly to Sourcery's review comments.
  • Generate a GitHub issue from a review comment: Ask Sourcery to create an
    issue from a review comment by replying to it. You can also reply to a
    review comment with @sourcery-ai issue to create an issue from it.
  • Generate a pull request title: Write @sourcery-ai anywhere in the pull
    request title to generate a title at any time. You can also comment
    @sourcery-ai title on the pull request to (re-)generate the title at any time.
  • Generate a pull request summary: Write @sourcery-ai summary anywhere in
    the pull request body to generate a PR summary at any time exactly where you
    want it. You can also comment @sourcery-ai summary on the pull request to
    (re-)generate the summary at any time.
  • Generate reviewer's guide: Comment @sourcery-ai guide on the pull
    request to (re-)generate the reviewer's guide at any time.
  • Resolve all Sourcery comments: Comment @sourcery-ai resolve on the
    pull request to resolve all Sourcery comments. Useful if you've already
    addressed all the comments and don't want to see them anymore.
  • Dismiss all Sourcery reviews: Comment @sourcery-ai dismiss on the pull
    request to dismiss all existing Sourcery reviews. Especially useful if you
    want to start fresh with a new review - don't forget to comment
    @sourcery-ai review to trigger a new review!

Customizing Your Experience

Access your dashboard to:

  • Enable or disable review features such as the Sourcery-generated pull request
    summary, the reviewer's guide, and others.
  • Change the review language.
  • Add, remove or edit custom review instructions.
  • Adjust other review settings.

Getting Help

Copy link
Copy Markdown
Contributor

@sourcery-ai sourcery-ai bot left a comment

Choose a reason for hiding this comment

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

Hey - I've reviewed your changes and they look great!


Sourcery is free for open source - if you like our reviews please consider sharing them ✨
Help me be more useful! Please click 👍 or 👎 on each comment and I'll use the feedback to improve your reviews.

@github-actions github-actions bot added the docs label Feb 26, 2026
@github-project-automation github-project-automation bot moved this to 🆕 Unprioritized in Presto Documentation Feb 26, 2026
@garimauttam garimauttam changed the title docs: document EXPLAIN CREATE TABLE syntax and examples docs: Add EXPLAIN CREATE TABLE documentation Feb 26, 2026
Copy link
Copy Markdown
Contributor

@steveburnett steveburnett left a comment

Choose a reason for hiding this comment

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

LGTM! (docs)

Pull branch, local doc build, looks good. Thanks!

@github-project-automation github-project-automation bot moved this from 🆕 Unprioritized to ✅ Done in Presto Documentation Feb 26, 2026
@steveburnett
Copy link
Copy Markdown
Contributor

The CI checks seem to be stuck in pending status. You may need to re-push the branch to re-run the CI checks. If you do that, re-request a review from me and I'll be happy to approve this again so it can be merged.

@garimauttam garimauttam requested a review from steveburnett March 4, 2026 18:22
@garimauttam garimauttam force-pushed the docs/update-explain-rst-documentation branch from fc1a817 to dcb79c1 Compare March 4, 2026 19:57
Copy link
Copy Markdown
Contributor

@steveburnett steveburnett left a comment

Choose a reason for hiding this comment

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

LGTM! (docs)

Pull updated branch, new local doc build, looks good. Thanks!

@steveburnett
Copy link
Copy Markdown
Contributor

The CI block for docs-only PRs has been fixed in #27285. Could you rebase to the latest master branch? Then we can move forward and merge this PR.

Please add

== NO RELEASE NOTE ==

to the PR description.

Copy link
Copy Markdown
Contributor

@steveburnett steveburnett left a comment

Choose a reason for hiding this comment

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

LGTM! (docs)

Pull updated branch, new local doc build, looks good. Thanks!

@steveburnett steveburnett merged commit 78ae082 into prestodb:master Mar 13, 2026
83 checks passed
@garimauttam garimauttam deleted the docs/update-explain-rst-documentation branch March 13, 2026 14:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

Status: ✅ Done

Development

Successfully merging this pull request may close these issues.

Add documentation for CREATE TABLE to sql/explain.rst

2 participants