Skip to content

Commit 4e719c9

Browse files
standardise procedure formatting to use () (#1389)
1 parent a640a26 commit 4e719c9

File tree

6 files changed

+59
-55
lines changed

6 files changed

+59
-55
lines changed

modules/ROOT/pages/clauses/call.adoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -208,7 +208,7 @@ RETURN count(*) AS results
208208
`YIELD` can be used to filter for specific results.
209209
This requires knowing the names of the arguments within a procedure's signature, which can either be found in the link:{neo4j-docs-base-uri}/operations-manual/current/procedures/[Operations Manual -> Procedures] or in the `signature` column returned by a `SHOW PROCEDURES` command (see example below).
210210
211-
.Find the argument names of `db.propertyKeys`
211+
.Find the argument names of `db.propertyKeys()`
212212
[source, cypher]
213213
----
214214
SHOW PROCEDURES YIELD name, signature

modules/ROOT/pages/genai-integrations.adoc

Lines changed: 11 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -68,17 +68,21 @@ This function sends one API request every time it is called, which may result in
6868
If you want to generate many embeddings at once, use xref:genai-integrations.adoc#multiple-embeddings[].
6969

7070

71-
Use the `db.create.setNodeVectorProperty` procedure to store an embedding to a node property.
71+
Use the `db.create.setNodeVectorProperty()` procedure to store an embedding to a node property.
7272

73-
.Signature for `db.create.setNodeVectorProperty` label:procedure[]
73+
.Signature for `db.create.setNodeVectorProperty()` label:procedure[]
7474
[source,syntax]
7575
----
7676
db.create.setNodeVectorProperty(node :: NODE, key :: STRING, vector :: ANY)
7777
----
7878

79-
Use the `db.create.setRelationshipVectorProperty` procedure to store an embedding to a relationship property.
79+
Use the `db.create.setRelationshipVectorProperty()` procedure to store an embedding to a relationship property.
8080

81+
<<<<<<< HEAD
8182
.Signature for `db.create.setRelationshipVectorProperty` label:procedure[] label:new[Introduced in 5.18]
83+
=======
84+
.Signature for `db.create.setRelationshipVectorProperty()` label:procedure[]
85+
>>>>>>> f17b4060 (standardise procedure formatting to use `()` (#1389))
8286
[source,syntax]
8387
----
8488
db.create.setRelationshipVectorProperty(relationship :: RELATIONSHIP, key :: STRING, vector :: ANY)
@@ -125,14 +129,14 @@ This result only shows the first 4 of the 1536 numbers in the embedding.
125129
[[multiple-embeddings]]
126130
== Generating a batch of embeddings and store them
127131
128-
Use the `genai.vector.encodeBatch` procedure to generate many vector embeddings with a single API request.
132+
Use the `genai.vector.encodeBatch()` procedure to generate many vector embeddings with a single API request.
129133
This procedure takes a list of resources as an input, and returns the same number of result rows, instead of a single one.
130134
131135
[NOTE]
132136
This procedure attempts to generate embeddings for all supplied resources in a single API request.
133137
Therefore, it is recommended to see the respective provider's documentation for details on, for example, the maximum number of embeddings that can be generated per request.
134138
135-
.Signature for `genai.vector.encodeBatch` label:procedure[]
139+
.Signature for `genai.vector.encodeBatch()` label:procedure[]
136140
[source,syntax]
137141
----
138142
genai.vector.encodeBatch(resources :: LIST<STRING>, provider :: STRING, configuration :: MAP = {}) :: (index :: INTEGER, resource :: STRING, vector :: LIST<FLOAT>)
@@ -169,7 +173,7 @@ CALL db.create.setNodeVectorProperty(moviesList[index], 'embedding', vector) //
169173

170174
<1> xref:functions/aggregating.adoc#functions-collect[Collect] all 20 `Movie` nodes into a `LIST<NODE>`.
171175
<2> Use a xref:expressions/list-expressions.adoc#list-comprehension[list comprehension] (`[]`) to extract the `title` and `plot` properties of the movies in `moviesList` into a new `LIST<STRING>`.
172-
<3> `db.create.setNodeVectorProperty` is run for each `vector` returned by `genai.vector.encodeBatch`, and stores that vector as a property named `embedding` on the corresponding node.
176+
<3> `db.create.setNodeVectorProperty()` is run for each `vector` returned by `genai.vector.encodeBatch()`, and stores that vector as a property named `embedding` on the corresponding node.
173177
====
174178
175179
.Create embeddings from a large number of properties and store them
@@ -212,7 +216,7 @@ For an alternative method more suitable to processing large amounts of data, see
212216
== GenAI providers
213217
214218
The following GenAI providers are supported for generating vector embeddings.
215-
Each provider has its own configuration map that can be passed to `genai.vector.encode` or `genai.vector.encodeBatch`.
219+
Each provider has its own configuration map that can be passed to `genai.vector.encode()` or `genai.vector.encodeBatch()`.
216220
217221
[[vertex-ai]]
218222
=== Vertex AI

modules/ROOT/pages/indexes/semantic-indexes/full-text-indexes.adoc

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -125,7 +125,7 @@ OPTIONS {
125125

126126
<1> The `fulltext.analyzer` setting can be used to configure an index-specific analyzer.
127127
In this case, it is set to the `english` analyzer.
128-
The possible values for the `fulltext.analyzer` setting can be listed with the `db.index.fulltext.listAvailableAnalyzers` procedure.
128+
The possible values for the `fulltext.analyzer` setting can be listed with the `db.index.fulltext.listAvailableAnalyzers()` procedure.
129129
<2> The `fulltext.eventually_consistent` setting, if set to `true`, will put the index in an _eventually consistent_ update mode.
130130
This means that updates will be applied in a background thread "as soon as possible", instead of during a transaction commit, which is true for other indexes.
131131

@@ -135,13 +135,13 @@ For more information on how to configure full-text indexes, refer to the link:{n
135135
== Query full-text indexes
136136

137137
Unlike xref:indexes/search-performance-indexes/managing-indexes.adoc[search-performance indexes], full-text indexes are not automatically used by the xref:planning-and-tuning/execution-plans.adoc[Cypher query planner].
138-
To query a full-text index, use either the link:{neo4j-docs-base-uri}/operations-manual/current/procedures/#procedure_db_index_fulltext_queryNodes[`db.index.fulltext.queryNodes`] or the link:{neo4j-docs-base-uri}/operations-manual/current/procedures/#procedure_db_index_fulltext_queryRelationships[`db.index.fulltext.queryRelationships`] procedure.
138+
To query a full-text index, use either the link:{neo4j-docs-base-uri}/operations-manual/current/procedures/#procedure_db_index_fulltext_queryNodes[`db.index.fulltext.queryNodes()`] or the link:{neo4j-docs-base-uri}/operations-manual/current/procedures/#procedure_db_index_fulltext_queryRelationships[`db.index.fulltext.queryRelationships()`] procedure.
139139

140140
[NOTE]
141141
An index cannot be used while its `state` is `POPULATING`, which occurs immediately after it is created.
142142
To check the `state` of a full-text index -- whether it is `ONLINE` (usable) or `POPULATING` (still being built; the `populationPercent` column shows the progress of the index creation) -- run the following command: `SHOW FULLTEXT INDEXES`.
143143

144-
This query uses the `db.index.fulltext.queryNodes` to look for `nils` in the previously created full-text index `namesAndTeams`:
144+
This query uses the `db.index.fulltext.queryNodes()` procedure to look for `nils` in the previously created full-text index `namesAndTeams`:
145145

146146
.Query a full-text index for a node property
147147
[source, cypher]
@@ -173,7 +173,7 @@ This is possible because both the property values that are indexed, and the quer
173173

174174
The `score` results are always returned in _descending score order_, where the best matching result entry is put first.
175175

176-
This query uses the `db.index.fulltext.queryRelationships` to query the previously created `communications` full-text index for any `message` containing "meeting":
176+
This query uses the `db.index.fulltext.queryRelationships()` procedure to query the previously created `communications` full-text index for any `message` containing "meeting":
177177

178178
.Query a full-text index for a relationship property
179179
[source, cypher]
@@ -363,19 +363,19 @@ The procedures for full-text indexes are listed in the table below:
363363
| Usage | Procedure/Command | Description
364364

365365
| Eventually consistent indexes.
366-
| https://neo4j.com/docs/operations-manual/current/procedures/#procedure_db_index_fulltext_awaitEventuallyConsistentIndexRefresh[`db.index.fulltext.awaitEventuallyConsistentIndexRefresh`]
366+
| https://neo4j.com/docs/operations-manual/current/procedures/#procedure_db_index_fulltext_awaitEventuallyConsistentIndexRefresh[`db.index.fulltext.awaitEventuallyConsistentIndexRefresh()`]
367367
| Wait for the updates from recently committed transactions to be applied to any eventually-consistent full-text indexes.
368368

369369
| List available analyzers.
370-
| https://neo4j.com/docs/operations-manual/current/procedures/#procedure_db_index_fulltext_listAvailableAnalyzers[`db.index.fulltext.listAvailableAnalyzers`]
370+
| https://neo4j.com/docs/operations-manual/current/procedures/#procedure_db_index_fulltext_listAvailableAnalyzers[`db.index.fulltext.listAvailableAnalyzers()`]
371371
| List the available analyzers that the full-text indexes can be configured with.
372372

373373
| Use full-text node index.
374-
| https://neo4j.com/docs/operations-manual/current/procedures/#procedure_db_index_fulltext_queryNodes[`db.index.fulltext.queryNodes`]
374+
| https://neo4j.com/docs/operations-manual/current/procedures/#procedure_db_index_fulltext_queryNodes[`db.index.fulltext.queryNodes()`]
375375
| Query the given full-text index. Returns the matching nodes and their Lucene query score, ordered by score.
376376

377377
| Use full-text relationship index.
378-
| https://neo4j.com/docs/operations-manual/current/procedures/#procedure_db_index_fulltext_queryRelationships[`db.index.fulltext.queryRelationships`]
378+
| https://neo4j.com/docs/operations-manual/current/procedures/#procedure_db_index_fulltext_queryRelationships[`db.index.fulltext.queryRelationships()`]
379379
| Query the given full-text index. Returns the matching relationships and their Lucene query score, ordered by score.
380380

381381
|===

modules/ROOT/pages/indexes/semantic-indexes/vector-indexes.adoc

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -194,13 +194,13 @@ Default value::: `100`
194194
[[query-vector-index]]
195195
== Query vector indexes
196196

197-
To query a node vector index, use the link:{neo4j-docs-base-uri}/operations-manual/current/procedures/#procedure_db_index_vector_queryNodes[`db.index.vector.queryNodes`] procedure.
197+
To query a node vector index, use the link:{neo4j-docs-base-uri}/operations-manual/current/procedures/#procedure_db_index_vector_queryNodes[`db.index.vector.queryNodes()`] procedure.
198198

199199
[NOTE]
200200
An index cannot be used while its `state` is `POPULATING`, which occurs immediately after it is created.
201201
To check the `state` of a vector index -- whether it is `ONLINE` (usable) or `POPULATING` (still being built; the `populationPercent` column shows the progress of the index creation) -- run the following command: `SHOW VECTOR INDEXES`.
202202

203-
.Signature for `db.index.vector.queryNodes`
203+
.Signature for `db.index.vector.queryNodes()`
204204
[source,syntax]
205205
----
206206
db.index.vector.queryNodes(indexName :: STRING, numberOfNearestNeighbours :: INTEGER, query :: ANY) :: (node :: NODE, score :: FLOAT)
@@ -242,13 +242,13 @@ If the query vector itself is not wanted, adding the predicate `WHERE score < 1`
242242

243243
To query a relationship vector index, use the link:{neo4j-docs-base-uri}/operations-manual/current/procedures/#procedure_db_index_vector_queryRelationships[`db.index.vector.queryRelationships`] procedure.
244244

245-
.Signature for `db.index.vector.queryRelationships` label:new[Introduced in 5.18]
245+
.Signature for `db.index.vector.queryRelationships()` label:new[Introduced in 5.18]
246246
[source,syntax]
247247
----
248248
db.index.vector.queryRelationships(indexName :: STRING, numberOfNearestNeighbours :: INTEGER, query :: ANY) :: (relationship :: RELATIONSHIP, score :: FLOAT)
249249
----
250250

251-
`db.index.vector.queryRelationships` has the same argument descriptions as `db.index.vector.queryNodes`.
251+
`db.index.vector.queryRelationships()` has the same argument descriptions as `db.index.vector.queryNodes()`.
252252

253253
[TIP]
254254
Use xref:functions/vector.adoc[] to compute the similarity score between two specific vector pairs without using a vector index.
@@ -488,25 +488,25 @@ image::euclidean_similarity_equation.svg["The Euclidean of vector v and vector u
488488
Replaced by the `CREATE VECTOR INDEX` command.
489489

490490
| Use node vector index.
491-
| link:{neo4j-docs-base-uri}/operations-manual/current/procedures/#procedure_db_index_vector_queryNodes[`db.index.vector.queryNodes`]
491+
| link:{neo4j-docs-base-uri}/operations-manual/current/procedures/#procedure_db_index_vector_queryNodes[`db.index.vector.queryNodes()`]
492492
| Query the given node vector index.
493493
Returns the requested number of approximate nearest neighbor nodes and their similarity score, ordered by score.
494494

495495
| Use relationship vector index.
496-
| link:{neo4j-docs-base-uri}/operations-manual/current/procedures/#procedure_db_index_vector_queryRelationships[`db.index.vector.queryRelationships`]
496+
| link:{neo4j-docs-base-uri}/operations-manual/current/procedures/#procedure_db_index_vector_queryRelationships[`db.index.vector.queryRelationships()`]
497497
| Query the given relationship vector index.
498498
Returns the requested number of approximate nearest neighbor relationships and their similarity score, ordered by score. label:new[Introduced in 5.18]
499499

500500
| Set node vector property.
501-
| link:{neo4j-docs-base-uri}/operations-manual/current/procedures/#procedure_db_create_setnodeVectorProperty[`db.create.setNodeVectorProperty`]
502-
| Update a given node property with the given vector in a more space-efficient way than directly using xref:clauses/set.adoc#set-set-a-property[`SET`]. Replaces link:{neo4j-docs-base-uri}/operations-manual/current/procedures/#procedure_db_create_setVectorProperty[`db.create.setVectorProperty`]. label:beta[] label:new[Introduced in 5.13]
501+
| link:{neo4j-docs-base-uri}/operations-manual/current/procedures/#procedure_db_create_setnodeVectorProperty[`db.create.setNodeVectorProperty()`]
502+
| Update a given node property with the given vector in a more space-efficient way than directly using xref:clauses/set.adoc#set-set-a-property[`SET`]. Replaces link:{neo4j-docs-base-uri}/operations-manual/current/procedures/#procedure_db_create_setVectorProperty[`db.create.setVectorProperty()`]. label:beta[] label:new[Introduced in 5.13]
503503

504504
| Set node vector property.
505-
| link:{neo4j-docs-base-uri}/operations-manual/current/procedures/#procedure_db_create_setVectorProperty[`db.create.setVectorProperty`]
506-
| Replaced by link:{neo4j-docs-base-uri}/operations-manual/current/procedures/#procedure_db_create_setnodevectorproperty[`db.create.setNodeVectorProperty`]. label:deprecated[] label:beta[]
505+
| link:{neo4j-docs-base-uri}/operations-manual/current/procedures/#procedure_db_create_setVectorProperty[`db.create.setVectorProperty()`]
506+
| Replaced by link:{neo4j-docs-base-uri}/operations-manual/current/procedures/#procedure_db_create_setNodeVectorProperty[`db.create.setNodeVectorProperty()`]. label:deprecated[] label:beta[]
507507

508508
| Set relationship vector property.
509-
| link:{neo4j-docs-base-uri}/operations-manual/current/procedures/#procedure_db_create_setRelationshipVectorProperty[`db.create.setRelationshipVectorProperty`]
509+
| link:{neo4j-docs-base-uri}/operations-manual/current/procedures/#procedure_db_create_setRelationshipVectorProperty[`db.create.setRelationshipVectorProperty()`]
510510
| Update a given relationship property with the given vector in a more space-efficient way than directly using xref:clauses/set.adoc#set-set-a-property[`SET`]. label:beta[] label:new[Introduced in 5.18]
511511

512512
|===
@@ -535,7 +535,7 @@ The following table lists the issues and, if fixed, the version in which they we
535535
|===
536536
| Known issues | Fixed in
537537

538-
| The creation of a vector index using the legacy procedure link:{neo4j-docs-base-uri}/operations-manual/current/procedures/#procedure_db_index_vector_createNodeIndex[`db.index.vector.createNodeIndex`] may fail with an error in Neo4j 5.18 and later if the database was last written to with a version prior to Neo4j 5.11, and the legacy procedure is the first write operation used on the newer version.
538+
| The creation of a vector index using the legacy procedure link:{neo4j-docs-base-uri}/operations-manual/current/procedures/#procedure_db_index_vector_createNodeIndex[`db.index.vector.createNodeIndex()`] may fail with an error in Neo4j 5.18 and later if the database was last written to with a version prior to Neo4j 5.11, and the legacy procedure is the first write operation used on the newer version.
539539
In Neo4j 5.20, the error was clarified.
540540
[TIP]
541541
--

modules/ROOT/pages/indexes/syntax.adoc

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -177,7 +177,7 @@ ON EACH “[“ r.propertyName[, ...] “]”
177177

178178
The following settings can be specified for full-text indexes:
179179

180-
* `fulltext.analyzer` - specifies what analyzer to use (the `db.index.fulltext.listAvailableAnalyzers` procedure lists what analyzers are available).
180+
* `fulltext.analyzer` - specifies what analyzer to use (the `db.index.fulltext.listAvailableAnalyzers()` procedure lists what analyzers are available).
181181
* `fulltext.eventually_consistent` - specifies whether a full-text index is eventually consistent.
182182
If set to `true`, it will ensure that updates from committing transactions are applied in a background thread.
183183

@@ -250,13 +250,13 @@ To use them, specific procedures must be called. Their signatures can be seen be
250250
[[query-full-text-index]]
251251
=== Full-text indexes
252252

253-
.Query full-text index on nodes: db.index.fulltext.queryNodes
253+
.Query full-text index on nodes: db.index.fulltext.queryNodes()
254254
[source,syntax]
255255
----
256256
CALL db.index.fulltext.queryNodes(indexName :: STRING, queryString :: STRING, options = {} :: MAP)
257257
----
258258

259-
.Query full-text index on relationships: db.index.fulltext.queryRelationships
259+
.Query full-text index on relationships: db.index.fulltext.queryRelationships()
260260
[source, syntax]
261261
----
262262
CALL db.index.fulltext.queryRelationships(indexName :: STRING, queryString :: STRING, options = {} :: MAP)
@@ -275,13 +275,13 @@ For more information, see xref:indexes/semantic-indexes/full-text-indexes.adoc#q
275275
[[query-vector-index]]
276276
=== Vector indexes
277277

278-
.Query vector-text index on nodes: db.index.vector.queryNodes label:new[Introduced 5.11]
278+
.Query vector-text index on nodes: db.index.vector.queryNodes() label:new[Introduced 5.11]
279279
[source,syntax]
280280
----
281281
CALL db.index.vector.queryNodes(indexName :: STRING, numberOfNearestNeighbours :: INTEGER, query :: LIST<INTEGER | FLOAT>)
282282
----
283283

284-
.Query vector-text index on relationships: db.index.vector.queryRelationships label:new[Introduced 5.18]
284+
.Query vector-text index on relationships: db.index.vector.queryRelationships() label:new[Introduced 5.18]
285285
[source,syntax]
286286
----
287287
CALL db.index.vector.queryRelationships(indexName :: STRING, numberOfNearestNeighbours :: INTEGER, query :: LIST<INTEGER | FLOAT>)

0 commit comments

Comments
 (0)