Nesta página, descrevemos como descobrir e conhecer suas entidades de dados na extensão do Google Cloud Data Agent Kit para Visual Studio Code. A extensão oferece vários pontos de entrada para encontrar seus dados, desde um explorador e uma pesquisa do catálogo até um chat de agente.
Antes de começar
- Instale a extensão.
- Defina as configurações. Ative todas as APIs e configure seu projeto e região.
- Opcional: para interagir com recursos do Cloud SQL para MySQL, do Cloud SQL para PostgreSQL e do AlloyDB para PostgreSQL na extensão Data Agent Kit para VS Code, configure-os para que os metadados possam ser ingeridos no Knowledge Catalog. Para mais informações, consulte:
Conhecer o catálogo
O explorador de catálogo oferece uma visualização estruturada das suas entidades de dados. Navegue pelo catálogo seguindo estas etapas:
- Na barra de atividades do IDE, clique no ícone Kit do agente de dados do Google Cloud.
- No menu do Google Cloud Data Agent Kit, expanda a seção Catálogo. O explorador mostra essas fontes de dados em uma estrutura de árvore:
- Entidades de dados no BigQuery e no BigLake, além de entidades do AlloyDB, do Cloud SQL e do Spanner no seu projeto atual.
- Conjuntos de dados públicos do BigQuery.
- Outros projetos na sua organização a que você tem acesso. Clique em Carregar mais para vê-los no explorador.
- Para navegar na hierarquia, clique em um nó para expandi-lo. Por exemplo, quando você clica em um ID do projeto, o explorador mostra fontes de dados organizadas por nome do produto.
- Clique no nome de um produto para explorar as entidades de dados desse produto e continue expandindo para ver visualizações e tabelas.
- Clique em uma entidade de dados para conferir os detalhes dela em uma nova guia do editor.
- Clique com o botão direito do mouse no nome de um recurso para ver uma lista de ações rápidas, como Consulta ou Carregar em DataFrame do Spark.
Usar a descoberta com agente
Para encontrar conjuntos de dados usando linguagem natural, use o painel de chat do seu agente:
- Se o painel de chat não aparecer, abra a paleta de comandos pressionando Cmd/Ctrl+Shift+P, pesquise e execute Abrir chat.
- No painel Chat, insira um comando em linguagem natural, como "encontre o conjunto de dados que tem pedidos de clientes". O agente mostra o estado Raciocínio enquanto busca tabelas relevantes.
- Se o agente pedir para você executar comandos da CLI gcloud para ajudar na pesquisa, clique em Executar para cada comando.
- Depois que o agente mostrar a lista de conjuntos de dados relevantes encontrados no seu projetoGoogle Cloud , pesquise e explore-os no catálogo ou na pesquisa universal.
Usar a pesquisa universal
Inicie uma pesquisa universal na paleta de comandos ou na barra de atividades.
Atalho
- Pressione Cmd/Ctrl+Shift+P para abrir a paleta de comandos.
- Pesquise e selecione Pesquisar conjunto de dados.
- Digite sua consulta de pesquisa no seletor rápido e pressione Enter para iniciar a Pesquisa universal em uma nova guia do editor.
Barra de atividades
- Na barra de atividades do IDE, clique no ícone Kit do agente de dados do Google Cloud.
- No menu do Google Cloud Data Agent Kit, expanda a seção Catálogo.
- Clique em Pesquisa universal. A Pesquisa Universal é aberta em uma nova guia do editor.
- Digite sua consulta de pesquisa e pressione Enter para conferir os resultados.
Filtragem
No editor da pesquisa universal, use o painel flutuante Filtros para restringir os resultados por Escopo, Sistemas, Projeto, Tipo ou Localização.
Ver detalhes
Depois que uma entidade de dados é identificada, confira os detalhes dela em uma nova guia do editor.
- Nos resultados da pesquisa, clique em uma entidade para abrir os detalhes dela em uma nova guia.
- No Catalog Explorer, clique em um conjunto de dados, como o nome de uma tabela, para abrir a visualização de detalhes.
Guias de detalhes
O editor de detalhes é organizado em guias verticais para ajudar você a entender o contexto e a qualidade dos dados.
As guias exibidas dependem do tipo de entidade de dados que você está visualizando. Por exemplo, a visualização de detalhes de um conjunto de dados do BigQuery inclui as guias Detalhes e Relacionamentos, enquanto os detalhes de uma tabela do Spanner incluem as guias Esquema e Detalhes.
Tab |
Funcionalidade |
Visualizar |
Confira uma amostra dos dados do conjunto de dados. |
Esquema |
Veja nomes de colunas, tipos de metadados, descrições e outros detalhes do esquema do conjunto de dados. |
Detalhes |
Confira as propriedades da entidade de dados. |
Insights |
Acesse exemplos de consultas geradas por IA que ajudam você a começar a explorar conjuntos de dados. Para mais informações, consulte Acessar insights de dados no Knowledge Catalog. |
Linhagem |
Confira um mapa visual das origens e descendentes do conjunto de dados, além das mudanças ou transformações aplicadas. Para mais informações, consulte Sobre a linhagem de dados. |
Relacionamentos |
Confira um gráfico de relações com o conjunto de dados para entender como ele se relaciona com outros conjuntos. |
Perfil dos dados |
Ver resumos estatísticos dos dados. Para mais informações, consulte Criar e usar verificações de perfil de dados. |
Qualidade dos dados |
Confira métricas de qualidade de dados, como integridade, exclusividade ou atualização do conjunto de dados selecionado. Para mais informações, consulte Visão geral da qualidade de dados automática. |