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à.
# Richiedere l'esportazione di un diario in QLDB
**Importante**
Avviso di fine del supporto: i clienti esistenti potranno utilizzare Amazon QLDB fino alla fine del supporto, il 31/07/2025. Per ulteriori dettagli, consulta [Migrare un registro Amazon QLDB su Amazon Aurora PostgreSQL](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/).
Amazon QLDB fornisce un'API per richiedere l'esportazione dei blocchi di journal per un intervallo di data e ora specificato e una destinazione di bucket Amazon S3 specificata. Un processo di esportazione del diario può scrivere gli oggetti dati nella rappresentazione testuale o binaria del formato [Amazon Ion](ion.md) o nel formato di testo [JSON Lines](https://jsonlines.org/). Puoi utilizzare il Console di gestione AWS, un AWS SDK o il AWS Command Line Interface (AWS CLI) per creare un processo di esportazione.
**Topics**
+ [Console di gestione AWS](#export-journal.request.con)
+ [API QLDB](#export-journal.request.api)
+ [Scadenza del lavoro di esportazione](#export-journal.request.expiration)
## Console di gestione AWS
Segui questi passaggi per inviare una richiesta di esportazione del journal in QLDB utilizzando la console QLDB.
**Per richiedere un'esportazione (console)**
1. [Accedi a e apri Console di gestione AWS la console Amazon QLDB all'indirizzo /qldb. https://console.aws.amazon.com](https://console.aws.amazon.com/qldb)
1. **Nel pannello di navigazione, scegli Esporta.**
1. Scegli **Crea processo di esportazione**.
1. Nella pagina **Crea processo di esportazione**, inserisci le seguenti impostazioni di esportazione:
+ **Libro contabile**: il libro contabile di cui si desidera esportare i blocchi del diario.
+ **Data e ora di inizio**: il timestamp di inizio incluso, in formato UTC (Coordinated Universal Time), dell'intervallo di blocchi di diario da esportare. **Questo timestamp deve essere anteriore alla data e all'ora di fine.** Se fornisci un timestamp di inizio precedente a quello del libro mastro, `CreationDateTime` QLDB lo imposta di default su quello del libro mastro. `CreationDateTime`
+ **Data e ora di fine**: l'esclusivo timestamp di fine (UTC) dell'intervallo di blocchi di journal da esportare. Questa data e ora non possono appartenere al futuro.
+ **Destinazione per i blocchi journal**: il bucket Amazon S3 e il nome del prefisso in cui il processo di esportazione scrive gli oggetti dati. Utilizza il seguente formato URI Amazon S3.
```
s3://amzn-s3-demo-qldb-cloudtrail/prefix/
```
È necessario specificare un nome di bucket S3 e un nome di prefisso opzionale per gli oggetti di output. Di seguito è riportato un esempio.
```
s3://amzn-s3-demo-qldb-cloudtrail/journalExport/
```
Il nome e il prefisso del bucket devono entrambi rispettare le regole e le convenzioni di denominazione di Amazon S3. Per ulteriori informazioni sulla denominazione dei bucket, consulta [Restrizioni e limitazioni dei bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/BucketRestrictions.html) nella *Amazon* S3 Developer Guide. [Per ulteriori informazioni sui prefissi dei nomi chiave, consulta Chiave dell'oggetto e metadati.](https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingMetadata.html)
**Nota**
Le esportazioni tra regioni non sono supportate. Il bucket Amazon S3 specificato deve trovarsi nello Regione AWS stesso registro.
+ **Crittografia S3**: le impostazioni di crittografia utilizzate dal processo di esportazione per scrivere dati in un bucket Amazon S3. *Per ulteriori informazioni sulle opzioni di crittografia lato server in Amazon S3, [consulta Protezione dei dati utilizzando la crittografia lato server nella](https://docs.aws.amazon.com/AmazonS3/latest/userguide/serv-side-encryption.html) Amazon S3 Developer Guide.*
+ **Crittografia predefinita del bucket**: utilizza le impostazioni di crittografia predefinite del bucket Amazon S3 specificato.
+ **AES-256**: utilizza la crittografia lato server con le chiavi gestite di Amazon S3 (SSE-S3).
+ **AWS-KMS**: utilizza la crittografia lato server con chiavi AWS KMS gestite (SSE-KMS).
Se scegli questo tipo insieme all' AWS KMS key opzione **Scegli un altro**, devi anche specificare una chiave KMS di crittografia simmetrica nel seguente formato Amazon Resource Name (ARN).
```
arn:aws:kms:aws-region:account-id:key/key-id
```
+ **Accesso al servizio**: il ruolo IAM che concede le autorizzazioni di scrittura QLDB nel bucket Amazon S3. Se applicabile, il ruolo IAM deve inoltre concedere le autorizzazioni QLDB per utilizzare la chiave KMS.
*Per passare un ruolo a QLDB quando si richiede l'esportazione di un journal, è necessario disporre delle autorizzazioni per eseguire `iam:PassRole` l'azione sulla risorsa del ruolo IAM.*
+ **Crea e usa un nuovo ruolo di servizio**: consenti alla console di creare un nuovo ruolo per te con le autorizzazioni richieste per il bucket Amazon S3 specificato.
+ **Usa un ruolo di servizio esistente**: per scoprire come creare manualmente questo ruolo in IAM, consulta. [Autorizzazioni di esportazione](export-journal.perms.md)
+ **Formato di output**: il formato di output dei dati del diario esportati
+ **Ion text** — (impostazione predefinita) Rappresentazione testuale di Amazon Ion
+ **Ion binary**: rappresentazione binaria di Amazon Ion
+ **JSON: formato** di testo JSON delimitato da una nuova riga
Se scegli JSON, QLDB converte i dati del journal Ion in JSON negli oggetti dati esportati. Per ulteriori informazioni, consulta [Conversione verso il basso in JSON](export-journal.output.md#export-journal.output.json).
1. **Quando le impostazioni sono quelle che desideri, scegli Crea processo di esportazione.**
Il tempo necessario per completare il processo di esportazione varia a seconda della dimensione dei dati. Se l'invio della richiesta ha esito positivo, la console torna alla pagina principale di **esportazione** ed elenca i lavori di esportazione con il loro stato attuale.
1. Puoi vedere i tuoi oggetti di esportazione sulla console Amazon S3.
Apri la console Amazon S3 all'indirizzo. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)
Per ulteriori informazioni sul formato di questi oggetti di output, consulta[Uscita di esportazione del diario in QLDB](export-journal.output.md).
**Nota**
I lavori di esportazione scadono sette giorni dopo il completamento. Per ulteriori informazioni, consulta [Scadenza del lavoro di esportazione](#export-journal.request.expiration).
## API QLDB
Puoi anche richiedere l'esportazione di un journal utilizzando l'API Amazon QLDB con AWS un SDK o il. AWS CLI L'API QLDB fornisce le seguenti operazioni per l'uso da parte dei programmi applicativi:
+ `ExportJournalToS3`— Esporta i contenuti del diario entro un intervallo di data e ora da un determinato registro in un bucket Amazon S3 specificato. Un processo di esportazione può scrivere i dati come oggetti nella rappresentazione testuale o binaria del formato Amazon Ion o nel formato di testo JSON Lines.
+ `DescribeJournalS3Export`— Restituisce informazioni dettagliate su un processo di esportazione di un diario. L'output include lo stato corrente, l'ora di creazione e i parametri della richiesta di esportazione originale.
+ `ListJournalS3Exports`— Restituisce un elenco di descrizioni dei lavori di esportazione delle riviste per tutti i libri contabili associati alla regione corrente Account AWS e alla regione. L'output di ogni descrizione del lavoro di esportazione include gli stessi dettagli restituiti da`DescribeJournalS3Export`.
+ `ListJournalS3ExportsForLedger`— Restituisce un elenco di descrizioni dei lavori di esportazione delle riviste per un determinato libro mastro. L'output di ogni descrizione del lavoro di esportazione include gli stessi dettagli restituiti da`DescribeJournalS3Export`.
Per una descrizione completa di queste operazioni API, consulta[Riferimento all'API Amazon QLDB](api-reference.md).
Per informazioni sull'esportazione dei dati del diario utilizzando AWS CLI, vedere il [AWS CLI Command Reference.](https://docs.aws.amazon.com/cli/latest/reference/qldb/index.html)
### Applicazione di esempio (Java)
Per esempi di operazioni di esportazione di base in codice Java, consulta il GitHub repository [amazon-qldb-dmv-sampleaws-samples/](https://github.com/aws-samples/amazon-qldb-dmv-sample-java) -java. Per istruzioni su come scaricare e installare questa applicazione di esempio, consulta. [Installazione dell'applicazione di esempio Amazon QLDB Java](sample-app.java.md) Prima di richiedere un'esportazione, assicurati di seguire i passaggi da 1 a 3 [Tutorial su Java](getting-started.java.tutorial.md) per creare un registro di esempio e caricarlo con dati di esempio.
Il codice tutorial nelle seguenti classi fornisce esempi di creazione di un'esportazione, controllo dello stato di un'esportazione ed elaborazione dell'output di un'esportazione.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/qldb/latest/developerguide/export-journal.request.html)
## Scadenza del lavoro di esportazione
I lavori di esportazione del diario completati sono soggetti a un periodo di conservazione di 7 giorni. Vengono eliminati automaticamente dopo la scadenza di questo limite. Questo periodo di scadenza è un limite rigido e non può essere modificato.
Dopo l'eliminazione di un processo di esportazione completato, non è più possibile utilizzare la console QLDB o le seguenti operazioni API per recuperare i metadati relativi al lavoro:
+ `DescribeJournalS3Export`
+ `ListJournalS3Exports`
+ `ListJournalS3ExportsForLedger`
Tuttavia, questa scadenza non ha alcun impatto sui dati esportati stessi. Tutti i metadati vengono conservati nei file manifesto scritti dalle tue esportazioni. Questa scadenza è progettata per fornire un'esperienza più fluida per le operazioni API che elencano i lavori di esportazione delle riviste. QLDB rimuove i vecchi lavori di esportazione per garantire che vengano visualizzate solo le esportazioni recenti senza dover analizzare più pagine di lavori.