

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Noções básicas sobre as tarefas de importação
<a name="understanding-import-jobs"></a>

Depois de criar um [armazenamento de dados](getting-started-concepts.md#concept-data-store) na AWS HealthImaging, você deve importar seus dados de imagens médicas do seu bucket de entrada do Amazon S3 para o seu armazenamento de dados para criar conjuntos de [imagens](getting-started-concepts.md#concept-image-set). Você pode usar os AWS SDKs Console de gerenciamento da AWS AWS CLI,, e para iniciar, descrever e listar trabalhos de importação.

[Quando você importa seus dados DICOM P10 para um datastore da AWS HealthImaging , o serviço tenta organizar automaticamente as instâncias de acordo com a hierarquia DICOM de UID de estudo, UID de série e UID de instância, com base nos elementos de metadados.](understanding-image-sets.md) Os dados importados se tornarão primários se os [elementos de metadados](understanding-image-sets.md) dos dados importados não entrarem em conflito com os [conjuntos de imagens](getting-started-concepts.md#concept-image-set) primárias existentes no armazenamento de dados. [Se os elementos de metadados dos dados DICOM P10 recém-importados entrarem em conflito com os [conjuntos de imagens](getting-started-concepts.md#concept-image-set) primárias existentes, os novos dados serão adicionados aos conjuntos de imagens não primárias.](getting-started-concepts.md#concept-image-set) Quando as importações de dados criam [conjuntos de imagens](getting-started-concepts.md#concept-image-set) não primários, a AWS HealthImaging emite um EventBridge evento com`isPrimary: False`, e o registro gravado no também `success.ndjson` estará `isPrimary: False` dentro do `importResponse` objeto.

Ao importar dados, HealthImaging faça o seguinte:
+ Se as instâncias que compõem uma série DICOM forem importadas em uma tarefa de importação e não entrarem em conflito com as instâncias que já estão no armazenamento de dados, todas as instâncias serão organizadas em um conjunto de [imagens](getting-started-concepts.md#concept-image-set) primário.
+ Se as instâncias que compõem uma série DICOM forem importadas em duas ou mais tarefas de importação e não entrarem em conflito com as instâncias que já estão no armazenamento de dados, todas as instâncias serão organizadas como um conjunto de [imagens](getting-started-concepts.md#concept-image-set) primárias.
+ Se uma instância for importada mais de uma vez, a versão mais recente substituirá qualquer versão mais antiga armazenada em um [conjunto de imagens](getting-started-concepts.md#concept-image-set) primário, e o número da versão do [conjunto de imagens](getting-started-concepts.md#concept-image-set) primário será incrementado.

Você pode atualizar as instâncias no primário com as etapas descritas em [Atualização dos metadados do conjunto de imagens](update-image-set-metadata.md).

Durante a importação, valores binários em tags privadas (com tipos de VR OB, OD, OF, OL, OV, OW, UN) que excedem 1 MB de tamanho são armazenados separadamente dos metadados. Ao recuperar metadados para essas instâncias usando `GetDICOMInstanceMetadata` ou`GetDICOMSeriesMetadata`, esses grandes valores binários são substituídos por BulkDataURIs, e os dados binários reais podem ser recuperados usando a API. `GetDICOMBulkdata`

HealthImaging tenta importar todos os seus dados de imagens médicas. Se forem encontradas não conformidades de dados ou elementos de dados não reconhecidos durante as importações, HealthImaging adiciona avisos ao `warning.ndjson` arquivo para instâncias DICOM que ainda podem ser importadas. Para obter uma lista completa dos códigos de aviso, consulte[HealthImaging Códigos de aviso](reference-warning-codes.md).

Lembre-se dos seguintes pontos ao importar seus arquivos de imagens médicas do Amazon S3 para HealthImaging um armazenamento de dados:
+ As instâncias correspondentes a uma série DICOM serão combinadas automaticamente em um único conjunto de imagens, denotado como primário.
+ Você pode importar dados DICOM P10 em uma tarefa de importação ou em várias tarefas de importação, e o serviço organizará as instâncias em conjuntos de imagens primárias que correspondem à série DICOM
+ As restrições de comprimento se aplicam a elementos DICOM específicos durante a importação. Para garantir uma importação bem-sucedida, verifique se os seus dados de imagens médicas não excedam as restrições de tamanho máximo. Para obter mais informações, consulte [Restrições de elementos de DICOM](dicom-element-constraints.md).
+ Uma verificação de dados de píxeis é realizada no início dos trabalhos de importação. Para obter mais informações, consulte [Verificação de dados de pixel](pixel-data-verification.md).
+ Há endpoints, cotas e limites de limitação associados às ações de importação. HealthImaging Para obter mais informações, consulte [Endpoints e cotas](endpoints-quotas.md) e [Limites de controle de utilização](throttling-limits.md).
+ Para cada tarefa de importação, os resultados do processamento são armazenados no `outputS3Uri` local. Os resultados do processamento são organizados em um arquivo `job-output-manifest.json` e pastas `SUCCESS` e `FAILURE`.
**nota**  
Você pode incluir até 10.000 pastas aninhadas em um único trabalho de importação.
  + O arquivo `job-output-manifest.json` contém a saída `jobSummary` e detalhes adicionais sobre os dados processados. O seguinte exemplo de saída mostra um arquivo `job-output-manifest.json`.

    ```
    {
    "jobSummary": {
    "jobId": "09876543210987654321098765432109",
            "datastoreId": "12345678901234567890123456789012",
            "inputS3Uri": "s3://medical-imaging-dicom-input/dicom_input/",
            "outputS3Uri": "s3://medical-imaging-output/job_output/12345678901234567890123456789012-DicomImport-09876543210987654321098765432109/",
            "successOutputS3Uri": "s3://medical-imaging-output/job_output/12345678901234567890123456789012-DicomImport-09876543210987654321098765432109/SUCCESS/",
            "failureOutputS3Uri": "s3://medical-imaging-output/job_output/12345678901234567890123456789012-DicomImport-09876543210987654321098765432109/FAILURE/",
            "warningsOutputS3Uri": "s3://medical-imaging-output/job_output/12345678901234567890123456789012-DicomImport-09876543210987654321098765432109/WARNING/",
            "numberOfScannedFiles": 5,
            "numberOfImportedFiles": 3,
            "numberOfFilesWithCustomerError": 2,
            "numberOfFilesWithServerError": 0,
            "numberOfGeneratedImageSets": 2,
            "imageSetsSummary": [{
    "imageSetId": "12345612345612345678907890789012",
                    "numberOfMatchedSOPInstances": 2
                },
                {
    "imageSetId": "12345612345612345678917891789012",
                    "numberOfMatchedSOPInstances": 1
                }
            ]
        }
    }
    ```
  + A pasta `SUCCESS` contém o arquivo `success.ndjson` contendo os resultados de todos os arquivos de imagem que foram importados com sucesso. O seguinte exemplo de saída mostra um arquivo `success.ndjson`.

    ```
    {"inputFile":"dicomInputFolder/1.3.51.5145.5142.20010109.1105620.1.0.1.dcm","importResponse":{"imageSetId":"12345612345612345678907890789012", "isPrimary": True}} 
    {"inputFile":"dicomInputFolder/1.3.51.5145.5142.20010109.1105630.1.0.1.dcm","importResponse":{"imageSetId":"12345612345612345678917891789012", "isPrimary": True}}
    ```
  + A pasta `FAILURE` contém o arquivo `failure.ndjson` contendo os resultados de todos os arquivos de imagem que não foram importados com êxito. O seguinte exemplo de saída mostra um arquivo `failure.ndjson`.

    ```
    {"inputFile":"dicom_input/invalidDicomFile1.dcm","exception":{"exceptionType":"ValidationException","message":"DICOM attribute TransferSyntaxUID does not exist"}}
    {"inputFile":"dicom_input/invalidDicomFile2.dcm","exception":{"exceptionType":"ValidationException","message":"DICOM attributes does not exist"}}
    ```
  + A `WARNING` pasta contém o `warning.ndjson` arquivo contendo os resultados de todos os arquivos de imagem que foram importados com sucesso, mas com avisos. O seguinte exemplo de saída mostra um arquivo `warning.ndjson`.

    ```
    {"inputFile":"dicom_input/warningDicomFile1.dcm","importResponse":{"imageSetId":"12345612345612345678907890789012","imageSetVersion":1,"isPrimary":true,"warnings":[{"warning_reason_code":45330,"type":"InvalidOffsetTable","message":"The file was imported but contains an invalid offset table, may see issues when retrieving certain frames."}]}}
    ```
+ Os trabalhos de importação são mantidos na lista de trabalhos por 90 dias e depois arquivados.