Compartilhar via


Usar a pesquisa do Dataverse para recuperar linhas

Use a ação Pesquisar linhas em fluxos para recuperar dados do Microsoft Dataverse usando palavras-chave e a pesquisa do Dataverse, que oferece resultados rápidos, inteligentes e abrangentes em tabelas no Dataverse.

Pré-requisitos

O administrador deve configurar a pesquisa do Dataverse em seu ambiente antes de usar a ação de pesquisa no Microsoft Dataverse.

A ação pesquisar linhas.

Você pode adicionar a ação Pesquisar linhas para seus fluxos e fornecer uma palavra-chave em Pesquisar termo para pesquisar essa palavra-chave em todas as linhas indexadas no Dataverse.

Você pode usar o conteúdo dinâmico de uma etapa anterior no fluxo para parametrizar a caixa Termo de pesquisa. Por exemplo, você pode usar uma palavra-chave inserida em um bot do Microsoft Copilot Studio e definir as seguintes opções para iniciar uma pesquisa automatizada.

Observação

Pode levar algumas horas para que as linhas adicionadas recentemente sejam incluídas nos resultados da pesquisa.

Tipo de pesquisa

Use a opção Tipo de pesquisa para fornecer a sintaxe para a consulta de pesquisa. Use simples para indicar que deseja usar a sintaxe de consulta simples. Ou use completa se preferir usar a sintaxe de consulta Lucene. A sintaxe de consulta padrão é simples.

Dê uma olhada nos exemplos a seguir ou analise a lista completa de recursos emPesquisar nos dados da tabela usando a pesquisa do Dataverse.

A sintaxe de consulta simples oferece suporte à seguinte funcionalidade:

Operador Descrição
Operadores booleanos Operador AND; denotado pelo operador +
OR; denotado pelo operador |
NOT; denotado por -
Operadores de precedência Um termo de pesquisa "hotel+(wifi | luxury)" pesquisará resultados que contenham o termo "hotel" e "wifi" ou "luxury" (ou ambos).
Curingas Há suporte para curingas à direita; por exemplo, "Alp*" procura por "alpino".
Correspondências exatas Uma consulta entre aspas " ".

A sintaxe de consulta Lucene oferece suporte à seguinte funcionalidade:

Operador Descrição
Operadores boolianos Fornece um conjunto expandido em comparação com a sintaxe de consulta simples.
Operador AND; denotado por AND, &&, +
operador OR; denotado por OR, ||
operador NOT; denotado por NOT, !, –
Operadores de precedência A mesma funcionalidade da sintaxe de consulta simples.
Curingas Além de um curinga à direita, também oferece suporte a um curinga à esquerda.
Curinga à direita – "alp*"
Curinga à esquerda - "/.*pine/"
Pesquisa difusa Permite consultas com erros ortográficos de até dois caracteres.
"Uniersty~" retornará "University"
"Blue~1" retornará "glue", "blues"
Aumento de termos Pondera termos específicos em uma consulta de maneira diferente.
"Rock^2 electronic" retornará resultados em que as correspondências a "rock" são mais importantes do que correspondências a "electronic".
Pesquisa por proximidade Retorna resultados onde os termos estão dentro de x palavras um do outro, para resultados mais contextuais.
Por exemplo, "airport hotel"~5 retorna resultados em que "airport" e "hotel" estão a cinco palavras um do outro, aumentando assim as chances de encontrar um hotel localizado próximo a um aeroporto.
Pesquisa de expressão regular (regex) Por exemplo, /[mh]otel/ corresponde a "motel" ou "hotel".

Para usar qualquer um dos operadores de pesquisa como parte do texto de pesquisa, aplique escape ao caractere prefixando-o com uma única barra invertida (\). Os caracteres especiais com escape incluem os seguintes caracteres: + - & | ! ( ) { } [ ] ^ " ~ * ? : \ /

Search mode

Você pode especificar se algum ou todos os termos de pesquisa devem ser correspondidos para contar o documento como uma correspondência. O padrão é qualquer. Ele controla se um termo com o operador NOT é AND ou OR com outros termos na consulta (assumindo que não há operador + ou | nos outros termos).

  • Usando qualquer um para Modo de pesquisa aumenta a recuperação de consultas, incluindo mais resultados. Por padrão, é interpretado como "OU NÃO". Por exemplo, "wifi -luxury" corresponderá a documentos que contenham o termo "wifi" ou que não contenham o termo "luxury".

  • Usando todos para Modo de pesquisa aumenta a precisão das consultas, incluindo menos resultados. Por padrão, é interpretado como "E NÃO". Por exemplo, "wifi-luxury" corresponderá a documentos que contêm o termo "wifi" e não contêm o termo "luxury".

Acesse Pesquisar nos dados da tabela usando a pesquisa do Dataverse para obter mais detalhes.

Exemplo do modo de pesquisa.

Opções Avançadas

Você pode otimizar sua pesquisa usando outras opções avançadas, conforme descrito nesta seção. Consulte Pesquisar nos dados da tabela usando a pesquisa do Dataverse para obter mais exemplos.

  • Filtro de linhas: você pode restringir sua pesquisa especificando filtros, conforme mostrado na imagem a seguir.

  • Filtro de tabela: você pode restringir sua pesquisa a tabelas específicas, conforme mostrado na imagem a seguir.

  • Ordenar por: use esta opção para classificar especificando um nome de coluna e adicionando asc ou desc como sufixo, conforme mostrado na imagem a seguir.

    Opções avançadas.

Usando conteúdo dinâmico e linhas do Dataverse

Você pode usar os resultados da ação diretamente pelo Conteúdo dinâmico. Aqui está o significado de cada um dos parâmetros.

Nome do parâmetro Descrição
Corpo O objeto que representa toda a resposta. Contém a lista de linhas, a contagem total de linhas e os resultados da faceta.
Lista de linhas Um objeto que representa todas as linhas retornadas.
Item da lista de linhas Uma linha individual na lista de linhas, quando usada dentro de um loop.
Pontuação de pesquisa de linha A pontuação do Dataverse de uma linha. Essa pontuação indica o quão próximo ele correspondeu às palavras-chave e condições de pesquisa.
Destaques da pesquisa de linha Destaca as palavras-chave específicas que correspondem às palavras-chave de pesquisa na linha.
Nome da tabela de linha O nome da tabela para uma única linha. Esta ação agrega linhas de todas as tabelas pesquisáveis no ambiente.
ID de objeto de linha Este é um identificador para cada linha. Use este identificador em conjunto com o nome da tabela na ação Obter linhas para ler todas as colunas em uma linha.
Código de tipo de objeto de linha O identificador do nome da tabela para a linha.

Quando você está construindo seu fluxo, o conteúdo dinâmico pode aparecer como esta imagem:

Conteúdo dinâmico para compilar um fluxo.

A ação Pesquisar linhas retorna muitas outras colunas para as linhas correspondentes em um esquema de variável, dependendo da configuração de pesquisa do Dataverse. Para usar essas colunas, analise a resposta JSON e, em seguida, use as saídas dinâmicas geradas a partir dela, conforme mostrado na imagem a seguir.

O esquema JSON.