Clarify the difference between the full and incremental import (#3085)

Co-authored-by: Reneta Popova <reneta.popova@neo4j.com>

Author: NataliaIvakina

modules/ROOT/pages/import.adoc

@@ -58,7 +58,7 @@ See <<import-logs, Import progress reporting>> for more details.
 [TIP]
 ====
 For information on `LOAD CSV`, see the link:{neo4j-docs-base-uri}/cypher-manual/current/clauses/load-csv[Cypher Manual -> `LOAD CSV`].
-For in-depth examples of using the command `neo4j-admin database import`, refer to the xref:tutorial/neo4j-admin-import.adoc[Tutorials -> Importing data].
+For in-depth examples of using the command `neo4j-admin database import full`, refer to the xref:tutorial/neo4j-admin-import.adoc[Tutorials -> Full data import].
 ====
 
 [[import-memory-controls]]
@@ -545,7 +545,8 @@ This is achieved by using the `format` option of the import command and setting
 
 [source, shell]
 --
-bin/neo4j-admin database import full --format=block
+bin/neo4j-admin database import full \
+--format=block
 --
 
 The `block` format is available in Enterprise Edition only.
@@ -560,7 +561,9 @@ For example, the following command:
 
 [source, shell]
 ----
-bin/neo4j-admin database import full @/path/to/your/<args-filename> mydb
+bin/neo4j-admin database import full \
+@/path/to/your/<args-filename> \
+databasename
 ----
 For more information, see link:https://picocli.info/#AtFiles[Picocli -> AtFiles] official documentation.
 ====
@@ -615,9 +618,11 @@ The command does not write any data to the database.
 
 [source, shell, role=noplay]
 ----
-bin/neo4j-admin database import full --dry-run=true --nodes import/movies_header.csv,import/movies.csv \
---nodes import/actors_header.csv,import/actors.csv \
---relationships import/roles_header.csv,import/roles.csv
+bin/neo4j-admin database import full \
+--dry-run=true \
+--nodes=import/movies_header.csv,import/movies.csv \
+--nodes=import/actors_header.csv,import/actors.csv \
+--relationships=import/roles_header.csv,import/roles.csv
 ----
 
 .Example output
@@ -663,9 +668,10 @@ The following command imports the three datasets:
 
 [source, shell, role=noplay]
 ----
-bin/neo4j-admin database import full --nodes import/movies_header.csv,import/movies.csv \
---nodes import/actors_header.csv,import/actors.csv \
---relationships import/roles_header.csv,import/roles.csv
+bin/neo4j-admin database import full \
+--nodes=import/movies_header.csv,import/movies.csv \
+--nodes=import/actors_header.csv,import/actors.csv \
+--relationships=import/roles_header.csv,import/roles.csv
 ----
 
 [[import-tool-multiple-input-files-regex-example]]
@@ -679,7 +685,8 @@ For example:
 
 [source, shell, role=noplay]
 ----
-bin/neo4j-admin database import full --nodes import/node_header.csv,import/node_data_\d+\.csv
+bin/neo4j-admin database import full \
+--nodes=import/node_header.csv,import/node_data_\d+\.csv
 ----
 
 [NOTE]
@@ -697,7 +704,9 @@ For example:
 
 [source, shell, role=noplay]
 ----
-bin/neo4j-admin database import full --nodes import/node_header.csv,'import/node_data_\d{1,5}.csv' databasename
+bin/neo4j-admin database import full \
+--nodes=import/node_header.csv,'import/node_data_\d{1,5}.csv' \
+databasename
 ----
 
 [[import-files-from-cloud-storage]]
@@ -722,7 +731,10 @@ The example assumes that you have data stored in the `myBucket/data` folder in y
 +
 [source, shell, role=noplay]
 ----
-bin/neo4j-admin database import full --nodes s3://myBucket/data/nodes.csv --relationships s3://myBucket/data/relationships.csv newdb
+bin/neo4j-admin database import full \
+--nodes=s3://myBucket/data/nodes.csv \
+--relationships=s3://myBucket/data/relationships.csv \
+databasename
 ----
 ======
 
@@ -736,7 +748,10 @@ The example assumes that you have data stored in the `myBucket/data` folder in y
 +
 [source,shell]
 ----
-bin/neo4j-admin database import full --nodes gs://myBucket/data/nodes.csv --relationships gs://myBucket/data/relationships.csv newdb
+bin/neo4j-admin database import full \
+--nodes=gs://myBucket/data/nodes.csv \
+--relationships=gs://myBucket/data/relationships.csv \
+databasename
 ----
 ======
 
@@ -750,7 +765,10 @@ The example assumes that you have data stored in the `myStorageAccount/myContain
 +
 [source,shell]
 ----
-bin/neo4j-admin database import full --nodes azb://myStorageAccount/myContainer/data/nodes.csv --relationships azb://myStorageAccount/myContainer/data/relationships.csv newdb
+bin/neo4j-admin database full \
+--nodes=azb://myStorageAccount/myContainer/data/nodes.csv \
+--relationships=azb://myStorageAccount/myContainer/data/relationships.csv \
+databasename
 ----
 ======
 =====
@@ -1264,7 +1282,11 @@ The command does not write any data to the database.
 ----
 neo4j@system> STOP DATABASE neo4j WAIT;
 ...
-bin/neo4j-admin database import incremental --dry-run=true --nodes=N1=../../raw-data/incremental-import/nodes.csv --relationships=R1=../../raw-data/incremental-import/relationships.csv neo4j
+bin/neo4j-admin database import incremental \
+--dry-run=true \
+--nodes=N1=../../raw-data/incremental-import/nodes.csv \
+--relationships=R1=../../raw-data/incremental-import/relationships.csv \
+neo4j
 ----
 
 .Example output
@@ -1314,7 +1336,11 @@ This option requires the database to be stopped.
 ----
 neo4j@system> STOP DATABASE neo4j WAIT;
 ...
-bin/neo4j-admin database import incremental --stage=all --nodes=N1=../../raw-data/incremental-import/nodes.csv --relationships=R1=../../raw-data/incremental-import/relationships.csv neo4j
+bin/neo4j-admin database import incremental \
+--stage=all \
+--nodes=N1=../../raw-data/incremental-import/nodes.csv \
+--relationships=R1=../../raw-data/incremental-import/relationships.csv \
+neo4j
 ----
 
 [[incremental-import-stages]]
@@ -1338,7 +1364,11 @@ STOP DATABASE neo4j WAIT
 +
 [source, shell, role=noplay]
 ----
-bin/neo4j-admin database import incremental --stage=prepare --nodes=N1=../../raw-data/incremental-import/nodes.csv --relationships=R1=../../raw-data/incremental-import/relationships.csv neo4j
+bin/neo4j-admin database import incremental \
+--stage=prepare \
+--nodes=N1=../../raw-data/incremental-import/nodes.csv \
+--relationships=R1=../../raw-data/incremental-import/relationships.csv \
+neo4j
 ----
 . `build` stage:
 +
@@ -1356,7 +1386,11 @@ ALTER DATABASE neo4j SET ACCESS READ ONLY
 +
 [source, shell, role=noplay]
 ----
-bin/neo4j-admin database import incremental --stage=build --nodes=N1=../../raw-data/incremental-import/nodes.csv --relationships=R1=../../raw-data/incremental-import/relationships.csv neo4j
+bin/neo4j-admin database import incremental \
+--stage=build \
+--nodes=N1=../../raw-data/incremental-import/nodes.csv \
+--relationships=R1=../../raw-data/incremental-import/relationships.csv \
+neo4j
 ----
 . `merge` stage:
 +
@@ -1375,7 +1409,9 @@ STOP DATABASE neo4j WAIT
 +
 [source, shell, role=noplay]
 ----
-bin/neo4j-admin database import incremental --stage=merge neo4j
+bin/neo4j-admin database import incremental \
+--stage=merge \
+neo4j
 ----
 
 [[import-tool-header-format]]
@@ -2095,7 +2131,10 @@ For example:
 
 [source, shell, role=noplay]
 ----
-bin/neo4j-admin database import full --nodes import/node_header.csv,import/node_data.csv --multiline-fields=true databasename
+bin/neo4j-admin database import full \
+--nodes=import/node_header.csv,import/node_data.csv \
+--multiline-fields=true \
+databasename
 ----
 
 Where `import/node_data.csv` contains multiline fields, such as:
@@ -2131,7 +2170,11 @@ For example:
 ======
 [source, shell, role=noplay]
 ----
-bin/neo4j-admin database import full --nodes import/node_header.csv,import/node_data.csv --multiline-fields=true --multiline-fields-format=v1 databasename
+bin/neo4j-admin database import full \
+--nodes=import/node_header.csv,import/node_data.csv \
+--multiline-fields=true \
+--multiline-fields-format=v1 \
+databasename
 ----
 
 Where `import/node_data.csv` contains multiline fields, such as:
@@ -2148,7 +2191,11 @@ description
 
 [source, shell, role=noplay]
 ----
-bin/neo4j-admin database import full --nodes import/node_header.csv,import/node_data.csv --multiline-fields=import/node_data.csv --multiline-fields-format=v2 databasename
+bin/neo4j-admin database import full \
+--nodes=import/node_header.csv,import/node_data.csv \
+--multiline-fields=import/node_data.csv \
+--multiline-fields-format=v2 \
+databasename
 ----
 
 Where `import/node_data.csv` contains multiline fields, such as:
@@ -2208,7 +2255,10 @@ actors-header.csv  actors.csv.zip  movies-header.csv  movies.csv.gz  roles-heade
 
 [source, sh]
 ----
-bin/neo4j-admin database import full --nodes import/movies-header.csv,import/movies.csv.gz --nodes import/actors-header.csv,import/actors.csv.zip --relationships import/roles-header.csv,import/roles.csv.gz
+bin/neo4j-admin database import full \
+--nodes=import/movies-header.csv,import/movies.csv.gz \
+--nodes=import/actors-header.csv,import/actors.csv.zip \
+--relationships=import/roles-header.csv,import/roles.csv.gz
 ----
 ====
 
@@ -2325,7 +2375,12 @@ Then, use the following example commands to run the import:
 
 [source, shell, role=noplay]
 ----
-bin/neo4j-admin database import full neo4j --nodes=import/movies.csv --nodes=import/actors.csv --relationships=import/roles.csv --schema=import/schema.cypher
+bin/neo4j-admin database import full \
+--nodes=import/movies.csv \
+--nodes=import/actors.csv \
+--relationships=import/roles.csv \
+--schema=import/schema.cypher \
+neo4j
 ----
 
 [role=label--new-2026.02]
@@ -2395,7 +2450,12 @@ Then, use the following example commands to run the import:
 
 [source, shell, role=noplay]
 ----
-bin/neo4j-admin database import incremental --stage=all --nodes=import/movies.csv --nodes=import/actors.csv --relationships=import/roles.csv --schema=import/schema.cypher
+bin/neo4j-admin database import incremental \
+--stage=all \
+--nodes=import/movies.csv \
+--nodes=import/actors.csv \
+--relationships=import/roles.csv \
+--schema=import/schema.cypher
 ----
 
 [role=label--enterprise-edition]
@@ -2421,9 +2481,10 @@ For example:
 .Run a full import with JFR recording
 [source, shell, role=noplay]
 ----
-bin/neo4j-admin database import full --nodes import/movies_header.csv,import/movies.csv \
---nodes import/actors_header.csv,import/actors.csv \
---relationships import/roles_header.csv,import/roles.csv \
+bin/neo4j-admin database import full \
+--nodes=import/movies_header.csv,import/movies.csv \
+--nodes=import/actors_header.csv,import/actors.csv \
+--relationships=import/roles_header.csv,import/roles.csv \
 --profile=true
 ----
 

modules/ROOT/pages/tutorial/index.adoc

@@ -7,7 +7,7 @@ The following step-by-step tutorials cover common operational tasks or otherwise
 
 //* <<tutorial-local-cluster, Set up a local Causal Cluster>> -- This tutorial walks through the basics of setting up a Neo4j Causal Cluster.
 //* <<tutorial-cc-backup-restore-db, Back up and restore a database in Causal Cluster>> -- This tutorial provides a detailed example of how to back up and restore a database in a running Causal Cluster.
-* xref:tutorial/neo4j-admin-import.adoc[Importing data] -- This tutorial provides detailed examples to illustrate the capabilities of importing data from CSV files with the command `neo4j-admin database import`.
+* xref:tutorial/neo4j-admin-import.adoc[Full data import] -- Examples of importing data from CSV files using the `neo4j-admin database import full` command.
 * xref:tutorial/tutorial-composite-database.adoc[Setting up and using a composite database] -- This tutorial walks through the basics of setting up and using Composite databases.
 * xref:tutorial/access-control.adoc[Fine-grained access control] -- This tutorial presents an example that illustrates various aspects of security and fine-grained access control.
 * xref:tutorial/tutorial-sso-configuration.adoc[Configuring Neo4j Single Sign-On (SSO)] -- Examples and solutions to common problems when configuring SSO.