Acessando a Amazon QLDB usando o console

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

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

Você pode usar o console para fazer o seguinte emQLDB:

• Criar, excluir, descrever e listar ledgers.

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

• Gerencie tags para QLDB recursos.

• Verifique os dados do diário criptograficamente.

• Exporte ou transmita blocos de diários.

Para saber como criar um QLDB livro contábil da Amazon e configurá-lo com exemplos de dados do aplicativo, consulteComeçando a usar o QLDB console da Amazon.

Referência rápida do editor PartiQL

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

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

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

Dicas rápidas do partiQL em QLDB

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

• Entenda os limites de simultaneidade e transação — Todas as declarações, incluindo SELECT consultas, estão sujeitas a conflitos otimistas de controle de simultaneidade (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 — 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

QLDBsuporta os seguintes comandos partiQL.

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.
CREATE TABLE	Cria uma tabela do .
DROP INDEX	Exclua um índice de uma tabela.
DROP TABLE	Desativa uma tabela existente.
UNDROP TABLE	Reativa uma tabela inativa.

Linguagem de manipulação de dados () DML
Comando	Descrição
DELETE	Marca um documento ativo como excluído criando uma nova revisão final do documento.
FROM(INSERT,REMOVE, ouSET)	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.

DMLexemplos de declarações

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.

QLDBsuporta as seguintes visualizações de uma tabela definidas pelo sistema.

Visão	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

QLDBsuporta 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 QLDB do sistema, incluindo nomes de campos e nomes de tabelas, diferenciam maiúsculas de minúsculas.

Atalhos de teclado do editor PartiQL

O editor partiQL no QLDB console 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