View a markdown version of this page

Crie uma entrega do Amazon S3 - Amazon Kinesis Data Streams
Usar o Console de gerenciamento da AWSUsar o AWS CLI

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Crie uma entrega do Amazon S3

Crie uma entrega que envie registros de um stream do Amazon Kinesis Data Streams para um bucket do Amazon S3 de uso geral. Você pode criar uma entrega com o Console de gerenciamento da AWS ou AWS CLI o. Os registros são entregues em seu formato de origem, agrupados em objetos de tamanho ideal, com compactação configurável e uma estrutura de chaves do S3 que você define.

nota

Antes de criar uma entrega, preencha os pré-requisitos emComeçando com a entrega de uso geral do S3, incluindo a função de execução do serviço IAM descrita em. Permissões do IAM para entrega de dados

Usar o Console de gerenciamento da AWS

  1. Abra o console Kinesis em. https://console.aws.amazon.com/kinesis

  2. No painel de navegação, escolha Entrega de uso geral do S3 e, em seguida, escolha Criar entrega.

  3. Etapa 1: Configuração da fonte. Em Detalhes da entrega, insira um nome de entrega. Em Source, escolha o On-Demand stream a partir do qual fazer a entrega. Somente On-Demand transmissões são exibidas. Escolha Próximo.

  4. Etapa 2: Configuração de destino. Escolha um formato de registro (JSON , STRING ou BYTE_ARRAY) e especifique o destino:

    • ARN do bucket S3 — o ARN do bucket de uso geral do Amazon S3 de destino.

    • Proprietário esperado do bucket — o Conta da AWS ID de 12 dígitos do proprietário esperado do bucket.

    • Tipo de compactação — escolha GZIP, ZSTD ou Nenhum.

    • Classe de armazenamento — opcionalmente, escolha uma classe de armazenamento Amazon S3.

    • Modelo de chave de saída — defina opcionalmente a estrutura da chave de objeto do Amazon S3. Para obter detalhes, consulte Modelo de chave de saída S3 para entrega do Amazon S3.

    • Atualização dos dados — o tempo máximo de buffer em segundos antes da entrega dos registros (mínimo 300, máximo 900).

    Escolha Próximo.

  5. Etapa 3: Configuração adicional. Configure a criptografia, o acesso ao serviço (a função do IAM), uma fila opcional de cartas mortas, entrega de registros e tags. Escolha Próximo.

  6. Etapa 4: Revise e crie. Revise sua configuração e escolha Criar entrega. A entrega passa de CREATING para ACTIVE após a conclusão do provisionamento.

Usar o AWS CLI

Use o create-channel comando para criar uma entrega do Amazon S3 que envie registros para um bucket do Amazon S3 de uso geral com formato JSON e compactação GZIP: 

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"
        }
    }'

O comando retorna o canal ARN (ChannelARN). Use-o com describe-channel para verificar se a entrega atinge o estado ATIVO. Consulte Descreva uma entrega do Amazon S3. Para personalizar a estrutura da chave de objeto do Amazon S3, consulteModelo de chave de saída S3 para entrega do Amazon S3.

Referência da API — veja CreateChannel na Referência da API do Amazon Kinesis Data Streams.