Pesquisar recursos

Use a pesquisa do Knowledge Catalog para encontrar Google Cloud recursos no BigQuery, como conjuntos de dados e tabelas do BigQuery.

A pesquisa do Knowledge 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 cotidiana.

Semelhante à pesquisa por palavras-chave, a pesquisa em linguagem natural enfatiza a descoberta de recursos analisando os metadados associados aos recursos da 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 melhorar a recuperação 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 no pré-lançamento, o representante da sua Conta do Google precisa enviar uma solicitação preenchendo o formulário de inscrição. Depois de 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 Google Cloud recursos, conclua as tarefas desta seção.

Funções exigidas

Para pesquisar recursos, você precisa de pelo menos uma das seguintes funções 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 de forma independente 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 de 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 essa tabela.
  • Para pesquisar um conjunto de dados, você precisa da permissão bigquery.datasets.get para esse conjunto de dados.

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

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

    Acesse Pesquisar

  2. No campo de pesquisa, insira 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: pesquisa em toda a organização (padrão), no projeto atual, ou apenas para recursos marcados com estrela. Para mais informações, consulte a seção Escopo de pesquisa deste documento.
    • Sistemas: o Google Cloud serviço a que o recurso pertence, como o BigQuery. O sistema do Knowledge 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 do BigQuery. No campo Digite para filtrar, insira o nome do conjunto de dados.
    • Anotações: os tipos de aspectos do Knowledge Catalog associados ao recurso que você está pesquisando. Para filtrar por valores de aspectos, 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. Ou, 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, nos resultados da pesquisa, clique no nome do recurso.

    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 no 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 Knowledge Catalog associados a um recurso, clique em Abrir no Knowledge Catalog.
    • Se você tiver resultados de pesquisa importantes que quer marcar, você pode marcar com estrela. Clique em Marcar com estrela para o recurso. Você pode ver recursos com estrela no BigQuery Studio.
    • Para fechar o resumo do recurso no painel dividido, clique em Fechar.

Como alternativa, pesquise 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 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 Google Cloud organização, a pesquisa opera no escopo dessa organização.

Os resultados da pesquisa respeitam as permissões que você tem nos 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 será exibida 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 Google Cloud console, esse é o projeto selecionado em o console.

A seguir