

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

# 데이터 변환에 필요한 파라미터
<a name="data-transformation-status-model"></a>

Lambda의 모든 변환된 레코드에는 다음 파라미터가 포함되어 있어야 합니다. 그렇지 않으면 Amazon Data Firehose가 이를 거부하고 데이터 변환 실패로 간주합니다.

------
#### [ For Kinesis Data Streams and Direct PUT ]

Lambda에서 변환된 모든 레코드에는 다음 파라미터가 필요합니다.
+ `recordId` – 레코드 ID는 호출 중에 Amazon Data Firehose에서 Lambda로 전달됩니다. 변환된 레코드에는 동일한 레코드 ID가 포함되어야 합니다. 원래 레코드의 ID와 변환된 레코드의 ID 간 불일치는 데이터 변환 실패로 간주됩니다.
+ `result` – 레코드의 데이터 변환 상태입니다. 가능한 값은 `Ok`(레코드가 성공적으로 변환되었음), `Dropped`(처리 로직에 의해 의도적으로 레코드가 삭제됨), `ProcessingFailed`(레코드를 변환하지 못함)입니다. 레코드의 상태가 `Ok` 또는 `Dropped`이면, Amazon Data Firehose는 성공적으로 처리된 것으로 간주합니다. 그렇지 않으면 Amazon Data Firehose는 이를 처리 실패로 간주합니다.
+ `data` – base64 인코딩 후 변환된 데이터 페이로드입니다.

  다음은 Lambda 결과 출력 예입니다.

  ```
   {
      "recordId": {{"<recordId from the Lambda input>"}},
      "result": "Ok",
      "data": {{"<Base64 encoded Transformed data>"}}
  }
  ```

------
#### [ For Amazon MSK ]

Lambda에서 변환된 모든 레코드에는 다음 파라미터가 필요합니다.
+ `recordId` – 레코드 ID는 호출 중에 Firehose에서 Lambda로 전달됩니다. 변환된 레코드에는 동일한 레코드 ID가 포함되어야 합니다. 원래 레코드의 ID와 변환된 레코드의 ID 간 불일치는 데이터 변환 실패로 간주됩니다.
+ `result` – 레코드의 데이터 변환 상태입니다. 가능한 값은 `Ok`(레코드가 성공적으로 변환되었음), `Dropped`(처리 로직에 의해 의도적으로 레코드가 삭제됨), `ProcessingFailed`(레코드를 변환하지 못함)입니다. 레코드 상태가 `Ok` 또는 `Dropped`인 경우 Firehose는 성공적으로 처리된 것으로 간주합니다. 그렇지 않으면 Firehose는 이를 처리 실패로 간주합니다.
+ `KafkaRecordValue` – base64 인코딩 후 변환된 데이터 페이로드입니다.

  다음은 Lambda 결과 출력 예입니다.

  ```
   {
      "recordId": {{"<recordId from the Lambda input>"}},
      "result": "Ok",
      "kafkaRecordValue": {{"<Base64 encoded Transformed data>"}}
  }
  ```

------