Solicitando a exportação de um diário em QLDB - Banco de dados Amazon Quantum Ledger (AmazonQLDB)

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á.

Solicitando a exportação de um diário em QLDB

Importante

Aviso de fim do suporte: os clientes existentes poderão usar a Amazon QLDB até o final do suporte em 31/07/2025. Para obter mais detalhes, consulte Migrar um Amazon QLDB Ledger para o Amazon Aurora Postgre. SQL

QLDBA Amazon fornece uma API opção 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 ou no formato de texto JSONLines. Você pode usar o AWS Management Console, um AWS SDK, ou o AWS Command Line Interface (AWS CLI) para criar um trabalho de exportação.

AWS Management Console

Siga estas etapas para enviar uma solicitação de exportação de diário QLDB usando o QLDB console.

Para solicitar uma exportação (console)
  1. Faça login no AWS Management Console e abra o QLDB console da Amazon em https://console.aws.amazon.com/qldb.

  2. No painel de navegação, selecione Exportar.

  3. Escolha Criar exportação.

  4. 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 de início inclusiva no Tempo 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 um registro de data e hora de início anterior ao do livro contábilCreationDateTime, o QLDB padrão será o do livro contábil. CreationDateTime

    • Data e hora de término — O carimbo de data/hora de término exclusivo (UTC) 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 do Amazon S3URI.

      s3://amzn-s3-demo-bucket/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-bucket/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 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.

      nota

      Exportações entre regiões não são compatíveis. O bucket do Amazon S3 especificado deve estar no mesmo Região da AWS como seu livro 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, 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 do lado do servidor com chaves gerenciadas do Amazon S3 (-S3). SSE

      • 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 Escolha um diferente AWS KMS keyopção, você também deve especificar uma KMS chave de criptografia simétrica no seguinte formato Amazon Resource Name (ARN).

        arn:aws:kms:aws-region:account-id:key/key-id
    • Acesso ao serviço — A IAM função que concede permissões de QLDB gravação em seu bucket do Amazon S3. Se aplicável, a IAM função também deve conceder QLDB permissões para usar sua KMS chave.

      Para passar uma função QLDB ao solicitar a exportação de um diário, você deve ter permissões para realizar a iam:PassRole ação no recurso da IAM função.

      • 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 uma função de serviço existente — Para saber como criar essa função manualmente emIAM, consultePermissões de exportação.

    • 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 delimitado por nova linha JSON

        Se você escolherJSON, QLDB converte negativamente os dados do diário Ion JSON em seus objetos de dados exportados. Para obter mais informações, consulte Conversão descendente para JSON.

  5. 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.

  6. É 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/

    Para saber mais sobre o formato desses objetos de saída, consulte Saída de exportação do diário em QLDB.

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.

QLDB API

Você também pode solicitar a exportação de um periódico usando a Amazon QLDB API com um AWS SDKou o AWS CLI. O QLDB API 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 na representação de texto ou 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— Retorna uma lista de descrições de trabalhos de exportação de periódicos para todos os livros contábeis associados ao 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 obter descrições completas dessas API operações, consulte QLDBAPIReferência da Amazon o.

Para obter informações sobre a exportação de dados do diário usando o AWS CLI, veja o AWS CLI Referência de comando.

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/ -java. Para obter instruções sobre como baixar e instalar esse aplicativo de amostra, consulte Instalando o aplicativo de amostra Amazon QLDB Java. Antes de solicitar uma exportação, siga as etapas de 1 a 3 em Tutorial de Java 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.

Classe Descrição
ExportJournal Exporta blocos de diário do ledger vehicle-registration de amostras para um intervalo de data e hora de 10 minutos atrás até agora. Grava os objetos de saída em um bucket S3 especificado ou cria um bucket exclusivo se não for fornecido.
DescribeJournalExport Descreve um trabalho de exportação de diário para um item especificado exportId no ledger vehicle-registration de amostra.
ListJournalExports Devolve uma lista de descrições de trabalhos de exportação de diários para o ledger vehicle-registration de amostra.
ValidateQldbHashChain Valida a cadeia de hash do ledger de vehicle-registration amostra usando um determinado exportId. Se não for fornecido, solicita uma nova exportação para usar na validação da cadeia de hash.

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 QLDB console ou as seguintes API operações 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 proporcionar uma experiência mais tranquila para as API operações que listam trabalhos de exportação de diários. QLDBremove trabalhos de exportação antigos para garantir que você veja apenas exportações recentes sem precisar analisar várias páginas de trabalhos.