You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/healthcare-apis/dicom/data-partitions.md
+17-12Lines changed: 17 additions & 12 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -15,21 +15,27 @@ Data partitioning allows you to set up a lightweight data partition scheme to st
15
15
16
16
Although UIDs should be [unique across all contexts](http://dicom.nema.org/dicom/2013/output/chtml/part05/chapter_9.html), it's common practice for healthcare providers to write DICOM files to portable storage media and then give them to a patient. The patient then gives the files to another healthcare provider, who then transfers the files into a new DICOM storage system. Therefore, multiple copies of one DICOM file do commonly exist in isolated DICOM systems. Data partitioning provides an on-ramp for your existing data stores and workflows.
17
17
18
-
## Enable data partitions on initial deployment of the DICOM service
18
+
## Limitations
19
19
20
-
You enable data partitions feature by selecting **Enable data partitions** when you deploy a new DICOM service. After data partitioning is turned on, it can't be turned off. In addition, data partitions can't be turned on for any DICOM service that is already deployed.
20
+
- The **partitions feature** can't be turned off after you turn it on.
21
+
-**Querying across partitions** isn't supported.
22
+
-**Updating and deleting partitions** is also not supported.
21
23
22
-
After the data partitions setting is enabled, the capability modifies the API surface of the DICOM server and makes any previous data accessible under the `Microsoft.Default` partition.
24
+
## Enable data partitions during initial deployment
25
+
26
+
You enable data partitions by selecting **Enable data partitions** when you deploy a new DICOM service. After data partitioning is turned on, it can't be turned off. In addition, data partitions can't be turned on for any DICOM service that is already deployed.
27
+
28
+
After the data partitions setting is turned on, the capability modifies the API surface of the DICOM server and makes any previous data accessible under the `Microsoft.Default` partition.
23
29
24
30
> [!IMPORTANT]
25
-
> Data partitions can't be disabled if partitions other than `Microsoft.Default` are present. In this case, the system throws a `DataPartitionsFeatureCannotBeDisabledException` error on startup.
31
+
> Data partitions can't be disabled if partitions other than `Microsoft.Default` are present. When this situation happens, the system throws a `DataPartitionsFeatureCannotBeDisabledException` error on startup.
26
32
27
33
## API changes
28
34
29
-
All unique resource identifies (URIs) assume an implicit DICOM service base URI. For example, the base URI of a DICOM server running locally is `https://localhost:63838/`.
35
+
All unique resource identifiers (URIs) assume an implicit DICOM service base URI. For example, the base URI of a DICOM server running locally is `https://localhost:63838/`.
30
36
Example requests can be sent in the [Postman collection](../resources/Conformance-as-Postman.postman_collection.json) by providing a value for the `partitionName` collection variable.
31
37
32
-
### List all data partitions
38
+
####List all data partitions
33
39
This command Lists all data partitions:
34
40
35
41
```http
@@ -50,11 +56,11 @@ GET /partitions
50
56
| 204 (No Content) || No partitions exist. |
51
57
| 400 (Bad Request) || Data partitions capability is disabled. |
52
58
53
-
### STOW, WADO, QIDO, Delete, Export update and worklist APIs
59
+
####STOW, WADO, QIDO, delete, export, update, and worklist APIs
54
60
55
61
After partitions are enabled, STOW, WADO, QIDO, delete, export, update, and worklist requests must include a data partition URI segment after the base URI, with the form `/partitions/{partitionName}`, where `partitionName` is:
56
62
57
-
- Up to 64 characters long
63
+
- Up to 64 characters long.
58
64
- Any combination of alphanumeric characters, `.`, `-`, and `_`, to allow both DICOM UID and GUID formats, as well as human-readable identifiers.
59
65
60
66
| Action | Example URI |
@@ -74,15 +80,14 @@ After partitions are enabled, STOW, WADO, QIDO, delete, export, update, and work
74
80
| 400 (Bad Request) |`PartitionName` value is missing in the route segment. |
All other APIs, including [extended query tags](../how-to-guides/extended-query-tags.md), [operations](../how-to-guides/extended-query-tags.md#get-operation), and [change feed](change-feed.md) continue to be accessed at the base URI.
79
85
80
-
## Manage data partitions
86
+
###Manage data partitions
81
87
82
88
The only management operation supported for partitions is an implicit creation during STOW and workitem create requests. If the partition specified in the URI doesn't exist, the system creates it implicitly and the response returns a retrieve URI including the partition path.
83
89
84
-
85
-
## Partition definitions
90
+
### Partition definitions
86
91
87
92
A partition is a unit of logical isolation and data uniqueness.
0 commit comments