Conexões

1. Geral

A funcionalidade de Conexões no Mitra permite que você importe dados de arquivos CSV ou de uma conexão JDBC, seja para criar novas tabelas ou para atualizar tabelas já existentes no sistema.

1.1. Usos das Conexões

As conexões podem ser usadas para construir novas tabelas ou para atualizar tabelas já existentes.

• Criando uma nova tabela: Você pode criar uma tabela diretamente a partir de uma importação via CSV ou conectando-se a um banco de dados externo. Isso é feito na área de criação de tabelas, localizada no canto superior esquerdo da tela. Nessa área, você pode optar por criar uma tabela manualmente ou a partir de uma conexão com arquivos CSV ou JDBC.

  • Antes de iniciar a criação, é necessário definir o tipo de ID que a tabela irá utilizar, escolhendo entre as opções: Auto Incremental, Numérico ou Texto. Essa configuração é fundamental para definir como cada linha será identificada de forma única. Escolher corretamente o tipo de ID garante uma estrutura organizada e facilita futuras interações com a tabela, como filtragens e carregamentos de dados externos.

  
  

• Atualizando uma tabela existente: Quando você já está dentro de uma tabela, no canto superior direito, é possível visualizar a lista de conexões existentes para aquela tabela e adicionar uma nova conexão. Ao criar uma nova conexão, você poderá adicionar novas colunas e linhas à tabela já existente.

2. Conexões para Tabelas de Chave Simples

Ao criar uma conexão para uma tabela de chave simples, no lado esquerdo do modal, você verá um preview dos dados que podem vir de um arquivo CSV ou de uma Query JDBC. Do lado direito, está o resumo, onde se faz a configuração da conexão.

2.1. Configuração de Colunas

Primeira Coluna (ID) e Segunda Coluna (Descrição): Para tabelas de chave simples em que o ID é do tipo INT ou VARCHAR, a primeira coluna sempre será o ID e a segunda a descrição. Para tabelas com ID autoincremental, a primeira coluna será sempre a descrição, já que o ID será gerado automaticamente.

Escolha de Colunas: Para cada coluna do seu conjunto de dados, você pode escolher uma das quatro opções:

• Nova Coluna: Adicionar a coluna como uma nova coluna na tabela. Ela pode ser Texto, Numérico, Data ou uma FK.

• Ignorar: Não incluir essa coluna na tabela.

• Descrição de uma FK: Se você tiver colunas que funcionam como chaves estrangeiras, como “Solicitante ID” e “Solicitante Descrição”, você pode definir “Solicitante ID” como uma nova coluna do tipo FK, enquanto “Solicitante Descrição” é configurada como a descrição dessa FK. Dessa forma, as colunas serão associadas corretamente e, para cada nova FK definida, será criada automaticamente uma tabela separada contendo o ID e a descrição configurados. Isso permite que cada chave estrangeira tenha sua própria tabela de referência, facilitando o gerenciamento e a vinculação de dados no sistema.

  
  

• Coluna Existente: Associar a coluna a uma já existente na tabela. Observação: Essa opção só estará disponível quando você estiver editando uma tabela existente, pois ao criar uma nova tabela, não haverá colunas pré-existentes.

2.2. Opções Adicionais

Fonte de Dados: Você pode alterar a fonte de dados clicando no botão “Fonte de dados”, alternando entre CSV e SQL conforme necessário.

Agendamento de Conexões: Se escolher importar os dados por um banco de dados externo, via SQL, é possível agendar a execução da conexão para horários específicos utilizando um código CRON, permitindo automações como execuções horárias ou diárias.

Critério de Adição de Linhas: Ao configurar a conexão para uma tabela já existente, você pode definir se o carregamento de dados deve adicionar apenas novas linhas ou se pode atualizar linhas já existentes. Observação: Esse critério só estará disponível quando você estiver atualizando uma tabela existente, já que ao criar uma nova tabela, todas as linhas serão novas.

3. Conexões com Tabelas de Chave Composta

Ao criar uma conexão para uma tabela de chave composta, o processo de configuração das colunas difere das tabelas de chave simples. Em uma tabela de chave composta, onde várias colunas podem atuar como chaves, essas chaves podem estar em qualquer posição no conjunto de dados. Para cada coluna, você poderá escolher uma das seguintes opções:

• Nova Coluna: Se você definir uma coluna como nova, poderá escolher se ela será uma Foreign Key (FK). Caso seja uma FK, você pode criar o cadastro dessa FK no momento da configuração ou vincular a uma FK já existente. Toda coluna configurada como FK fará parte da chave composta da tabela.

• Descrição de uma FK: Além disso, é possível marcar uma coluna como a descrição de uma FK, vinculando-a à FK correspondente.

  • Exemplo: Suponha que você tenha duas colunas, “Gerente de Vendas ID” e “Gerente de Vendas Descrição”. Você pode marcar “Gerente de Vendas ID” como uma nova coluna do tipo FK e “Gerente de Vendas Descrição” como a descrição dessa FK, vinculando-a ao “Gerente de Vendas ID”.

  
  

• Ignorar: Esta opção permite que você descarte colunas que não serão utilizadas na tabela.

• Coluna Existente: Utilize essa opção se você quiser mapear uma coluna do conjunto de dados para uma coluna já existente na tabela de destino. Observação: Essa opção só estará disponível quando você estiver editando uma tabela existente, pois ao criar uma nova tabela, não haverá colunas pré-existentes.

3.1. Configuração de Colunas do Tipo Tempo

Nas tabelas de chave composta, apenas uma coluna do tipo tempo (que inclui dia, mês, trimestre ou ano) pode ser utilizada. Se o seu conjunto de dados incluir mais de uma coluna temporal, você precisará selecionar qual delas será usada. Além disso, você deverá definir a granularidade da data e o formato adequado para o carregamento dos dados.

3.2. Configuração de Colunas Numéricas

Atenção: um dado do tipo número pode ser configurado como um atributo numérico ou uma FK (chave estrangeira). Atributo numérico é usado quando o valor será tratado como algo somável ou calculável, como "valor de vendas" ou "valor de mensalidade". Já uma FK é utilizada para representar um relacionamento, como "código de cliente" ou "código de produto", pois ao marcar como FK, você está ligando essa coluna a um cadastro destino, criando uma referência entre tabelas. Para colunas definidas como numéricas, elas serão tratadas como atributos do tipo numérico dentro do seu dataset. Estas colunas representam as métricas do seu conjunto de dados.

3.3. Opções Adicionais

Fonte de Dados: Você pode alterar a fonte de dados clicando no botão “Fonte de dados”, alternando entre CSV e SQL conforme necessário.

Agendamento de Conexões: Se escolher importar os dados por SQL, é possível agendar a execução da conexão para horários específicos utilizando um código CRON, permitindo automações como execuções horárias ou diárias.

3.4. Opções Adicionais de Carregamento

Ao configurar a conexão, você também terá a opção de decidir como os dados serão carregados na tabela de chave composta:

• Limpar Todos os Dados Antes do Carregamento: Essa opção remove todos os dados da tabela antes de importar o novo conjunto de dados.

• Utilizar uma das FKs como chave de substituição: Se você deseja adicionar novos dados sem reiniciar completamente a tabela, pode optar por utilizar uma das FKs como chave de substituição. Nesse caso, você escolherá uma FK específica dentro da tabela de chave composta. O sistema irá limpar apenas os registros que correspondem às chaves encontradas no novo conjunto de dados, antes de recarregar os dados para essas chaves específicas.