Database

1. Geral

O Database é o local onde você gerencia e manipula os dados na plataforma Mitra. Ele permite criar tabelas, atributos, carregar dados externos, criar scripts, queries e views de banco de dados.

2. Criando Novos Itens

No topo da lista de dados, o botão “+ Novo” permite adicionar tabelas, importar CSV, importar de banco externo, criar queries, scripts e views.

2.1. Tabela

Permite a criação de tabelas diretamente no banco de dados do Mitra. Existem dois tipos de tabelas: com chave simples ou com chave composta.

2.1.1. Tabela de Chave Simples

Uma única coluna identifica exclusivamente cada registro. Esse tipo de tabela é utilizado para cadastros ou transações. A configuração inclui o campo ID, onde você define se ele vai ser Auto Incremental, Numérico ou Texto. Outras configurações, como o grupo ao qual a tabela pertence, podem ser ajustadas conforme necessário.

Os atributos padrão, como ID, Descrição, Data de Criação, Usuário de Criação, Data da Última Alteração e Usuário da Última Alteração, são criados automaticamente e não podem ser alterados ou removidos.

Após criar tabelas de chave simples, é permitido realizar as seguintes configurações e carregamentos:

Configurações:

• Alterar o grupo ao qual a tabela pertence.

• Definir o tipo do ID: numérico, texto ou auto incremental.

• Ajustar o tipo de exibição: apenas descrição, apenas código ou ambos.

• Definir a ordenação padrão: ordenação por código ou por descrição.

Carregamentos: Criar um carregamento de dados externos para essa tabela, como importar dados a partir de um arquivo CSV ou de um banco de dados externo conectado. Para mais detalhes, consulte a documentação de conexões.

2.1.2. Tabela de Chave Composta

Composta por duas ou mais colunas que, juntas, identificam exclusivamente um registro. Ao criar uma tabela com chave composta, você seleciona os cadastros que irão compor essa chave.

Após criar tabelas de chave composta, é permitido realizar as seguintes configurações e carregamentos:

Configurações:

• Alterar o grupo ao qual a tabela pertence.

• Gerenciar as chaves da tabela composta: Adicionar ou remover cadastros que compõem a chave composta.

Carregamentos: Assim como nas tabelas de chave simples, é possível configurar carregamentos externos para alimentar a tabela a partir de diferentes fontes de dados, como CSV ou banco de dados externos. Para mais detalhes, consulte a documentação de conexões.

2.2. Importar CSV

Permite carregar dados a partir de arquivos CSV. Pode ser usado para tabelas com chave simples ou composta. Consulte a documentação "Conexões" para mais detalhes.

2.3. Importar de Banco Externo

Conecta e importa dados de bancos de dados externos. Também pode ser utilizado para tabelas com chave simples ou composta. Mais detalhes na documentação "Conexões".

2.4. Query

Crie e execute consultas SQL personalizadas. Utilize o dicionário de dados e variáveis de filtro para construir queries de forma eficiente e integrada aos filtros aplicados nas telas.

2.5. Scripts

Permite escrever operações de DML, como INSERT, DELETE e UPDATE. O dicionário de dados e variáveis de filtro também estão disponíveis para auxiliar na criação dos scripts.

3. Configurações de Tabelas

Nas configurações da tabela, você pode gerenciar como os dados serão exibidos e ordenados nos seletores e visualizações, além de escolher se a tabela será exibida nas operações de Drill ou não.

3.1. Criando um Novo Atributo

Para adicionar um novo atributo, clique no ícone “+” ao lado do último atributo listado. Você pode definir o nome e o tipo do atributo. Ele pode ser numérico, texto, data, seletor único ou uma Foreign Key (FK), que cria um relacionamento com outra tabela.

3.1.1. Atributo Dinâmico

O Mitra também permite que você crie atributos dinâmicos, que são uma espécie de view que puxa dados em tempo real com base em uma query. Ele permite que os valores sejam atualizados dinamicamente de acordo com os dados subjacentes.

Ao configurar um atributo dinâmico, sua query deve retornar duas colunas:

• Uma coluna com o ID do cadastro onde o atributo será criado.

• Uma coluna com o resultado do atributo dinâmico.

Essas duas colunas precisam ser mapeadas, ou seja, identificadas e marcadas no sistema para que o Mitra reconheça corretamente seus valores e relacionamentos.

Exemplo Prático:

Vamos ilustrar o processo de criação de um atributo dinâmico com um exemplo simples: imagine que você tenha uma tabela de "Movimentações Financeiras" que contém dados de valor unitário e quantidade de cada transação. Nosso objetivo é criar um atributo dinâmico que calcule automaticamente o valor total de cada transação (quantidade × valor unitário). Assim, sempre que a quantidade ou o valor unitário forem alterados, o valor total será atualizado em tempo real.

Passo a Passo:

• Acesse a tabela: Navegue até a tabela onde deseja adicionar o atributo dinâmico. Nesse exemplo, estamos na tabela "Movimentações Financeiras".

• Adicionar novo atributo: No canto superior da tela da tabela, clique no botão "+" para adicionar um novo atributo.

• Selecione o tipo de atributo: Escolha o tipo de atributo que deseja adicionar. No nosso exemplo, o atributo será numérico (pois estamos calculando um valor).

• Marcar como dinâmico: Ao selecionar o tipo de atributo, marque a opção "Dinâmico". Isso habilitará um campo para você escrever a query que será usada para calcular o valor dinâmico.

• Escrever a query: Agora, no campo da query, você deve escrever a consulta SQL que retornará os valores desejados. No nosso exemplo, a query utilizada retornará o "ID" da transação e o "Valor Total" calculado.

• Mapeamento de colunas: Após execultar a query, será necessário configurar a marcação dos resultados para definir qual coluna da query estará associada a qual atributo. A primeira marcação deve ser na coluna "ID" retornada pela query, adicionando o chip "ID" da tabela "Movimentação Financeira" A segunda marcação deve ser na coluna "VALOR_TOTAL" da query, adicionando o chip "Valor Total".

• Resultado esperado: Depois de seguir este passo a passo, você terá um atributo dinâmico configurado para exibir o valor total de cada movimentação financeira na tabela, com base na multiplicação de "quantidade" por "valor unitário". Segue o vídeo de modelo para a configuração desse exemplo.

3.2. Tabelas Nativas do Mitra

O Mitra gera automaticamente algumas tabelas nativas, como Usuários, Tipos de Usuários, Calendário, Telas e Módulos, ao criar um projeto.