Skip to content

Add information and example of combining SHOW and TERMINATE commands with regular Cypher#1528

Draft
Hunterness wants to merge 11 commits into
neo4j:devfrom
Hunterness:dev-composable-commands
Draft

Add information and example of combining SHOW and TERMINATE commands with regular Cypher#1528
Hunterness wants to merge 11 commits into
neo4j:devfrom
Hunterness:dev-composable-commands

Conversation

@Hunterness
Copy link
Copy Markdown
Collaborator

@Hunterness Hunterness commented Apr 21, 2026

Also includes

  • adding the plan operators for graph type alter and show plans (was missed during the graph type documentation)
  • adding notes on updated behaviour on null input for SHOW SETTINGS, SHOW TRANSACTIONS and TERMINATE TRANSACTIONS (will be updated in 2026.05)
  • adding the plan operator for show databases (part of https://github.com/neo-technology/neo4j/pull/36480 to make the show commands have nicer query plans when run against the system database)

TODO:

  • Update 2026.XX to relevant version once released
  • Do we want any of this on the cheat sheet?
  • Talked to Jens about maybe making a single page for the composable commands instead of having them spread out like they are now

@Hunterness Hunterness added team-cypher-operations Cypher operations should review this DO NOT MERGE labels Apr 21, 2026
Comment thread modules/ROOT/pages/clauses/listing-settings.adoc
@JPryce-Aklundh JPryce-Aklundh self-assigned this Apr 21, 2026
Comment thread modules/ROOT/pages/clauses/listing-settings.adoc
Since that PR was merged and it isn't behind the feature flag we now know the version for this case
Copy link
Copy Markdown
Collaborator Author

@Hunterness Hunterness left a comment

Choose a reason for hiding this comment

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

One thing I found missing + comments to update XX to correct version

Comment thread modules/ROOT/pages/clauses/listing-functions.adoc Outdated
Comment thread modules/ROOT/pages/clauses/listing-procedures.adoc Outdated
Comment thread modules/ROOT/pages/clauses/listing-settings.adoc Outdated
Comment thread modules/ROOT/pages/clauses/transaction-clauses.adoc Outdated
Comment thread modules/ROOT/pages/clauses/transaction-clauses.adoc Outdated
Comment thread modules/ROOT/pages/indexes/syntax.adoc Outdated
Comment thread modules/ROOT/pages/schema/constraints/list-constraints.adoc Outdated
Comment thread modules/ROOT/pages/schema/graph-types/list-graph-types.adoc Outdated
Comment thread modules/ROOT/pages/schema/syntax.adoc Outdated
Comment thread modules/ROOT/pages/schema/syntax.adoc Outdated
Since that feature flag PR was merged we now know the version
@neo4j-docops-agent
Copy link
Copy Markdown
Collaborator

@evelinadanielsson evelinadanielsson self-assigned this Apr 22, 2026
Comment thread modules/ROOT/pages/clauses/listing-settings.adoc

In difference to other show commands, the `SHOW` and `TERMINATE TRANSACTIONS` commands can be combined in the same query.
In Cypher 25 from 2026.05, the `SHOW` and `TERMINATE TRANSACTIONS` commands can be combined with general Cypher clauses in a single query.
Before 2026.05 and in Cypher 5, the `SHOW` and `TERMINATE TRANSACTIONS` commands can be combined in the same query, in difference to other show commands.
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Suggested change
Before 2026.05 and in Cypher 5, the `SHOW` and `TERMINATE TRANSACTIONS` commands can be combined in the same query, in difference to other show commands.
In earlier versions and in Cypher 5, the `SHOW` and `TERMINATE TRANSACTIONS` commands can be combined in the same query, in difference to other show commands.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

This page was moved and refactored a bit so this sentence is no longer relevant

[role=label--cypher-25-only label--new-Neo4j-2026.05]
=== Listing other transactions by the same user that were terminated with general Cypher

Similar to the previous example, we can list remaining transactions by users whose transactions were terminated by first terminate the transactions using `TERMINATE TRANSACTIONS`, then filter users through `SHOW TRANSACTIONS`.
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Suggested change
Similar to the previous example, we can list remaining transactions by users whose transactions were terminated by first terminate the transactions using `TERMINATE TRANSACTIONS`, then filter users through `SHOW TRANSACTIONS`.
Similar to the previous example, we can list remaining transactions by users whose transactions were terminated by first terminating the transactions using `TERMINATE TRANSACTIONS`, then filtering users through `SHOW TRANSACTIONS`.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

This page was moved and refactored a bit so this sentence is no longer relevant

@Hunterness
Copy link
Copy Markdown
Collaborator Author

Comment thread modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc Outdated
Comment thread modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc Outdated
Comment thread modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc Outdated
Comment thread modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc Outdated
Comment thread modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc Outdated
Co-authored-by: Reneta Popova <reneta.popova@neo4j.com>
Copy link
Copy Markdown
Collaborator Author

@Hunterness Hunterness left a comment

Choose a reason for hiding this comment

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

Some known updates based on updates from the PRs that moved pages around

Comment thread modules/ROOT/pages/clauses/listing-functions.adoc
Comment thread modules/ROOT/pages/schema/constraints/list-constraints.adoc
Comment thread modules/ROOT/pages/schema/graph-types/list-graph-types.adoc
Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

This page has been moved to operations manual, neo4j/docs-operations#3033, and that move included these updates.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

This page has been moved to operations manual, neo4j/docs-operations#3034, and that move included these updates.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

This page has been moved to operations manual, neo4j/docs-operations#3003, and that move included these updates.

Copy link
Copy Markdown
Collaborator Author

@Hunterness Hunterness May 15, 2026

Choose a reason for hiding this comment

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

This page has been moved to another part of the Cypher manual, #1531 (also adding a unified SHOW page). It currently doesn't include these changes.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

It has now been updated to include these changes.

Comment thread modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc Outdated
on the deprecations and additions page
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

2026.05 DO NOT MERGE team-cypher-operations Cypher operations should review this

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants