Partilhar via


Habilitar particionamento de dados

O particionamento de dados permite configurar um esquema de partição de dados leve para armazenar várias cópias da mesma imagem com o mesmo identificador exclusivo (UID) em uma única instância DICOM®.

Embora os UIDs devam ser únicos em todos os contextos, é prática comum para os prestadores de cuidados de saúde escrever ficheiros DICOM em suportes de armazenamento portáteis e entregá-los a um paciente. Em seguida, o paciente entrega os arquivos a outro prestador de cuidados de saúde, que os transfere para um novo sistema de armazenamento DICOM. Como resultado, várias cópias de um arquivo DICOM geralmente existem em vários sistemas DICOM isolados. O particionamento de dados fornece uma rampa para seus armazenamentos de dados e fluxos de trabalho existentes.

Limitações

  • O recurso de partições não pode ser desativado depois de ativá-lo.
  • Não há suporte para consultas entre partições.
  • A atualização e exclusão de partições também não é suportada.

Habilitar partições de dados durante a implantação inicial

  1. Selecione Ativar partições de dados ao implantar um novo serviço DICOM. Depois que o particionamento de dados estiver ativado, ele não poderá ser desativado. Além disso, as partições de dados não podem ser ativadas para qualquer serviço DICOM que já esteja implantado.

    Depois que a configuração de partições de dados é ativada, o recurso modifica a superfície da API do servidor DICOM e torna todos os dados anteriores acessíveis sob a Microsoft.Default partição.

    Captura de tela mostrando a opção Ativar partições de dados na página Criar serviço DICOM.

Importante

As partições de dados não podem ser desativadas se existirem partições diferentes Microsoft.Default . Quando essa situação acontece, o sistema lança um DataPartitionsFeatureCannotBeDisabledException erro na inicialização.

Alterações da API

Listar todas as partições de dados

Este comando Lista todas as partições de dados:

GET /partitions

Cabeçalho do pedido

Nome Obrigatório Type Description
Tipo de Conteúdo false string application/json é suportado

Respostas

Nome Tipo Description
200 (OK) [Partition] [] Uma lista de partições é retornada.
204 (Sem conteúdo) Não existem partições.
400 (Pedido Incorreto) A capacidade de partições de dados está desativada.

STOW, WADO, QIDO, excluir, exportar, atualizar e listar APIs

Depois que as partições são habilitadas, as solicitações STOW, WADO, QIDO, excluir, exportar, atualizar e lista de trabalho devem incluir um segmento de URI de partição de dados após o URI base, com o formulário /partitions/{partitionName}, onde partitionName está:

  • Até 64 caracteres.
  • Qualquer combinação de caracteres alfanuméricos, ., -e _ (para permitir os formatos DICOM UID e GUID), bem como identificadores legíveis por humanos.
Ação Exemplo de URI
STOW POST /partitions/myPartition-1/studies
AMA GET /partitions/myPartition-1/studies/2.25.0000
QIDO GET /partitions/myPartition1/studies?StudyInstanceUID=2.25.0000
Delete DELETE /partitions/myPartition1/studies/2.25.0000
Exportar POST /partitions/myPartition1/export
Atualizar POST /partitions/myPartition-1/studies/$bulkUpdate

Novas respostas

Nome Mensagem
400 (Pedido Incorreto) A capacidade de partições de dados está desativada.
400 (Pedido Incorreto) PartitionName valor está faltando no segmento de rota.
400 (Pedido Incorreto) Especificado PartitionName {PartitionName} não existe.

Outras APIs

Todas as outras APIs, incluindo tags de consulta estendidas, operações e feed de alterações continuam a ser acessadas no URI base.

Gerenciar partições de dados

A única operação de gerenciamento suportada para partições é uma criação implícita durante solicitações de criação de STOW e item de trabalho. Se a partição especificada no URI não existir, o sistema a criará implicitamente e a resposta retornará um URI de recuperação, incluindo o caminho da partição.

Definições de partição

Uma partição é uma unidade de isolamento lógico e exclusividade de dados.

Nome Tipo Description
PartitionKey número inteiro Identificador atribuído pelo sistema.
Nome da partição string Nome exclusivo atribuído pelo cliente, até 64 caracteres alfanuméricos, ., -, ou _.
Data de Criação string A data e a hora em que a partição foi criada.

Nota

DICOM® é a marca registrada da National Electrical Manufacturers Association para suas publicações de padrões relacionados a comunicações digitais de informações médicas.