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á.
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
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
A 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 em. QLDB
Tópicos
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 (
=
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 — 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 |
---|---|
|
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
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 |