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 3: consultar as tabelas em um ledger
<a name="getting-started-step-3"></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 criar tabelas em um ledger do Amazon QLDB e carregá-las com dados, você pode executar consultas para revisar os dados de registro do veículo que você acabou de inserir. O QLDB usa o PartiQL como sua linguagem de consulta e o Amazon Ion como seu modelo de dados orientado a documentos.

O partiQL é uma linguagem de consulta de código aberto compatível com SQL que foi estendida para funcionar com o Ion. Com o partiQL, você pode inserir, consultar e gerenciar seus dados com operadores SQL conhecidos. O Amazon Ion é um superconjunto do JSON. O Ion é um formato de dados de código aberto baseado em documentos que oferece a flexibilidade de armazenar e processar dados estruturados, semiestruturados e aninhados.

Nesta etapa, você pode usar instruções `SELECT` para ler os dados das tabelas no ledger `vehicle-registration`.

**Atenção**  
Quando você executa uma consulta no QLDB sem uma pesquisa indexada, ela invoca uma verificação completa da tabela. O partiQL suporta essas consultas porque é compatível com SQL. No entanto, *não* execute varreduras de tabela para casos de uso de produção no QLDB. Verificações de tabela podem causar problemas de performance em tabelas grandes, incluindo conflitos de simultaneidade e tempos limite de transação.  
Para evitar verificações de tabelas, você deve executar instruções com uma cláusula de predicado `WHERE` usando um operador de *igualdade* em um campo indexado ou em um ID de documento, por exemplo, `WHERE indexedField = 123` ou `WHERE indexedField IN (456, 789)`. Para obter mais informações, consulte [Otimizar a performance da consulta](working.optimize.md).

**Para consultar as tabelas**

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. Na janela do editor de consultas, insira a seguinte instrução para consultar a tabela `Vehicle` de um determinado número de identificação do veículo (VIN) que você adicionou ao ledger e escolha **Executar**.

   Para executar a instrução, você também pode usar o atalho de teclado Ctrl\$1Enter para Windows ou Cmd\$1Return para macOS. Para obter mais atalhos de teclado, consulte [Atalhos de teclado do editor PartiQL](console_QLDB.md#console_QLDB.partiql-editor-shortcuts).

   ```
   SELECT * FROM Vehicle AS v
   WHERE v.VIN = '1N4AL11D75C109151'
   ```

1. Você pode escrever consultas de junção internas. Este exemplo de consulta une `Vehicle` a `VehicleRegistration` e retorna as informações de registro junto com os atributos do veículo registrado para um determinado `VIN`.

   Insira a instrução a seguir e escolha **Executar**.

   ```
   SELECT v.VIN, r.LicensePlateNumber, r.State, r.City, r.Owners
   FROM Vehicle AS v, VehicleRegistration AS r
   WHERE v.VIN = '1N4AL11D75C109151'
   AND v.VIN = r.VIN
   ```

   Você também pode unir as tabelas `Person` e `DriversLicense` para ver os atributos relacionados aos motoristas que foram adicionados ao ledger.

   Repita esta etapa para o seguinte.

   ```
   SELECT * FROM Person AS p, DriversLicense AS l
   WHERE p.GovId = l.LicensePlateNumber
   ```

Para saber mais sobre a modificação de documentos nas tabelas do ledger `vehicle-registration`, consulte [Etapa 4: Modificar documentos em um ledger](getting-started-step-4.md).