Skip to content

Commit 7ad5ddb

Browse files
Emphasize in docs that in clustering environments, when using incremental import the updated database must be reseeded (#2093) (#2109)
Cherry-picked from #2093 Co-authored-by: NataliaIvakina <[email protected]>
1 parent 19836ff commit 7ad5ddb

File tree

1 file changed

+12
-7
lines changed

1 file changed

+12
-7
lines changed

modules/ROOT/pages/tools/neo4j-admin/neo4j-admin-import.adoc

Lines changed: 12 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -595,7 +595,7 @@ The syntax for importing a set of CSV files incrementally is:
595595

596596
[source, syntax, role="nocopy"]
597597
----
598-
neo4j-admin database import incremental [-h] [--expand-commands] --force [--update-all-matching-relationships]
598+
neo4j-admin database import incremental [-h] [--expand-commands] --force [--update-all-matching-relationships]
599599
[--verbose] [--auto-skip-subsequent-headers[=true|false]]
600600
[--ignore-empty-strings[=true|false]] [--ignore-extra-columns[=true|false]]
601601
[--legacy-style-quoting[=true|false]] [--normalize-types[=true|false]]
@@ -619,6 +619,17 @@ Incremental import into an existing database.
619619

620620
=== Usage and limitations
621621

622+
[WARNING]
623+
====
624+
The importer works well on standalone servers.
625+
626+
In clustering environments with multiple copies of the database, the updated database must be used as a source to reseed the rest of the database copies.
627+
You can use the procedure xref:procedures.adoc#procedure_dbms_cluster_recreateDatabase[`dbms.cluster.recreateDatabase()`].
628+
For details, see xref:clustering/databases.adoc#recreate-databases[Recreate databases].
629+
630+
Starting the clustered database after an incremental import without reseeding or performing the incremental import on a single server while the database remains online on other clustered members may result in unpredictable consequences, including data inconsistency between cluster members.
631+
====
632+
622633
The incremental import command can be used to add:
623634

624635
* New nodes with labels and properties.
@@ -638,12 +649,6 @@ The incremental import command cannot be used to:
638649
* Update or delete labels in nodes.
639650
* Delete existing nodes and relationships.
640651

641-
[NOTE]
642-
====
643-
The importer works well on standalone servers.
644-
In clustering environments with multiple copies of the database, the updated database must be reseeded.
645-
====
646-
647652
=== Parameters
648653

649654
.`neo4j-admin database import incremental` parameters

0 commit comments

Comments
 (0)