Configurar uma tabela para indexação e pesquisa

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. 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 nos registros. Configure os atributos de indexação de texto da tabela, palavras irrelevantes e dicionários de sinônimos para controlar o comportamento da pesquisa.

    Antes de Iniciar

    Função necessária: ts_admin ou admin

    Por Que e Quando Desempenhar Esta Tarefa

    Habilitar a indexação de texto para uma tabela permite que os usuários pesquisem valores de cadeia de caracteres nos registros dessa tabela. Você pode configurar atributos, palavras irrelevantes e dicionários de sinônimos para controlar o comportamento de indexação e 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 aos dados principais
    • Tabelas relacionadas ao Connect
    • Tabela de tarefas
    • Tabela de Usuário
    Habilitar a indexação de texto para uma tabela também a habilita para todas as tabelas secundárias. Se você quiser desabilitar a indexação de texto para uma tabela secundária, consulte Remover o índice de texto de uma tabela secundária.
    Nota:
    Sempre que você cria uma tabela de índice, o sistema também cria funções de controle de acesso (ACLs) para novas tabelas.
    A indexação de texto pode ser uma tarefa que consome muitos recursos e pode demorar um pouco para ser concluída. Você pode notar uma degradação no 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 as estatísticas históricas de indexação de texto.
    Nota:

    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, você deve habilitar 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ê pretender usar a tabela em pesquisas de várias tabelas ou se quiser usar o algoritmo de pontuação BM25 na tabela, faça o upgrade do formato de indexação para V4.
      1. Se o valor em Formato não estiver esmaecido, selecione v4e, em seguida, 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 ter sua indexação 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 do índice.
      5. Em Links relacionados, selecione Fazer upgrade para V4 e Enviar.
        A indexação da tabela especificada foi 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 relacionadospara mostrar o formato de indexação da tabela na página Configuração do índice de texto.
    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 atributo da tabela de índice de texto, selecione Novo.
        Os atributos pertencem à forma como o Zing indexa documentos e classifica os documentos retornados nos resultados da pesquisa.
      3. No formulário Mapas de atributo da tabela de índice de texto, preencha os campos.
        Campo Descrição
        Tabela Tabela para definir atributos para.
        Nome de atributo Atributo do mecanismo de pesquisa. Para obter uma lista dos atributos e valores válidos, consulte Índice do Zing 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 de nível de 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 atributo 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. Somente tabelas no grupo de índices e suas tabelas secundárias são exibidas.
        Nome de atributo Atributo. Para obter uma lista dos atributos e valores válidos, consulte Índice do Zing 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 índices.
      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 ,umou um. Há uma lista global de palavras irrelevantes comuns, portanto, você só precisa adicionar palavras irrelevantes específicas para 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. Na guia Palavras irrelevantes do índice, selecione Novo.
      2. Em Índice, selecione o índice ao qual adicionar a palavra irrelevante.
      3. No Word, 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, automóvel. O Zing fornece um dicionário de sinônimos padrão.
      1. Na guia Dicionários de sinônimos do í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 opção de pesquisa de lista para texto aparece nas exibições de lista da tabela e 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 a tabela indexada em busca de correspondências de cadeia de caracteres usando os métodos GlideRecord.addQuery(name, value) ou GlideRecord.addEncodedQuery(name, value) com o nome reservado 123TEXTQUERY321. Para obter mais informações sobre como consultar correspondências de cadeia de caracteres, consulte Consulta de tabelas em 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 excluirá 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 os campos 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 o atributo no_text_index definido como verdadeiro.

    Para obter mais informações sobre este atributo, consulte Remover 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.