Skip to content

sql: add description column to SHOW ALL output #165397

Merged
trunk-io[bot] merged 1 commit intocockroachdb:masterfrom
rafiss:show-all-3cols
Mar 16, 2026
Merged

sql: add description column to SHOW ALL output #165397
trunk-io[bot] merged 1 commit intocockroachdb:masterfrom
rafiss:show-all-3cols

Conversation

@rafiss
Copy link
Collaborator

@rafiss rafiss commented Mar 11, 2026

PostgreSQL's SHOW ALL returns three columns: name, setting, description.
CockroachDB's SHOW ALL previously only returned two: variable, value.
Now that all session variables have descriptions, expose them as a third
column to match PostgreSQL's behavior.

This adds a description column to the crdb_internal.session_variables
virtual table and includes it in the SHOW ALL delegate query.

Resolves: #101715

Release note (sql change): SHOW ALL now returns a third column,
description, containing a human-readable description of each session
variable. This matches the PostgreSQL behavior of SHOW ALL.

@trunk-io
Copy link
Contributor

trunk-io bot commented Mar 11, 2026

😎 Merged successfully - details.

@blathers-crl
Copy link

blathers-crl bot commented Mar 11, 2026

Your pull request contains more than 1000 changes. It is strongly encouraged to split big PRs into smaller chunks.

🦉 Hoot! I am a Blathers, a bot for CockroachDB. My owner is dev-inf.

@cockroach-teamcity
Copy link
Member

This change is Reviewable

@rafiss rafiss force-pushed the show-all-3cols branch 4 times, most recently from d8766e9 to 23675a9 Compare March 14, 2026 16:16
PostgreSQL's SHOW ALL returns three columns: name, setting, description.
CockroachDB's SHOW ALL previously only returned two: variable, value.
Now that all session variables have descriptions, expose them as a third
column to match PostgreSQL's behavior.

This adds a `description` column to the `crdb_internal.session_variables`
virtual table and includes it in the `SHOW ALL` delegate query.

Resolves: cockroachdb#101715

Release note (sql change): `SHOW ALL` now returns a third column,
`description`, containing a human-readable description of each session
variable. This matches the PostgreSQL behavior of `SHOW ALL`.

Co-Authored-By: roachdev-claude <roachdev-claude-bot@cockroachlabs.com>
@rafiss rafiss marked this pull request as ready for review March 16, 2026 15:16
@rafiss rafiss requested a review from a team as a code owner March 16, 2026 15:17
@rafiss rafiss requested a review from fqazi March 16, 2026 15:17
Copy link
Collaborator

@fqazi fqazi left a comment

Choose a reason for hiding this comment

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

:lgtm:

@fqazi reviewed 6 files and all commit messages, and made 1 comment.
Reviewable status: :shipit: complete! 1 of 0 LGTMs obtained (waiting on rafiss).

@rafiss
Copy link
Collaborator Author

rafiss commented Mar 16, 2026

/trunk merge

@trunk-io trunk-io bot merged commit 89201d9 into cockroachdb:master Mar 16, 2026
27 checks passed
@rafiss rafiss deleted the show-all-3cols branch March 18, 2026 01:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

sql: SHOW ALL returns two columns instead of three

3 participants