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

# Etapa 5: Visualizar o histórico de revisão de um documento
<a name="getting-started-step-5"></a>

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

Depois de modificar os dados de registro do carro com o VIN ` 1N4AL11D75C109151`, você pode consultar o histórico de todos os proprietários registrados e quaisquer outros campos atualizados. Você pode ver todas as revisões de um documento que inseriu, atualizou e excluiu consultando a [Função de histórico](working.history.md#working.history.function) incorporada.

A função de histórico retorna revisões da *visualização confirmada* de sua tabela, que inclui os dados do aplicativo e os metadados associados. Os metadados mostram exatamente quando cada revisão foi feita, em que ordem e qual transação as confirmou.

Nesta etapa, você consulta o histórico de revisão de um documento na tabela `VehicleRegistration` do ledger `vehicle-registration`.

**Visualizar o histórico de revisão**

1. [Abra 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 **Editor PartiQL**.

1. Escolha o ledger `vehicle-registration`.

1. Para consultar o histórico de um documento, comece encontrando seu `id` único. Além de consultar a visualização confirmada, outra forma de obter um documento `id` é usar a palavra-chave `BY` na visualização padrão do usuário da tabela. Para saber mais, consulte [Usar a cláusula BY para consultar o ID do documento](working.metadata.by-clause.md).

   Na janela do editor de consulta, insira a instrução a seguir e, em seguida, escolha **Executar**.

   ```
   SELECT r_id FROM VehicleRegistration AS r BY r_id
   WHERE r.VIN = '1N4AL11D75C109151'
   ```

1. Em seguida, você pode usar esse valor `id` para consultar a função de histórico. Insira a instrução a seguir e escolha **Executar**. Certifique-se de substituir o valor `id` pelo seu próprio ID do documento, conforme apropriado.

   ```
   SELECT h.data.VIN, h.data.City, h.data.Owners
   FROM history(VehicleRegistration) AS h
   WHERE h.metadata.id = 'ADR2LQq48kB9neZDupQrMm' --replace with your id
   ```
**nota**  
Para os fins deste tutorial, essa consulta de histórico retorna todas as revisões do ID `ADR2LQq48kB9neZDupQrMm` do documento. Como prática recomendada, no entanto, qualifique uma consulta de histórico com um ID do documento e um intervalo de datas (hora de início e hora de término).  
No QLDB, cada consulta `SELECT` é processada em uma transação e está sujeita a um [tempo limite de transação](limits.md#limits.fixed). As consultas de histórico que incluem uma hora de início e uma hora de término ganham o benefício da qualificação por intervalo de datas. Para obter mais informações, consulte [Função de histórico](working.history.md#working.history.function).

   A função de histórico retorna documentos no mesmo esquema da visualização confirmada. Este exemplo projeta seus dados de registro de veículos modificados. A saída deve ser semelhante à seguinte.  
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/qldb/latest/developerguide/getting-started-step-5.html)
**nota**  
A consulta do histórico pode nem sempre retornar as revisões do documento em ordem sequencial.

   Analise a saída e confirme se as alterações refletem o que você fez em [Etapa 4: Modificar documentos em um ledger](getting-started-step-4.md).

1. Em seguida, você pode inspecionar os metadados do documento de cada revisão. Insira a instrução a seguir e escolha **Executar**. Novamente, certifique-se de substituir o valor `id` pelo seu próprio ID do documento, conforme apropriado.

   ```
   SELECT VALUE h.metadata
   FROM history(VehicleRegistration) AS h
   WHERE h.metadata.id = 'ADR2LQq48kB9neZDupQrMm' --replace with your id
   ```

   A saída deve ser semelhante à seguinte.  
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/qldb/latest/developerguide/getting-started-step-5.html)

   Esses campos de metadados fornecem detalhes sobre quando cada item foi modificado e por qual transação. A partir desses dados, você pode deduzir o seguinte:
   + O documento é identificado exclusivamente por seu `id` atribuído pelo sistema: `ADR2LQq48kB9neZDupQrMm`. Esse é um identificador universalmente exclusivo (UUID) representado em uma string codificada em Base62.
   + O `txTime` mostra que a revisão inicial do documento (versão `0`) foi criada em `2019-05-23T19:20:360d-3Z`.
   + Cada transação subsequente cria uma nova revisão com o mesmo documento `id`, um número de versão incrementado e `txId` e `txTime` atualizados.

Para verificar uma revisão de documento criptograficamente no ledger `vehicle-registration`, vá para [Etapa 6: verificar um documento em um ledger](getting-started-step-6.md).