Skip to content

Commit a4b376f

Browse files
Add tabbed examples for multiple node IDs
1 parent dcf808d commit a4b376f

File tree

1 file changed

+56
-18
lines changed

1 file changed

+56
-18
lines changed

modules/ROOT/pages/import.adoc

Lines changed: 56 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -1464,22 +1464,24 @@ Now use the previously defined ID spaces when connecting the actors to movies.
14641464
== Using multiple node IDs
14651465

14661466
A node header can contain multiple `ID` columns.
1467-
The relationship data must then use a matching number of `START_ID` / `END_ID` columns as references to the composite value of those ID columns.
1467+
1468+
Starting from 2025.07, the relationship data must then use a matching number of `START_ID` / `END_ID` columns as references to the composite value of those ID columns.
14681469
This implies using `string` as `id-type`.
14691470

14701471
For each `ID` column, you can specify to store its values as different node properties.
14711472
However, the composite value cannot be stored as a node property.
14721473

1473-
[NOTE]
1474+
[IMPORTANT]
14741475
====
14751476
Incremental import doesn't support the use of multiple node identifiers.
14761477
This functionality is only available with a full import.
14771478
====
14781479

14791480

1480-
.Define multiple IDs as node properties
1481-
====
1481+
=== Define multiple IDs as node properties
1482+
14821483
You can define multiple `ID` columns in the node header.
1484+
14831485
For example, you can define a node header with two `ID` columns.
14841486

14851487
.nodes_header.csv
@@ -1495,54 +1497,90 @@ aa,11,John
14951497
bb,22,Paul
14961498
----
14971499

1500+
[.tabbed-example]
1501+
=====
1502+
[role=include-with-multiple-node-IDs]
1503+
======
1504+
14981505
Now use both IDs when defining the relationship:
14991506

1500-
.relationships_header.csv
1507+
[source, csv]
1508+
----
1509+
:START_ID,:TYPE,:END_ID
1510+
----
1511+
1512+
[source, csv]
1513+
----
1514+
aa11,WORKS_WITH,bb22
1515+
----
1516+
1517+
======
1518+
[role=include-with-multiple-IDs label--new-2025.07]
1519+
======
1520+
1521+
Starting from 2025.07, you can use multiple IDs when defining the relationship:
1522+
15011523
[source, csv]
15021524
----
15031525
:START_ID,:START_ID,:TYPE,:END_ID,:END_ID
15041526
----
15051527

1506-
.relationships.csv
15071528
[source, csv]
15081529
----
15091530
aa,11,WORKS_WITH,bb,22
15101531
----
1511-
====
1532+
======
1533+
=====
15121534

15131535
[[multiple-IDs-Id-spaces]]
1514-
.Define multiple IDs stored in ID spaces
1515-
====
1536+
=== Define multiple IDs stored in ID spaces
15161537

1517-
Define a `MyGroup` ID space in the _nodes_header.csv_ file.
1518-
1519-
.nodes_header.csv
1538+
. Define a `MyGroup` ID space in the _nodes_header.csv_ file.
1539+
+
15201540
[source, csv]
15211541
----
15221542
personId:ID(MyGroup),memberId:ID(MyGroup),name
15231543
----
1524-
1525-
.nodes.csv
1544+
+
15261545
[source, csv]
15271546
----
15281547
aa,11,John
15291548
bb,22,Paul
15301549
----
15311550

1532-
Now use the defined ID space when connecting John with Paul, and use both IDs in the relationship.
1551+
. Now use the defined ID space when connecting John with Paul, and use both IDs in the relationship.
1552+
+
1553+
[.tabbed-example]
1554+
=====
1555+
[role=include-with-multiple-node-IDs]
1556+
======
1557+
1558+
[source, csv]
1559+
----
1560+
:START_ID(MyGroup),:TYPE,:END_ID(MyGroup)
1561+
----
1562+
1563+
[source, csv]
1564+
----
1565+
aa11,WORKS_WITH,bb22
1566+
----
1567+
1568+
======
1569+
[role=include-with-multiple-IDs label--new-2025.07]
1570+
======
15331571

1534-
.relationships_header.csv
15351572
[source, csv]
15361573
----
15371574
:START_ID(MyGroup),:START_ID(MyGroup),:TYPE,:END_ID(MyGroup),:END_ID(MyGroup)
15381575
----
15391576

1540-
.relationships.csv
15411577
[source, csv]
15421578
----
15431579
aa,11,WORKS_WITH,bb,22
15441580
----
1545-
====
1581+
=====
1582+
======
1583+
15461584

15471585
[[import-tool-id-types-header]]
15481586
== Storing a different value type for IDs in a group

0 commit comments

Comments
 (0)