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á.
# Solicitar uma exportação de diário no QLDB
**Importante**
Aviso de fim do suporte: os clientes existentes poderão usar o Amazon QLDB até o final do suporte em 31/07/2025. Para obter mais detalhes, consulte [Migrar um Amazon QLDB Ledger para o Amazon](https://aws.amazon.com/blogs/database/migrate-an-amazon-qldb-ledger-to-amazon-aurora-postgresql/) Aurora PostgreSQL.
O Amazon QLDB fornece uma API para solicitar a exportação de seus blocos de diário para um intervalo de data e hora especificado e um destino específico do bucket do Amazon S3. Um trabalho de exportação de diário pode gravar os objetos de dados no texto ou na representação binária do formato [Amazon Ion](ion.md) ou no formato de texto [JSON Lines](https://jsonlines.org/). Você pode usar o Console de gerenciamento da AWS, um AWS SDK ou o AWS Command Line Interface (AWS CLI) para criar um trabalho de exportação.
**Topics**
+ [
## Console de gerenciamento da AWS
](#export-journal.request.con)
+ [
## API QLDB
](#export-journal.request.api)
+ [
## Expiração do trabalho de exportação
](#export-journal.request.expiration)
## Console de gerenciamento da AWS
Siga estas etapas para enviar uma solicitação de exportação de diário no QLDB usando o console do QLDB.
**Para solicitar uma exportação (console)**
1. [Faça login no e abra Console de gerenciamento da AWS o console do Amazon QLDB em /qldb. https://console.aws.amazon.com](https://console.aws.amazon.com/qldb)
1. No painel de navegação, selecione **Exportar**.
1. Escolha **Criar exportação**.
1. Na página **Criar tarefa de exportação**, insira as seguintes configurações de exportação:
+ **ledger**: o ledger cujos blocos de diário você deseja exportar.
+ **Data e hora de início**: a data e hora inclusiva de início no Horário Universal Coordenado (UTC) do intervalo de blocos de diário a serem exportados. Esse carimbo de data/hora deve ser anterior à **data e hora de término**. Se você fornecer uma data e hora de início anterior à `CreationDateTime` do ledger, o QLDB usará como padrão a `CreationDateTime` do ledger .
+ **Data e hora de término**: a data e hora de término (UTC) exclusiva da variedade de blocos de diário a serem exportados. Essa data e hora não podem estar no futuro.
+ **Destino dos blocos de diário**: o bucket do Amazon S3 e o nome do prefixo no qual seu trabalho de exportação grava os objetos de dados. Use o seguinte formato de URI do Amazon S3.
```
s3://amzn-s3-demo-qldb-cloudtrail/prefix/
```
É necessário especificar um nome de bucket do S3 e um nome de prefixo opcional para os objetos de saída. Veja um exemplo a seguir.
```
s3://amzn-s3-demo-qldb-cloudtrail/journalExport/
```
O nome e o prefixo do bucket devem estar em conformidade com as regras e convenções de nomenclatura do Amazon S3. Para obter informações sobre como nomear buckets, consulte [Restrições e limitações de buckets](https://docs.aws.amazon.com/AmazonS3/latest/userguide/BucketRestrictions.html) no *Guia do usuário do Amazon S3*. Para ter mais informações sobre prefixos de nomes de chaves, consulte [Chave de objeto e metadados](https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingMetadata.html).
**nota**
Exportações entre regiões não são compatíveis. O bucket especificado do Amazon S3 deve estar no mesmo que seu livro Região da AWS contábil.
+ **Criptografia S3**: as configurações de criptografia usadas pelo seu trabalho de exportação para gravar dados em um bucket do Amazon S3. Para obter mais informações sobre o uso da criptografia no lado do servidor no Amazon S3, consulte [ Proteger dados usando criptografia no lado do servidor](https://docs.aws.amazon.com/AmazonS3/latest/userguide/serv-side-encryption.html), no *Guia do desenvolvedor do Amazon S3*.
+ **Criptografia padrão do bucket**: use as configurações de criptografia padrão do bucket do Amazon S3 especificado.
+ **AES-256**: use criptografia no lado do servidor com chaves gerenciadas pelo Amazon S3 (SSE-S3).
+ **AWS-KMS** — Use criptografia do lado do servidor com AWS KMS chaves gerenciadas (SSE-KMS).
Se você escolher esse tipo junto com a opção **Escolher uma opção diferente AWS KMS key**, também deverá especificar uma chave KMS de criptografia simétrica no seguinte formato de nome do recurso da Amazon (ARN).
```
arn:aws:kms:aws-region:account-id:key/key-id
```
+ **Acesso ao serviço**: o perfil do IAM que concede permissões de gravação ao QLDB em seu bucket do Amazon S3. Se aplicável, o perfil do IAM também deve conceder permissões ao QLDB para usar sua chave KMS.
*Para transmitir um perfil ao QLDB ao solicitar uma exportação de diário, você deve ter permissões para realizar a ação `iam:PassRole` no recurso do perfil do IAM.*
+ **Crie e use um novo perfil de serviço**: deixe o console criar uma nova função para você com as permissões necessárias para o bucket do Amazon S3 especificado.
+ **Use um perfil de serviço existente**: para saber como criar essa função manualmente no IAM, consulte [Permissões de exportação](export-journal.perms.md).
+ **Formato de saída**: o formato de saída dos dados exportados do diário
+ **Texto de íons**: (padrão) representação de texto do Amazon Ion
+ **Binário de íons**: representação binária do Amazon Ion
+ **JSON**: formato de texto JSON delimitado por nova linha
Se você escolher JSON, o QLDB converterá negativamente os dados do diário Ion em JSON nos objetos de dados exportados. Para obter mais informações, consulte [Conversão descendente para JSON](export-journal.output.md#export-journal.output.json).
1. Quando estiver satisfeito com as configurações, escolha **Criar trabalho de exportação**.
O tempo necessário para a conclusão do trabalho de exportação varia dependendo do tamanho dos dados. Se o envio da solicitação for bem-sucedido, o console retornará à página principal de **Exportação** e listará seus trabalhos de exportação com o status atual.
1. É possível ver seus objetos de exportação no console do Amazon S3.
Abra o console do Amazon S3 em [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
Para saber mais sobre o formato desses objetos de saída, consulte [Saída de exportação de diário no QLDB](export-journal.output.md).
**nota**
Os trabalhos de exportação expiram sete dias após serem concluídos. Para obter mais informações, consulte [Expiração do trabalho de exportação](#export-journal.request.expiration).
## API QLDB
Você também pode solicitar a exportação de um diário usando a API Amazon QLDB com AWS um SDK ou o. AWS CLI A API do QLDB fornece as seguintes operações para uso por programas aplicativos:
+ `ExportJournalToS3`: exporta o conteúdo do diário dentro de um intervalo de data e hora de um determinado ledger para um bucket específico do Amazon S3. Um trabalho de exportação pode gravar os dados como objetos no texto ou na representação binária do formato Amazon Ion ou no formato de texto JSON Lines.
+ `DescribeJournalS3Export`: devolve informações detalhadas sobre um trabalho de exportação de diário. A saída inclui seu status atual, hora de criação e os parâmetros da sua solicitação de exportação original.
+ `ListJournalS3Exports`: devolve uma lista de descrições de trabalhos de exportação de diários para todos os ledgers associados à atual Conta da AWS e à região. A saída de cada descrição do trabalho de exportação inclui os mesmos detalhes retornados por `DescribeJournalS3Export`.
+ `ListJournalS3ExportsForLedger`: devolve uma lista de descrições de trabalhos de exportação de diários para um determinado ledger. A saída de cada descrição do trabalho de exportação inclui os mesmos detalhes retornados por `DescribeJournalS3Export`.
Para uma descrição completa dessas operações de API, consulte o [Referência da API do Amazon QLDB](api-reference.md).
Para obter informações sobre como exportar dados do diário usando o AWS CLI, consulte a [Referência de AWS CLI Comandos](https://docs.aws.amazon.com/cli/latest/reference/qldb/index.html).
### Aplicativos de exemplo (Java)
Para exemplos de código Java de operações básicas de exportação, consulte o GitHub repositório [amazon-qldb-dmv-sampleaws-samples/](https://github.com/aws-samples/amazon-qldb-dmv-sample-java) -java. Para obter instruções sobre como baixar e instalar esse aplicativo de amostra, consulte [Como instalar o aplicativo de amostra Java do Amazon QLDB](sample-app.java.md). Antes de solicitar uma exportação, siga as etapas de 1 a 3 em [Tutorial de Java](getting-started.java.tutorial.md) para criar um ledger de amostra e carregá-lo com dados de amostra.
O código do tutorial nas classes a seguir fornece exemplos de como criar uma exportação, verificar o status de uma exportação e processar a saída de uma exportação.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/qldb/latest/developerguide/export-journal.request.html)
## Expiração do trabalho de exportação
Os trabalhos de exportação de diários concluídos estão sujeitos a um período de retenção de 7 dias. Eles são excluídos automaticamente após a expiração desse limite. Esse período de expiração é um limite fixo e não pode ser alterado.
Depois que um trabalho de exportação concluído for excluído, você não poderá mais usar o console do QLDB ou as seguintes operações de API para recuperar metadados sobre o trabalho:
+ `DescribeJournalS3Export`
+ `ListJournalS3Exports`
+ `ListJournalS3ExportsForLedger`
No entanto, essa expiração não afeta os dados exportados em si. Todos os metadados são preservados nos arquivos de manifesto gravados por suas exportações. Essa expiração foi projetada para fornecer uma experiência mais tranquila para as operações de API que listam trabalhos de exportação de diários. O QLDB remove trabalhos de exportação antigos para garantir que você veja apenas exportações recentes sem precisar analisar várias páginas de trabalhos.