apoc.refactor.rename.nodeProperty
Procedure
apoc.refactor.rename.nodeProperty(oldName STRING, newName STRING, nodes LIST<NODE>, config MAP<STRING, ANY>)
- renames the given property from oldName
to newName
for all NODE
values.
If a LIST<NODE>
is provided, the renaming is applied to the NODE
values within this LIST<NODE>
only.
Signature
apoc.refactor.rename.nodeProperty(oldName :: STRING, newName :: STRING, nodes = [] :: LIST<NODE>, config = {} :: MAP) :: (batches :: INTEGER, total :: INTEGER, timeTaken :: INTEGER, committedOperations :: INTEGER, failedOperations :: INTEGER, failedBatches :: INTEGER, retries :: INTEGER, errorMessages :: MAP, batch :: MAP, operations :: MAP, constraints :: LIST<STRING>, indexes :: LIST<STRING>)
Input parameters
Name | Type | Default |
---|---|---|
oldName |
STRING |
null |
newName |
STRING |
null |
nodes |
LIST<NODE> |
[] |
config |
MAP |
{} |
Output parameters
Name | Type |
---|---|
batches |
INTEGER |
total |
INTEGER |
timeTaken |
INTEGER |
committedOperations |
INTEGER |
failedOperations |
INTEGER |
failedBatches |
INTEGER |
retries |
INTEGER |
errorMessages |
MAP |
batch |
MAP |
operations |
MAP |
constraints |
LIST<STRING> |
indexes |
LIST<STRING> |
Usage Examples
The examples in this section are based on the following sample graph:
CREATE (mark:Engineer {name: "Mark", city: "London"})
CREATE (jennifer:Engineer {name: "Jennifer", city: "St Louis"})
CREATE (michael:Engineer {name: "Michael", city: "Dresden"})
CREATE (jim:Engineer {name: "Jim", city: "London"})
CREATE (alistair:Engineer {name: "Alistair", city: "London"})
MERGE (jim)-[:COLLEAGUES {since: date("2006-05-01")}]->(alistair)
MERGE (mark)-[:COLLEAGUES {since: date("2018-02-01")}]->(jennifer)
MERGE (mark)-[:COLLEAGUES {since: date("2013-05-01")}]->(michael);
The following query changes the node property city
to location
for all nodes with the DevRel
label:
MATCH (person:DevRel)
WITH collect(person) AS people
CALL apoc.refactor.rename.nodeProperty("city", "location", people)
YIELD batches, total, timeTaken, committedOperations
RETURN batches, total, timeTaken, committedOperations;
batches | total | timeTaken | committedOperations |
---|---|---|---|
1 |
3 |
0 |
3 |
The following query returns all the nodes in our graph after this refactoring has been done:
MATCH (n)
RETURN (n)
n |
---|
(:DevRel {name: "Jennifer", location: "St Louis"}) |
(:DevRel {name: "Michael", location: "Dresden"}) |
(:Engineer {city: "London", name: "Jim"}) |
(:DevRel {name: "Mark", location: "London"}) |
(:Engineer {city: "London", name: "Alistair"}) |