This is an automated email from the ASF dual-hosted git repository. spmallette pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/tinkerpop.git
commit 044c7db24343754950b24cedc831229f64fd0fdf Author: Andrii Lomakin <[email protected]> AuthorDate: Mon Oct 20 15:29:56 2025 +0200 Clarify parameterization for match queries Updated the parameterization section to clarify the use of Map for supplying parameters in match queries. --- .../proposal-declarative-match-step-9.asciidoc | 21 +++++++-------------- 1 file changed, 7 insertions(+), 14 deletions(-) diff --git a/docs/src/dev/future/proposal-declarative-match-step-9.asciidoc b/docs/src/dev/future/proposal-declarative-match-step-9.asciidoc index a1088cb8f3..7342add358 100644 --- a/docs/src/dev/future/proposal-declarative-match-step-9.asciidoc +++ b/docs/src/dev/future/proposal-declarative-match-step-9.asciidoc @@ -73,26 +73,19 @@ reference ANTLR4 grammar for the default GQL dialect. === 4. Parameterization -To prevent query injection and improve performance by enabling query -plan caching, parameterized queries are supported. Parameters are -supplied using the existing `with()` modulator with a special key -convention. - -* *Convention:* A key in a `with()` modulator that is prefixed with a -dollar sign (`$`) will be treated as a query parameter for the `match()` -step. The prefix is removed to derive the parameter name. +Parameterized queries are supported to prevent query injection and improve performance by enabling query +plan caching. If such exist, parameters are +supplied using the `Map` argument as part of the match query step. + * *Example:* + [source,groovy] ---- -g.match("MATCH (p:Person WHERE p.name = $personName)") - .with("$personName", "Stephen") +g.match("MATCH (p:Person WHERE p.name = $personName)", Map.of("personName", "Stephen")) ---- -This approach unifies parameter handling, allowing parameters to be -defined locally for a specific `match()` step or globally on the -`GraphTraversalSource`. If parameters are not explicitly provided via -`with()`, an implicit lookup on remote server bindings may be performed. +If parameters are not explicitly provided via +`Map`, an implicit lookup on remote server bindings may be performed. '''''
