Pesquisar recursos

Use a pesquisa do Knowledge Catalog no BigQuery para encontrar recursos doGoogle Cloud , como conjuntos de dados e tabelas, usando consultas em linguagem natural. A pesquisa com linguagem cotidiana em metadados que você cria permite descobrir os recursos de dados necessários sem depender de correspondências exatas de palavras-chave.

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 no pré-lançamento, 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 com linguagem natural no BigQuery para buscar recursos doGoogle Cloud , conclua as tarefas nesta seção.

Funções exigidas

Para pesquisar recursos, você precisa de pelo menos um dos seguintes papéis do IAM do Knowledge 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 limitados de acordo com suas permissões do IAM nos recursos subjacentes. Para pesquisar um recurso no BigQuery, é preciso 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, é necessário ter a permissão bigquery.tables.get para essa tabela.
  • Para pesquisar um conjunto de dados, você precisa da permissão bigquery.datasets.get para esse conjunto de dados.

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 o 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 por padrão para todos os novos projetos do Google Cloud com o BigQuery. Se a API Dataplex não estiver ativada no projeto, consulte Ativar o Knowledge Catalog.

  1. No console do Google Cloud , acesse a página de 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 em recursos marcados com estrela. Para mais informações, consulte a seção Escopo da pesquisa deste documento.
    • Sistemas: o serviço do Google Cloud ao qual o recurso pertence, como o BigQuery. O sistema do Knowledge Catalog contém grupos de entrada.
    • Projetos: os projetos em que a pesquisa será feita.
    • 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 para 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 Knowledge 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, nos resultados da pesquisa, clique no nome dele.

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

    • Para abrir o recurso no serviço ao qual ele pertence, clique em Abrir em PRODUCT_NAME para o recurso. 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 ver os metadados do Knowledge Catalog associados a um recurso, clique em Abrir no Knowledge Catalog para o recurso.
    • Se você tiver resultados da pesquisa importantes que queira adicionar aos favoritos, poderá marcá-los com estrela. Clique em Marcar com estrela para o recurso. É possível ver os recursos marcados com estrela no BigQuery Studio.
    • Para fechar o resumo de recursos no painel dividido, clique em Fechar.

Como alternativa, é possível pesquisar recursos usando o Gemini Cloud Assist.

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 do BigQuery e o tipo de recurso dataset, os resultados da pesquisa vão incluir conjuntos de dados do BigQuery, mas não do Gemini Enterprise Agent Platform.

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 do Google 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 a contém, a tabela 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 do Google Cloud , esse é o projeto selecionado no console.

A seguir