Activer le partitionnement des données

Article
2024-11-11

Le partitionnement des données vous permet de configurer un schéma de partition de données léger pour stocker plusieurs copies de la même image avec le même identifiant unique (UID) dans une seule instance DICOM®.

Bien que les UID doivent être uniques dans tous les contextes, il est courant que les prestataires de soins de santé écrivent des fichiers DICOM sur des supports de stockage portables et les donnent à un patient. Le patient remet ensuite les dossiers à un autre prestataire de soins de santé, qui transfère les fichiers dans un nouveau système de stockage DICOM. Par conséquent, plusieurs copies d’un même fichier DICOM existent généralement dans plusieurs systèmes DICOM isolés. Le partitionnement des données fournit une rampe d'accès pour vos magasins de données et flux de travail existants.

Limites

La fonctionnalité de partitions ne peut pas être désactivée une fois que vous l'avez activée.
L'interrogation entre les partitions n'est pas prise en charge.
La mise à jour et la suppression de partitions ne sont pas prises en charge.

Activer les partitions de données pendant le déploiement initial

Sélectionnez Activer les partitions de données lorsque vous déployez un nouveau service DICOM. Une fois le partitionnement des données activé, il ne peut pas être désactivé. En outre, les partitions de données ne peuvent pas être activées pour un service DICOM déjà déployé.

Une fois le paramètre de partitions de données activé, la fonctionnalité modifie la surface d'API du serveur DICOM et rend toutes les données précédentes accessibles sous la partition Microsoft.Default.

Important

Les partitions de données ne peuvent pas être désactivées si des partitions autres que Microsoft.Default sont présentes. Lorsque cette situation se produit, le système génère une erreur DataPartitionsFeatureCannotBeDisabledException au démarrage.

Modifications d'API

Répertorier toutes les partitions de données

Cette commande répertorie toutes les partitions de données :

HTTP

GET /partitions

En-tête de requête

Nom	Requise	Type	Description
Type de contenu	false	string	`application/json` est pris en charge

Réponses

Nom	Type	Description
200 (OK)	`[Partition] []`	Une liste de partitions est retournée.
204 (Pas de contenu)		Aucune partition n'existe.
400 (Requête incorrecte)		La capacité de partitions de données est désactivée.

Demandes STOW, WADO, QIDO, suppression, exportation, mise à jour et liste de travail des API

Une fois les partitions activées, les demandes STOW, WADO, QIDO, de suppression, d'exportation, de mise à jour et de liste de travail doivent inclure un segment URI de partition de données après l'URI de base, sous la forme /partitions/{partitionName}, où partitionName est :

Jusqu'à 64 caractères
Toute combinaison de caractères alphanumériques, ., -, et _ (pour autoriser les formats DICOM UID et GUID), ainsi que des identifiants lisibles par l'homme.

Action	Exemple d'URI
STOW	`POST /partitions/myPartition-1/studies`
WADO	`GET /partitions/myPartition-1/studies/2.25.0000`
QIDO	`GET /partitions/myPartition1/studies?StudyInstanceUID=2.25.0000`
Supprimer	`DELETE /partitions/myPartition1/studies/2.25.0000`
Exporter	`POST /partitions/myPartition1/export`
Mettre à jour	`POST /partitions/myPartition-1/studies/$bulkUpdate`

Nouvelles réponses

Nom	Message
400 (Requête incorrecte)	La capacité de partitions de données est désactivée.
400 (Requête incorrecte)	La valeur `PartitionName` est manquante dans le segment de routage.
400 (Requête incorrecte)	L'élément spécifié `PartitionName {PartitionName}` n'existe pas.

Autres API

Toutes les autres API, notamment les balises de requête étendues, les opérations et le flux de modification, continuent d'être accessibles à l'URI de base.

Gestion des partitions de données

La seule opération de gestion prise en charge pour les partitions est une création implicite pendant les demandes de création STOW et workitem. Si la partition spécifiée dans l'URI n'existe pas, le système le crée implicitement et la réponse retourne un URI de récupération, y compris le chemin d'accès de partition.

Définitions de partition

Une partition est une unité d'isolation logique et d'unicité des données.

Nom	Type	Description
PartitionKey	int	Identifiant attribué par le système.
PartitionName	string	Nom unique attribué par le client, jusqu'à 64 caractères alphanumériques, `.`, `-` ou `_`.
CreatedDate	string	Date et heure auxquelles la partition a été créée.

Remarque

DICOM® est une marque déposée de la National Electrical Manufacturers Association pour ses publications de standards relatifs aux communications numériques des informations médicales.

Partage via