Compartilhar via


Pesquisar objetos do workspace

Este artigo descreve como pesquisar tabelas, volumes, notebooks, consultas, painéis, alertas, arquivos, pastas, bibliotecas, trabalhos, repositórios, parceiros e listagens do Marketplace no workspace do Azure Databricks.

As tabelas precisam ser registradas no Catálogo do Unity para aparecer nos resultados da pesquisa.

Em workspaces que usam chaves gerenciadas pelo cliente para criptografia, o conteúdo do notebook e o conteúdo da consulta não estão disponíveis na pesquisa.

A pesquisa do Azure Databricks aproveita o DatabricksIQ, o Mecanismo Data Intelligence do Azure Databricks, para fornecer uma experiência de pesquisa mais inteligente baseada em IA. Os comentários gerados por IA usam LLMs para adicionar automaticamente descrições e tags a tabelas e colunas gerenciadas pelo Unity Catalog. Esses comentários tornam o mecanismo de pesquisa ciente do jargão, das métricas e da semântica exclusivos da empresa, fornecendo o contexto necessário para tornar os resultados da pesquisa mais relevantes, precisos e acionáveis.

Para pesquisar o workspace usando a pesquisa de navegação na barra superior da interface do usuário, faça o seguinte:

  1. Clique no campo Pesquisar na barra superior do workspace do Azure Databricks ou use o atalho de teclado Command-P.

    Barra de pesquisa de navegação

    Seus arquivos, notebooks, consultas, alertas e painéis recentes são listados em Recentes, classificados pela data da última abertura.

  2. Insira seus critérios de pesquisa.

    Objetos recentes na lista são filtrados para corresponder aos critérios de pesquisa. A pesquisa de navegação também pode sugerir outros objetos que correspondam aos seus critérios. Para realizar uma pesquisa completa no espaço de trabalho, use a página Resultados da pesquisa.

  3. Selecione um item na lista.

Página de resultados de pesquisa

A experiência de pesquisa de página inteira oferece mais espaço para ver os resultados, mais metadados para seus objetos e mais filtros para restringir seus resultados.

Para filtrar os resultados da pesquisa por tipo de objeto, proprietário do objeto ou data da última modificação na página Resultados da pesquisa, faça o seguinte:

  1. Clique no campo Pesquisar na barra superior do workspace do Azure Databricks ou use o atalho de teclado Command-P e pressione Enter.

    A página Resultados da pesquisa é aberta.

  2. Insira seus critérios de pesquisa.

  3. Selecione um item na lista.

É possível pesquisar por cadeia de caracteres de texto, por tipo de objeto ou ambos. Após você digitar os critérios de pesquisa e pressionar Enter, o sistema pesquisa os nomes de todas as consultas, painéis, alertas, arquivos, pastas, notebooks, bibliotecas, repositórios, parceiros e listagens do Marketplace no workspace ao qual você tem acesso. Se o workspace estiver habilitado para o Unity Catalog, o sistema também pesquisará nomes de tabela, comentários de tabela, nomes de coluna e comentários de coluna.

Pesquisar por cadeia de caracteres de texto

Para pesquisar uma cadeia de caracteres de texto, digite-a no campo de pesquisa e, em seguida, pressione Enter. O sistema pesquisa os nomes de todos os objetos no workspace ao qual você tem acesso. Ele também pesquisa texto em comandos de notebook, mas não em arquivos que não são de notebook.

Você pode colocar aspas em torno de sua entrada de pesquisa para restringir os resultados da pesquisa apenas a documentos que contêm sua frase exata.

A pesquisa de correspondência exata dá suporte ao seguinte:

  • Aspas básicas (por exemplo, "spark.sql(")
  • Aspas com escape (por exemplo, "spark.sql(\"select")

A pesquisa de correspondência exata não dá suporte ao seguinte:

  • Com aspas e sem aspas (por exemplo, "spark.sql" partition)
  • Várias aspas (por exemplo, "spark.sql" "partition")

Importante

Esse recurso está em uma versão prévia.

Você pode usar linguagem natural para pesquisar tabelas do Catálogo do Unity. A pesquisa retorna resultados que têm significado semântico relacionado.

Por exemplo, a consulta de pesquisa “O que devo usar para geografias” concentra-se em “geografias” e encontra termos relacionados contendo atributos geográficos, como cidades, países, territórios e localizações geográficas.

A pesquisa também pode compreender padrões em suas consultas de pesquisa, separando o que pode ser um termo de pesquisa de um filtro, o que significa que as consultas em linguagem natural são ainda mais poderosas.

Por exemplo, a consulta de pesquisa “Mostre-me tabelas sobre inspeções” é dividida de modo que “inspeções” seja o termo-chave e “tabela” seja o tipo de objeto que o usuário está procurando.

Limitar a pesquisa a um tipo de objeto específico

Você pode pesquisar itens por tipo (como arquivos, pastas, blocos de anotações, bibliotecas, tabelas ou repositórios) clicando no tipo de objeto na página Resultados da pesquisa, na lista suspensa Tipo ou nas guias no lado direito da página. Não é necessário inserir uma cadeia de caracteres de texto. Se você deixar o campo de texto em branco e pressionar Enter, o sistema pesquisará por todos os objetos desse tipo. Clique em um nome da lista para abrir esse item no workspace. Você também pode usar menus suspensos para restringir ainda mais os resultados da pesquisa para itens de um tipo específico, como por proprietário ou data da última modificação.

Você também pode especificar filtros em sua consulta de pesquisa na barra de pesquisa na parte superior da IU. Por exemplo, você pode incluir o seguinte em sua consulta de pesquisa para pesquisar tabelas de sua propriedade: type:table owner:me. Para saber mais sobre como especificar seus filtros por meio de sintaxe, aplique filtros na página Resultados da pesquisa e veja como a consulta na barra de pesquisa é atualizada automaticamente.

Popularidade

A pesquisa usa sinais de popularidade com base na frequência com que outros usuários em seu espaço de trabalho interagem com tabelas específicas para melhorar a classificação das tabelas.

Sem o aumento da popularidade, você teria que consultar as tabelas retornadas nos resultados da pesquisa para saber qual é a tabela oficial. Com o aumento da popularidade, a tabela mais popular tem uma classificação mais elevada, para que você não precise adivinhar qual é a correta. O indicador de popularidade Ícone do indicador de popularidade próximo ao nome da tabela nos resultados da pesquisa reflete a classificação do objeto. Você também pode classificar os resultados da pesquisa por popularidade.

Cartões de conhecimento

Quando a pesquisa consegue identificar o que você procura com alta confiança, o principal resultado da pesquisa se transforma em um cartão de conhecimento. Um cartão de conhecimento fornece metadados de objeto adicionais. Os cartões de conhecimento são compatíveis com tabelas gerenciadas do Unity Catalog.

Exemplo de cartão de conhecimento

Pesquisar tabelas e modelos em workspaces habilitados para o Catálogo do Unity

Em workspaces habilitados para o Catálogo do Unity, você pode pesquisar tabelas e modelos registrados no Catálogo do Unity. É possível pesquisar qualquer um dos seguintes:

  • Nomes de tabela, exibição ou modelo.
  • Comentários de tabela, exibição ou modelo.
  • Nomes de coluna de tabela ou exibição.
  • Comentários de coluna de tabela ou exibição.
  • Teclas de marca a tabela ou exibição.

Para filtrar os resultados da pesquisa por catálogo pai, esquema pai, proprietário ou marca na página Resultados da pesquisa, clique no menu suspenso Tipo e selecione Tabelas. Os menus suspensos de filtro aparecem na parte superior da página.

Você também pode classificar os resultados pela popularidade da tabela.

Os resultados da pesquisa não incluem:

  • Tabelas, exibições e modelos que você não tem permissão para ver.

    Em outras palavras, para que uma tabela ou modelo apareça nos resultados da sua pesquisa, você deve ter pelo menos o privilégio SELECT nessa tabela, o privilégio EXECUTE no modelo, o privilégio USE SCHEMA em seu esquema pai e o privilégio USE CATALOG no catálogo pai. Os administradores de metastore têm esses privilégios por padrão. Todos os outros usuários devem receber esses privilégios. Confira Privilégios e objetos protegíveis do Catálogo do Unity.

  • Tabelas e exibições no metastore do Hive herdado (ou seja, no catálogo hive_metastore).

    Para atualizar essas tabelas para o Catálogo do Unity e disponibilizá-las para pesquisa, siga as instruções descritas em Atualizar tabelas e exibições do Hive para o Catálogo do Unity.

  • Modelos no registro de modelo de workspace.

    Para atualizar fluxos de trabalho de ML para criar modelos no Catálogo do Unity, consulte Atualizar fluxos de trabalho de ML para modelos de destino no Catálogo do Unity.

Usar marcas para pesquisar tabelas

Você pode usar a barra de pesquisa do workspace do Azure Databricks para pesquisar tabelas, volumes, exibições e colunas de tabela usando chaves de marca e valores de marca. Você também pode usar chaves de marca para filtrar tabelas e exibições usando a pesquisa de workspace. Você não pode pesquisar outros objetos marcados, como catálogos ou esquemas. Consulte também Aplicar marcas a objetos protegíveis do Catálogo do Unity.

Somente tabelas e exibições que você tem permissão para ver aparecem nos resultados da pesquisa.

Para pesquisar tabelas, exibições e colunas usando marcas:

  1. Clique no campo Pesquisar na barra superior do workspace do Azure Databricks ou use o atalho de teclado Command-P.

    Você não pode usar o campo de filtro no Gerenciador de Catálogos para pesquisar por marca.

  2. Insira seus critérios de pesquisa. Pesquise tabelas ou colunas marcadas inserindo a chave ou o valor da marca de tabela ou coluna. Você deve usar a chave de marca exata ou o termo de valor.

    Se você quiser pesquisar apenas por chave de marca, use a sintaxe: tag:<tag_key>. Para pesquisar por chave de marca e valor de marca, omita tag:.

    Pesquisar tabelas por chave de marca

Para filtrar os resultados da pesquisa de tabela usando chaves de marca:

  1. Clique no campo Pesquisar na barra superior do workspace do Azure Databricks ou use o atalho de teclado Command-P.
  2. Insira um termo de pesquisa ou deixe o campo de pesquisa em branco.
  3. Na página resultados da Pesquisa, clique no menu suspenso Tipo e selecione Tabelas.
  4. Use o menu suspenso de filtro Marca para selecionar a chave de marca.