Pesquisar recursos

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

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

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

A pesquisa de linguagem natural se concentra em melhorar 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, o representante da sua 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 para informar as próximas etapas.

Antes de começar

Antes de usar a pesquisa de linguagem natural no BigQuery para pesquisar recursosGoogle Cloud , 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.

Os resultados da pesquisa no BigQuery são definidos de acordo com suas permissões do IAM nos recursos subjacentes. Para pesquisar um recurso no BigQuery, você precisa ter permissões para acessar o recurso correspondente. 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 respectivas permissões 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 esse conjunto.

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 você ativou a API Dataplex. A API Dataplex é ativada automaticamente para todos os novos Google Cloud projetos com o BigQuery. Se a API Dataplex não estiver ativada no projeto, consulte Ativar o catálogo universal do Dataplex.

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

    Acesse Pesquisar

  2. No campo de pesquisa, digite a 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 sua 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 em recursos marcados com estrela. Para mais informações, consulte a seção Escopo da pesquisa deste documento.
    • Sistemas: o Google Cloud serviço ao qual o recurso pertence, como o BigQuery. O sistema do Dataplex Universal Catalog contém grupos de entrada.
    • Projects: os projetos em que você quer pesquisar.
    • Type: 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 você quer pesquisar.
    • Selecionar conjuntos de dados: limita os resultados da pesquisa a recursos do BigQuery que pertencem aos conjuntos de dados do BigQuery selecionados. No campo Type to filter, insira o nome do conjunto de dados.
    • Anotações: os tipos de aspectos 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 conferir mais informações sobre um recurso, clique no nome dele nos resultados da pesquisa.

    Isso abre um resumo de recursos 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 Dataplex Catalog.
    • Se você tiver resultados de pesquisa importantes que quer marcar, é possível marcar com estrela. Clique em Star para o recurso. É possível conferir os recursos marcados com estrela no BigQuery Studio.
    • Para fechar o resumo do recurso 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 do 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 o tipo de recurso dataset e o tipo de recurso table, os resultados da pesquisa vão incluir conjuntos de dados e tabelas.

Escopo de pesquisa

Para projetos que pertencem a uma organização Google Cloud , a pesquisa opera no escopo dela.

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, esse recurso 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 Google Cloud , esse é o projeto selecionado no console.

A seguir