View a markdown version of this page

Amazon S3 전송 생성 - Amazon Kinesis Data Streams
사용 AWS Management Console사용 AWS CLI

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

Amazon S3 전송 생성

Amazon Kinesis Data Streams 스트림의 레코드를 범용 Amazon S3 버킷으로 전송하는 전송을 생성합니다. AWS Management Console 또는를 사용하여 전송을 생성할 수 있습니다 AWS CLI. 레코드는 소스 형식으로 전달되며, 구성 가능한 압축과 정의한 S3 키 구조를 사용하여 최적의 크기의 객체로 일괄 처리됩니다.

참고

전송을 생성하기 전에에 설명된 IAM 서비스 실행 역할을 S3 범용 전송 시작하기포함하여의 사전 조건을 완료합니다데이터 전송을 위한 IAM 권한.

사용 AWS Management Console

  1. 에서 Kinesis 콘솔을 엽니다https://console.aws.amazon.com/kinesis.

  2. 탐색 창에서 S3 범용 전송을 선택한 다음 전송 생성을 선택합니다.

  3. 1단계: 소스 구성. 전송 세부 정보에서 전송 이름을 입력합니다. 소스에서 전송할 온디맨드 스트림을 선택합니다. 온디맨드 스트림만 표시됩니다. 다음을 선택합니다.

  4. 2단계: 대상 구성. 레코드 형식(JSON, STRING 또는 BYTE_ARRAY)을 선택한 다음 대상을 지정합니다.

    • S3 버킷 ARN - 대상 범용 Amazon S3 버킷의 ARN입니다.

    • 예상 버킷 소유자 - 예상 버킷 소유자의 12자리 AWS 계정 ID입니다.

    • 압축 유형 - GZIP, ZSTD 또는 없음을 선택합니다.

    • 스토리지 클래스 - 선택적으로 Amazon S3 스토리지 클래스를 선택합니다.

    • 출력 키 템플릿 - 선택적으로 Amazon S3 객체 키 구조를 정의합니다. 자세한 내용은 Amazon S3 전송을 위한 S3 출력 키 템플릿 Amazon S3을 참조하세요.

    • 데이터 신선도 - 레코드가 전송되기 전 초 단위의 최대 버퍼링 시간입니다(최소 300, 최대 900).

    다음을 선택합니다.

  5. 3단계: 추가 구성. 암호화, 서비스 액세스(IAM 역할), 선택적 배달 못한 편지 대기열, 로그 전송 및 태그를 구성합니다. 다음을 선택합니다.

  6. 4단계: 검토 및 생성. 구성을 검토한 다음 전송 생성을 선택합니다. 프로비저닝이 완료된 후 전송이 CREATING에서 ACTIVE로 전환됩니다.

사용 AWS CLI

create-channel 명령을 사용하여 JSON 형식 및 GZIP 압축을 사용하여 레코드를 범용 Amazon S3 버킷으로 전송하는 Amazon S3 전송을 생성합니다.

aws kinesis create-channel \
    --channel-name "my-s3-delivery" \
    --service-execution-role-arn "arn:aws:iam::123456789012:role/my-channel-role" \
    --stream-configuration-list '[
        {
            "StreamARN": "arn:aws:kinesis:us-east-1:123456789012:stream/my-stream",
            "RecordConfiguration": {
                "RecordFormatType": "JSON"
            }
        }
    ]' \
    --s3-destination-configuration '{
        "DataFreshnessInSeconds": 300,
        "StorageConfiguration": {
            "BucketARN": "arn:aws:s3:::my-destination-bucket",
            "ExpectedBucketOwner": "123456789012",
            "CompressionType": "GZIP",
            "StorageClass": "STANDARD"
        }
    }'

명령은 채널 ARN()을 반환합니다ChannelARN. 와 함께 사용하여 전송이 ACTIVE 상태에 도달하는지 describe-channel 확인합니다. Amazon S3 전송 설명을(를) 참조하세요. Amazon S3 객체 키 구조를 사용자 지정하려면 섹션을 참조하세요Amazon S3 전송을 위한 S3 출력 키 템플릿 Amazon S3.

API 참조 - Amazon Kinesis Data Streams API 참조CreateChannel의 섹션을 참조하세요.