Pesquisar recursos

Use a pesquisa do catálogo universal do Dataplex para encontrar recursos Trusted Cloud no BigQuery, como conjuntos de dados e tabelas.

A pesquisa do Dataplex Universal Catalog oferece suporte a consultas de pesquisa em linguagem natural (também conhecidas como consultas de pesquisa semântica), que permitem pesquisar recursos usando a linguagem do dia a dia.

Assim como a pesquisa por palavras-chave, a pesquisa com linguagem natural enfatiza a descoberta de recursos analisando os metadados associados a eles na sua organização. A Pesquisa considera uma ampla variedade de metadados que descrevem os recursos, incluindo os que você cria.

A pesquisa em linguagem natural se concentra em aumentar o recall em vez da precisão.

Para mais informações sobre como pesquisar dados de tabelas no BigQuery, consulte Introdução à pesquisa no BigQuery.

Inscreva-se para participar do pré-lançamento

Para se inscrever na Visualização, seu representante da Conta do Google precisa enviar uma solicitação preenchendo o formulário de inscrição. Depois que você enviar o formulário, a equipe do BigQuery vai entrar em contato com as próximas etapas.

Antes de começar

Antes de usar a pesquisa em linguagem natural no BigQuery para pesquisar Trusted Cloud recursos, conclua as tarefas desta seção.

Funções exigidas

Para pesquisar recursos, você precisa de pelo menos um dos seguintes papéis do IAM do Dataplex Universal Catalog no projeto usado para pesquisa: administrador do Dataplex Catalog, editor do Dataplex Catalog ou leitor do Dataplex Catalog. As permissões nos resultados da pesquisa são verificadas independentemente do projeto selecionado.

O escopo dos resultados da pesquisa no BigQuery é definido de acordo com suas permissões do IAM nos recursos subjacentes. Para pesquisar um recurso no BigQuery, você precisa ter permissões de acesso a ele. Para mais informações, consulte a seção Escopo da pesquisa deste documento.

Por exemplo, para pesquisar conjuntos de dados, tabelas, visualizações e modelos do BigQuery, você precisa das permissões respectivas para acessar esses recursos. Para mais informações, consulte Permissões do BigQuery. A lista a seguir descreve as permissões mínimas necessárias:

  • Para pesquisar uma tabela, você precisa da permissão bigquery.tables.get para ela.
  • Para pesquisar um conjunto de dados, você precisa da permissão bigquery.datasets.get para ele.

O papel de leitor de metadados do BigQuery (roles/bigquery.metadataViewer) inclui as permissões bigquery.tables.get e bigquery.datasets.get e permite pesquisar qualquer recurso do BigQuery.

Para mais informações sobre como conceder papéis, consulte Gerenciar acesso.

Também é possível receber as permissões necessárias com papéis personalizados ou outros papéis predefinidos.

Ativar a API

Para usar a pesquisa, verifique se a API Dataplex está ativada. A API Dataplex é ativada por padrão para todos os novos projetos Trusted Cloud com o BigQuery. Se a API Dataplex não estiver ativada no seu projeto, consulte Ativar o catálogo universal do Dataplex.

  1. No console Trusted Cloud , acesse a página Pesquisa do BigQuery.

    Acesse Pesquisar

  2. No campo de pesquisa, digite sua consulta em linguagem natural e pressione Enter. Confira alguns exemplos de consultas:

    • Show me the datasets that contain taxi information
    • Find data on vaccine distribution across different countries
    • Get tables with historical temperature data for major world cities
    • Search for hurricane tracking and storm activity datasets
    • Population data by country

  3. Para filtrar a pesquisa, clique em Filtros. Os seguintes filtros estão disponíveis:

    • Escopo: pesquise em toda a organização (padrão), no projeto atual ou apenas nos recursos marcados com estrela. Para mais informações, consulte a seção Escopo da pesquisa deste documento.
    • Sistemas: o serviço Trusted Cloud a que o recurso pertence, como o BigQuery. O sistema do Dataplex Universal Catalog contém grupos de entrada.
    • Projetos: os projetos em que pesquisar.
    • Tipo: o tipo de recurso, como conexão do BigQuery, bucket do Cloud Storage ou banco de dados. Dependendo do tipo de recurso, também é possível filtrar por subtipo, como o tipo de conexão ou o dialeto SQL.
    • Selecionar locais: os locais em que pesquisar.
    • Selecionar conjuntos de dados: limita os resultados da pesquisa aos recursos do BigQuery que pertencem aos conjuntos de dados selecionados. No campo Digite para filtrar, insira o nome do conjunto de dados.
    • Anotações: os tipos de aspecto do Dataplex Universal Catalog associados ao recurso que você está procurando. Para filtrar por valores de aspecto, clique em Filtrar por valores de anotação e selecione os valores.

    Para remover um filtro, clique em Limpar ao lado do filtro específico que você quer remover. Para remover todos os filtros, clique em Limpar filtros.

    Para mais informações sobre como os filtros são avaliados, consulte a seção Filtros deste documento.

  4. Opcional: para ver mais informações sobre um recurso, clique no nome dele nos resultados da pesquisa.

    Isso abre um resumo do recurso em um painel dividido. Execute um dos seguintes procedimentos:

    • Para abrir o recurso no serviço a que ele pertence, clique em Abrir em PRODUCT_NAME. Por exemplo, para abrir um conjunto de dados do BigQuery no BigQuery Studio, clique em Abrir no Studio. As opções disponíveis dependem do recurso.
    • Para conferir os metadados do Dataplex Universal Catalog associados a um recurso, clique em Abrir no catálogo do Dataplex.
    • Se você tiver resultados de pesquisa importantes que quer marcar como favoritos, clique na estrela. Clique em Marcar com estrela para o recurso. É possível conferir os recursos marcados com estrela no BigQuery Studio.
    • Para fechar o resumo de recursos no painel dividido, clique em Fechar.

Filtros

Os filtros permitem restringir os resultados da pesquisa.

Quando você fornece filtros em várias seções, eles são avaliados usando o operador lógico AND. Os resultados da pesquisa contêm recursos que correspondem a pelo menos uma condição de cada seção selecionada. Por exemplo, se você selecionar o sistema BigQuery e o tipo de recurso dataset, os resultados da pesquisa vão incluir conjuntos de dados do BigQuery, mas não da Vertex AI.

Se você selecionar vários filtros em uma única seção, eles serão avaliados usando o operador lógico OR. Por exemplo, se você selecionar os tipos de recurso dataset e table, os resultados da pesquisa vão incluir conjuntos de dados e tabelas.

Escopo de pesquisa

Para projetos que pertencem a uma organização do Trusted Cloud , a pesquisa opera no escopo dessa organização.

Os resultados da pesquisa respeitam as permissões que você tem sobre os recursos. Por exemplo, se você tiver acesso de leitura de metadados do BigQuery a um recurso, ele vai aparecer nos resultados da pesquisa. Se você tiver acesso a uma tabela do BigQuery, mas não ao conjunto de dados que contém essa tabela, ela ainda vai aparecer como esperado nos resultados da pesquisa.

Os resultados da pesquisa incluem apenas os recursos que pertencem ao mesmo perímetro do VPC Service Controls que o projeto em que a pesquisa é realizada. Ao usar o console Trusted Cloud , esse é o projeto selecionado no console.

A seguir