Pular para o conteúdo principal

CSV para Tabela

Configuração atual da tarefa CSV to Table no Workflow Designer
  • Tipo de Tarefa: csv-to-table

A Tarefa CSV para Tabela é projetada para importar dados de um ficheiro no formato CSV (Comma-Separated Values) e inseri-los numa tabela de base de dados. A sua função é dupla: conecta-se a uma base de dados para escrever fisicamente os dados e, ao mesmo tempo, expõe os dados importados como um Dataset para utilização por Tarefas subsequentes no Fluxo de Trabalho (como um Iterator).

Configuração​

A configuração está dividida em duas abas principais: Conexão para os detalhes da base de dados e Ficheiro CSV para as especificações do ficheiro de origem.

1. Aba "Conexão"​

Esta secção é idêntica à de outras Tarefas de escrita em base de dados e define como se conectar ao destino.

  • Modo de Conexão: Selecione a origem das credenciais:
  • Manual: Insira manualmente todos os dados de conexão.
  • Ambiente: Selecione um ambiente de conexão pré-configurado para preencher automaticamente os campos.
  • Tipo de Base de Dados: Selecione o tipo de base de dados (ex. PostgreSQL, SQL Server, etc.).
  • Conexão SSL: Especifique se usar uma conexão segura (SSL).
  • Autenticação: Insira os detalhes para acesso:
  • Host: O endereço do servidor da base de dados.
  • Porta: A porta de comunicação.
  • Nome da BD: O nome da base de dados.
  • Utilizador: O nome de utilizador.
  • Palavra-passe: A palavra-passe associada.

2. Aba "Ficheiro CSV"​

Esta aba é o coração da Tarefa e define como o ficheiro CSV deve ser lido e mapeado.

  • Estrutura CSV:
  • Definição de Campo: Clicar neste botão abre a janela "Estrutura CSV - CSV para Tabela". Aqui define-se a estrutura da tabela de destino, mapeando cada coluna do CSV. Para cada campo (+ Adicionar Campo) especificam-se:
  • Nome: O nome da coluna na base de dados.
  • Tipo: O tipo de dado (String, Numeric, etc.).
  • Tamanho: O tamanho do campo.
  • Formato: Um formato específico para dados como datas.
  • Não Nulo: Se o campo não pode conter valores nulos.
  • Cabeçalho CSV: Especifica se a primeira linha do ficheiro CSV é um cabeçalho.
  • Sim: A primeira linha contém os nomes das colunas e não será importada como dado.
  • Não: O ficheiro não tem uma linha de cabeçalho; todos os dados são importados.
  • Codificação: A codificação dos caracteres do ficheiro (ex. UTF-8, ISO-8859-1).
  • Separador: O caractere usado no ficheiro CSV para separar os valores (ex. ,, ;, |, =).
  • Caractere de Aspas de String: O caractere usado para envolver os campos de texto, especialmente aqueles que contêm o separador (ex. ").
  • Tipo de Importação: O método de importação do ficheiro.
  • CSV Local: Carrega um ficheiro do seu computador através do botão "Escolher ficheiro".
  • CSV Web: Importa um ficheiro de uma URL web.
  • CSV Remoto: Importa um ficheiro de um caminho de rede remoto.
  • Tabela de Destino: A ação a executar na base de dados.
  • Tabela Existente: Insere os dados numa tabela já existente.
  • Nova Tabela: Cria uma nova tabela para os dados importados.
  • Nome da Tabela de Destino: O nome da tabela de destino. Pode ser um valor estático ou dinâmico (ex. #>nome_tabella<#).
  • Modo de Carregamento: Como inserir os dados numa Tabela Existente.
  • Anexar: Adiciona os novos dados aos já presentes.
  • Truncar Inserir: Esvazia completamente a tabela antes de inserir os novos dados.

Gestão da Estrutura da Tabela - Estrutura CSV​

No canto inferior direito do modal Estrutura CSV (CSV structure) existem três botões:

BotãoAção
GuardarGuarda a estrutura definida
ImportarImporta uma estrutura existente
ExportarExporta a estrutura definida

Esta funcionalidade permite guardar, exportar ou reutilizar os mapeamentos, evitando a compilação manual dos campos e reduzindo o risco de erros.

Nota Técnica

  • Visibilidade: As estruturas guardadas no sistema são visíveis exclusivamente para o utilizador que as criou.
  • Aprofundamento: Para uma descrição detalhada de todas as opções e da lógica de funcionamento, consulte a página Estrutura da Tabela.

Parâmetros de Saída​

Após a conclusão da importação, a Tarefa expõe os seguintes parâmetros:

  • targetTable: Retorna o nome da tabela do base de dados onde os dados foram inseridos.
  • sourceFilename: Retorna o nome do ficheiro CSV de origem que foi processado.
  • sourcePath: Retorna o caminho completo do ficheiro CSV de origem.
  • count: Indica o número total de linhas que foram importadas do ficheiro CSV.
  • result: Fornece o estado geral da execução da Tarefa (ex: "Success" ou uma mensagem de erro).
  • resultJson: Representa o resultado da execução da tarefa em formato JSON, incluindo informações gerais, configurações e detalhes da execução.
  • DataExportCsv: Retorna o conjunto de dados completo processado, formatado como texto em formato CSV.
  • DataExportJson: Retorna o conjunto de dados completo processado, formatado como uma string JSON.
  • Dataset: Este parâmetro representa o nome da coluna da tabela (Ex: name). É o parâmetro mais importante para ligar esta Tarefa a um Iterador. Para aceder aos valores de uma coluna específica durante uma iteração, utiliza-se a sintaxe Dataset.NomeColuna.
  • DataColumn: Este parâmetro permite aceder a todo o conteúdo de uma coluna como uma única entidade (por exemplo, um array ou uma lista).
  • DataColumn.NomeColuna: Retorna todos os valores da coluna “NomeColuna”. Ex: “Luca, Maria, Giovanni, Elena”