Skip to content

Conversation

@rmloveland
Copy link
Contributor

Fixes DOC-14457

@netlify
Copy link

netlify bot commented Oct 29, 2025

Deploy Preview for cockroachdb-api-docs canceled.

Name Link
🔨 Latest commit 976d5c9
🔍 Latest deploy log https://app.netlify.com/projects/cockroachdb-api-docs/deploys/690260ed45fb0700085ffc95

@netlify
Copy link

netlify bot commented Oct 29, 2025

Deploy Preview for cockroachdb-interactivetutorials-docs canceled.

Name Link
🔨 Latest commit 976d5c9
🔍 Latest deploy log https://app.netlify.com/projects/cockroachdb-interactivetutorials-docs/deploys/690260eded365b000848d7a5

@github-actions
Copy link

@rmloveland rmloveland requested a review from rafiss October 29, 2025 18:46
@rmloveland
Copy link
Contributor Author

@rafiss this is to document the changes from cockroachdb/cockroach#130547

@netlify
Copy link

netlify bot commented Oct 29, 2025

Netlify Preview

Name Link
🔨 Latest commit 976d5c9
🔍 Latest deploy log https://app.netlify.com/projects/cockroachdb-docs/deploys/690260edc793760007806035
😎 Deploy Preview https://deploy-preview-20858--cockroachdb-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.


### `RESET {session variable}`

`ALTER DATABASE ... RESET {session variable}` resets a [session variable]({% link {{ page.version.version }}/set-vars.md %}#supported-variables) for a database to its default value for the client session.
Copy link
Contributor

Choose a reason for hiding this comment

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

This is not part of your PR, but this is not accurate. It should say something more like:

ALTER DATABASE ... RESET {session variable} removes the override for a default value of a [session variable]({% link {{ page.version.version }}/set-vars.md %}#supported-variables) for a database for future sessions.

(My suggestion is too much word salad... but hopefully my intent is legible. Basically, my point is that this only affects future sessions.)

For reference, postgres docs:

The remaining forms change the session default for a run-time configuration variable for a PostgreSQL database. Whenever a new session is subsequently started in that database, the specified value becomes the session default value.

No [privileges]({% link {{ page.version.version }}/security-reference/authorization.md %}#managing-privileges) are required to reset a session setting.
To reset default session variable values for a database with `ALTER DATABASE ... RESET {session variable}`, the user must be a member of the [`admin` role]({% link {{ page.version.version }}/security-reference/authorization.md %}#admin-role) or the [owner]({% link {{ page.version.version }}/security-reference/authorization.md %}#object-ownership) of the target database.

All other session variables do not require [privileges]({% link {{ page.version.version }}/security-reference/authorization.md %}#managing-privileges) to modify.
Copy link
Contributor

Choose a reason for hiding this comment

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

What is "other session variables" referring to here? I think we possibly could just remove this sentence entirely.

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.

2 participants