Todos os produtos
Search

Este produto

    Tablestore:Criar um índice de pesquisa

    Central de documentação

    Tablestore:Criar um índice de pesquisa

    Última atualização: Jul 03, 2026

    Um índice de pesquisa usa um índice invertido e um armazenamento em colunas para permitir consultas complexas e multidimensionais, além de análises estatísticas em grandes conjuntos de dados. Crie um índice de pesquisa para uma tabela de dados a fim de acelerar as consultas. Ao criar o índice, adicione os campos que deseja consultar. Também é possível definir opções avançadas, como chave de roteamento, Time to Live (TTL) e pré-ordenação.

    Observações de uso

    • Inclua todos os campos necessários para consulta em um único índice de pesquisa. Evite criar um índice separado para cada campo.

    • A inicialização do índice de pesquisa pode levar alguns segundos após a criação. Durante esse período, as gravações na tabela de dados não são afetadas, mas não é possível consultar o índice ou seus metadados.

    • Para obter informações sobre os limites de número de linhas, tamanho total e quantidade de campos de um índice de pesquisa, consulte Limites do índice de pesquisa.

    Procedimento

    1. Acesse a aba Indexes.

      1. Faça login no console do Tablestore.

      2. Na barra de navegação superior, selecione um grupo de recursos e uma região.

      3. Na página Overview, clique em nome de uma instância ou em Manage Instance na coluna Actions.

      4. Na aba Instance Details, na seção Tables, clique em nome de uma tabela de dados ou em Indexes na coluna Actions.

    2. Na aba Indexes, clique em Create Search Index.

    3. Na caixa de diálogo Create Index, configure o índice de pesquisa.

      1. O sistema gera um nome de índice automaticamente. Use o nome sugerido ou especifique um nome personalizado.

      2. Selecione um tipo de geração de esquema.

        Importante

        • Os campos Field Name e Field Type devem corresponder aos respectivos campos na tabela de dados. Para ver os mapeamentos entre os tipos de campo da tabela de dados e do índice de pesquisa, consulte Tipos de dados.

        • Para destacar conteúdo que atenda a condições específicas em um campo do tipo Text, ative o realce para esse campo. Para mais detalhes, consulte resumo e realce.

        • Caso defina o tipo de geração de esquema como Manual, insira o nome do campo, selecione o tipo de campo e especifique se deve ativar Array para cada campo.

        • Ao definir o tipo de geração de esquema como Auto Generate, o Tablestore usa automaticamente a chave primária e as colunas de atributos da tabela de dados como campos de índice. Em seguida, selecione o tipo de campo e indique se deve ativar Array para cada um.

        Nota

        Em determinados cenários, use uma coluna virtual para otimizar o desempenho das consultas.

      3. Para ajustar opções como Time to Live, chave de roteamento ou pré-ordenação, ative as Advanced Settings e configure os parâmetros conforme descrito na tabela a seguir.

        Parâmetro

        Descrição

        routing key

        Defina os campos para roteamento de dados. Selecione uma ou mais colunas de chave primária como campos de roteamento, embora geralmente uma seja suficiente. Se você selecionar vários campos, seus valores serão concatenados para formar uma única chave de roteamento.

        O sistema indexa registros com o mesmo valor de chave de roteamento na mesma partição de dados.

        Time to Live

        Período de retenção dos dados no índice de pesquisa, em segundos. O valor padrão é -1, indicando que os dados nunca expiram.

        O valor deve ser de pelo menos 86.400 segundos (um dia) ou -1. O Time to Live (TTL) do índice de pesquisa precisa ser menor ou igual ao TTL da tabela de dados correspondente.

        Defina um TTL para excluir dados expirados automaticamente. A exclusão ocorre quando a idade dos dados ultrapassa o valor configurado.

        pre-sorting

        Define a ordem de classificação padrão para os resultados das consultas. Essa configuração determina a ordenação física dos dados dentro do índice de pesquisa.

        A pré-ordenação suporta classificação por chave primária ou por um valor de campo específico. Sem uma ordem personalizada, o índice adota a classificação por chave primária como padrão. Escolha o método mais adequado aos seus padrões de consulta.

        Importante

        Índices de pesquisa contendo campos do tipo Nested não suportam pré-ordenação.

    4. Clique em OK.

      Após a criação do índice de pesquisa, visualize seus detalhes — incluindo informações básicas, métricas, chave de roteamento, campos indexados e configurações de pré-ordenação — clicando em Index Details na coluna Actions da lista de índices.

    Integração de desenvolvimento

    Use os SDKs do Tablestore ou o CLI do Tablestore para criar um índice de pesquisa.

    Tópicos relacionados