Diagramas (Schema)

A ferramenta Diagramas (Schema) fornece uma representação visual dos modelos de dados e dos relacionamentos entre tabelas. Ela ajuda desenvolvedores e agentes de IA a entender como os datasets estão estruturados e conectados, tornando a exploração, análise e raciocínio sobre os dados mais precisos.

Essa ferramenta também pode ser habilitada para agentes de IA, permitindo que eles interpretem corretamente os relacionamentos entre tabelas ao responder perguntas ou gerar insights.

---

O que o Diagram (Schema) permite

• Visualizar relacionamentos entre tabelas

• Esclarecer relações um-para-um, um-para-muitos e muitos-para-muitos

• Servir como referência para modelagem de dados e analytics

• Fornecer contexto estrutural para agentes de IA

---

Como configurar diagramas

1. Acesse o diagrama por meio do ícone no menu lateral.

2. Em Configurações, defina:

   • Um nome claro para o schema ou diagrama

   • A descrição do propósito e escopo do schema

   • A coluna utilizada para filtrar dados relacionados ao usuário

3. Na aba Tabelas, selecione e filtre as tabelas que deseja utilizar no diagrama.

4. Arraste as tabelas desejadas para o canvas.

5. Crie os relacionamentos entre as tabelas utilizando as chaves correspondentes de cada uma.

6. Após relacionar as tabelas, defina a cardinalidade do relacionamento.

7. Clique em Salvar para persistir a configuração do schema.

8. Acesse o diagrama configurado na aba Diagramas do painel.

---

Benefícios dos relacionamentos

Esses relacionamentos ajudam usuários e agentes a compreender:

• Como os dados fluem entre as tabelas

• Quais tabelas devem ser relacionadas (joins)

• Onde faz sentido aplicar agregações

---

Metadata Viewer

Clique em “Ver metadados” para acessar os metadados de schema gerados.

Esses metadados são representados em formato JSON e incluem:

• Tabelas

• Colunas

• Tipos de dados

• Possibilidade de valores nulos (nullability)

• Referências de banco de dados e schema

---

Estrutura de metadados explicada

Seção Tables

{
  "tables": [
    {
      "tableName": "sales",
      "databaseName": "bucket_78",
      "fields": [...]
    }
  ]
}

Atributos	Descrição
tableName	Tabela a qual as colunas pertencem
columnName	Nome da coluna
columnLength	Tamanho da coluna (se aplicável)
dataType	Tipo de dado e nulidade

Por que os metadados são importantes

Os metadados gerados são utilizados por:

• Funcionalidades de IA (compreensão contextual dos dados)

• Construtores de queries

• Descoberta de dados

• Governança e linhagem de dados

• Documentação automatizada

Eles garantem que:

• A semântica das colunas seja consistente

• As respostas da IA sejam mais precisas

• Ferramentas downstream compreendam corretamente a estrutura do schema

---

Como os agentes de IA utilizam o diagrama

Quando habilitado para um agente de IA, o Diagram (Schema) permite que o agente:

• Compreenda os relacionamentos entre tabelas antes de consultar os dados

• Escolha caminhos corretos de join

• Evite suposições incorretas sobre a estrutura dos dados

• Explique resultados com base no contexto estrutural

---

Boas práticas

• Mantenha schemas focados e específicos por domínio

• Utilize nomes claros e consistentes

• Defina colunas de filtro de usuário quando aplicável

• Evite diagramas excessivamente complexos em um único schema

• Habilite diagramas apenas para agentes que realmente precisam de entendimento estrutural

Um schema limpo melhora significativamente a compreensão tanto para humanos quanto para agentes de IA.