기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
DynamoDB
DynamoDB
이벤트 소스 유형을 설명하는 객체. 자세한 내용은 개발자 안내서의 Amazon AWS Lambda DynamoDB와 함께 사용을 참조하십시오.AWS Lambda
AWS SAM 이 이벤트 유형이 설정되면 AWS::Lambda::EventSourceMapping리소스를 생성합니다.
구문
AWS Serverless Application Model (AWS SAM) 템플릿에서 이 엔티티를 선언하려면 다음 구문을 사용하십시오.
YAML
BatchSize:
Integer
BisectBatchOnFunctionError:Boolean
DestinationConfig:DestinationConfig
Enabled:Boolean
FilterCriteria:FilterCriteria
FunctionResponseTypes:List
KmsKeyArn:String
MaximumBatchingWindowInSeconds:Integer
MaximumRecordAgeInSeconds:Integer
MaximumRetryAttempts:Integer
ParallelizationFactor:Integer
StartingPosition:String
StartingPositionTimestamp:Double
Stream:String
TumblingWindowInSeconds:Integer
속성
-
BatchSize
-
한 번의 배치에서 검색하는 최대 항목 수입니다.
유형: 정수
필수 항목 여부: 아니요
기본값: 100
AWS CloudFormation 호환성: 이 속성은
AWS::Lambda::EventSourceMapping
리소스의BatchSize
속성으로 직접 전달됩니다.최소:
1
최대:
1000
-
BisectBatchOnFunctionError
-
함수가 오류를 제시하면 비치를 2개로 분할해서 다시 시도합니다.
유형: 부울
필수 항목 여부: 아니요
AWS CloudFormation 호환성: 이 속성은
AWS::Lambda::EventSourceMapping
리소스의BisectBatchOnFunctionError
속성에 직접 전달됩니다. -
DestinationConfig
-
폐기된 레코드를 위한 Amazon 심플 큐 서비스 (AmazonSQS) 큐 또는 아마존 심플 알림 서비스 (AmazonSNS) 주제 대상.
필수 항목 여부: 아니요
AWS CloudFormation 호환성: 이 속성은
AWS::Lambda::EventSourceMapping
리소스의DestinationConfig
속성으로 직접 전달됩니다. -
Enabled
-
이벤트 소스 매핑을 비활성화하여 폴링 및 간접 호출을 일시 중지합니다.
유형: 부울
필수 항목 여부: 아니요
AWS CloudFormation 호환성: 이 속성은
AWS::Lambda::EventSourceMapping
리소스의Enabled
속성에 직접 전달됩니다. -
FilterCriteria
-
Lambda가 이벤트를 처리해야 하는지 결정하는 기준을 정의하는 객체입니다. 자세한 내용은 AWS Lambda 개발자 가이드의 AWS Lambda 이벤트 필터링을 참조하세요.
유형: FilterCriteria
필수 항목 여부: 아니요
AWS CloudFormation 호환성: 이 속성은
AWS::Lambda::EventSourceMapping
리소스의FilterCriteria
속성으로 직접 전달됩니다. -
FunctionResponseTypes
-
이벤트 소스 매핑에 현재 적용된 응답 유형의 목록입니다. 자세한 내용은 AWS Lambda Developer Guide의 Reporting batch item failures를 참조하세요.
유효한 값:
ReportBatchItemFailures
유형: 목록
필수 항목 여부: 아니요
AWS CloudFormation 호환성: 이 속성은
AWS::Lambda::EventSourceMapping
리소스의FunctionResponseTypes
속성에 직접 전달됩니다. -
KmsKeyArn
-
이 이벤트와 관련된 정보를 암호화하기 위한 키의 Amazon 리소스 이름 (ARN).
유형: 문자열
필수 항목 여부: 아니요
AWS CloudFormation 호환성: 이 속성은
AWS::Lambda::EventSourceMapping
리소스의KmsKeyArn
속성으로 직접 전달됩니다. -
MaximumBatchingWindowInSeconds
-
함수를 호출하기 전에 기록을 수집할 최대 기간(단위: 초)입니다.
유형: 정수
필수 항목 여부: 아니요
AWS CloudFormation 호환성: 이 속성은
AWS::Lambda::EventSourceMapping
리소스의MaximumBatchingWindowInSeconds
속성에 직접 전달됩니다. -
MaximumRecordAgeInSeconds
-
Lambda가 처리를 위해 함수에 보내는 기록의 최대 사용 기간입니다.
유형: 정수
필수 항목 여부: 아니요
AWS CloudFormation 호환성: 이 속성은
AWS::Lambda::EventSourceMapping
리소스의MaximumRecordAgeInSeconds
속성에 직접 전달됩니다. -
MaximumRetryAttempts
-
함수가 오류를 반환할 때 재시도하는 최대 횟수입니다.
유형: 정수
필수 항목 여부: 아니요
AWS CloudFormation 호환성: 이 속성은
AWS::Lambda::EventSourceMapping
리소스의MaximumRetryAttempts
속성에 직접 전달됩니다. -
ParallelizationFactor
-
각 샤드에서 동시에 처리할 배치의 수입니다.
유형: 정수
필수 항목 여부: 아니요
AWS CloudFormation 호환성: 이 속성은
AWS::Lambda::EventSourceMapping
리소스의ParallelizationFactor
속성에 직접 전달됩니다. -
StartingPosition
-
읽기를 시작하는 스트림 내의 위치입니다.
-
AT_TIMESTAMP
- 기록 읽기를 시작할 시간을 지정합니다. -
LATEST
– 새 기록만 읽습니다. -
TRIM_HORIZON
– 사용 가능한 모든 기록을 처리합니다.
유효한 값:
AT_TIMESTAMP
|LATEST
|TRIM_HORIZON
유형: 문자열
필수 항목 여부: 예
AWS CloudFormation 호환성: 이 속성은
AWS::Lambda::EventSourceMapping
리소스의StartingPosition
속성에 직접 전달됩니다. -
-
StartingPositionTimestamp
-
읽기를 시작하는 시간(유닉스 시간 초 단위)입니다.
StartingPositionTimestamp
언제StartingPosition
를AT_TIMESTAMP
으로 지정할지 정의합니다.유형: Double
필수 항목 여부: 아니요
AWS CloudFormation 호환성: 이 속성은
AWS::Lambda::EventSourceMapping
리소스의StartingPositionTimestamp
속성에 직접 전달됩니다. -
Stream
-
DynamoDB 스트림의 Amazon 리소스 이름 (ARN).
유형: 문자열
필수 항목 여부: 예
AWS CloudFormation 호환성: 이 속성은 리소스의
EventSourceArn
속성으로 직접 전달됩니다.AWS::Lambda::EventSourceMapping
-
TumblingWindowInSeconds
-
처리 윈도우 기간(초 단위). 유효한 범위는 1 ~ 900입니다(15분).
자세한 내용은 개발자 가이드의 AWS Lambda Tumbling windows를 참조하세요.
유형: 정수
필수 항목 여부: 아니요
AWS CloudFormation 호환성: 이 속성은
AWS::Lambda::EventSourceMapping
리소스의TumblingWindowInSeconds
속성에 직접 전달됩니다.
예시
기존 DynamoDB 테이블의 DynamoDB 이벤트 소스
계정에 이미 있는 DynamoDB 테이블의 DynamoDB 이벤트 소스입니다. AWS
YAML
Events: DDBEvent: Type: DynamoDB Properties: Stream: arn:aws:dynamodb:us-east-1:123456789012:table/TestTable/stream/2016-08-11T21:21:33.291 StartingPosition: TRIM_HORIZON BatchSize: 10 Enabled: false
템플릿에 선언된 DynamoDB 테이블에 대한 DynamoDB 이벤트
동일한 템플릿 파일에 선언된 DynamoDB 테이블에 대한 DynamoDB 이벤트입니다.
YAML
Events: DDBEvent: Type: DynamoDB Properties: Stream: !GetAtt MyDynamoDBTable.StreamArn # This must be the name of a DynamoDB table declared in the same template file StartingPosition: TRIM_HORIZON BatchSize: 10 Enabled: false