Skip to content

feat(query): SHOW/TERMINATE SESSIONS - #1814

Draft
katarinasupe wants to merge 2 commits into
release/3.14from
docs/session-user-read-uaf
Draft

katarinasupe wants to merge 2 commits into
release/3.14from
docs/session-user-read-uaf

Conversation

@katarinasupe

@katarinasupe katarinasupe commented Oct 7, 2026 •

Copy link
Copy Markdown
Contributor

Description

Documents SHOW SESSIONS and TERMINATE SESSIONS on the Transactions page and in the query privileges table. Also fixes two older statements on the same page: TERMINATE TRANSACTIONS $id (parameters were never accepted) and the new database column of SHOW TRANSACTIONS (memgraph/memgraph#4571).

Not done:

  • SHOW TRANSACTIONS example outputs still show seven columns; I don't know what database shows on snapshot and GC rows.
  • SHOW ACTIVE USERS also gained columns in #4571 (server-stats page).

Product PR

memgraph/memgraph#4577

Checklist

  • For a product change: milestone set to the release and feature or bugfix label added
  • For a product change: this PR is linked from the product PR's documentation checklist

@katarinasupe katarinasupe added this to the 3.14 milestone Oct 7, 2026
@katarinasupe katarinasupe added the feature Documentation related to a new product feature of feature update label Oct 7, 2026
@vercel

vercel Bot commented Oct 7, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
documentation Ready Ready Preview Oct 7, 2026 11:52am UTC

Request Review

@andrejtonev andrejtonev left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Thanks for writing this up! I checked every statement against current master (6e9c79da3), on a live instance as well as in the code. Most of it is accurate. The inline comments cover two statements that are wrong for 3.14 (SESSIONS isn't reserved, and the forced-DROP DATABASE example no longer applies after #4843), a few that overstate what happens (killed: true, "running query is aborted"), and some behaviour that's missing: open-transaction rollback, what the client sees and driver retries, auth disabled, Community vs Enterprise, impersonation, coordinators, LOGOFF and $id parameters. Every suggestion was re-run against master.

Three things outside this diff:

  1. TERMINATE TRANSACTIONS $id (around line 340): "A parameterized id is treated exactly like a literal one, so running TERMINATE TRANSACTIONS $id with $id = "*" also terminates everything." This has never worked. The grammar only accepts a literal there (transactionId : literal, unchanged since the query was added), so TERMINATE TRANSACTIONS $id is a syntax error (extraneous input '$' expecting ...) whatever $id is. The sentence came in with v3.13 (#1689). Suggested replacement: "Transaction ids, including "*", must be string literals. Query parameters such as $id aren't supported and cause a syntax error."
  2. SHOW TRANSACTIONS columns (line 95): since memgraph#4571 (3.14, listed under breaking changes in #1764), SHOW TRANSACTIONS returns an 8th column, database, after elapsed_ms. The page still says "contains seven columns", and the column table and example outputs don't include it. Suggested row: | database | String | The database the transaction is running on. |
  3. PR description: it says the SHOW TRANSACTIONS fix is internal and "the release note already covers it". It doesn't: on release/3.14 the only #4577 entry is the feature line. I've suggested a bug-fix line on #1764.

Comment thread pages/fundamentals/transactions.mdx
Comment thread pages/fundamentals/transactions.mdx Outdated
Comment thread pages/fundamentals/transactions.mdx Outdated
Comment thread pages/fundamentals/transactions.mdx Outdated
Comment thread pages/fundamentals/transactions.mdx Outdated
Comment thread pages/fundamentals/transactions.mdx Outdated
Comment thread pages/fundamentals/transactions.mdx
Comment thread pages/fundamentals/transactions.mdx
Comment thread pages/fundamentals/transactions.mdx Outdated
Comment thread pages/database-management/authentication-and-authorization/query-privileges.mdx Outdated
@andrejtonev andrejtonev mentioned this pull request Oct 7, 2026
66 of 75 tasks
katarinasupe and others added 2 commits October 7, 2026 13:48
Documents the session management queries from memgraph/memgraph#4577:
listing open Bolt sessions and terminating them from another connection,
who can see and terminate which sessions, the result columns, and the
SESSIONS reserved keyword. Adds both queries to the query privileges table.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Also fix the TERMINATE TRANSACTIONS parameter claim and add the database
column of SHOW TRANSACTIONS.

This branch was successfully deployed

1 active deployment
Preview — 54ce8128 Deployed Oct 7, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

feature Documentation related to a new product feature of feature update

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants