Criação de tabelas com índices e inserção de documentos - Banco de dados Amazon Quantum Ledger (AmazonQLDB)
Criar tabelas e índicesInserir documentos

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

Criação de tabelas com índices e inserção de documentos

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

Depois de criar um QLDB livro contábil da Amazon, sua primeira etapa é criar uma tabela com uma CREATE TABLE declaração básica. As tabelas consistem em QLDBdocumentos, que são conjuntos de dados no formato Amazon Ion struct.

Criar tabelas e índices

As tabelas têm nomes simples que diferenciam maiúsculas de minúsculas, sem namespaces. QLDBoferece suporte a conteúdo aberto e não impõe esquema, portanto, você não define atributos ou tipos de dados ao criar tabelas.

CREATE TABLE VehicleRegistration
CREATE TABLE Vehicle

Uma instrução CREATE TABLE retorna o ID atribuído pelo sistema da nova tabela. Todos os sistemas atribuídos IDs em QLDB são identificadores universalmente exclusivos (UUID), cada um representado em uma string codificada em Base62.

nota

Opcionalmente, você pode definir tags para um recurso de tabela ao criar a tabela. Para saber como, consulte Marcar tabelas na criação.

Também é possível criar índices em tabelas para otimizar a performance da consulta.

CREATE INDEX ON VehicleRegistration (VIN)
CREATE INDEX ON VehicleRegistration (LicensePlateNumber)
CREATE INDEX ON Vehicle (VIN)
Importante

QLDBrequer um índice para pesquisar um documento com eficiência. Sem um índice, QLDB precisa fazer uma digitalização completa da tabela ao ler documentos. Isso pode causar problemas de desempenho 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 (= ou IN) em um campo indexado ou em um ID de documento. Para ter mais informações, consulte Otimizar a performance da consulta.

Observe as seguintes restrições ao criar índices:

  • Um índice só pode ser criado em um único campo de nível superior. Não há suporte para índices compostos, aninhados, exclusivos e baseados em funções.

  • Você pode criar um índice em qualquer tipo de dados Ion, incluindo list e struct. No entanto, você só pode fazer a pesquisa indexada pela igualdade de todo o valor de Ion, independentemente do tipo de Ion. Por exemplo, ao usar um tipo list como índice, você não pode fazer uma pesquisa indexada por um item dentro da lista.

  • O desempenho da consulta é aprimorado somente quando você usa um predicado de igualdade; por exemplo, WHERE indexedField = 123 ou WHERE indexedField IN (456, 789).

    QLDBnão respeita as desigualdades nos predicados de consulta. Como resultado, as verificações filtradas por intervalo não são implementadas.

  • Os nomes dos campos indexados diferenciam maiúsculas e minúsculas e podem ter no máximo 128 caracteres.

  • A criação do índice em QLDB é assíncrona. O tempo necessário para concluir a criação de um índice em uma tabela não vazia varia dependendo do tamanho da tabela. Para ter mais informações, consulte Gerenciamento de Índices.

Inserir documentos

Depois, você pode inserir documentos em suas tabelas. QLDBos documentos são armazenados no formato Amazon Ion. As instruções INSERT partiQL a seguir incluem um subconjunto dos dados de amostra de registro do veículo usados em Começando a usar o QLDB console da Amazon.

INSERT INTO VehicleRegistration
<< {
    'VIN' : '1N4AL11D75C109151',
    'LicensePlateNumber' : 'LEWISR261LL',
    'State' : 'WA',
    'City' : 'Seattle',
    'PendingPenaltyTicketAmount' : 90.25,
    'ValidFromDate' : `2017-08-21T`,
    'ValidToDate' : `2020-05-11T`,
    'Owners' : {
        'PrimaryOwner' : { 'PersonId' : '294jJ3YUoH1IEEm8GSabOs' },
        'SecondaryOwners' : [ { 'PersonId' : '5Ufgdlnj06gF5CWcOIu64s' } ]
    }
},
{
    'VIN' : 'KM8SRDHF6EU074761',
    'LicensePlateNumber' : 'CA762X',
    'State' : 'WA',
    'City' : 'Kent',
    'PendingPenaltyTicketAmount' : 130.75,
    'ValidFromDate' : `2017-09-14T`,
    'ValidToDate' : `2020-06-25T`,
    'Owners' : {
        'PrimaryOwner' : { 'PersonId': 'IN7MvYtUjkp1GMZu0F6CG9' },
        'SecondaryOwners' : []
    }
} >>
INSERT INTO Vehicle
<< {
    'VIN' : '1N4AL11D75C109151',
    'Type' : 'Sedan',
    'Year' : 2011,
    'Make' : 'Audi',
    'Model' : 'A5',
    'Color' : 'Silver'
} ,
{
    'VIN' : 'KM8SRDHF6EU074761',
    'Type' : 'Sedan',
    'Year' : 2015,
    'Make' : 'Tesla',
    'Model' : 'Model S',
    'Color' : 'Blue'
} >>
Sintaxe e semântica do PartiQL

  • Os nomes dos campos estão entre aspas simples ('...').

  • Os valores da string também estão entre aspas simples ('...').

  • Os carimbos de data/hora estão entre acentos graves (`...`). Os acentos graves podem ser usados para denotar qualquer literal de Ion.

  • Números inteiros e decimais são valores literais que não precisam ser indicados.

Para obter mais detalhes sobre a sintaxe e a semântica do partiQL, consulte Consultando o Ion com o PartiQL na Amazon QLDB.

Uma instrução INSERT cria a revisão inicial de um documento com um número de versão zero. Para identificar cada documento de forma exclusiva, QLDB atribua uma ID do documento como parte dos metadados. As instruções de inserção retornam o ID de cada documento inserido.

Importante

Como QLDB não impõe o esquema, você pode inserir o mesmo documento em uma tabela várias vezes. Cada declaração inserida confirma uma entrada de documento separada no diário e QLDB atribui a cada documento uma ID exclusiva.

Para saber como consultar os documentos que você inseriu na tabela, vá para Consultar seus dados.