Configurar um grupo de índice de texto para pesquisar em várias tabelas

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 6 min. de leitura

    • Atualize tabelas para o formato de indexação V4 e inclua-as em um grupo de índice de texto para facilitar a pesquisa em várias tabelas.

    Antes de Iniciar

    Função necessária: ts_admin ou admin

    Por Que e Quando Desempenhar Esta Tarefa

    Os grupos de índice de texto permitem indexar e pesquisar em várias tabelas.

    Realizar pesquisas em várias tabelas requer a normalização das tabelas primeiro para que as pontuações de relevância tenham o mesmo significado para todas as tabelas. A indexação V4 fornece essa normalização. O Zing usa a função de classificação Okapi BM25 para calcular a pontuação de relevância dos resultados da pesquisa.

    O formato de indexação de tabela V4 é otimizado para documentação, como artigos da base de conhecimento. Você não precisa reindexar tabelas que usam esse formato ao alterar o valor de um atributo de indexação, como o peso de um campo. Se você quiser usar a função de classificação BM25 em uma única tabela, poderá convertê-la para o formato V4.

    Para habilitar a pesquisa em várias tabelas, você:
    1. Configure todas as tabelas escolhidas para usar o formato de índice V4, caso ainda não o usem.
      Nota:
      Em novas instâncias, as tabelas Item do catálogo [sc_cat_item], Conhecimento [kb_knowledge], Perguntas e respostas sociais [kb_social_qa_question] e Usuário [sys_user] usam o formato de índice V4. Se você atualizar sua instância de uma versão anterior, o formato de indexação dessas tabelas permanecerá o mesmo da versão mais antiga.
    2. Adicione as tabelas a um grupo de índice de texto para que elas possam ser indexadas e pesquisadas juntas.
      Nota:
      Você não pode adicionar a tabela Tarefa [task] ou tabelas que a estendam para um grupo de índice de texto.

    Procedimento

    1. Configure as tabelas que você deseja incluir em várias pesquisas de tabela para usar o formato de índice V4.
      Nota:
      Atualizar da V3 para a V4 é fácil. O downgrade de V4 para V3 é mais difícil e desencorajado.
      1. Navegar até Todos > Definição do Sistema > Configurações do índice de texto.
      2. Abra o registro da tabela que você deseja atualizar para o formato de índice V4.
      3. Se o formato não estiver desabilitado, selecione V4, selecione Enviare pule para a etapa 2.
        Você pode escolher a formatação de índice nesta etapa porque não existe nenhum índice para a tabela.
      4. Se o formato estiver desabilitado, selecione o link relacionado Mostrar registro de nome de índice.
        O campo desabilitado significa que já existe um índice para a tabela e você deve atualizar explicitamente o formato do índice.
        A página Índice de texto é exibida.
      5. Selecione o link relacionado Atualizar para V4 e selecione OK.
        O sistema programa uma tarefa para atualizar o índice de texto de V3 para V4, permitindo que esta tabela participe da indexação de várias tabelas.
    2. Crie um grupo de índice de texto que especifica as tabelas que você deseja indexar juntas para que você possa pesquisá-las juntas.
      1. Navegar até Todos > Definição do Sistema > Grupos de Índice de Texto.
      2. Selecione Novo.
      3. Insira os seguintes valores de campo:
        Campo Valor
        Rótulo Nome do grupo de tabelas que você deseja indexar e pesquisar juntos.
        Tabelas Lista de tabelas que você deseja incluir no grupo de índice de texto.

        Você pode adicionar tabelas formatadas com V3 e V4 a grupos de índice de texto. Se você adicionar tabelas V3, o grupo de índice de texto permanecerá inativo.

      4. Selecione Enviar.
    3. Configure a indexação e os atributos de pesquisa em tabelas em um grupo de índice de texto.
      1. Navegar até Todos > Definição do Sistema > Configurações do índice de texto.
      2. Selecione Novo.
        O formulário de configuração de índice de texto é exibido. Se você já tiver um grupo de índice de texto na lista, pule para a etapa 3.d.
      3. Em Aplica-se a, selecione Grupo de índices.
      4. Em Grupo de índice, selecione a lupa e selecione o grupo de índice de texto que você criou e selecione Enviar.
        Os únicos grupos de índice de texto exibidos são aqueles que você já criou.
        A tabela Configuração de índice de texto é exibida.
      5. Abra o registro do seu grupo de índice de texto.
      6. Na guia Mapas de atributos da tabela de índice de texto, selecione Novo.
        O formulário Mapa de atributos da tabela de índice de texto é exibido. Os atributos pertencem à maneira como o Zing indexa ou pesquisa tabelas individuais no grupo de índices de texto.
      7. Em Tabela, selecione uma tabela para definir atributos.
        Somente tabelas no grupo de índice de texto especificado e suas tabelas secundárias são exibidas.
      8. Em Nome do atributo, selecione a lupa e selecione um atributo.
        Para ver a lista de atributos, insira ts_configuration_attribute.list no navegador de aplicações. Para obter definições de atributo, consulte Índice do Zing e atributos de pesquisa.
      9. Em Valor, insira um valor e selecione Enviar.
        Os valores válidos dependem do atributo. Para obter informações sobre valores válidos, consulte Índice do Zing e atributos de pesquisa.
      10. Repita este procedimento para definir parâmetros de mecanismo de pesquisa adicionais para outras tabelas no grupo de índice de texto.
      11. Em Links relacionados, selecione Gerar índice de texto.
    4. Configure os parâmetros de pesquisa em colunas de tabela individuais no grupo de índice de texto.
      1. Navegar até Todos > Definição do Sistema > Configurações do índice de texto.
      2. Abra o registro do seu grupo de índice de texto.
      3. Na guia Mapas de atributos da coluna de índice de texto, selecione Novo.
        O formulário Mapa de atributos da coluna de índice de texto é exibido. Os atributos pertencem à maneira como o Zing indexa ou pesquisa colunas de tabela individuais no grupo de índice de texto.
      4. Em Tabela, selecione uma tabela para definir atributos.
        Somente tabelas no grupo de índice de texto e suas tabelas secundárias são exibidas.
      5. Em Nome do atributo, selecione um parâmetro de mecanismo de pesquisa, insira um valor para esse parâmetro em Valore selecione Enviar.
        Para ver a lista de atributos, insira ts_configuration_attribute.list no navegador de aplicações. Para obter definições de atributo, consulte Índice do Zing e atributos de pesquisa.
      6. Em Coluna, especifique o nome da coluna na tabela selecionada à qual você deseja aplicar o atributo de pesquisa.
      7. Em Valor, especifique o valor do atributo que rege a pesquisa.
      8. Selecione Enviar.
      9. Repita este procedimento para definir parâmetros de mecanismo de pesquisa adicionais para colunas de tabela no grupo de índice de texto.
      10. Em Links relacionados, selecione Gerar índice de texto.
    5. Opcional: Adicione um dicionário de sinônimos.
      Especificar um dicionário permite pesquisas no termo de pesquisa e nos sinônimos do termo de pesquisa, como carro e seu sinônimo automático. O Zing fornece um dicionário de sinônimos padrão.
      1. Navegar até Todos > Definição do Sistema > Configurações do índice de texto.
      2. Abra o registro do seu grupo de índice de texto.
      3. Na guia Dicionários de sinônimos do índice, selecione Novo.
      4. Em Índice, selecione o índice da tabela ao qual adicionar as palavras irrelevantes.
      5. Em Dicionário de sinônimos, selecione o dicionário a ser usado.
        Para adicionar um dicionário, selecione Novo e siga o procedimento em Criar dicionários de sinônimos.
      6. Selecione Enviar.
      7. Em Links relacionados, selecione Gerar índice de texto.
    6. Selecione Atualizar.

    O que Fazer Depois

    Você pode consultar as tabelas no grupo de índice de texto para correspondências de cadeia de caracteres usando os métodos GlideRecord.addQuery(name, value) ou GlideRecord.addEncodedQuery(name, value) com o nome reservado 123TEXTINDEXGROUP321. Para obter mais informações sobre como consultar grupos de índice de texto para correspondências de cadeia de caracteres, consulte Consulta de tabelas no script.