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

를 사용하여 대규모 리소스 패치 적용 $bulk-patch

AWS HealthLake 는 많은 수의 FHIR 리소스에 패치 $bulk-patch 작업을 비동기적으로 적용하는 작업을 지원합니다. ID별로 특정 리소스 목록을 대상으로 지정하거나 데이터 스토어 내에서 지정된 유형의 모든 리소스를 대상으로 지정할 수 있습니다. 이 작업을 사용하면 각 리소스를 개별적으로 업데이트하지 않고도 대규모로 리소스를 수정할 수 있습니다.

$bulk-patch 작업은 다음을 수행해야 할 때 특히 유용합니다.

용도

$bulk-patch 작업은 비동기식입니다. 작업을 시작하려면 POST 요청을 제출합니다.

POST [base]/$bulk-patch

작업 상태를 폴링하려면 설명 엔드포인트를 사용합니다.

GET [base]/$bulk-patch/{jobId}

$bulk-patch 작업을 시작하려면 다음을 수행합니다.

파라미터

$bulk-patch 작업은 다음 파라미터를 지원합니다.

리소스 대상 지정

두 가지 모드로 리소스를 대상으로 지정할 수 있습니다.

리소스 유형 모드

리소스 유형 모드에서 작업은 데이터 스토어에서 특정 유형의 모든 리소스를 패치합니다.

{
    "resourceType": "Patient",
    "operations": { ... }
}

리소스 IDs 모드

리소스 IDs 모드에서 작업은 ID별로 특정 리소스 목록을 패치합니다. 모든 리소스 IDs 동일한 유형이어야 하며 resourceType 파라미터와 일치해야 합니다. 형식은 전체 참조([resourceType]/[id]) 또는 ID()일 수 있습니다[id]. 목록에는 최대 50,000개의 리소스 IDs.

{
    "resourceType": "Patient",
    "resourceIds": ["Patient/001", "Patient/002", "Patient/003"],
    "operations": { ... }
}

지원되는 패치 형식

$bulk-patch 작업은 JSON 패치(RFC 6902) 및 FHIR 패치(FHIRPath 기반) 구문을 모두 지원합니다. 지원되는 작업 세트와 동기식 PATCH 작업과 동일한 구문을 사용합니다. 자세한 내용은 PATCH 작업을 사용하여 리소스 수정 단원을 참조하십시오.

대량 패치 시작 작업 예제

다음 예제에서는 FHIR 패치를 사용하여 특정 Patient 리소스에 규정 준수 태그를 추가하는 대량 패치 작업을 제출합니다.

요청 예시

POST [base]/$bulk-patch
Content-Type: application/json

{
    "resourceType": "Patient",
    "resourceIds": ["patient-1", "patient-2", "patient-3"],
    "validationLevel": "strict",
    "clientToken": "unique-idempotency-token-123",
    "operations": {
        "resourceType": "Parameters",
        "parameter": [
            {
                "name": "operation",
                "part": [
                    {"name": "type", "valueCode": "add"},
                    {"name": "path", "valueString": "Patient.meta"},
                    {"name": "name", "valueString": "tag"},
                    {"name": "value", "valueCoding": {
                        "system": "http://example.org/compliance",
                        "code": "2026-audit-complete"
                    }}
                ]
            }
        ]
    }
}

응답의 예

{
    "datastoreId": "datastoreId",
    "jobId": "jobId",
    "jobStatus": "SUBMITTED"
}

대량 패치 작업 상태 폴링

작업을 제출한 후 작업 상태를 폴링하여 진행 상황을 추적하고 결과를 검색합니다. 작업은 SUBMITTED 및 IN_PROGRESS를 거쳐 COMPLETED 또는의 터미널 상태로 전환됩니다COMPLETED_WITH_ERRORS.

GET [base]/$bulk-patch/{jobId}

다음 예제는 진행 중인 작업에 대한 응답을 보여줍니다.

{
    "datastoreId": "datastoreId",
    "jobId": "jobId",
    "status": "IN_PROGRESS",
    "submittedTime": "2026-09-14T06:53:31.429Z",
    "summary": {
        "estimatedResourceCount": 1000
    }
}

작업이 터미널 상태에 도달하면 설명 응답에는 성공, 실패 및 건너뛴 리소스의 개수 요약이 포함됩니다. 리소스가 실패하거나 건너뛴 경우 응답에는 failedResources 및의 이유가 나열됩니다skippedResources. 작업 상태는 고객 오류이든 서버 오류이든 관계없이 오류가 있는 COMPLETED_WITH_ERRORS 경우 입니다. 응답 크기는 failedResources 및 skippedResources 목록을 제한하므로 잘릴 수 있습니다. failedResourcesTruncated 및 skippedResourcesTruncated를 확인하여 전체 목록이 포함되어 있는지 확인합니다.

{
    "datastoreId": "datastoreId",
    "jobId": "jobId",
    "status": "COMPLETED_WITH_ERRORS",
    "submittedTime": "2026-09-14T06:53:31.429Z",
    "endTime": "2026-09-14T07:08:34.930Z",
    "summary": {
        "estimatedResourceCount": 1000,
        "totalResourcesProcessed": 1000,
        "succeeded": 985,
        "failedWithCustomerError": 5,
        "failedWithServerError": 0,
        "skipped": 10
    },
    "failedResources": [
        {
            "resourceId": "Patient/patient-101",
            "message": "FHIR resource in payload failed FHIR validation rules."
        }
    ],
    "skippedResources": [
        {
            "resourceId": "Patient/patient-201",
            "message": "Resource was modified after job submission"
        },
        {
            "resourceId": "Patient/patient-202",
            "message": "Resource was deleted."
        },
        {
            "resourceId": "Patient/patient-203",
            "message": "Resource not found."
        }
    ],
    "failedResourcesTruncated": false,
    "skippedResourcesTruncated": false
}

일반적인 건너뛴 이유

작업은 범위 내에 있을 때 리소스를 건너뛰지만 작업 제출과 처리 간에 상태가 변경되어 리소스를 패치할 수 없습니다. 건너뛴 리소스는 오류로 간주되지 않습니다. 다음은 리소스를 건너뛰는 일반적인 이유입니다.

일반적인 고객 장애

리소스 또는 패치 작업 문제로 인해 작업이 패치를 적용할 수 없는 경우 리소스가 실패합니다. 실패한 리소스에는 진단 세부 정보가 포함된 오류 메시지가 포함됩니다. 다음은 일반적인 고객 실패입니다.

모범 사례

$bulk-patch 작업을 사용할 때는 다음 모범 사례를 따르는 것이 좋습니다.

권한 부여

$bulk-patch 작업은 다음과 같은 권한 부여 방법을 지원합니다.

성능 특성

이 $bulk-patch 작업은 대량 처리를 위해 설계되었으며 비동기적으로 실행됩니다.

관련 작업