Skip to content

Commit 84c7bf4

Browse files
Merge pull request #268870 from EXPEkesheth/patch-158
Issue with isparallel query parameter in export job
2 parents 87532d3 + bd09c1f commit 84c7bf4

File tree

2 files changed

+14
-18
lines changed

2 files changed

+14
-18
lines changed

articles/healthcare-apis/azure-api-for-fhir/export-data.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,6 +17,9 @@ The Bulk Export feature allows data to be exported from the FHIR Server per the
1717

1818
Before using $export, you want to make sure that the Azure API for FHIR is configured to use it. For configuring export settings and creating Azure storage account, refer to [the configure export data page](configure-export-data.md).
1919

20+
> [!NOTE]
21+
> Only storage accounts in the same subscription as that for Azure API for FHIR are allowed to be registered as the destination for $export operations.
22+
2023
## Using $export command
2124

2225
After configuring the Azure API for FHIR for export, you can use the $export command to export the data out of the service. The data will be stored into the storage account you specified while configuring export. To learn how to invoke $export command in FHIR server, read documentation on the [HL7 FHIR $export specification](https://www.hl7.org/fhir/uv/bulkdata/).
@@ -68,7 +71,7 @@ The Azure API for FHIR supports the following query parameters. All of these par
6871
|\_isparallel| No |The "_isparallel" query parameter can be added to the export operation to enhance its throughput. The value needs to be set to true to enable parallelization. It is important to note that using this parameter may result in an increase in the request units consumption over the life of export. |
6972

7073
> [!NOTE]
71-
> Only storage accounts in the same subscription as that for Azure API for FHIR are allowed to be registered as the destination for $export operations.
74+
> There is a known issue with the $export operation that could result in incomplete exports with status success. Issue occurs when the is_parallel flag was used. Export jobs executed with _isparallel query parameter starting February 13th, 2024 are impacted with this issue.
7275
7376
## Secure Export to Azure Storage
7477

articles/healthcare-apis/azure-api-for-fhir/release-notes.md

Lines changed: 10 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -22,10 +22,12 @@ Azure API for FHIR provides a fully managed deployment of the Microsoft FHIR Ser
2222
The query parameter _summary=count and _count=0 can be added to _history endpoint to get count of all versioned resources. This count includes soft deleted resources. For more information, see [history management](././../azure-api-for-fhir/purge-history.md).
2323

2424
**Improve throughput for export operation**
25-
The "_isparallel" query parameter can be added to the export operation to enhance its throughput. It is important to note that using this parameter may result in an increase in Request Units consumption over the life of export. For more information, see [Export operation query parameters](././../azure-api-for-fhir/export-data.md).
25+
The "_isparallel" query parameter can be added to the export operation to enhance its throughput. Its' important to note that using this parameter may result in an increase in Request Units consumption over the life of export. For more information, see [Export operation query parameters](././../azure-api-for-fhir/export-data.md).
26+
> [!NOTE]
27+
> There's a known issue with the $export operation that could result in incomplete exports with status success. Issue occurs when the is_parallel flag was used. Export jobs executed with _isparallel query parameter starting February 13th, 2024 are impacted with this issue.
2628
2729
**Change in name nomenclature for exported file name and default storage account**
28-
With this change exported file names follow the format '{FHIR Resource Name}-{Number}-{Number}.ndjson'. The order of the files is not guaranteed to correspond to any ordering of the resources in the database.Default storage account name is updated to 'Export-{Number}'. There is no change to number of resources added in individual exported files.
30+
With this change, exported file names follow the format '{FHIR Resource Name}-{Number}-{Number}.ndjson'. The order of the files isn't guaranteed to correspond to any ordering of the resources in the database. Default storage account name is updated to 'Export-{Number}'. There's no change to number of resources added in individual exported files.
2931

3032

3133
**Performance Enhancement**
@@ -41,7 +43,7 @@ Conditional interactions can be complex and performance-intensive. To enhance th
4143
$export operation now supports exporting versioned resources and soft deleted resources. For more information, see [Export query parameters](../../healthcare-apis/azure-api-for-fhir/export-data.md).
4244

4345
## **November 2023**
44-
**Bulk delete capability now available**
46+
**Bulk delete capability now available in preview**
4547
`$bulk-delete' allows you to delete resources from FHIR server asynchronously. Bulk delete operation can be executed at system level or for individual resource type. For more information, see [bulk-delete operation](../../healthcare-apis/azure-api-for-fhir/bulk-delete-operation.md).
4648

4749
Bulk delete operation is currently in public preview. Review disclaimer for details. [!INCLUDE public preview disclaimer]
@@ -50,15 +52,6 @@ Bulk delete operation is currently in public preview. Review disclaimer for deta
5052

5153
Issue is now addressed and FHIR queries using continuation token with include/ revinclude, no longer report an exception. For details on fix, visit [#3525](https://github.com/microsoft/fhir-server/pull/3525).
5254

53-
## **July 2023**
54-
**Feature enhancement: Change to the exported file name format**
55-
56-
FHIR service enables customers to export data with $export operation. Export can be conducted across various levels, such as System, Patient and Group of patients. There are name changes with exported file and default storage account name.
57-
* Exported file names will follow the format \<FHIR Resource Name\>-\<Number\>- \<Number\>.ndjson. The order of the files is not guaranteed to correspond to any ordering of the resources in the database.
58-
* Default storage account name is updated to Export-\<Number\>.
59-
60-
There is no change to number of resources added in individual exported files.
61-
6255
## **June 2023**
6356
**Bug Fix: Metadata endpoint URL in capability statement is relative URL**
6457
Per FHIR specification, metadata endpoint URL in capability statement needs to be an absolute URL.
@@ -74,7 +67,7 @@ For more details, visit [#3250](https://github.com/microsoft/fhir-server/pull/32
7467
## **April 2023**
7568

7669
**Fixed transient issues associated with loading custom search parameters**
77-
This bug fix address the issue, where the FHIR service would not load the latest SearchParameter status in event of failure.
70+
This bug fix addresses the issue, where the FHIR service wouldn't load the latest SearchParameter status in the event of failure.
7871
For more details, visit [#3222](https://github.com/microsoft/fhir-server/pull/3222)
7972

8073
## **November 2022**
@@ -89,7 +82,7 @@ Bug is now fixed and Resource will be updated if matches the Etag header. For de
8982

9083
|Enhancement |Related information |
9184
| :----------------------------------- | :--------------- |
92-
|Azure API for FHIR does not create a new version of the resource if the resource content has not changed. |If a user updates an existing resource and only meta.versionId or meta.lastUpdated have changed then we return OK with existing resource information without updating VersionId and lastUpdated. For more information, see [#2519](https://github.com/microsoft/fhir-server/pull/2519). |
85+
|Azure API for FHIR doesn't create a new version of the resource if the resource content hasn't changed. |If a user updates an existing resource and only meta.versionId or meta.lastUpdated have changed then we return OK with existing resource information without updating VersionId and lastUpdated. For more information, see [#2519](https://github.com/microsoft/fhir-server/pull/2519). |
9386

9487
## April 2022
9588

@@ -121,7 +114,7 @@ Bug is now fixed and Resource will be updated if matches the Etag header. For de
121114
|Bug fixes |Related information |
122115
| :----------------------------------- | :--------------- |
123116
|Duplicate resources in search with `_include` |Fixed issue where a single resource can be returned twice in a search that has `_include`. For more information, see [PR #2448](https://github.com/microsoft/fhir-server/pull/2448). |
124-
|PUT creates on versioned update |Fixed issue where creates with PUT resulted in an error when the versioning policy is configured to `versioned-update`. For more information, see [PR #2457](https://github.com/microsoft/fhir-server/pull/2457). |
117+
|PUT creates on versioned update |Fixed issue were creates with PUT resulted in an error when the versioning policy is configured to `versioned-update`. For more information, see [PR #2457](https://github.com/microsoft/fhir-server/pull/2457). |
125118
|Invalid header handling on versioned update |Fixed issue where invalid `if-match` header would result in an HTTP 500 error. Now an HTTP Bad Request is returned instead. For more information, see [PR #2467](https://github.com/microsoft/fhir-server/pull/2467). |
126119

127120
## February 2022
@@ -220,8 +213,8 @@ Bug is now fixed and Resource will be updated if matches the Etag header. For de
220213

221214
|Custom search bugs |Related information |
222215
| :----------------------------------- | :--------------- |
223-
|Addresses the delete failure with Custom Search parameters. | [#2133](https://github.com/microsoft/fhir-server/pull/2133)|
224-
|Added retry logic while Deleting Search parameter. | [#2121](https://github.com/microsoft/fhir-server/pull/2121)|
216+
|Addresses failure with the custom search parameters. | [#2133](https://github.com/microsoft/fhir-server/pull/2133)|
217+
|Added retry logic while deleting search parameter. | [#2121](https://github.com/microsoft/fhir-server/pull/2121)|
225218
|Set max item count in search options in SearchParameterDefinitionManager. | [#2141](https://github.com/microsoft/fhir-server/pull/2141)|
226219
|Provides better exception if there's a bad expression in search parameter. |[#2157](https://github.com/microsoft/fhir-server/pull/2157)|
227220

0 commit comments

Comments
 (0)