Configure uma tabela para indexação e pesquisa

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 6 min. de leitura
  • Habilite a indexação de texto do Zing para uma tabela para permitir que os usuários pesquisem valores de cadeia de caracteres em seus registros. Configure os atributos de indexação de texto da tabela, palavras irrelevantes e dicionários de sinônimos para controlar o comportamento de pesquisa.

    Antes de Iniciar

    Função necessária: ts_admin ou admin

    Por Que e Quando Desempenhar Esta Tarefa

    A habilitação da indexação de texto para uma tabela permite que os usuários pesquisem valores de cadeia de caracteres em registros nessa tabela. Você pode configurar atributos, palavras irrelevantes e dicionários de sinônimos para controlar a indexação e o comportamento de pesquisa de uma tabela indexada.

    Por padrão, o sistema cria índices de texto para as tabelas com um registro de índice de texto (Tudo > Definição do Sistema > Índices de Texto). Por exemplo:
    • Tabelas relacionadas ao conhecimento
    • Tabelas relacionadas a dados principais
    • Tabelas relacionadas ao Connect
    • Tabela de tarefas
    • Tabela de usuário
    A habilitação da indexação de texto para uma tabela também a habilita para todas as tabelas secundárias. Para desabilitar a indexação de texto para uma tabela secundária, consulte Remova o índice de texto de uma tabela secundária.
    Nota:
    Sempre que você cria uma tabela de índice, o sistema também cria ACLs (Funções de controle de acesso) para novas tabelas.
    A indexação de texto pode ser uma tarefa que consome muitos recursos e pode levar algum tempo para ser concluída. Você pode notar degradação de desempenho ou resultados de pesquisa incompletos durante a geração do índice. Para estimar a duração da indexação de texto, você pode exibir estatísticas históricas de indexação de texto .
    Nota:

    As novas tabelas criadas por transferências de conjunto de atualizações têm a indexação de texto desabilitada, mesmo se ela estiver habilitada para as tabelas incluídas no conjunto de atualizações.

    Para permitir que os usuários pesquisem tabelas criadas por transferências de conjunto de atualizações, habilite manualmente a indexação de texto para essas tabelas.

    Procedimento

    1. Navegar até Tudo > Definição do Sistema > Configurações do índice de texto e selecione Novo .
    2. Em Aplica-se a. , selecione Tabela .
    3. Em Tabela , selecione a tabela para a qual você deseja configurar a indexação de texto.
    4. Opcional: Se você pretende usar a tabela em pesquisas de várias tabelas ou se quiser usar o algoritmo de pontuação BM25 na tabela, atualize seu formato de indexação para V4.
      1. Se o valor em Formato não estiver esmaecido, selecione v4 e selecione Enviar e pule para a etapa 5.
      2. Se o valor em Formato estiver esmaecido, selecione Enviar .
        O valor esmaecido significa que a tabela já foi indexada e precisa que sua indexação seja atualizada para V4.
      3. Navegar até Tudo > Definição do Sistema > Configurações do índice de texto e selecione a tabela que você enviou.
      4. Em Links relacionados , selecione Mostrar registro de nome de índice .
      5. Em Links relacionados , selecione Upgrade para V4 e selecione Enviar .
        A indexação da tabela especificada é atualizada de V3 para V4. Agora, esta tabela pode fazer parte da indexação de várias tabelas e o BM25 é usado para pontuar a pontuação de relevância da tabela. Opcionalmente, selecione Mostrar configuração em Links relacionados para mostrar o formato de indexação da tabela no Configuração do índice de texto página.
    5. Configure atributos de indexação e pesquisa na tabela selecionada.
      1. Navegar até Tudo > Definição do Sistema > Configurações do índice de texto e selecione a tabela que você configurou.
      2. Na lista relacionada Mapas de atributos da tabela de índice de texto, selecione Novo .
        Os atributos pertencem à maneira como o Zing indexa documentos e classifica os documentos retornados nos resultados da pesquisa.
      3. No formulário Mapas de atributos da tabela de índice de texto, preencha os campos.
        Campo Descrição
        Tabela Tabela para definir atributos.
        Nome de atributo Atributo do mecanismo de pesquisa. Para obter uma lista de atributos e valores válidos, consulte Zing índice e atributos de pesquisa .
        Valor Valor do atributo.
      4. Repita este procedimento para definir atributos adicionais para a tabela.
      5. Na seção Links relacionados, selecione Gerar índice de texto .
    6. Configure atributos no nível da coluna.
      1. Navegar até Tudo > Definição do Sistema > Configurações do índice de texto e selecione uma tabela.
      2. Na lista relacionada Mapas de atributos da coluna de índice de texto, selecione Novo .
      3. No formulário Mapa de atributos da coluna de índice de texto, preencha os campos.
        Campo Descrição
        Tabela Tabela que contém a coluna para a qual você deseja definir atributos. São exibidas somente tabelas no grupo de índices e suas tabelas secundárias.
        Nome de atributo Atributo. Para obter uma lista de atributos e valores válidos, consulte Zing índice e atributos de pesquisa .
        Coluna O nome da coluna na tabela selecionada à qual você deseja aplicar o atributo de pesquisa.
        Valor Valor do atributo.
      4. Selecione Enviar.
      5. Repita este procedimento para definir parâmetros adicionais do mecanismo de pesquisa para colunas da tabela no grupo de índice.
      6. Na seção Links relacionados, selecione Gerar índice de texto .
    7. Opcional: Adicione palavras irrelevantes.
      Palavras irrelevantes são palavras que você não deseja indexar, como . , a , ou um . Há uma lista global de palavras irrelevantes comuns, portanto, você só precisa adicionar palavras irrelevantes específicas à sua situação. Para ver a lista global de palavras irrelevantes, navegue no navegador até https://<instance name>.service-now.com/ts_stop_list.do .
      1. Em Palavras irrelevantes do índice , selecione Novo .
      2. Em Índice , selecione o índice ao qual adicionar a palavra de interrupção.
      3. Em Palavra , insira uma única palavra que você não deseja indexar e selecione Enviar .
    8. Opcional: Adicione um dicionário de sinônimos.
      Especificar um dicionário de sinônimos pesquisa o termo de pesquisa, bem como sinônimos do termo de pesquisa, como carro, e seu sinônimo, auto. Zing fornece um dicionário de sinônimos padrão.
      1. Em Dicionários de sinônimos de índice , selecione Novo .
      2. Em Índice , selecione o índice ao qual adicionar as palavras irrelevantes.
      3. Em Dicionário de sinônimos , selecione o dicionário de sinônimos a ser usado na tabela especificada.
        Para adicionar um dicionário, selecione Novo e siga o procedimento em Criar dicionários de sinônimos .

    Resultado

    A pesquisa de lista para texto a opção aparece nas exibições de lista da tabela e de suas tabelas secundárias.

    O que Fazer Depois

    Você pode pesquisar registros na tabela indexada usando a pesquisa de lista na exibição de formulário. Para saber mais sobre como usar a pesquisa de lista, consulte A pesquisa de lista encontra registros da tabela atual.

    Você também pode consultar correspondências de cadeia de caracteres na tabela indexada usando GlideRecord.addQuery(nome, valor) ou GlideRecord.addEncodedQuery(nome, valor) métodos com 123TEXTQUERY321 nome reservado. Para obter mais informações sobre consultar correspondências de cadeia de caracteres, consulte Consultando tabelas no script .

    Campos excluídos da indexação de texto

    A indexação de texto exclui campos que atendem a determinadas condições de nome, tipo, atributo ou criptografia. As pesquisas do usuário não correspondem ou retornam valores de campos excluídos.

    A indexação de texto exclui um campo se ele atender a qualquer uma das condições na tabela a seguir.
    Categoria Descrição
    Nome do campo A indexação de texto inclui o. sys_class_name e. sys_tags mas exclui todos os outros campos cujos nomes começam com sys_ .
    Tipo de campo
    A indexação de texto exclui campos destes tipos:
    • Data
    • Data/Hora
    • Duração
    • Verdadeiro/Falso
    • Fluxo de trabalho

    Para obter mais informações sobre esses tipos, consulte Referência de tipos de campo.

    Atributos de campo

    A indexação de texto exclui campos que têm no_text_index atributo definido como verdadeiro.

    Para obter mais informações sobre esse atributo, consulte Remova um índice de um campo específico.

    Criptografia de campo

    A indexação de texto exclui campos configurados para Edge Encryption.

    Para obter mais informações sobre como configurar campos com Edge Encryption, consulte Criptografar campos usando configurações de criptografia .