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à. # Come funziona la consegna di Amazon S3 Usa questo argomento per scoprire come una consegna Amazon S3 invia i record da un flusso di Amazon Kinesis Data Streams a bucket Amazon Simple Storage Service generici, tra cui configurazione dello storage, compressione, classe di storage, formati di record e crittografia. ## Come funziona la consegna Una consegna Amazon S3 invia i record a bucket Amazon S3 generici nei seguenti passaggi: 1. **Lettura**: la consegna legge i record da tutti i frammenti dello stream Kinesis Data Streams. 1. **Buffer**: i record vengono memorizzati nel buffer fino al raggiungimento dell'intervallo di aggiornamento dei dati. 1. **Convalida**: quando il formato del record è`STRING`, ogni record viene convalidato come UTF-8 stringa valida; quando il formato del record è`JSON`, ogni record viene convalidato come payload JSON valido. I record che non superano la convalida vengono inviati alla coda delle lettere morte. 1. **Compressione e formattazione**: i record vengono formattati in base al formato di output configurato e compressi utilizzando l'algoritmo di compressione specificato. 1. **Consegna**: gli oggetti risultanti vengono scritti nel bucket Amazon S3 di destinazione utilizzando il modello di chiave configurato. 1. **Dead-letter coda**: i record che non superano la convalida vengono scritti nella coda delle lettere morte con un contesto di errore. ## Configurazione di archiviazione Quando crei una consegna Amazon S3, specifichi la seguente configurazione di storage: + **BuckeTarn**: l'ARN del bucket Amazon S3 di destinazione. + **ExpectedBucketOwner**— l' Account AWS ID a 12 cifre del proprietario previsto del bucket di destinazione. Questo valore è obbligatorio e aiuta a prevenire la consegna a un bucket non previsto in caso di cambio di proprietà. + **CompressionType**— il tipo di compressione applicato agli oggetti consegnati. Questo valore è obbligatorio; specifica `NONE` di inviare oggetti senza compressione. Consulta [Opzioni di compressione](#data-delivery-s3-compression). + **StorageClass**— la classe di storage Amazon S3 per gli oggetti consegnati (opzionale). Consulta [Classe di storage](#data-delivery-s3-storage-class). + **OutputKeyTemplate**— il modello utilizzato per costruire la chiave oggetto Amazon S3 (opzionale). Consulta [Modello di chiave di output S3 per la consegna di Amazon S3](data-delivery-s3-key-template.md). ## Opzioni di compressione È necessario specificare un tipo di compressione per la distribuzione a bucket Amazon S3 generici. Per inviare oggetti senza compressione, scegli. `NONE` Scegliete uno dei seguenti tipi di compressione: + **GZIP**: compressione gzip standard. Buon equilibrio tra rapporto di compressione e velocità. + **ZSTD ** — Compressione Zstandard. Rapporto di compressione più elevato con decompressione più rapida. + **NESSUNA**: nessuna compressione applicata. I record vengono consegnati non compressi. ## Classe di storage È possibile specificare facoltativamente la classe di storage Amazon S3 per gli oggetti consegnati. Se non specificata, la classe di archiviazione predefinita è STANDARD. Classi di archiviazione supportate: + **STANDARD**: archiviazione generica per i dati a cui si accede di frequente. + **INTELLIGENT\_TIERING**: sposta automaticamente i dati tra i livelli di accesso in base ai modelli di utilizzo. + **GLACIER\_IR: archiviazione a basso costo per i dati che richiedono un recupero ** immediato. Per ulteriori informazioni sulle classi di storage di Amazon S3, consulta [ Understanding and management classes nella Amazon S3 User Guide. ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage-class-intro.html) * * ## Modello di chiave di output Puoi configurare il modello di chiave di output per controllare la struttura delle chiavi oggetto di Amazon S3 per i file consegnati. Il modello supporta segnaposto dinamici per i metadati di data, ora e consegna per organizzare i dati nel bucket di destinazione. Per il modello predefinito, le variabili supportate e gli esempi, consulta. [Modello di chiave di output S3 per la consegna di Amazon S3](data-delivery-s3-key-template.md) ## Aggiornamento dei dati L'aggiornamento dei dati definisce il tempo massimo di buffering prima della consegna dei record. È possibile configurare questo valore tra 300 e 900 secondi (da 5 a 15 minuti). Il valore predefinito è 300 secondi. Valori più bassi consentono una consegna più rapida, mentre valori più alti producono un numero inferiore di oggetti di dimensioni maggiori. ## Dead-letter coda Una coda per le lettere morte è facoltativa per la consegna a bucket Amazon S3 generici. Se non specifichi una configurazione della coda per le lettere morte, per impostazione predefinita la spedizione prevede la scrittura delle informazioni di errore nello stesso bucket di destinazione con un prefisso di errore. Se specifichi una coda per le lettere morte, fornisci quanto segue: + **BucketARN**: l'ARN del bucket Amazon S3 che riceve informazioni sui record che non è stato possibile consegnare. + **ExpectedBucketOwner**— l' Account AWS ID a 12 cifre del proprietario previsto del bucket per le lettere morte (richiesto quando si specifica una coda di lettere morte). + **ErrorOutputPrefix**— un prefisso opzionale per organizzare gli oggetti di metadati di errore all'interno del bucket. ## Formati di registrazione Le consegne Amazon S3 supportano i seguenti formati di record per la consegna a bucket Amazon S3 generici: + **JSON: semplici record JSON**. + **STRING ** — record di UTF-8 stringa. + **BYTE\_ARRAY ** — record binari non elaborati. **Nota** Il formato di `GSR_JSON` registrazione non è supportato per la distribuzione a bucket Amazon S3 generici. È supportato solo per la distribuzione a tabelle di streaming su Apache Iceberg, che richiedono Schema Registry. AWS Glue ## Cross-account consegna Le consegne Amazon S3 supportano la consegna tra account a bucket Amazon S3 generici. Lo stream di origine e il bucket di destinazione devono essere uguali. Regione AWS Configura la policy del bucket di destinazione per concedere al ruolo IAM di consegna l'autorizzazione a scrivere oggetti. ## Encryption (Crittografia) Le consegne Amazon S3 supportano la crittografia lato server con AWS KMS chiavi gestite dal cliente per oggetti consegnati a bucket Amazon S3 generici. Puoi specificare una chiave gestita dal cliente per crittografare gli oggetti consegnati. AWS KMS **Importante** Non è possibile utilizzare l'`aws/kinesis` AWS KMS alias per la crittografia della destinazione. È necessario utilizzare una chiave gestita dal cliente AWS KMS . Se il flusso di dati Kinesis di origine è crittografato, valgono ulteriori considerazioni. Un flusso crittografato con un Chiave gestita da AWS (`aws/kinesis`alias) non è supportato e il ruolo di esecuzione del servizio richiede le AWS KMS autorizzazioni per decrittografare i record di origine. Per i requisiti di crittografia del flusso di origine, consulta. [Crittografia del flusso sorgente](data-delivery-security.md#data-delivery-security-source-stream-encryption) Per le AWS KMS autorizzazioni necessarie al ruolo di esecuzione del servizio, consulta[Autorizzazioni IAM per la distribuzione dei dati](data-delivery-iam.md).