Acessar o Amazon QLDB usando o console - Amazon Quantum Ledger Database (Amazon QLDB)

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

Acessar o Amazon QLDB usando o console

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 Aurora PostgreSQL.

Você pode acessar o AWS Management Console para Amazon QLDB em https://console.aws.amazon.com /qldb.

Você pode usar o console para fazer o seguinte no QLDB:

  • Criar, excluir, descrever e listar ledgers.

  • Execute instruções partiQL usando o editor partiQL.

  • Gerencie tags para recursos do QLDB.

  • Verifique os dados do diário criptograficamente.

  • Exporte ou transmita blocos de diários.

Para saber como criar um livro contábil do Amazon QLDB e configurá-lo com exemplos de dados do aplicativo, consulte Conceitos básicos do console do Amazon QLDB.

Referência rápida do editor PartiQL

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 Aurora PostgreSQL.

O Amazon QLDB oferece suporte a um subconjunto do PartiQL como linguagem de consulta e ao Amazon Ion como formato de dados orientado a documentos. Para obter um guia completo e informações mais detalhadas sobre a implementação do PartiQL no QLDB, consulte o Amazon QLDB PartiQL Reference.

Os tópicos a seguir fornecem uma visão geral rápida de como usar o PartiQL no QLDB.

Dicas rápidas do PartiQL no QLDB

A seguir está um breve resumo das dicas e das melhores práticas para trabalhar com o PartiQL no QLDB:

  • Entenda os limites de simultaneidade e transação: todas as instruções, incluindo consultas SELECT, estão sujeitas a conflitos controle de simultaneidade otimista (OCC) e limites de transação, incluindo um tempo limite de transação de 30 segundos.

  • Use índices: use índices de alta cardinalidade e execute consultas direcionadas para otimizar suas declarações e evitar a varredura completa da tabela. Para saber mais, consulte Otimizar a performance da consulta.

  • Use predicados de igualdade: as pesquisas indexadas exigem um operador de igualdade (= ou IN). Operadores de desigualdade (<, >, LIKE, BETWEEN) não se qualificam para pesquisas indexadas e resultam em verificações de tabela completa.

  • Use somente junções internas: o QLDB suporta somente junções internas. Como prática recomendada, junte em campos indexados para cada tabela que você está unindo. Escolha índices de alta cardinalidade para os critérios de junção e os predicados de igualdade.

Comandos

O QLDB oferece suporte aos comandos PartiQL a seguir.

Linguagem de definição de dados (DDL)
Comando Descrição
CREATE INDEX Cria um índice para um campo de documento de nível superior em uma tabela.
CRIAR TABELA Cria uma tabela do .
DROP INDEX Exclua um índice de uma tabela.
DESCARTAR TABELA Desativa uma tabela existente.
UNDROP TABLE Reativa uma tabela inativa.
DML (Data Manipulation Language)
Comando Descrição
DELETE Marca um documento ativo como excluído criando uma nova revisão final do documento.
FROM (INSERIR, REMOVER ou DEFINIR) Semanticamente o mesmo que UPDATE.
INSERT Adiciona um ou mais documentos a uma tabela.
SELECT Recupera até itens de uma ou mais tabelas.
UPDATE Atualiza, insere ou remove elementos específicos em um documento.

Exemplos de instruções DML

INSERT

INSERT INTO VehicleRegistration VALUE { 'VIN' : 'KM8SRDHF6EU074761', --string 'RegNum' : 1722, --integer 'PendingPenaltyTicketAmount' : 130.75, --decimal 'Owners' : { --nested struct 'PrimaryOwner' : { 'PersonId': '294jJ3YUoH1IEEm8GSabOs' }, 'SecondaryOwners' : [ --list of structs { 'PersonId' : '1nmeDdLo3AhGswBtyM1eYh' }, { 'PersonId': 'IN7MvYtUjkp1GMZu0F6CG9' } ] }, 'ValidToDate' : `2020-06-25T` --Ion timestamp literal with day precision }

UPDATE-INSERT

UPDATE Vehicle AS v INSERT INTO v VALUE 26500 AT 'Mileage' WHERE v.VIN = '1N4AL11D75C109151'

UPDATE-REMOVE

UPDATE Person AS p REMOVE p.Address WHERE p.GovId = '111-22-3333'

SELECT: subconsulta correlacionada

SELECT r.VIN, o.SecondaryOwners FROM VehicleRegistration AS r, @r.Owners AS o WHERE r.VIN IN ('1N4AL11D75C109151', 'KM8SRDHF6EU074761')

SELECT: junção interna

SELECT v.Make, v.Model, r.Owners FROM VehicleRegistration AS r INNER JOIN Vehicle AS v ON r.VIN = v.VIN WHERE r.VIN IN ('1N4AL11D75C109151', 'KM8SRDHF6EU074761')

SELECT: obtenha o ID do documento usando a cláusula BY

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

Visualizações definidas pelo sistema.

O QLDB oferece suporte às seguintes visualizações de tabela definidas pelo sistema.

Visualizar Descrição
table_name A visualização padrão do usuário de uma tabela que inclui somente o estado atual dos dados do usuário.
_ql_committed_table_name A visualização confirmada completa definida pelo sistema de uma tabela que inclui o estado atual dos dados do usuário e dos metadados gerados pelo sistema, como um ID de documento.
history(table_name) A função de histórico integrada que retorna o histórico completo de revisão de uma tabela.

Regras de sintaxe básica

O QLDB suporta as seguintes regras básicas de sintaxe para partiQL.

Caractere Descrição
' Aspas simples denotam valores de string ou nomes de campos nas estruturas Amazon Ion.
" As aspas duplas denotam identificadores entre aspas, como uma palavra reservada usada como nome de tabela.
` Os acentos graves denotam valores literais de Ion.
. A notação de pontos acessa os nomes dos campos de uma estrutura principal.
[ ] Os colchetes definem um list Ion ou denotam um número ordinal baseado em zero para uma lista existente.
{ } Chavetas definem um struct Ion.
<< >> Os colchetes angulares duplos definem uma bolsa PartiQL, que é uma coleção não ordenada. Você usa uma sacola para inserir vários documentos em uma tabela.
Diferenciação de letras maiúsculas e minúsculas Todos os nomes de objetos do sistema QLDB, incluindo nomes de campos e nomes de tabelas, diferenciam maiúsculas de minúsculas.

Atalhos de teclado do editor PartiQL

O editor partiQL no console QLDB oferece suporte aos seguintes atalhos de teclado.

Ação macOS Windows
Executar Cmd+Return Ctrl+Enter
Comentário Cmd+/ Ctrl+/
Clear Cmd+Shift+Delete Ctrl+Shift+Delete