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
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
O Amazon QLDB oferece suporte a um subconjunto do PartiQL
Os tópicos a seguir fornecem uma visão geral rápida de como usar o PartiQL no QLDB.
Tópicos
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 (
=
ouIN
). 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.
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. |
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 |
---|---|
|
A visualização padrão do usuário de uma tabela que inclui somente o estado atual dos dados do usuário. |
_ql_committed_ |
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( |
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 |