Referência de sintaxe Catálogo de Dados Search
O Azure Catálogo de Dados é um serviço totalmente gerenciado hospedado no Microsoft Azure que serve como um sistema de registro e sistema de descoberta para fontes de dados corporativas. O Azure Catálogo de Dados tem recursos que permitem que usuários técnicos e não técnicos descubram, entendam e consumam fontes de dados.
Um aspecto fundamental da descoberta de dados é a capacidade de pesquisar fontes de dados que foram registradas no Azure Catálogo de Dados. O Azure Catálogo de Dados tem uma sintaxe de pesquisa poderosa que permite que os usuários criem facilmente consultas que retornam os dados de que os usuários precisam.
Visão geral da sintaxe de pesquisa
As pesquisas de Catálogo de Dados do Azure são semelhantes às usadas pelo Microsoft Windows e pelo Microsoft Outlook e que devem ser familiares para os usuários dessas ferramentas.
Técnicas de consulta
| Técnica | Uso | Exemplo |
|---|---|---|
| Pesquisa básica | Pesquisa básica usando um ou mais termos de pesquisa. Os resultados são quaisquer ativos que correspondam a qualquer propriedade com um ou mais dos termos especificados. | sales data |
| Escopo de propriedade | Retornar apenas as fontes de dados em que o termo de pesquisa corresponda à propriedade especificada | name:finance |
| Operadores boolianos | Ampliar ou restringir uma pesquisa usando operações boolianas | finance NOT corporate |
| Agrupando com parênteses | Usar parênteses para agrupar partes da consulta para obter o isolamento lógico, principalmente em conjunto com operadores boolianos | name:finance AND (tags:tag1 OR tags:tag2) |
| Operadores de comparação | Usar comparações que não sejam de igualdade para propriedades que tenham tipos de dados numéricos e de data | creationTime>"11/05/2014" |
Operadores correspondentes, de comparação e boolianos
| Palavra-chave/símbolo | Exemplos | Função |
|---|---|---|
| : | experts:user@domain.com tags:tag1 |
Use o escopo de propriedades e retorne apenas os ativos em que uma determinada propriedade contém o texto que está sendo pesquisado. A semântica da consulta é "correspondência de prefixo". |
| = | name=Sales name="Soft Drink Sales" |
Permite que o usuário especifique uma correspondência exata. Somente os ativos que contêm a propriedade com exatamente o valor do termo de pesquisa serão retornados. |
| <> | experts<>user1 tags<>tag2 |
Operador "Não igual a". Retornará apenas os ativos que não têm o valor indicado na consulta de pesquisa. |
| "" | "social security" |
Localiza itens que contêm a frase exata previdência social. Há um caso especial para usar aspas. Se aspas forem usadas com a propriedade que faz o escopo, a semântica está agrupando, mas não com frases exatas. Nesse caso, o comportamento é o mesmo que especificar a propriedade nomeada duas vezes. Exemplo: name:"social security" localiza todos os ativos que têm uma propriedade name com a palavra social ou uma propriedade name com a palavra segurança. |
| () | (tags:tag1 AND tags:tag2) OR (name:sales AND database:salesfy15) |
Localiza itens que contêm tag1 e tag2 ou têm as vendas de nome no banco de dados salesfy15. Normalmente usado em conjunto com operadores boolianos |
| >,>= | timestamp>"11/05/2014" |
Localiza itens com uma data modificada após 05/11/2014. |
| <,<= | timestamp<"11/05/2014" |
Localiza itens com uma data antes de 05/11/2014. |
| NOT | social NOT security |
Localiza itens que contêm segurança social, mas não social. |
| AND | social AND security |
Localiza itens que contêm seguros e sociais. |
| OU | social OR security |
Localiza itens que contêm seguro ou social. |
| Hsa: | has:tags has:description |
Permitir filtragem e retornar somente os ativos em que uma determinada propriedade é definida (ou se a propriedade representa uma coleção – ela contém pelo menos um elemento). |
Observações
Semântica de prefixo
Por padrão, todas as pesquisas no Azure Catálogo de Dados são feitas usando uma técnica chamada Semântica de Correspondência de Prefixo. Isso significa que qualquer termo de pesquisa inicia uma correspondência no início das propriedades do ativo.
Por exemplo, considere dois ativos fictícios registrados no Azure Catálogo de Dados com os seguintes nomes:
- SalesData
- Cotações do vendedor
Uma pesquisa por "vendas" retorna esses dois ativos, pois seus nomes começam com a palavra "vendas". Versões futuras do Azure Catálogo de Dados incluem suporte para operadores de correspondência exata.
Pesquisas no escopo da propriedade
A gramática de consulta Catálogo de Dados do Azure dá suporte ao escopo de propriedades. Na versão prévia atual, os escopos de propriedade diferenciam maiúsculas de minúsculas. Isso significa que, para que a consulta funcione, o uso de maiúsculas e minúsculas real da propriedade na consulta de pesquisa deve corresponder ao que está no índice.
Pesquisas em propriedades inválidas (propriedades que não existem) resultam em um erro.
As aspas se comportam de maneira especial ao usar o escopo de propriedade. Aspas em qualquer outro contexto indicam frases exatas. No entanto, quando as aspas são usadas no escopo da propriedade, a semântica está agrupando. Por exemplo, name:"Sales Products" uma pesquisa de texto gratuito pesquisa o conteúdo da propriedade name que procura "Vendas" ou "Produtos". Portanto, a semântica de: name:"Sales Products" é exatamente a mesma name:Sales name:Productsque .
O princípio geral para nomes de propriedade em Propriedades Pesquisáveis é camel-case, o que significa que a primeira letra é minúscula e, em seguida, cada uma das primeiras letras da palavra são maiúsculas.
As propriedades mais úteis estão listadas abaixo.
| Propriedade | Uso | Exemplo |
|---|---|---|
| name | Localiza itens em que o termo de pesquisa aparece no nome da fonte de dados | name:finance |
| descrição | Localiza itens em que o termo de pesquisa aparece na descrição da fonte de dados | description:finance |
| objectType | Localiza itens de um tipo de objeto específico, como tabela, exibição ou KPI | objectType:table |
| sourceType | Localiza itens de um tipo de fonte de dados específico, como SQL Server ou SQL Server Analysis Services Multidimensional | sourceType:"tabular" |
| marcas | Localiza itens em que o termo de pesquisa aparece nas marcas de fonte de dados | tags:finance |
| timestamp | Localiza itens com base na data e hora em que seus metadados foram modificados mais recentemente | timestamp:>"11/05/2014" |
| lastRegisteredTime | Localiza itens com base na data e hora em que seus metadados foram registrados | lastRegisteredTime:>"11/05/2014" |
| friendlyName | Localiza itens em que o termo de pesquisa aparece no nome amigável da fonte de dados | friendlyName: finance |
| Especialistas | Localiza itens em que o especialista em fonte de dados corresponde ao termo de pesquisa | experts:user@example.com experts:user |
| termName | Localiza itens em que o termo de pesquisa aparece em termos de glossário de negócios aplicados ao ativo de dados | termName:marketing |
Você também pode usar os seguintes nomes de propriedade junto com o filtro "has:" para marcar em que os ativos têm propriedades específicas definidas.
| Propriedade | Uso | Exemplo |
|---|---|---|
| visualizações | Localiza itens que contêm visualização | has:preview |
| documentação | Localiza itens que contêm documentação | has:documentation |
| tableDataProfiles | Localiza itens que têm um perfil de tabela (tamanho, número de linhas etc.) | has:tableDataProfiles |
| columnsDataProfiles | Localiza itens que têm um perfil de dados de coluna (número de valores distintos, mínimo, máximo etc.) | has:columnsDataProfiles |
Exemplos de pesquisa
As seções a seguir mostram alguns exemplos de Pesquisa.
Retornar todos os ativos com "vendas" no nome
name:sales
Retornar todos os ativos registrados após 20/04/2015 que incluem "vendas" em qualquer propriedade
sales AND lastRegisteredTime>"4/20/2015"
Retornar todos os ativos que incluem vendas em qualquer propriedade e que não têm a marca Q1FY2013
sales AND tags<>"Q1FY2013"
Retornar todos os ativos que não têm especialistas nem documentação atribuída
not has:experts and not has:documentation