View a markdown version of this page

Crea una consegna Amazon S3 - Flusso di dati Amazon Kinesis
Utilizzo di Console di gestione AWSUtilizzo di AWS CLI

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Crea una consegna Amazon S3

Crea una distribuzione che invii i record da un flusso Amazon Kinesis Data Streams a un bucket Amazon S3 generico. Puoi creare una consegna con o. Console di gestione AWS AWS CLI I record vengono forniti nel loro formato sorgente, raggruppati in oggetti di dimensioni ottimali, con compressione configurabile e una struttura di chiavi S3 definita dall'utente.

Nota

Prima di creare una distribuzione, completa i prerequisiti inGuida introduttiva alla distribuzione generica di S3, incluso il ruolo di esecuzione del servizio IAM descritto in. Autorizzazioni IAM per la consegna dei dati

Utilizzo di Console di gestione AWS

  1. Apri la console Kinesis all'indirizzo. https://console.aws.amazon.com/kinesis

  2. Nel pannello di navigazione, scegli S3 General Purpose Delivery, quindi scegli Crea consegna.

  3. Fase 1: Configurazione del codice sorgente. In Dettagli di consegna, inserisci un nome di consegna. Per Source, scegli lo On-Demand stream da cui effettuare la trasmissione. Vengono visualizzati solo On-Demand gli stream. Scegli Avanti.

  4. Fase 2: Configurazione della destinazione. Scegliete un formato di registrazione (JSON, STRING o BYTE_ARRAY), quindi specificate la destinazione:

    • ARN del bucket S3: l'ARN del bucket Amazon S3 generico di destinazione.

    • Proprietario previsto del bucket: l'ID a 12 Account AWS cifre del proprietario del bucket previsto.

    • Tipo di compressione : scegli GZIP, ZSTD o Nessuno.

    • Classe di storage: opzionalmente scegli una classe di storage Amazon S3.

    • Modello di chiave di output: definisci facoltativamente la struttura chiave dell'oggetto Amazon S3. Per informazioni dettagliate, vedi Modello di chiave di output S3 per la consegna di Amazon S3.

    • Freschezza dei dati: il tempo massimo di buffering in secondi prima della consegna dei record (minimo 300, massimo 900).

    Scegli Avanti.

  5. Fase 3: Configurazione aggiuntiva. Configura la crittografia, l'accesso al servizio (il ruolo IAM), una coda opzionale di lettere non scritte, la consegna dei log e i tag. Scegli Avanti.

  6. Fase 4: Rivedi e crea. Controlla la configurazione, quindi scegli Crea consegna. La consegna passa da CREATING a ACTIVE dopo il completamento del provisioning.

Utilizzo di AWS CLI

Usa il create-channel comando per creare una distribuzione Amazon S3 che invii i record a un bucket Amazon S3 generico con formato JSON e compressione GZIP: 

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

Il comando restituisce il canale ARN ()ChannelARN. Utilizzatelo con describe-channel per verificare che la consegna raggiunga lo stato ATTIVO. Consulta Descrivi una consegna Amazon S3. Per personalizzare la struttura delle chiavi degli oggetti di Amazon S3, consulta. Modello di chiave di output S3 per la consegna di Amazon S3

Riferimento all'API: CreateChannel consulta il riferimento all'API Amazon Kinesis Data Streams.