AWS Management Console QLDB API Scadenza del lavoro di esportazione

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 Amazon QLDB Ledger ad Amazon Aurora Postgre. SQL

Amazon QLDB consente di API 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 o nel formato di testo JSONLines. Puoi usare the AWS Management Console AWS SDK, an o the AWS Command Line Interface (AWS CLI) per creare un processo di esportazione.

AWS Management Console

Segui questi passaggi per inviare una richiesta di esportazione del diario QLDB utilizzando la QLDB console.

Per richiedere un'esportazione (console)

Accedi a e apri AWS Management Console la QLDB console Amazon all'indirizzo https://console.aws.amazon.com/qldb.
Nel pannello di navigazione, scegli Esporta.
Scegli Crea processo di esportazione.
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: l'indicatore orario di inizio incluso in Coordinated Universal Time (UTC) dell'intervallo di blocchi di giornale 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 contabileCreationDateTime, lo imposta come QLDB predefinito su quello del libro contabile. CreationDateTime
- Data e ora di fine: l'esclusivo timestamp di fine (UTC) dell'intervallo di blocchi di diario 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 Amazon S3URI.
```
s3://amzn-s3-demo-bucket/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-bucket/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 nella Amazon S3 Developer Guide. Per ulteriori informazioni sui prefissi dei nomi chiave, consulta Chiave dell'oggetto e metadati.
  
  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 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 (-S3). SSE
  - AWS- KMS — Usa la crittografia lato server con chiavi gestite (-). AWS KMS SSE KMS
    
    Se scegli questo tipo insieme all' AWS KMS key opzione Scegli un altro, devi anche specificare una KMS chiave di crittografia simmetrica nel seguente formato Amazon Resource Name (ARN).
    
    arn:aws:kms:aws-region:account-id:key/key-id
- Accesso al servizio: il IAM ruolo che concede le autorizzazioni di QLDB scrittura nel tuo bucket Amazon S3. Se applicabile, il IAM ruolo deve inoltre concedere le QLDB autorizzazioni per utilizzare la chiave. KMS
  
  Per passare un ruolo a QLDB quando si richiede l'esportazione di un diario, è necessario disporre delle autorizzazioni necessarie per eseguire l'iam:PassRoleazione sulla risorsa del IAM ruolo.
  - 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 informazioni su come creare manualmente questo ruolo inIAM, consulta. Autorizzazioni di esportazione
- 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 delimitato da una nuova riga JSON
    
    Se lo desideriJSON, QLDB converte i dati di Ion journal in oggetti dati esportati. JSON Per ulteriori informazioni, consulta Conversione verso il basso in JSON.
Quando le impostazioni sono quelle desiderate, scegliete 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.
Puoi vedere i tuoi oggetti di esportazione sulla console Amazon S3.

Apri la console Amazon S3 all'indirizzo. https://console.aws.amazon.com/s3/

Per ulteriori informazioni sul formato di questi oggetti di output, consultaUscita di esportazione del diario in QLDB.

Nota

I lavori di esportazione scadono sette giorni dopo il completamento. Per ulteriori informazioni, consulta Scadenza del lavoro di esportazione.

QLDB API

Puoi anche richiedere l'esportazione di un diario utilizzando Amazon QLDB API con un AWS SDK o il AWS CLI. QLDBAPIFornisce le seguenti operazioni per l'utilizzo 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 daDescribeJournalS3Export.
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 daDescribeJournalS3Export.

Per una descrizione completa di queste API operazioni, vedereQLDBAPIRiferimento Amazon.

Per informazioni sull'esportazione dei dati del diario utilizzando AWS CLI, vedere il AWS CLI Command Reference.

Applicazione di esempio (Java)

Per esempi di operazioni di esportazione di base in codice Java, consulta il GitHub repository amazon-qldb-dmv-sampleaws-samples/ -java. Per istruzioni su come scaricare e installare questa applicazione di esempio, consulta. Installazione dell'applicazione di esempio Amazon QLDB Java Prima di richiedere un'esportazione, assicurati di seguire i passaggi da 1 a 3 Tutorial su Java 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.

Classe	Descrizione
ExportJournal	Esporta i blocchi del diario dal registro di `vehicle-registration` esempio per un intervallo di timestamp compreso tra 10 minuti e ora. Scrive gli oggetti di output in un bucket S3 specificato o crea un bucket unico se non ne viene fornito uno.
DescribeJournalExport	Descrive un processo di esportazione del giornale per un registro specificato `exportId` nel registro di esempio. `vehicle-registration`
ListJournalExports	Restituisce un elenco di descrizioni dei lavori di esportazione delle riviste per il libro mastro `vehicle-registration` di esempio.
ValidateQldbHashChain	Convalida la catena hash del registro di `vehicle-registration` esempio utilizzando un dato. `exportId` Se non viene fornita, richiede una nuova esportazione da utilizzare per la convalida della catena hash.

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 QLDB console o le seguenti API operazioni 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 API le operazioni che elencano i lavori di esportazione delle riviste. QLDBrimuove i vecchi lavori di esportazione per garantire che vengano visualizzate solo le esportazioni recenti senza dover analizzare più pagine di lavori.

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

Esportazione dei dati del diario

Output di esportazione