Skip to content

Commit 0ec3bf6

Browse files
Merge pull request #277955 from EXPEkesheth/patch-172
Improvements to import operation
2 parents f54c611 + 69170bc commit 0ec3bf6

File tree

1 file changed

+5
-8
lines changed

1 file changed

+5
-8
lines changed

articles/healthcare-apis/fhir/import-data.md

Lines changed: 5 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -32,16 +32,11 @@ The `import` operation supports two modes: initial and incremental. Each mode ha
3232
- Allows you to load resources in a nonsequential order of versions.
3333

3434
- If import files don't have the `version` and `lastUpdated` field values specified, there's no guarantee of importing resources in the FHIR service.
35-
3635
- If import files have resources with duplicate `version` and `lastUpdated` field values, only one resource is randomly ingested in the FHIR service.
36+
- If multiple resources share the same resource ID, only one of those resources is imported at random. An error is logged for the resources that share the same resource ID.
3737

3838
- Allows you to ingest soft-deleted resources. This capability is beneficial when you migrate from Azure API for FHIR to the FHIR service in Azure Health Data Services.
3939

40-
> [!IMPORTANT]
41-
> The `import` operation doesn't support conditional references in resources.
42-
>
43-
> Also, if multiple resources share the same resource ID, only one of those resources is imported at random. An error is logged for the resources that share the same resource ID.
44-
4540
This table shows the difference between import modes.
4641

4742
|Areas|Initial mode |Incremental mode |
@@ -56,9 +51,9 @@ This table shows the difference between import modes.
5651

5752
To achieve the best performance with the `import` operation, consider these factors:
5853

59-
- **Use large files for import**. The file size of a single `import` operation should be more than 200 MB. Smaller files might result in slower import times.
54+
- **Use large files for import**. The optimal NDJSON file size for import is >=50MB (or >=20K resources, no upper limit). Consider combining smaller files together.
6055

61-
- **Import FHIR resource files as a single batch**. For optimal performance, import all the FHIR resource files that you want to ingest in the FHIR server in one `import` operation. Importing all the files in one operation reduces the overhead of creating and managing multiple import jobs. The combined total size of all the files in a single import should be greater than 100 GB or 100 M resources.
56+
- **Import FHIR resource files as a single batch**. For optimal performance, import all the FHIR resource files that you want to ingest in the FHIR server in one `import` operation. Importing all the files in one operation reduces the overhead of creating and managing multiple import jobs. For optimal performance total size of files in single import should be large (>=100GB or >=100M resources, no upper limit).
6257

6358
- **Limit the number of parallel import jobs**. You can run multiple `import` jobs at the same time, but running multiple jobs might affect the overall throughput of the `import` operation.
6459

@@ -291,6 +286,8 @@ Here are the error messages that occur if the `import` operation fails, along wi
291286
## Limitations
292287
- The maximum number of files allowed for each `import` operation is 10,000.
293288
- The number of files ingested in the FHIR server with same lastUpdated field value upto milliseconds can't exceed beyond 10,000.
289+
- Import operation is not supported for SearchParameter resource type.
290+
- The import operation doesn't support conditional references in resources.
294291

295292
## Next steps
296293

0 commit comments

Comments
 (0)