기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

온톨로지 연결 배치 분석

Amazon Comprehend Medical을 사용하여 Amazon Simple Storage Service(S3) 버킷에 저장된 임상 텍스트에서 엔터티를 감지하고 이러한 엔터티를 표준화된 온톨로지에 연결합니다. 온톨로지 연결 배치 분석을 사용하여 문서 모음 또는 최대 20,000자의 단일 문서를 분석할 수 있습니다. 콘솔이나 온톨로지 연결 배치 API 작업을 사용하여 진행 중인 배치 분석 작업을 시작, 중지, 나열 및 설명하는 작업을 수행할 수 있습니다.

배치 분석 및 기타 Amazon Comprehend Medical 작업에 대한 요금 정보는 Amazon Comprehend Medical 요금을 참조하십시오.

배치 분석 수행

Amazon Comprehend Medical 콘솔 또는 Amazon Comprehend Medical 배치 API 작업을 사용하여 배치 분석 작업을 실행할 수 있습니다.

API 작업을 사용하여 배치 분석 수행

필수 조건

Amazon Comprehend Medical API를 사용하는 경우 AWS Identity Access and Management(IAM) 정책을 만들고 IAM 역할에 연결해야 합니다. IAM 역할 및 신뢰 정책에 대한 자세한 내용은 IAM 권한 및 정책을 참조하세요.

콘솔을 사용하여 배치 분석 수행

배치 작업에 대한 IAM 정책

Amazon Comprehend Medical 배치 API 작업을 호출하는 IAM 역할에는 입력 및 출력 파일이 포함된 S3 버킷에 대한 액세스 권한을 부여하는 정책이 있어야 합니다. Amazon Comprehend Medical 서비스가 역할을 맡을 수 있도록 IAM 역할에도 신뢰 관계를 할당해야 합니다. IAM 역할 및 신뢰 정책에 대한 자세한 내용은 IAM 역할을 참조하세요.

역할에는 다음과 같은 정책도 있어야 합니다.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Action": [
                "s3:GetObject"
            ],
            "Resource": [
                "arn:aws:s3:::input-bucket/*"
            ],
            "Effect": "Allow"
        },
        {
            "Action": [
                "s3:ListBucket"
            ],
            "Resource": [
                "arn:aws:s3:::input-bucket",
                "arn:aws:s3:::output-bucket",
            ],
            "Effect": "Allow"
        },
        {
            "Action": [
                "s3:PutObject"
            ],
            "Resource": [
                " arn:aws:s3:::output-bucket/*"
            ],
            "Effect": "Allow"
        }
    ]
}

 

역할은 다음과 같은 신뢰 관계를 맺고 있어야 합니다. 혼동되는 대리인 보안 문제를 방지하기 위해 aws:SourceAccount 및 aws:SourceArn 조건 키를 사용하여 혼동되는 대리인 보안 문제를 방지하는 것이 좋습니다. 혼동된 대리인 문제와 AWS 계정 보호 방법에 대해 자세히 알아보려면 IAM 설명서의 혼동된 대리인 문제를 참조하십시오.

{
   "Version":"2012-10-17",
   "Statement":[
      {
         "Effect":"Allow",
         "Principal":{
            "Service":[
               "comprehendmedical.amazonaws.com"
            ]
         },
         "Action":"sts:AssumeRole",
         "Condition": {
            "StringEquals": {
               "aws:SourceAccount": "account_id"
            },
            "ArnLike": {
               "aws:SourceArn": "arn:aws:comprehendmedical:region:account_id:*"
            }
         }
      }
   ]
}

배치 분석 출력 파일

Amazon Comprehend Medical은 배치의 각 입력 파일에 대해 하나의 출력 파일을 생성합니다. 이 파일의 확장자는 .out입니다. Amazon Comprehend Medical은 먼저 AwsAccountIdJobType- JobId-를 이름으로 사용하여 출력 S3 버킷에 디렉터리를 생성한 다음 배치에 대한 모든 출력 파일을 이 디렉터리에 씁니다. Amazon Comprehend Medical은 한 작업의 출력이 다른 작업의 출력을 덮어쓰지 않도록 이 새 디렉터리를 생성합니다.

배치 작업은 동기 작업과 동일한 출력을 생성합니다.

각 배치 작업은 작업에 대한 정보가 포함된 다음 세 개의 매니페스트 파일을 생성합니다.

Amazon Comprehend Medical은 사용자가 배치 작업을 위해 지정한 출력 디렉터리에 파일을 기록합니다. 요약 매니페스트 파일은 Manifest_AccountId-Operation-JobId 제목이 붙은 폴더와 함께 출력 폴더에 기록됩니다. 매니페스트 폴더 내에는 성공 매니페스트를 포함하는 success 폴더와 처리되지 않은 파일 매니페스트를 포함하는 failed 폴더가 있습니다. 다음 단원에서는 매니페스트 파일의 구조를 보여줍니다.

배치 매니페스트 파일

다음은 배치 매니페스트 파일의 JSON 구조입니다.

{"Summary" : 
    {"Status" : "COMPLETED | FAILED | PARTIAL_SUCCESS | STOPPED", 
    "JobType" : "ICD10CMInference | RxNormInference | SNOMEDCTInference", 
    "InputDataConfiguration" : {
        "Bucket" : "input bucket", 
        "Path" : "path to files/account ID-job type-job ID" 
    }, "OutputDataConfiguration" : {
        "Bucket" : "output bucket", 
        "Path" : "path to files" 
    }, 
    "InputFileCount" : number of files in input bucket, 
    "TotalMeteredCharacters" : total characters processed from all files, 
    "UnprocessedFilesCount" : number of files not processed, 
    "SuccessFilesCount" : total number of files processed, 
    "TotalDurationSeconds" : time required for processing, 
    "SuccessfulFilesListLocation" : "path to file", 
    "UnprocessedFilesListLocation" : "path to file",
    "FailedJobErrorMessage": "error message or if not applicable,
              The status of the job is completed"
    } 
}

성공 매니페스트 파일

다음은 성공적으로 처리된 파일에 대한 정보가 포함된 파일의 JSON 구조입니다.

{
    "Files": [{
            "Input": "input path/input file name",
            "Output": "output path/output file name",
            "InputSize": size in bytes of input file
        },
        {
            "Input": "input path/input file name",
            "Output": "output path/output file name",
            "InputSize": size in bytes of input file
     }]
}

처리되지 않은 매니페스트 파일

처리되지 않은 파일에 대한 정보가 포함된 매니페스트 파일의 JSON 구조는 다음과 같습니다.

{
  "Files" : [ {
      "Input": "file_name_that_failed",
      "ErrorCode": "error code for exception",
      "ErrorMessage": "explanation of the error code and suggestions"
  }, 
  { ...}
  ]
}