Skip to content

Commit 1f8049d

Browse files
authored
Document --temp-path for import (neo4j#2262) (neo4j#2268)
Cherry-picked from neo4j#2262
1 parent 6edc956 commit 1f8049d

File tree

1 file changed

+23
-9
lines changed

1 file changed

+23
-9
lines changed

modules/ROOT/pages/import.adoc

Lines changed: 23 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@
55
:rfc-4180: https://tools.ietf.org/html/rfc4180
66

77
`neo4j-admin database import` writes CSV data into Neo4j's native file format as fast as possible. +
8-
Starting with version 5.26, Neo4j also provides support for the Parquet file format.
8+
It also provides support for the Parquet file format.
99

1010
You should use this tool when:
1111

@@ -93,8 +93,8 @@ neo4j-admin database import full [-h] [--expand-commands] [--verbose] [--auto-sk
9393
[--format=<format>] [--high-parallel-io=on|off|auto] [--id-type=string|integer|actual]
9494
[--input-encoding=<character-set>] [--input-type=csv|parquet]
9595
[--max-off-heap-memory=<size>] [--quote=<char>] [--read-buffer-size=<size>]
96-
[--report-file=<path>] [--schema=<path>] [--threads=<num>] --nodes=[<label>[:
97-
<label>]...=]<files>... [--nodes=[<label>[:<label>]...=]<files>...]...
96+
[--report-file=<path>] [--schema=<path>] [--temp-path=<path>] [--threads=<num>]
97+
--nodes=[<label>[:<label>]...=]<files>... [--nodes=[<label>[:<label>]...=]<files>...]...
9898
[--relationships=[<type>=]<files>...]... [--multiline-fields=true|false|<path>[,
9999
<path>] [--multiline-fields-format=v1|v2]] <database>
100100
----
@@ -275,7 +275,7 @@ It can also be specified as a percentage of the available memory, for example `7
275275
| {check-mark}
276276

277277
|--multiline-fields=true\|false\|<path>[,<path>]
278-
|label:changed[Changed in 5.26] In v1, whether or not fields from an input source can span multiple lines, i.e. contain newline characters. Setting `--multiline-fields=true` can severely degrade the performance of the importer. Therefore, use it with care, especially with large imports. In v2, this option will specify the list of files that contain multiline fields. Files can also be specified using regular expressions.
278+
|In v1, whether or not fields from an input source can span multiple lines, i.e. contain newline characters. Setting `--multiline-fields=true` can severely degrade the performance of the importer. Therefore, use it with care, especially with large imports. In v2, this option will specify the list of files that contain multiline fields. Files can also be specified using regular expressions.
279279
|null
280280
| {check-mark}
281281
|
@@ -397,7 +397,14 @@ Skipped nodes will be logged if they are within the limit of entities specified
397397
| Whether or not the lookup of nodes referred to from relationships needs to be checked strict.
398398
If disabled, most but not all relationships referring to non-existent nodes will be detected.
399399
If enabled all those relationships will be found but at the cost of lower performance.
400-
|false label:changed[Changed in 5.8]
400+
|false
401+
| {check-mark}
402+
| {check-mark}
403+
404+
|--temp-path=<path> label:new[Introduced in 2025.04]
405+
|Provide a path where to store temporary files that are created and deleted during import.
406+
If not specifically provided, the default temp path will be created inside the database directory of the imported database.
407+
|
401408
| {check-mark}
402409
| {check-mark}
403410

@@ -643,8 +650,8 @@ neo4j-admin database import incremental [-h] [--expand-commands] --force [--upda
643650
[--input-encoding=<character-set>] [--input-type=csv|parquet]
644651
[--max-off-heap-memory=<size>] [--quote=<char>] [--read-buffer-size=<size>]
645652
[--report-file=<path>] [--schema=<path>] [--stage=all|prepare|build|merge]
646-
[--threads=<num>] --nodes=[<label>[:<label>]...=]<files>... [--nodes=[<label>[:
647-
<label>]...=]<files>...]... [--relationships=[<type>=]<files>...]...
653+
[--temp-path=<path>] [--threads=<num>] --nodes=[<label>[:<label>]...=]<files>...
654+
[--nodes=[<label>[: <label>]...=]<files>...]... [--relationships=[<type>=]<files>...]...
648655
[--multiline-fields=true|false|<path>[,<path>]
649656
[--multiline-fields-format=v1|v2]] <database>
650657
----
@@ -845,7 +852,7 @@ It can also be specified as a percentage of the available memory, for example `7
845852
| {check-mark}
846853

847854
|--multiline-fields=true\|false\|<path>[,<path>]
848-
|label:changed[Changed in 5.26] In v1, whether or not fields from an input source can span multiple lines, i.e. contain newline characters. Setting `--multiline-fields=true` can severely degrade the performance of the importer. Therefore, use it with care, especially with large imports. In v2, this option will specify the list of files that contain multiline fields. Files can also be specified using regular expressions.
855+
|In v1, whether or not fields from an input source can span multiple lines, i.e. contain newline characters. Setting `--multiline-fields=true` can severely degrade the performance of the importer. Therefore, use it with care, especially with large imports. In v2, this option will specify the list of files that contain multiline fields. Files can also be specified using regular expressions.
849856
|null
850857
| {check-mark}
851858
|
@@ -971,7 +978,14 @@ For semi-online incremental import run `prepare` (on a stopped database) followe
971978
| Whether or not the lookup of nodes referred to from relationships needs to be checked strict.
972979
If disabled, most but not all relationships referring to non-existent nodes will be detected.
973980
If enabled all those relationships will be found but at the cost of lower performance.
974-
|false label:changed[Changed in 5.8]
981+
|false
982+
| {check-mark}
983+
| {check-mark}
984+
985+
|--temp-path=<path> label:new[Introduced in 2025.04]
986+
|Provide a path where to store temporary files that are created and deleted during import.
987+
If not specifically provided, the default temp path will be created inside the database directory of the imported database.
988+
|
975989
| {check-mark}
976990
| {check-mark}
977991

0 commit comments

Comments
 (0)