Os tipos de arquivos clássicos não estarão mais disponíveis para uso a partir de janeiro de 2021. Você pode fazer a transição de seus arquivos clássicos ou baixar um PDF. Saber mais
Centro de suporte da Workiva
Comandos de transformação tabular
Comandos de transformação tabular
Última atualização em
Para preparar dados de valores separados por delimitadores (DSV) para upload, como, por exemplo, para massagear dados tabulares no formato necessário, adicione uma etapa em uma cadeia que use um comando de conexão de transformação tabular. Por exemplo:
Dividir conjuntos de dados com base no conteúdo de um registro
Para adicionar uma linha de cabeçalho a um arquivo de valores separados por vírgula (CSV), use o comando Add Header.
Propriedades
Propriedade
Detalhes
Arquivo de entrada
Digite o arquivo ao qual você deseja adicionar os cabeçalhos.
Delimitador
Selecione o delimitador usado para separar as colunas em Arquivo de entrada.
Visualizar resultados
Para visualizar as dez primeiras linhas e o cabeçalho dos resultados da transformação, marque essa caixa.
Linha de cabeçalho
Insira todo o conteúdo da linha de cabeçalho. Separe cada cabeçalho com um delimitador, como, por exemplo, Column1,Column2,Column3.
Delimitador de cabeçalho
Digite o delimitador usado para separar os cabeçalhos em Linha de cabeçalho, como ,
Saídas
Saída
Tipo de saída
CSV com cabeçalhos
Arquivo
Contagem de registros
Inteiro
Códigos de saída
Código
Tipo
Detalhes
0
Sucesso
Sucesso
1
Erro
Argumentos inválidos
2
Erro
Falha geral
Adicionar números de linha
Para adicionar o número da linha ao DSV na primeira coluna, use o comando Add Row Numbers.
Propriedades
Propriedade
Detalhes
Arquivo de entrada
Digite o arquivo ao qual você deseja adicionar números de linha.
Arquivo de saída
Digite o nome do arquivo resultante da transformação.
Delimitador
Digite o delimitador usado para separar as colunas em Arquivo de entrada.
Visualizar resultados
Para visualizar as primeiras dez linhas e o cabeçalho dos resultados da transformação, marque essa caixa.
Saídas
Saída
Tipo de saída
Adicionar saída de números de linha
Arquivo
Contagem de registros
Inteiro
Códigos de saída
Código
Tipo
Detalhes
0
Sucesso
Sucesso
1
Erro
Argumentos inválidos
2
Erro
Falha geral
14
Erro
Local do arquivo de saída inválido
15
Erro
O caractere de escape usado em Arquivo de entrada, geralmente um "
Consulta avançada
Para executar uma consulta SQL em um ou mais arquivos CSV, use o comando Advanced Query. Você também pode unir outros arquivos que você anexa a este comando.
Observação: Este comando suporta instruções SELECT e instruções complementares JOIN, mas não instruções como INSERT, UPDATE ou CREATE. Para inserir linhas, use o comando Empilhar arquivos; para atualizar linhas, use Localizar e substituir.
Propriedades
Propriedade
Detalhes
Tabelas
Digite todos os arquivos a serem usados na consulta, bem como o nome da tabela.
Se os nomes de colunas ou identificadores contiverem espaços ou caracteres especiais, use colchetes. Por exemplo, [Column A], [Column B].
Para formatar dados com duas casas decimais, use a sintaxe SELECT PRINTF('%.2f',(SUM(DATA))) AS EBITDA FROM HFMDat.
Para selecionar a primeira instância de uma duplicata, por exemplo, se dois registros tiverem o mesmo ID, use a sintaxe select * from group by ID having MIN(ID) ORDER BY ID.
Para concatenar várias strings, use o operador || como em string1 || string2 [ || string_n ].
Delimitador de entrada
Selecione o delimitador usado em Tabelas, bem como os arquivos de junção.
Delimitador de saída
Selecione o delimitador a ser usado nos resultados da consulta.
Exibição
Para imprimir uma visualização dos resultados da consulta, marque esta caixa.
O comando Consulta avançada tenta determinar automaticamente o tipo de dado de uma coluna. Para preservar zeros à esquerda de um valor que o comando confunde com um inteiro, use comandos Localizar e substituir — com Regex e Substituir apenas correspondências selecionados — para adicionar aspas simples (') em torno dos valores da coluna e, em seguida, removê-las após a conclusão do comando Consulta avançada:
Para adicionar aspas simples, localize (\d+) e substitua por '$1'.
Para remover as aspas simples, localize '(\d+)' e substitua por $1.
Com Regex selecionado, o comando Localizar e substituir usa os parênteses (()) para capturar o grupo ou os caracteres e, em seguida, os substitui como o primeiro parâmetro $1. Para criar várias capturas, use conjuntos subsequentes de parênteses e valores incrementais como $2.
Saídas
Saída
Tipo de saída
Resultado
Arquivo
Contagem de registros
Inteiro
Códigos de saída
Código
Tipo
Detalhes
0
Sucesso
Sucesso
1
Erro
Argumentos inválidos
2
Erro
Falha geral
14
Erro
Local do arquivo de saída inválido
15
Erro
O caractere de escape usado em Arquivo de entrada, geralmente um "
Alterar delimitador
Para alterar o delimitador de um arquivo CSV, use um comando Alterar delimitador.
Observação: Para cumprir a especificação RFC, sempre use um único caractere como delimitador, de preferência vírgula ou tabulação.
Propriedades
Propriedade
Detalhes
Arquivo de entrada
Digite o arquivo a ser transformado.
Delimitador de entrada
Insira o delimitador atualmente usado no Arquivo de entrada. Para um caractere de tabulação, insira \t.
Delimitador de saída
Insira o delimitador a ser usado após a transformação. Para um caractere de tabulação, digite \t.
Visualizar resultados
Para visualizar as primeiras dez linhas e o cabeçalho dos resultados da transformação, marque essa caixa.
Manter linhas vazias
Marque essa caixa para manter as linhas vazias em sua saída. Elas são removidas por padrão.
Saídas
Saída
Tipo de saída
Resultado CSV
Arquivo
Contagem de registros
Inteiro
Códigos de saída
Código
Tipo
Detalhes
0
Sucesso
Sucesso
1
Erro
Argumentos inválidos
2
Erro
Falha geral
Limpar quebras de linha sem aspas
Para tentar limpar um arquivo que esteja em conformidade com a Request for Comments (RFC), exceto no que se refere a caracteres de nova linha não citados, use o comando Clean Unquoted Newlines. Por exemplo, use este comando para processar arquivos de dados com caracteres inconsistentes para retornos de carro ou novas linhas.
Observação: Este comando limpa apenas novas linhas sem aspas. Outros problemas de não conformidade ainda farão o conjunto de dados falhar.
Propriedades
Propriedade
Detalhes
Resultado da visualização
Para visualizar o resultado no registro do comando, marque essa caixa.
Arquivo de entrada
Digite o arquivo a ser limpo.
Delimitador de arquivo
Selecione o delimitador para cada coluna em Arquivo de entrada.
Usar aspas lenientes
Para permitir que as aspas apareçam em campos sem aspas e que aspas não duplas apareçam em campos com aspas, marque essa caixa.
Acrescentar texto ao final
Para anexar qualquer linha de coluna única sem delimitadores no arquivo de entrada ao último valor da última coluna do registro anterior, marque esta caixa.
Saídas
Saída
Tipo de saída
Saída de novas linhas limpas
Arquivo
Contagem de linhas
Inteiro
Observação: A saída Line count fornece o número total de registros - incluindo o cabeçalho - na saída Cleaned newlines output.
Códigos de saída
Código
Tipo
Detalhes
0
Sucesso
Sucesso
1
Erro
Falha ao criar a saída de nova linha limpa
Filtro de coluna
Para filtrar as colunas DSV com cabeçalhos que correspondam ao padrão especificado, use o comando Column Filter.
Propriedades
Propriedade
Detalhes
Arquivo de entrada
Digite o arquivo a ser transformado.
Arquivo de saída
Digite o nome do arquivo resultante da transformação.
Delimitador
Selecione o delimitador usado em Arquivo de entrada.
Tipo de padrão
Selecione o tipo de padrão para filtrar:
Índice para filtrar por índice de coluna
Exato para filtrar por uma lista de valores exatos separados por vírgulas
Insira o padrão para corresponder às colunas. Se o Tipo de padrão for Índice, aplique o operador de propagação, como 0:5,7:8,10:15. Observação: A primeira coluna tem um valor de índice "0", e não "1".
Visualizar resultados
Para visualizar as primeiras dez linhas e o cabeçalho dos resultados da transformação, marque essa caixa.
Inversa
Para manter as colunas correspondentes e remover todas as outras, marque essa caixa.
Saídas
Saída
Tipo de saída
Saída do filtro de coluna
Arquivo
Contagem de registros
Inteiro
Códigos de saída
Código
Tipo
Detalhes
0
Sucesso
Sucesso
1
Erro
Argumentos inválidos
2
Erro
Falha geral
14
Erro
Local do arquivo de saída inválido
15
Erro
O caractere de escape usado em Arquivo de entrada, geralmente um "
Concatenar arquivos
Para mesclar vários arquivos de fonte de dados tabulares horizontalmente em um único conjunto de dados CSV, use o comando Concat Files.
Propriedades
Propriedade
Detalhes
Arquivos de origem
Digite os arquivos a serem concatenados.
Resultado da visualização
Para visualizar o resultado no registro do comando, marque essa caixa.
Delimitador de arquivo
Selecione o delimitador usado em Arquivos de origem.
Saídas
Saída
Tipo de saída
CSV mesclado
Arquivo
Contagem de registros
Inteiro
Códigos de saída
Código
Tipo
Detalhes
0
Sucesso
Sucesso
1
Erro
Falha ao gerar CSV
Converter CSV para XLSX
Para converter um arquivo CSV em uma pasta de trabalho do Microsoft Excel® (XLSX), use o comando Convert CSV to XLSX.
Propriedades
Propriedade
Detalhes
Arquivo de entrada
Digite o arquivo a ser convertido em XLSX.
Delimitador
Selecione o delimitador usado em Arquivo de entrada.
Nome da aba
Digite o nome da planilha a ser criada na pasta de trabalho do Excel.
Arquivo de saída
Digite o caminho para o local onde você deseja armazenar o arquivo (opcional). Se você estiver usando como saída para outro comando na cadeia, deixe em branco.
Saídas
Saída
Tipo de saída
Saída XLSX
Arquivo
Códigos de saída
Código
Tipo
Detalhes
0
Sucesso
Sucesso
1
Erro
Argumentos inválidos
Converter JSON para CSV
Para converter um arquivo JSON em CSV, use o comando Convert JSON to CSV.
Propriedades
Propriedade
Detalhes
Arquivo de entrada
Digite o arquivo JSON a ser convertido em CSV.
Arquivo de saída
Digite o caminho para onde você deseja salvar o novo arquivo CSV. Se você estiver usando como saída para outro comando na cadeia, deixe em branco.
Prévia dos resultados
Para visualizar as primeiras dez linhas e o cabeçalho dos resultados da transformação, marque essa caixa.
Saídas
Saída
Tipo de saída
Saída de CSV
Arquivo
Códigos de saída
Código
Tipo
Detalhes
0
Sucesso
Sucesso
1
Erro
Argumentos inválidos
Converter para tabela cruzada
Para converter um conjunto de dados tabulares - como uma saída de consulta Oracle Essbase® multidimensional expressions (MDX) - em uma tabulação cruzada, ou crosstab, use o comando Convert to Cross-Tab. Este comando baseia o layout da tabela cruzada nos cabeçalhos de coluna e linha definidos como tuplas no conjunto de dados tabulares de entrada.
Por exemplo, com este comando, este conjunto de dados:
A configuração terá uma aparência semelhante a esta:
Propriedades
Propriedade
Detalhes
Resultado da visualização
Para visualizar o formato de tabela de referência cruzada, marque essa caixa.
Arquivo de entrada
Insira o arquivo a ser convertido para o formato de tabela cruzada, com os cabeçalhos de coluna e linha definidos como tuplas.
Observação: Configure o arquivo de entrada de modo que a primeira coluna seja um conjunto delimitado de valores a serem distribuídos horizontalmente e a primeira linha seja um conjunto delimitado de valores a serem distribuídos verticalmente.
Delimitador de arquivo
Selecione o delimitador usado com as colunas em Arquivo de entrada.
Delimitador de campo
Digite o caractere a ser usado para separar cada divisão de campo no formato de tabela de referência cruzada.
Omitir a chave (célula A1)
Para omitir a célula A1 do arquivo de entrada do formato de tabulação cruzada, marque esta caixa. Por exemplo, se a célula A1 contiver (A,B), as células A1 e A2 do formato de tabela cruzada ficam em branco; caso contrário, contêm A e B.
Saídas
Saída
Tipo de saída
Relatório de tabulação cruzada
Arquivo
Contagem de linhas
Inteiro
Observação: A saída Line count fornece o número total de linhas na saída do relatório Crosstab, incluindo todas as linhas de cabeçalho.
Códigos de saída
Código
Tipo
Detalhes
0
Sucesso
Sucesso
1
Erro
Argumentos inválidos
Converter XLSX em CSV
A versão de transformação tabular desse comando foi descontinuada. Todas as cadeias existentes que usam esse comando continuarão funcionando, mas nenhuma instância futura poderá ser criada.
Para copiar uma coluna de um arquivo DSV, use o comando Copy Column.
Propriedades
Propriedade
Detalhes
Arquivo de entrada
Digite o arquivo a ser transformado.
Arquivo de saída
Digite o nome do arquivo resultante da transformação.
Delimitador
Selecione o delimitador usado em Arquivo de entrada.
Nome da coluna
Digite o nome da coluna a ser copiada.
Nome da nova coluna
Digite o nome da cópia resultante da coluna.
Inserir índice
Digite o índice da coluna em que você deseja inserir a cópia da coluna.
Prévia dos resultados
Para visualizar as primeiras dez linhas e o cabeçalho dos resultados da transformação, marque essa caixa.
Saídas
Saída
Tipo de saída
Copiar saída da coluna
Arquivo
Contagem de registros
Inteiro
Códigos de saída
Código
Tipo
Detalhes
0
Sucesso
Sucesso
1
Erro
Argumentos inválidos
2
Erro
Falha geral
14
Erro
Local do arquivo de saída inválido
15
Erro
O caractere de escape usado no arquivo de entrada, geralmente um "
Extrair valor
Para extrair um valor de um arquivo DSV pelo índice de linha e pelo índice de coluna, use o comando Extract Value.
Propriedades
Propriedade
Detalhes
Arquivo de entrada
Digite o arquivo a ser transformado.
Delimitador
Selecione o delimitador usado em Arquivo de entrada.
Índice de linha
Digite o número da linha da qual você deseja extrair o valor, com a primeira linha em Input file sendo 1.
Índice de coluna
Digite o número da coluna da entrada Row index da qual você deseja extrair. Para extrair a linha inteira, deixe em branco.
Saídas
Saída
Tipo de saída
Linha
JSON
Valor
String
Códigos de saída
Código
Tipo
Detalhes
0
Sucesso
Sucesso
1
Erro
Argumentos inválidos
2
Erro
Falha geral
Filtrar linhas
Para filtrar as linhas do DSV por uma expressão regular (regex) ou pela correspondência exata de uma ou mais colunas na linha, use o comando Filter Rows.
Propriedades
Propriedade
Detalhes
Arquivo de entrada
Digite o arquivo a ser transformado.
Arquivo de saída
Digite o nome do arquivo resultante da transformação.
Delimitador
Selecione o delimitador usado em Arquivo de entrada.
Localizar padrão
Digite o padrão a ser usado para encontrar correspondências.
Tipo de correspondência de padrão
Selecione se você deseja fazer a correspondência com um padrão Regex ou Exact.
Não diferencia maiúsculas de minúsculas
Para ignorar as maiúsculas e minúsculas do texto, marque essa caixa.
Inverso
Para manter todas as linhas correspondentes e descartar as demais, marque essa caixa.
Colunas de pesquisa
Insira uma lista separada por vírgulas de índices de coluna para limitar a pesquisa.
Prévia dos resultados
Para visualizar as primeiras dez linhas e o cabeçalho dos resultados da transformação, marque esta caixa
Observação: O comando Filtrar linhas requer um arquivo DSV adequado com cabeçalhos. Para filtrar a primeira linha de um arquivo sem cabeçalhos, use o comando Localizar de uma conexão de utilitários de arquivo.
Saídas
Saída
Tipo de saída
Filtrar a saída da linha
Arquivo
Contagem de registros
Inteiro
Códigos de saída
Código
Tipo
Detalhes
0
Sucesso
Sucesso
1
Erro
Argumentos inválidos
2
Erro
Falha geral
14
Erro
Local do arquivo de saída inválido
15
Erro
O caractere de escape usado em Input File, geralmente um "
Localizar e substituir
Para localizar e substituir valores de coluna nos dados com base em uma expressão regular , em uma string de texto completo ou em um índice de coluna, use o comando Find and Replace.
Propriedades
Propriedade
Detalhes
Arquivo de entrada
Digite o arquivo a ser transformado.
Arquivo de saída
Especifique se deseja gerar o arquivo original ou uma cópia:
Para gerar o arquivo original com seus valores de coluna atualizados, digite o mesmo arquivo que Arquivo de entrada.
Para gerar uma cópia do original com os valores de coluna atualizados, insira o nome do novo arquivo.
Delimitador
Selecione o delimitador usado em Arquivo de entrada.
Localizar padrão
Digite a expressão regular, a cadeia de caracteres de texto ou o índice de coluna a ser usado para identificar os valores a serem substituídos, com base em Match pattern type.
Tipo de correspondência de padrão
Selecione como identificar os valores de coluna a localizar:
Para localizar valores com base em uma expressão regular, selecione Regex.
Para localizar valores que correspondam a uma string de texto completo, selecione Exato.
Para localizar valores com base na coluna, selecione Índice.
Observação:Exato corresponde à string completa em cada coluna. Para localizar e substituir um valor parcial em uma coluna, selecione Regex e Substituir apenas correspondências.
Valor de substituição
Insira o texto com o qual substituir os valores correspondentes.
Observação: Se Tipo de padrão de correspondência for Índice, o valor de substituição substituirá todos os valores da coluna correspondente.
Não diferencia maiúsculas de minúsculas
Para ignorar as maiúsculas e minúsculas do texto, marque essa caixa.
Substituir apenas correspondências
Se Match pattern type is Regex, marque essa caixa para substituir apenas o texto correspondente pelo valor de substituição.
Visualizar resultados
Para visualizar as dez primeiras linhas e o cabeçalho dos resultados da transformação, marque essa caixa.
Colunas
Insira uma lista de colunas separadas por vírgula para definir o escopo do comando, com 0 para a primeira coluna. Por exemplo, 0,1,2,3 limita o comando às primeiras quatro colunas.
Observação: Para aplicar o mesmo valor de Valor de substituição a vários valores, use uma expressão regular como valor de Localizar padrão, como (?:Variance|Variance %|All Periods|FY15|YTD).
Saídas
Saída
Tipo de saída
Saída de localização e substituição
Arquivo
Contagem de registros
Inteiro
Códigos de saída
Código
Tipo
Detalhes
0
Sucesso
Sucesso
1
Erro
Argumentos inválidos
2
Erro
Falha geral
14
Erro
Local do arquivo de saída inválido
15
Erro
O caractere de escape usado em Input File, geralmente um "
Inserir coluna
Para inserir uma coluna em um arquivo DSV, use o comando Insert Column.
Propriedades
Propriedade
Detalhes
Arquivo de entrada
Digite o arquivo a ser transformado.
Arquivo de saída
Digite o nome do arquivo resultante da transformação.
Delimitador
Selecione o delimitador usado em Arquivo de entrada.
Texto do cabeçalho
Digite o nome do novo cabeçalho da coluna.
Valor dos dados
Digite o texto a ser inserido na nova coluna.
Inserir índice
Digite o índice da coluna em que você deseja inserir a nova coluna.
Prévia dos resultados
Para visualizar as primeiras dez linhas e o cabeçalho dos resultados da transformação, marque esta caixa.
Observação: Para inserir várias colunas, adicione uma coluna ao arquivo de entrada com o cabeçalho EMPTY_REPLACED_HEADER, com um valor para cada linha de EMPTY_REPLACED_VALUE. Com a conexão de utilitários de arquivo, use os comandos Localizar e substituir para substituir o espaço reservado do cabeçalho pelo cabeçalho de coluna desejado e o espaço reservado do valor por uma string com o número necessário de vírgulas.
Saídas
Saída
Tipo de saída
Inserir saída de coluna
Arquivo
Contagem de registros
Inteiro
Códigos de saída
Código
Tipo
Detalhes
0
Sucesso
Sucesso
1
Erro
Argumentos inválidos
2
Erro
Falha geral
14
Erro
Local do arquivo de saída inválido
15
Erro
O caractere de escape usado em Arquivo de entrada, geralmente um "
Unir colunas
Para unir várias colunas de um arquivo DSV e, opcionalmente, descartar as colunas usadas, use o comando Join Columns.
Propriedades
Propriedade
Detalhes
Arquivo de entrada
Digite o arquivo a ser transformado.
Arquivo de saída
Digite o nome do arquivo resultante da transformação.
Delimitador
Selecione o delimitador de Arquivo de entrada.
Índice da coluna unida
Insira o índice numérico da nova coluna. Para a primeira coluna, digite 0.
Tipo de correspondência de padrão
Selecione o tipo de padrão para pesquisar colunas:
Para pesquisar por localização de coluna, selecione Índice.
Para inserir uma lista de cabeçalhos separados por vírgula, selecione Exato.
Insira o padrão ou o índice a ser usado para localizar as colunas a serem unidas.
Cabeçalho da coluna unida
Digite o nome da nova coluna criada a partir da união.
Texto de união
Digite o texto que une os valores na nova coluna, como -.
Descartar
Para remover as colunas unidas para criar a nova, marque essa caixa.
Prévia dos resultados
Para visualizar as primeiras 10 linhas e o cabeçalho dos resultados da transformação, marque essa caixa.
Saídas
Saída
Tipo de saída
Juntar saída de coluna
Arquivo
Contagem de registros
Inteiro
Códigos de saída
Código
Tipo
Detalhes
0
Sucesso
Sucesso
1
Erro
Argumentos inválidos
2
Erro
Falha geral
14
Erro
Local do arquivo de saída inválido
15
Erro
O caractere de escape usado em Arquivo de entrada, geralmente um "
Mapear cabeçalhos
Para substituir uma lista de cabeçalhos por outra lista de cabeçalhos, use o comando Map Headers. Nas listas, separe os cabeçalhos com vírgulas; a ordem importa.
Propriedades
Propriedade
Detalhes
Arquivo de entrada
Digite o arquivo a ser transformado.
Arquivo de saída
Digite o nome do arquivo resultante da transformação.
Delimitador
Selecione o delimitador de Arquivo de entrada.
Cabeçalhos de entrada
Insira uma lista dos cabeçalhos a serem substituídos por novos valores, na mesma ordem de . Cabeçalhos de saída.
Cabeçalhos de saída
Digite uma lista dos novos cabeçalhos a serem incluídos na saída, na mesma ordem que Cabeçalhos de entrada.
Visualizar resultados
Para visualizar as primeiras dez linhas e o cabeçalho dos resultados da transformação, marque essa caixa.
Usar índices
Se Os cabeçalhos de entrada usam índices numéricos, marque essa caixa.
Saídas
Saída
Tipo de saída
Saída dos cabeçalhos do mapa
Arquivo
Contagem de registros
Inteiro
Códigos de saída
Código
Tipo
Detalhes
0
Sucesso
Sucesso
1
Erro
Argumentos inválidos
2
Erro
Falha geral
14
Erro
Local do arquivo de saída inválido
15
Erro
O caractere de escape usado em Arquivo de entrada, geralmente um "
Pivô
Para representar os valores em uma coluna de dados como colunas separadas, use o comando Pivot. Ao dinamizar uma coluna, os valores únicos de suas linhas se tornam novos cabeçalhos de coluna.
Se você dinamizar a coluna MEASURE, agregar a coluna Amount e especificar as colunas restantes como linhas, a saída substituirá a coluna MEASURE por colunas para seus valores Sales e COGS e exibirá os respectivos valores:
Se você dinamizar as colunas MEASURE e Period, cada combinação única de seus valores aparecerá como colunas, como Sales-JAN, Sales-FEB, COGS-JAN e assim por diante:
Insira o arquivo com os dados a serem dinamizados.
Delimitador
Selecione o delimitador usado para separar os campos em Arquivo de entrada.
Agregação
Selecione como agregar os valores dinamizados:
SUM, para recolher registros com os mesmos valores de linha em um único registro. Recomendado.
NONE, para criar várias linhas para um único conjunto de valores equivalentes. Cada linha da coluna dinamizada será preenchida, mas outras podem incluir NULL.
Valores a agregar
Insira a coluna com os dados a serem incluídos nas linhas das colunas dinâmicas, como a coluna Amount no exemplo anterior.
Colunas de pivô
Insira as colunas com valores de linha a serem usados como cabeçalhos de coluna. Se você tiver várias colunas, uma coluna separada aparecerá para cada combinação exclusiva de seus valores.
Delimitador de coluna
Se você tiver vários Colunas dinâmicas, digite o delimitador a ser usado para separar seus valores nos novos cabeçalhos de coluna.
Linhas de pivô
Insira as colunas em Arquivo de entrada para manter. Na saída, cada combinação única dos valores dessas colunas aparece como linhas. Do not insira as mesmas colunas que Valores para agregar ou Colunas dinâmicas.
Visualizar resultados
Para ativar uma visualização dos dados dinamizados, marque essa caixa.
Saídas
Saída
Tipo de saída
Resultado dinamizado
Arquivo
Códigos de saída
Código
Tipo
Detalhes
0
Sucesso
Sucesso
1
Erro
Argumentos inválidos
2
Erro
Falha geral
14
Erro
Local do arquivo de saída inválido
15
Erro
O caractere de escape usado em Arquivo de entrada, geralmente um "
Reordenar colunas
Para reorganizar as colunas de um arquivo DSV, use o comando Reorder columns (Reordenar colunas). Você pode identificar as colunas pelo nome ou índice.
Propriedades
Propriedade
Detalhes
Arquivo de entrada
Digite o arquivo a ser transformado.
Delimitador
Selecione o delimitador usado em Arquivo de entrada.
Ordem das colunas
Insira uma matriz das colunas individuais ou intervalos do Arquivo de entrada, na ordem em que devem aparecer no arquivo transformado. Para especificar colunas, use o nome ou índice, começando em 1. Por exemplo, insira 4:6 ou ColA:ColC para especificar um intervalo, ou 7 ou ColH para uma coluna individual.
Observação: As colunas do Arquivo de entradanão incluídas em Ordem das colunas aparecem no final das colunas do arquivo transformado, na mesma ordem do Arquivo de entrada.
Visualizar resultados
Para mostrar uma visualização dos resultados - o cabeçalho e as primeiras 10 linhas - na saída do comando, marque esta caixa.
Saídas
Saída
Tipo de saída
Arquivo transformado
Arquivo
Linhas transformadas
Inteiro
Códigos de saída
Código
Tipo
Detalhes
0
Sucesso
Sucesso
1
Erro
Argumentos inválidos
2
Erro
Falha geral
Filtro inteligente de linhas
Para aplicar critérios de vários grupos de filtro — com base em valores de texto, data ou número — às linhas de um arquivo DSV, use um comando Filtro inteligente de linhas. Você pode filtrar linhas por expressão regular ou correspondência exata de uma ou mais de suas colunas.
Propriedades
Propriedade
Detalhes
Arquivo de entrada
Digite o arquivo a ser transformado.
Arquivo de saída
Digite o nome do arquivo resultante da transformação.
Delimitador
Selecione o delimitador usado em Arquivo de entrada.
Inverso
Para manter - em vez de remover - todas as linhas que correspondam a Filtros, marque esta caixa.
Filtros
Para configurar os filtros de texto, número ou data a serem aplicados ao Arquivo de entrada, selecione o operador para os grupos de filtro — E ou OU — e configure os critérios para cada um.
Para um grupo de filtro de texto:
Em Nome da coluna, insira o nome da coluna a filtrar.
Para ignorar o uso de maiúsculas e minúsculas em Nome da coluna e Texto de comparação, selecione Não diferencia maiúsculas de minúsculas.
Em Condição e Texto de comparação, insira os critérios do valor a pesquisar na coluna, como "Igual a [texto]" ou "Contém [texto]". <!--To apply
the inverse of the Condition
input, such as to match text that does not
equal or contain the Compare Text
input, select Not.-->
<!--
To remove any leading or trailing spaces from
matched text, select Trim.
-->
Para um grupo de filtro de número:
Em Formato, selecione o formato do número a corresponder — Inteiro ou Decimal. Se puder ser qualquer um dos dois, selecione Decimal.
Em Nome da coluna, insira o nome da coluna a filtrar.
Em Condição e Número de teste, insira os critérios do valor a pesquisar na coluna, como "Igual a [número]" ou "Menor que [número]". <!--To apply the inverse
of the Condition input,
such as to match numbers that do not
equal the Test Number input,
select Not.-->
<!--
To match numbers regardless of whether they're
positive or negative, select Absolute Value.
-->
Para um grupo de filtro de data:
Em Formato, insira 2 de janeiro de 2006 no formato da data a corresponder, como 2006-01-02.
Em Nome da coluna, insira o nome da coluna a filtrar.
Em Condição e Data de comparação, insira os critérios do valor a pesquisar na coluna, como "Igual a [data]" ou "Menor que [data]".
<!--To
apply the inverse of the Condition
input, such as to match dates that do not
equal the Compare Date
input, select Not.-->
Visualizar resultados
Para mostrar uma visualização dos resultados na saída do comando, marque essa caixa.
Saídas
Saída
Tipo de saída
Saída de linha de filtro inteligente
Arquivo
Contagem de registros
Inteiro
Códigos de saída
Código
Tipo
Detalhes
0
Sucesso
Sucesso
1
Erro
Argumentos inválidos
2
Erro
Falha geral
14
Erro
Local do arquivo de saída inválido
15
Erro
O caractere de escape usado em Arquivo de entrada, geralmente um "
Dividir arquivo
Para dividir um arquivo em vários arquivos com base em uma contagem de registros, use o comando Split File. Por exemplo, use este comando para processar partes menores em paralelo e melhorar o desempenho
Propriedades
Propriedade
Detalhes
Arquivo de entrada
Digite o arquivo a ser dividido em vários arquivos.
Delimitador de arquivo
Selecione o delimitador para cada coluna em Arquivo de entrada.
Preceder cabeçalho
Para incluir o cabeçalho de Arquivo de entrada em cada bloco de arquivo criado, marque essa caixa.
Registros por arquivo
Digite o número máximo de registros a serem incluídos em cada bloco de arquivo.
Saídas
Saída
Tipo de saída
Dividir pedaços de arquivos
Arquivo
Número de blocos
Inteiro
Códigos de saída
Código
Tipo
Detalhes
0
Sucesso
Sucesso
1
Erro
Falha ao criar os pedaços de arquivo
Valor de divisão
Para dividir uma coluna em várias colunas com um delimitador de valor, use o comando Split Value.
Propriedades
Propriedade
Detalhes
Arquivo de entrada
Digite o arquivo a ser transformado.
Arquivo de saída
Digite o nome do arquivo resultante da transformação.
Delimitador
Selecione o delimitador usado para separar as colunas em Arquivo de entrada.
Novos cabeçalhos
Digite uma lista dos novos cabeçalhos a serem criados a partir do valor de divisão, em ordem.
Nome da coluna
Digite o cabeçalho da coluna a ser dividida.
Delimitador de valor
Digite o delimitador para dividir o valor.
Descartar coluna
Para remover a coluna que está sendo dividida, marque essa caixa.
Prévia dos resultados
Para visualizar as primeiras dez linhas e o cabeçalho dos resultados da transformação, marque essa caixa.
Saídas
Saída
Tipo de saída
Saída de valores divididos
Arquivo
Contagem de registros
Inteiro
Códigos de saída
Código
Tipo
Detalhes
0
Sucesso
Sucesso
1
Erro
Argumentos inválidos
2
Erro
Falha geral
14
Erro
Local do arquivo de saída inválido
15
Erro
O caractere de escape usado em Arquivo de entrada, geralmente um "
Empilhar arquivos
Para empilhar os valores de uma lista de arquivos de valores separados por delimitadores (DSV) uns sobre os outros em uma ordem especificada, use o comando Stack Files. A linha de cabeçalho do primeiro arquivo será usada no novo arquivo.
Observação: Para empilhar arquivos com este comando, todos devem ter o mesmo número de colunas. Para empilhar arquivos assimétricos, use o conector Utilitários de arquivo e seu comando Empilhar arquivos.
Propriedades
Propriedade
Detalhes
Arquivos
Digite os arquivos DSV a serem empilhados.
Arquivo de saída
Digite o nome do arquivo resultante da transformação.
Delimitador
Selecione o delimitador usado para separar as colunas em Files.
Arquivo de entrada
Insira os arquivos a empilhar, separados por vírgula.
Observação: Ao usar um loop, este campo é obrigatório (pois os arquivos não são carregados na seção Arquivos). O comando acionará um erro de "arquivo não encontrado" se adicionado à seção Arquivos.
Visualizar resultados
Para visualizar as primeiras dez linhas e o cabeçalho dos resultados da transformação, marque essa caixa.
Saídas
Saída
Tipo de saída
Saída de arquivos de pilha
Arquivo
Contagem de registros
Inteiro
Códigos de saída
Código
Tipo
Detalhes
0
Sucesso
Sucesso
1
Erro
Argumentos inválidos
2
Erro
Falha geral
14
Erro
Local do arquivo de saída inválido
15
Erro
O caractere de escape usado em Arquivo de entrada, geralmente um "
Transpor
Para girar todos os campos de um arquivo delimitado ao longo de seus eixos horizontal e vertical, de modo que as linhas se tornem colunas e vice-versa, use o comando Transpose. Por exemplo, com este comando, este CSV:
id,1,2,3,4 name,"Johnson, Smith, and Jones Co.","Sam Smith",Barney & Co.,Johnson's Auto amount,345.33,933.40,0,2344 remark,Pays on time,,"Great to work with.",
torna-se:
id,name,amount,remark 1,"Johnson, Smith, and Jones Co",345.33,Pays on time 2,"Sam Smith",933.40, 3,Barney & Co.,"Great to work with." 4,Johnson's Auto,2344,
Propriedades
Propriedade
Detalhes
Prévia dos resultados
Para visualizar as primeiras dez linhas e o cabeçalho dos resultados da transformação, marque essa caixa.
Arquivo de entrada
Digite o arquivo delimitado a ser transposto.
Delimitador de arquivo
Selecione o delimitador de cada coluna de Arquivo de entrada.
Tamanho do bloco
Insira o tamanho máximo - em MB - de cada arquivo de trabalho para processamento.
Saídas
Saída
Tipo de saída
CSV transposto
Arquivo
Contagem de registros
Inteiro
Observação:Record Count fornece o número total de linhas em Transposed CSV, e não, incluindo a linha do cabeçalho.
Códigos de saída
Código
Tipo
Detalhes
0
Sucesso
Sucesso
1
Erro
Falha ao transpor o arquivo de entrada
Reverter pivô
Para consolidar várias colunas de dados - como períodos de tempo em dados financeiros - em uma única coluna com várias linhas, use o comando Unpivot. Por exemplo, com estes dados:
Insira o arquivo com os dados a serem dinamizados.
Delimitador
Selecione o delimitador usado para separar os campos em Arquivo de entrada.
Agregação
Selecione como agregar os valores com pivô revertido:
SUM, para agregar registros quando os valores forem iguais em todas as colunas. Recomendado.
NONE, para criar linhas duplicadas com o valor de dados exclusivo de cada registro.
Etiqueta da nova coluna
Insira o cabeçalho da coluna na saída com linhas baseadas nas colunas com pivô revertido. No exemplo anterior, Período.
Cabeçalho da coluna de dados
Insira o cabeçalho da coluna na saída com dados das colunas com pivô revertido. No exemplo anterior, Amount.
Cabeçalhos de dados
Para reverter o pivô de colunas específicas, liste seus cabeçalhos pressionando Enter entre cada um. No exemplo anterior, JAN, FEB, MAR e assim por diante.
Nome da coluna de início do pivô
Para reverter o pivô de um intervalo de colunas por cabeçalho, insira o nome da primeira coluna do intervalo. No exemplo anterior, JAN.
Nome da coluna de fim do pivô
Para reverter o pivô de um intervalo de colunas por cabeçalho, insira o nome da última coluna do intervalo. No exemplo anterior, DEC.
Observação: Se você inserir Nome da coluna de início do pivô, mas não inserir Nome da coluna de fim do pivô, o comando reverterá o pivô dessa coluna e de todas as colunas à direita de Nome da coluna de início do pivô. Isso pode ser útil com dados gerados por previsões contínuas.
Índice da coluna de início do pivô
Para reverter o pivô de um intervalo de colunas por posição, insira o valor de índice da primeira coluna do intervalo. Use um índice baseado em zero, em que as colunas do Arquivo de entrada começam em 0. No exemplo anterior, 5.
Índice da coluna de fim do pivô
Para reverter o pivô de um intervalo de colunas por posição, insira o valor de índice da última coluna do intervalo. Use um índice baseado em zero, em que as colunas do Arquivo de entrada começam em 0. No exemplo anterior, 16.
Observação: Se você inserir Índice da coluna de início do pivô, mas não inserir Índice da coluna de fim do pivô, o comando reverterá o pivô dessa coluna e de todas as colunas à direita de Índice da coluna de início do pivô. Isso pode ser útil com dados gerados por previsões contínuas.
Visualizar resultados
Para ativar uma visualização do resultado não pivotado, marque essa caixa.
Saídas
Saída
Tipo de saída
Resultado não pivotado
Arquivo
Códigos de saída
Código
Tipo
Detalhes
0
Sucesso
Sucesso
1
Erro
Argumentos inválidos
2
Erro
Falha geral
14
Erro
Local do arquivo de saída inválido
15
Erro
O caractere de escape usado em Arquivo de entrada, geralmente um "
Solução de problemas
Se um comando falhar, verifique se há esses problemas comuns.
Delimitador incorreto
Se o delimitador errado for definido quando você configurar um comando de transformação, a transformação não será executada conforme o esperado.
Não é um CSV adequado
Se o conjunto de dados tabulares não for um CSV adequado, o comando de transformação não será executado, pois ele verifica se o formato está em conformidade com a RFC 4180 antes de processar a entrada. Um CSV adequado:
Armazena dados em texto simples usando um conjunto de caracteres como ASCII, Unicode (por exemplo, UTF-8), EBCDIC ou Shift JIS.
Consiste em registros com um registro por linha e registros divididos em campos separados por delimitadores, geralmente um único caractere reservado, como vírgula, ponto e vírgula ou tabulação. Às vezes, o delimitador pode incluir espaços opcionais.
Tem a mesma sequência de campos para todos os registros
Normalmente é uma saída de relatório de dados planos ou relacionais
Número inconsistente de colunas em cada registro
Se os registros em um conjunto de dados tabulares tiverem contagens de colunas diferentes, o comando de transformação detectará que não se trata de um CSV adequado.
Contagens de colunas diferentes
A combinação de dois conjuntos de dados tabulares CSV adequados com diferentes contagens de colunas não funcionará, e o comando Stack Files exibirá um erro.
Para preparar dados de valores separados por delimitadores (DSV) para upload, como, por exemplo, para massagear dado...