Sintaxe de pesquisa de palavras-chave

Quando procura recursos de dados, pode utilizar palavras-chave, operadores e consultas no âmbito do campo para encontrar exatamente os dados de que precisa. Este artigo descreve a sintaxe de consulta suportada para que possa criar pesquisas precisas e eficazes.

Para obter uma descrição geral da pesquisa e navegação de recursos de dados, veja Procurar recursos de dados no Catálogo unificado.

Observação

A sintaxe descrita neste artigo aplica-se à experiência de pesquisa de recursos de Dados de Deteção de Catálogo unificado >> no portal do Microsoft Purview. Os resultados da pesquisa são filtrados com base nas suas permissões, pelo que só vê recursos aos quais tem acesso. Para obter mais informações sobre permissões, veja Procurar recursos de dados no Catálogo unificado.

Referência rápida

A tabela seguinte resume as opções de sintaxe de consulta disponíveis no Catálogo unificado pesquisa.

Sintaxe Exemplo Descrição
Palavra-chave customer Procure o palavra-chave em todos os campos.
Múltiplas palavras-chave customer sales Procure recursos que correspondam a qualquer uma das palavras. Os elementos que correspondem a ambas as palavras são classificados com uma classificação superior.
AND customer AND sales Ambos os termos têm de estar presentes.
OU customer OR sales Qualquer um dos termos pode estar presente.
NOT customer NOT draft Tem de conter o primeiro termo, não pode conter o segundo.
Expressão exata "sales report" Corresponda à expressão exata por ordem.
Agrupamento (A OR B) AND C Controlar a ordem de avaliação.
Pesquisa de campos name:customer Pesquise apenas num campo específico.
Corresponder a todos * ou vazio Devolver todos os recursos.

Uma única palavra-chave procura em todos os campos pesquisáveis no catálogo, incluindo o nome do recurso, descrição, nome qualificado, colunas de esquema, termos do glossário, contactos, classificações, atributos personalizados, coleções, domínios e etiquetas de confidencialidade.

O exemplo seguinte devolve qualquer recurso em que customer aparece em qualquer campo pesquisável:

customer

Os resultados são classificados por relevância. Uma correspondência exata no nome do recurso tem classificações superiores a uma correspondência parcial na descrição.

Múltiplas palavras-chave

Quando introduz múltiplas palavras separadas por espaços sem um operador explícito, a pesquisa devolve recursos que contêm qualquer uma das palavras. Os recursos que contêm mais palavras-chave são classificados mais alto nos resultados.

O exemplo seguinte localiza os recursos que contêm customer, salesou ambos:

customer sales

Importante

Uma pesquisa de palavra-chave separada por espaços não é igual a uma pesquisa E. Considere as seguintes diferenças:

Consultar Comportamento Resultado de exemplo
customer sales Corresponde customer a OU sales. Os recursos com ambas as classificações são superiores. Um recurso com o nome "Dashboard de Vendas" corresponde mesmo sem "cliente".
customer AND sales Amboscustomer E sales tem de estar presente. "Dashboard de Vendas" não corresponde, a menos que também contenha "cliente".
"customer sales" A expressão customer sales exata tem de aparecer por essa ordem. Apenas corresponde se customer for imediatamente seguido por sales.

Operadores booleanos

Os operadores booleanos permitem combinar termos de pesquisa com lógica explícita. Os operadores têm de ser escritos em maiúsculas (AND, OR, NOT).

Operador AND

Utilize o operador AND quando todos os termos têm de estar presentes nos recursos correspondentes. Os termos não precisam de ser adjacentes ou no mesmo campo.

customer AND sales
azure AND sql AND database

Operador OR

Utilize o operador OR quando qualquer um dos termos puder estar presente.

customer OR client
sales OR marketing OR operations

Operador NOT

Utilize o operador NOT para excluir recursos que contenham um termo específico.

customer NOT draft
sales NOT internal NOT test

O exemplo seguinte devolve recursos que contêm customer , mas não contêm draft:

customer NOT draft

Combinar operadores

Pode encadear operadores numa única consulta:

customer AND sales NOT draft

Esta consulta devolve recursos que contêm customer e sales, mas não contêm draft.

Coloque a consulta entre aspas para procurar uma expressão exata. As palavras têm de aparecer na ordem especificada e adjacentes umas às outras.

"sales report"
"customer data analysis"

A tabela seguinte mostra como a pesquisa de expressões difere de uma pesquisa de palavra-chave:

Consultar Correspondências Não corresponde
"sales report" "Resumo do relatório de vendas do 1.º trimestre" "relatório sobre vendas" (encomenda errada)
"sales report" " Relatório anual de vendas" "relatório trimestral de vendas" (palavras não adjacentes)

Utilize sales report (sem aspas) quando quiser qualquer recurso que mencione sales ou report. Utilize "sales report" (com aspas) quando quiser apenas recursos que contenham a expressão exata.

Agrupar com parênteses

Os parênteses controlam a ordem de avaliação, tal como nas expressões matemáticas.

(customer OR client) AND sales

Sem parênteses, a precedência do operador pode produzir resultados inesperados. Os exemplos seguintes mostram como os parênteses alteram a interpretação da consulta:

Consultar Interpretação
(customer OR client) AND sales Recursos que contêm customer ou client, e também contêm sales.
customer OR (client AND sales) Recursos que contêm customer, ou recursos que contêm e clientsales.

Pode aninhar parênteses para consultas mais complexas:

(A AND B) OR (C AND D) NOT E
((alpha OR beta) AND gamma) NOT delta

Por predefinição, é pesquisada uma palavra-chave em todos os campos. A pesquisa no âmbito do campo permite-lhe restringir a pesquisa a um campo específico.

Utilize a sintaxe fieldName:value ou fieldName:"phrase value":

name:customer
classification:Confidential
entityType:azure_sql_table
contact:alice@company.com
name:"sales report"

Campos suportados

Os seguintes campos podem ser utilizados com a field:value sintaxe:

Nome do campo Descrição Exemplo
name Nome do recurso name:customer
qualifiedName Nome completamente qualificado qualifiedName:sales_db.customers
description Descrição do recurso description:quarterly
userDescription Descrição fornecida pelo utilizador userDescription:important
displayText Apresentar texto displayText:customer
entityType Tipo de entidade entityType:azure_sql_table
assetType Categoria do recurso assetType:Tables
classification Etiquetas ou etiquetas de confidencialidade classification:Confidential
endorsement Endossamento status endorsement:Certified
glossaryType Tipo de glossário glossaryType:AtlasGlossaryTerm
termStatus Status de Termos termStatus:Approved
termTemplate Modelo de termo termTemplate:BusinessTerm
glossary Nome do glossário glossary:Finance
fileExtension Extensão de arquivo fileExtension:csv
term Termos do glossário atribuídos term:Revenue
contact Contacto de proprietário ou especialista contact:john@company.com
abbreviation Abreviatura de termos abbreviation:ROI
objectType Tipo de objeto objectType:Tables
tag Marcações tag:important

Os nomes dos campos não são sensíveis a maiúsculas e minúsculas. Por exemplo, Name:customer e name:customer produza os mesmos resultados.

Se utilizar um nome de campo que não esteja na tabela Campos suportados , o motor de busca não devolve um erro. Em vez disso, trata toda a expressão como uma palavra-chave não âmbito. Por exemplo, alice AND report:myreport procura alice E o texto report:myreport literal em todos os campos, em vez de restringir myreport a um campo chamado report.

Importante

Apenas um token de valor é capturado após os dois pontos. Para procurar um valor com várias palavras, utilize aspas:

Consultar Comportamento
name:sales report Procura name e sales, em seguida, procura separadamente todos os campos para report.
name:"sales report" Procura name a expressão sales reportexata .

Campos aninhados

Alguns campos suportados, como contact e term, representam dados compostos com várias propriedades. Por exemplo, um contacto tem um nome a apresentar, um endereço de e-mail e um ID.

Não pode utilizar a notação de pontos para direcionar uma propriedade específica. O sistema só reconhece os nomes de campo de nível superior listados na tabela Campos suportados .

Consultar Com suporte Comportamento
contact:Alice Sim Procura em todas as propriedades de contacto (nome a apresentar, e-mail, ID).
contact.displayName:Alice Não Não reconhecido como uma pesquisa no âmbito do campo.
term:Revenue Sim Procura em todas as propriedades do termo (nome, glossário).
term.name:Revenue Não Não reconhecido como uma pesquisa no âmbito do campo.

Utilize o nome do campo de nível superior. Por exemplo, contact:Alice procura em todas as propriedades de contacto e devolve recursos em que qualquer propriedade corresponde.

Quando mistura uma palavra-chave simples com uma pesquisa no âmbito do campo, um espaço não implica E. As cláusulas separadas por espaços são tratadas como OU.

Consultar Comportamento
alice contact:bob alice OU o contacto contém bob.
alice AND contact:bob alice E o contacto contém bob.

Dica

Utilize sempre operadores ou OR explícitos AND ao combinar palavra-chave pesquisa com pesquisa no âmbito do campo.

Corresponder todos os resultados

Uma consulta vazia ou * devolve todos os recursos, sujeitos às suas permissões e quaisquer filtros aplicados.

*

Esta opção é útil como ponto de partida quando pretende procurar recursos utilizando apenas filtros e facetas.

Diferenciação de maiúsculas e minúsculas

Geralmente, a pesquisa não é sensível a maiúsculas e minúsculas. CustomerProcurar , customerou CUSTOMER devolve os mesmos resultados.

No entanto, a caixa e os carateres especiais na consulta de pesquisa podem afetar o número de resultados devolvidos. Determinados campos são processados pelo motor de busca, que divide os termos em limites específicos antes da correspondência.

Delimitadores de divisão de tokens

Os seguintes limites fazem com que um termo seja dividido em tokens separados durante a indexação e pesquisa:

Delimitador Entrada de exemplo Tokens produzidos
Alteração de maiúsculas/minúsculas (minúsculas para maiúsculas) CustomerOrder customer, order, customerorder
Caráter de sublinhado (_) customer_order customer, order, customer_order
Hífen (-) customer-order customer, order, customer-order
Ponto (.) customer.order customer, order, customer.order
Vírgula (,) item1,item2 item1, item2
Dois pontos (:) db:schema db, schema
Espaço em Branco customer order customer, order
Transição letra a número version2release version, 2, release
Transição de número para letra 2ndEdition 2, nd, edition

Observação

A divisão é cumulativa. Um nome como Customer_Order_Details é dividido em cada caráter de sublinhado e em cada limite de alteração de maiúsculas/minúsculas em cada segmento, produzindo tokens como customer, order, details, customer_ordere order_details.

Como a caixa afeta os resultados

Quando a consulta de pesquisa contém maiúsculas/minúsculas mistas (como PascalCase ou camelCase), o motor de busca divide-a em limites de alteração de maiúsculas e minúsculas, produzindo vários tokens. Cada token é correspondido de forma independente, o que alarga o conjunto de resultados.

Quando a consulta está em minúsculas, não existem limites de alteração de maiúsculas/minúsculas para dividir, pelo que permanece como um único token e tem de corresponder como uma cadeia contígua.

O exemplo seguinte ilustra a diferença:

Consulta de pesquisa Comportamento Efeito nos resultados
CustomerOrder Dividir em tokens: customer, , ordercustomerorder Corresponde a recursos que customer contêm ou order ou customerorder. Resultados mais amplos.
customerorder Permanece como um token: customerorder Corresponde apenas a recursos que contêm a cadeia contígua customerorder. Resultados mais estreitos.

Pesquisa e casing de expressões

A pesquisa de expressões citadas também interage com a caixa. Com "CustomerOrder" aspas, os tokens de consulta ainda customersão , order, customerorder, mas como é uma pesquisa de expressões, os tokens têm de aparecer adjacentes e por ordem.

Consulta de expressões Correspondências Não corresponde
"CustomerOrder" CustomerOrder, FAC_Customer_OrderLine (onde customer e order são tokens adjacentes) legacy customer database (sem token adjacente order )
"customerorder" CustomerOrder (indexado como contíguo customerorder) FAC_Customer_OrderLine (sem token contíguo customerorder )

Recomendações para a casing

  • Para obter os resultados mais amplos, utilize a caixa natural do termo (por exemplo, CustomerOrder ou SalesReport). A divisão de maiúsculas/minúsculas encontra correspondências parciais.
  • Para obter os resultados mais precisos, utilize todas as minúsculas (por exemplo, customerorder) ou utilize uma pesquisa de expressões exata com aspas.
  • Em caso de dúvida, procure ambos os formulários ou utilize operadores booleanos explícitos: CustomerOrder OR customerorder.

Classificação de resultados

Quando uma pesquisa devolve vários resultados, são ordenados por uma classificação de relevância. Os seguintes fatores influenciam a classificação, do impacto mais elevado ao mais baixo. A lógica de classificação exata está sujeita a alterações, uma vez que o motor de relevância é continuamente ajustado.

Onde ocorre a correspondência

Nem todos os campos têm igual peso. Uma correspondência no nome do recurso é considerada mais relevante do que uma correspondência na descrição ou noutros campos:

Prioridade Tipo correspondente Exemplo
Mais Alta Correspondência exata no nome do recurso Procurar customers quando o recurso tem o nome exato customers.
Alto Correspondência exata não sensível a maiúsculas e minúsculas no nome Procurar Customers quando o recurso tem o nome customers.
Médio Correspondência parcial no nome ou nome qualificado Procurar customer quando o recurso tem o nome CustomerOrderTable.
Padrão Corresponder na descrição, apresentar texto, classificação, tipo de entidade ou outros campos Procurar customer quando a palavra é apresentada na descrição do recurso.
Inferior Corresponder em colunas de esquema, termos do glossário, contactos ou atributos personalizados Procurar customer quando existe uma coluna com o nome customer_id no elemento.

Em cada nível, os recursos que correspondem a mais tokens de pesquisa têm uma classificação superior à dos recursos correspondentes a menos.

Tipo de recurso

Os recursos ao nível da folha, como tabelas individuais, ficheiros e termos do glossário, recebem um aumento de classificação sobre os recursos de contentor, como bases de dados ou contas de armazenamento. Quando procura sales, uma tabela com o nome sales_data normalmente está acima da base de dados que a contém.

Plenitude de dados

Os ativos mais organizados recebem um aumento de classificação. Cada um dos seguintes sinais contribui de forma independente para uma classificação mais alta:

  • Tem uma descrição
  • Tem uma ou mais classificações (etiquetas de confidencialidade)
  • Tem um ou mais termos do glossário atribuídos
  • Tem proprietários ou especialistas definidos
  • Tem informações de esquema ou coluna
  • Tem atributos personalizados preenchidos
  • Tem etiquetas de confidencialidade aplicadas

Endossamento status

Os recursos endossados são mais elevados do que os não suportados. Os recursos promovidos recebem um aumento moderado e os Recursos certificados recebem um aumento que é empilhado com Promovido quando ambos se aplicam.

Atualização

Os recursos recentemente atualizados recebem um ligeiro aumento de classificação em vez dos obsoletos. O impulso diminui gradualmente.

Sinais de popularidade

Os sinais baseados na utilização contribuem para a classificação, incluindo a frequência de modificação, a classificação da qualidade dos dados e a classificação do utilizador.

Personalização

Quando efetua uma pesquisa, os recursos em que está listado como proprietário ou especialista recebem um pequeno impulso, tornando os seus próprios recursos mais fáceis de encontrar.

Deteção de palavra-chave inteligente

O sistema de pesquisa reconhece determinadas palavras-chave e ajusta a classificação:

  • my: aumenta os recursos onde é proprietário, especialista ou editor recente.
  • Palavras-chave de tipo de objeto: procurar uma categoria de recursos reconhecida (como Tables, Filesou Folders) aumenta os recursos desse tipo.
  • Palavras-chave de classificação: procurar um termo que corresponda a um nome de classificação conhecido (como PII ou Confidential) aumenta os recursos com essa classificação.

Observação

Quando é aplicada uma sequência de ordenação explícita (por exemplo, ordenar por nome ou hora de atualização), a classificação por relevância só é utilizada como desempate quando dois recursos têm o mesmo valor de ordenação.

Limites de consulta

Limite Valor
Comprimento máximo de palavra-chave 1024 carateres. As consultas mais longas são truncadas.

Limitações conhecidas

O agrupamento não é suportado numa pesquisa de campos. Por exemplo, name:(alice AND bob) é uma sintaxe inválida. Em vez disso, utilize name:alice AND name:bob .

Recursos

  • Last updated on