翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # インポートジョブを理解する AWS HealthImaging で[データストア](getting-started-concepts.md#concept-data-store)を作成したら、Amazon S3 入力バケットから医療画像データをデータストアにインポートして[画像セット](getting-started-concepts.md#concept-image-set)を作成する必要があります。 AWS マネジメントコンソール、 AWS CLI、および AWS SDKs を使用して、インポートジョブを開始、説明、一覧表示できます。 DICOM P10 データを AWS HealthImaging データストアにインポートすると、サービスは[メタデータ要素](understanding-image-sets.md)に基づいて、治験 UID、シリーズ UID、インスタンス UID の DICOM 階層に従ってインスタンスを自動的に整理しようとします。インポートされたデータの[メタデータ要素](understanding-image-sets.md)がデータストア内の既存のプライマリ[イメージセット](getting-started-concepts.md#concept-image-set)と競合しない場合、インポートされたデータはプライマリになります。新しくインポートされた DICOM P10 データのメタデータ要素が既存のプライマリ[イメージセット](getting-started-concepts.md#concept-image-set)と競合する場合、新しいデータは非プライマリ[イメージセット](getting-started-concepts.md#concept-image-set)に追加されます。データインポートが非プライマリ[イメージセット](getting-started-concepts.md#concept-image-set)を作成すると、AWS HealthImaging `success.ndjson`は を使用して EventBridge イベントを出力し`isPrimary: False`、 に書き込まれたレコードも `importResponse` オブジェクト`isPrimary: False`内に存在します。 データをインポートすると、HealthImaging は以下を実行します。 + DICOM シリーズで構成されるインスタンスが 1 つのインポートジョブにインポートされ、そのインスタンスがデータストアに既に存在するインスタンスと競合しない場合、すべてのインスタンスは 1 つのプライマリ[イメージセット](getting-started-concepts.md#concept-image-set)に整理されます。 + DICOM シリーズで構成されるインスタンスが 2 つ以上のインポートジョブにインポートされ、インスタンスがデータストアに既に存在するインスタンスと競合しない場合、すべてのインスタンスは 1 つのプライマリ[イメージセット](getting-started-concepts.md#concept-image-set)として編成されます。 + インスタンスが複数回インポートされた場合、最新バージョンはプライマリ[イメージセット](getting-started-concepts.md#concept-image-set)に保存されている古いバージョンを上書きし、プライマリ[イメージセット](getting-started-concepts.md#concept-image-set)のバージョン番号が増加します。 [「イメージセットメタデータの更新](update-image-set-metadata.md)」で説明されているステップを使用して、プライマリのインスタンスを更新できます。 インポート中、サイズが 1MB を超えるプライベートタグ (VR タイプ OB、OD、OF、OL、OV、OW、UN) のバイナリ値は、メタデータとは別に保存されます。`GetDICOMInstanceMetadata` または を使用してこれらのインスタンスのメタデータを取得する場合`GetDICOMSeriesMetadata`、これらの大きなバイナリ値は BulkDataURIsに置き換えられ、実際のバイナリデータは `GetDICOMBulkdata` API を使用して取得できます。 HealthImaging は、すべての医療画像データのインポートを試みます。インポート中にデータの不一致または認識されないデータ要素が発生した場合、HealthImaging はインポート可能な DICOM インスタンスの`warning.ndjson`ファイルに警告を追加します。警告コードの完全なリストについては、「」を参照してください[HealthImaging 警告コード](reference-warning-codes.md)。 Amazon S3 から HealthImaging データストアに医療画像ファイルをインポートするときは、次の点に注意してください。 + DICOM シリーズに対応するインスタンスは、プライマリを示す単一の画像セットに自動的に結合されます。 + DICOM P10 データを 1 つのインポートジョブまたは複数のインポートジョブにインポートでき、サービスはインスタンスを DICOM シリーズに対応するプライマリイメージセットに整理します。 + インポート中、特定の DICOM 要素には長さの制限が適用されます。インポートジョブを正常に実行するには、医療画像データが長さの制限を超えていないことを確認してください。詳細については、「[DICOM 要素の制約](dicom-element-constraints.md)」を参照してください。 + インポートジョブの開始時に、ピクセルデータの検証チェックが実行されます。詳細については、「[ピクセルデータ検証](pixel-data-verification.md)」を参照してください。 + HealthImaging のインポートアクションに関連した、エンドポイント、クォータ、スロットリング制限があります。詳細については、「[エンドポイントとクォータ](endpoints-quotas.md)」および「[スロットリングの制限](throttling-limits.md)」を参照してください。 + インポートジョブごとに、処理結果は `outputS3Uri` の場所に保存されます。処理結果は、`job-output-manifest.json`ファイル、`SUCCESS` および `FAILURE` フォルダで整理されます。 **注記** 1 つのインポートジョブに最大 10,000 個の入れ子になったフォルダーを含めることができます。 + この `job-output-manifest.json` ファイルには、`jobSummary` 出力と処理されたデータに関する追加情報が含まれます。次の例は、`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 } ] } } ``` + この `SUCCESS` フォルダには、正常にインポートされたすべての画像ファイルの結果を含む `success.ndjson` ファイルが格納されます。次の例は、`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}} ``` + この `FAILURE` フォルダには、正常にインポートされなかったすべての画像ファイルの結果を含む `failure.ndjson` ファイルが格納されます。次の例は、`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"}} ``` + `WARNING` フォルダには、正常にインポートされたが警告が表示されたすべての画像`warning.ndjson`ファイルの結果を含むファイルが保持されます。次の例は、`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."}]}} ``` + インポートジョブはジョブのリストに 90 日間保持され、その後アーカイブされます。