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á.
CREATEINDEXcomando na Amazon QLDB
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
Na AmazonQLDB, use o CREATE INDEX comando para criar um índice para um campo de documento em uma tabela.
Para aprender a controlar o acesso para executar este comando do PartiQL em tabelas específicas, consulte Introdução ao modo de permissões padrão na Amazon QLDB.
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
listestruct. 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 tipolistcomo í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 = 123ouWHERE 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.
Sintaxe
CREATE INDEX ONtable_name(field)
Parâmetros
table_name-
O nome da tabela na qual você deseja qual criar o índice. A tabela já deve existir.
O nome da tabela diferencia maiúsculas de minúsculas.
field-
O nome do campo do documento para o qual criar o índice. O campo deve ser um atributo de nível superior.
Os nomes dos campos indexados diferenciam maiúsculas e minúsculas e podem ter no máximo 128 caracteres.
Você pode criar um índice em qualquer tipo de dados Amazon Ion, incluindo
listestruct. 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 tipolistcomo índice, você não pode fazer uma pesquisa indexada por um item dentro da lista.
Valor de retorno
tableId: o ID exclusivo da tabela na qual você criou o índice.
Exemplos
CREATE INDEX ON VehicleRegistration (LicensePlateNumber)
CREATE INDEX ON Vehicle (VIN)
Executar programaticamente usando o driver
Para saber como executar programaticamente essa instrução usando o QLDB driver, consulte os seguintes tutoriais em Introdução ao driver:
