Export to Excel

Descrição

Exporta uma tabela de dados do Analyze para o PlaidCloud Document como um ficheiro Microsoft Excel. O PlaidCloud Analyze suporta as versões modernas do Microsoft Excel (2007-2016), bem como as versões antigas (2000/2003).

Parâmetros de exportação

Seletor de ficheiro de exportação

O seletor de ficheiro nesta transformação permite escolher um destino para guardar o resultado exportado num documento do PlaidCloud.

Escolhe-se um diretório e indica-se um nome de ficheiro para o ficheiro de destino.

Tabela de origem

Opção dinâmica

A opção dinâmica permite especificar uma tabela através de texto, incluindo variáveis. É útil em fluxos de trabalho orientados por variáveis, em que as referências a tabelas e vistas são relativas às variáveis especificadas.

Um exemplo que utiliza a variável current_month para apontar dinamicamente para a tabela de origem:

legal_entity/inputs/{current_month}/ledger_values

Opção estática

Quando se pretende uma tabela específica como origem da exportação, deixe a caixa Dynamic desassinalada e selecione a tabela de origem.

O Explorador de tabelas está sempre disponível com qualquer seleção de tabela. Clique no botão do Explorador de tabelas à direita da seleção da tabela e abre-se uma janela do Explorador de tabelas.

Selecionar uma conta de documentos

Escolha uma conta de documentos do PlaidCloud a que tenha acesso. Isto permite-lhe selecionar um diretório na seleção seguinte.

Dentro de um projeto, a lista oferece também Project Default no topo — um substituto da conta que o projeto tem atualmente definida como predefinida. Um novo passo pré-seleciona Project Default quando o projeto tem uma; um passo existente mantém a conta com que já tinha sido guardado até a alterar. Um passo deixado em Project Default é executado na conta que for a predefinição do projeto nesse momento — se não houver nenhuma definida, a execução falha e indica o projeto, em vez de recorrer a outra conta.

Caminho do diretório de destino

Selecione o ícone Procurar à direita do Caminho do diretório de destino e navegue até à localização onde pretende guardar o ficheiro.

Nome do ficheiro de destino

Indique o nome com que o ficheiro exportado deve ser guardado.

Nome da folha de destino

Indique o nome da folha de destino. O valor predefinido é Sheet1.

Dividir

Dividir reparte uma tabela por vários resultados, segundo os valores de uma coluna:

Sem divisão (predefinição) — um livro com a tabela na folha Nome da folha de destino.
Ficheiros separados — um livro por cada valor distinto da coluna, com as linhas desse valor.
Folhas separadas — um livro com uma folha por cada valor distinto, com o nome desse valor. Nome da folha de destino não é utilizado.

Defina Dividir por coluna com a coluna segundo a qual dividir; tem de ser uma coluna que a exportação escreva. Dar nome a cada ficheiro por define como Ficheiros separados dá nome a cada livro: Sufixo do nome do ficheiro ou Prefixo do nome do ficheiro acrescenta o valor ao nome do ficheiro, e Nome do ficheiro utiliza o valor como nome completo. Selecione Manter a coluna de divisão na saída para escrever também a coluna de divisão em cada resultado.

As linhas cujo valor está em branco não são escritas e o passo termina com um aviso. Folhas separadas é interrompido, indicando os valores, quando dois valores dão o mesmo nome de folha.

Selecionar a compressão do ficheiro

Todos os ficheiros exportados são não comprimidos, mas estão disponíveis as seguintes opções de compressão:

Sem compressão
Zip
GZip
BZip2

Escrever o cabeçalho na primeira linha

Se esta caixa de seleção estiver selecionada, os cabeçalhos da tabela são exportados para a primeira linha. Caso contrário, o ficheiro exportado não terá cabeçalhos.

Se o ficheiro existir

Em Mais opções do Excel, Um ficheiro que já existe (if_exists) decide o que acontece quando o livro já existe: replace (predefinição) escreve um livro novo, append escreve as linhas abaixo da última linha utilizada da folha, a partir da coluna A, e fail interrompe o passo sem escrever nada. Um acréscimo transfere o livro, adiciona as linhas e carrega-o de novo, pelo que, quando duas execuções acrescentam ao mesmo ficheiro em simultâneo, prevalece a que terminar em último lugar. Selecione Voltar a escrever o cabeçalho abaixo das linhas existentes (header_on_append) para escrever de novo a linha de cabeçalho abaixo das linhas já existentes.

Definições adicionais

Mais opções do Excel inclui também estes campos:

Ordenar linhas por (sort_columns) — ordena as linhas escritas por estas colunas de origem, começando pela primeira chave, cada uma com uma definição de Coluna, Ascendente e Nulos. Não é necessário que uma coluna-chave seja escrita. Nulos assume por predefinição primeiro em ordem ascendente e último em ordem descendente. Não é utilizado com Resumir nem com Distinto.
Células em falta como (null_as) — texto escrito em cada célula em falta, incluindo as das colunas numéricas.
Uma folha existente (if_sheet_exists) — com Escrever no livro existente, mantendo a formatação (preserve_format) selecionado e um livro que já tem a folha: Falhar o passo (fail) interrompe o passo e Deixar como está (skip) deixa essa folha tal como está. Por predefinição, Escrever os dados nela escreve os dados na folha.

Limites de tamanho

Uma folha de cálculo do Excel contém, no máximo, 1 048 576 linhas (a linha de cabeçalho conta para este total) e 16 384 colunas. Um passo que produza mais do que isso é interrompido de imediato e informa-o, em vez de gastar a exportação a produzir um ficheiro que o Excel depois se recusa a abrir.

As exportações muito grandes também podem exceder o que o próprio formato de ficheiro permite, mesmo quando o número de linhas e de colunas está dentro do limite. Se isso acontecer, o passo indica que os dados da folha são demasiado grandes.

Para dados acima destes tamanhos, exporte antes para CSV ou Parquet — nenhum dos dois tem limite de linhas, e ambos são consideravelmente mais rápidos de produzir e mais pequenos de armazenar.

Seleção de dados da tabela

Configuração do Data Mapper

Table Data Mapper

O Data Mapper serve para mapear colunas dos dados de origem para a tabela de dados de destino.

Inspeção e preenchimento do mapeador

Utilizar o botão de menu Inspecionar origem oferece formas adicionais de mapear colunas da origem para o destino:

Preencher ambas as tabelas de mapeamento: propaga todos os valores da tabela de dados de origem para a tabela de dados de destino. É o comportamento predefinido.
Preencher apenas a tabela de mapeamento de origem: mapeia apenas todos os valores da tabela de dados de origem. É útil ao modificar um fluxo de trabalho existente cuja estrutura de colunas de origem mudou.
Preencher apenas a tabela de mapeamento de destino: propaga todos os valores apenas para a tabela de dados de destino.

Se as opções de colunas de origem e de destino não forem suficientes, podem adicionar-se outras colunas à tabela de dados de destino de várias formas:

Propagar tudo insere todas as colunas de origem na tabela de dados de destino, quer já existam ou não.
Propagar selecionadas insere apenas as colunas de origem selecionadas.
Clique com o botão direito do rato no lado do destino e selecione Inserir linha para inserir uma linha imediatamente acima da linha atualmente selecionada.
Clique com o botão direito do rato no lado do destino e selecione Acrescentar linha para inserir uma linha no fim (extremo direito) da tabela de dados de destino.

Eliminar colunas

Para eliminar colunas da tabela de dados de destino, selecione as colunas pretendidas, clique com o botão direito do rato e selecione Eliminar.

Colunas de origem que já não constam da lista

Uma linha de destino pode indicar uma Coluna de origem que a tabela de dados de origem já não lista, por exemplo depois de a origem ter sido inspecionada novamente. O passo nunca remove essa linha por si. Em vez disso, o nome da coluna é apresentado a vermelho, atrás de um sinal de aviso ⚠, e, ao passar o cursor por cima, é indicado que a coluna não consta das colunas de origem. Num passo com várias tabelas, como uma união, cada tabela é verificada em relação às suas próprias colunas de origem.

Uma linha com uma Constante, uma Expressão ou um resumo Contagem (incluindo nulos) nunca é sinalizada, porque o passo não lê a respetiva coluna de origem. Nada é sinalizado enquanto a tabela de dados de origem não listar colunas, por exemplo antes de a origem ser inspecionada pela primeira vez.

Ao guardar um passo que ainda tem linhas sinalizadas, uma caixa de diálogo Colunas obsoletas encontradas lista-as sob o separador ou a tabela em que se encontram e oferece três opções:

Remover todas e guardar: remove as linhas sinalizadas e depois guarda.
Guardar mesmo assim: guarda o passo tal como está.
Cancelar: volta ao passo sem guardar.

Para manter uma linha e eliminar o respetivo aviso, adicione a coluna de volta à tabela de dados de origem ou escolha uma coluna que a tabela de dados de origem liste.

Tipo de dados da coluna

Cada coluna de destino tem um Tipo. Uma coluna propagada da origem mantém o tipo da coluna de origem; uma linha que adicione manualmente começa como Texto, e define o Tipo para indicar o que a coluna deve realmente ser. Uma coluna que pretenda somar ou ordenar precisa do respetivo tipo numérico ou de data, porque o texto é ordenado e somado como texto.

Um passo guardado com uma coluna sem qualquer tipo é, mesmo assim, executado. O tipo é determinado quando o passo é iniciado, a partir da coluna de origem que essa coluna lê. Quando não há nada de onde o ler, é tratado como texto: as colunas de um passo Extrair SQL vêm da consulta que escreveu e não de uma origem mapeada e, quando várias origens têm o mesmo nome de coluna com tipos discordantes, é utilizado texto em vez de adivinhar um deles, porque um palpite errado produz uma conversão que o armazém pode rejeitar, e tudo se converte em texto.

Definir o Tipo manualmente continua a ser a forma de indicar o que uma coluna deve ser. Deixá-lo por definir significa aceitar o que a coluna de origem for.

Alterar a ordem das colunas

Para reordenar as colunas na tabela de dados de destino, selecione as colunas pretendidas. Pode utilizar:

Setas de movimento em massa: selecione a opção de movimento pretendida nas setas no canto superior direito
Menu de contexto: clique com o botão direito do rato e selecione Mover para o início, Mover para cima, Mover para baixo ou Mover para o fim.

Reduzir o resultado apenas a registos distintos

Para devolver apenas opções distintas, selecione a opção de menu Distinto. Isto apresenta um conjunto de caixas de verificação para cada coluna da origem. Basta marcar a caixa junto da coluna correspondente para devolver apenas resultados distintos.

Consoante a situação, pode ser preferível considerar a utilização da sumarização.

O processo de distinção mantém o primeiro registo único encontrado e descarta os restantes. Pode querer aplicar uma ordenação aos dados, se for importante para a consistência entre execuções.

Agregação e agrupamento

Para agregar resultados, selecione a opção de menu Resumir. Isto apresenta um conjunto de caixas de seleção para cada coluna da tabela de dados de destino. Escolha um método de sumarização adequado para cada coluna.

Quando Inspecionar origem preenche as colunas, uma coluna numérica começa como Agrupar por em vez de Soma se o nome se assemelhar a um identificador, como id, customer_id, Order No ou CustomerKey, se a respetiva tabela a definir como chave ou se a junção a utilizar como chave.

Agrupar por
Soma
Mínimo
Máximo
Primeiro
Último
Contagem
Contagem (incluindo nulos)
Média
Desvio padrão
Desvio padrão da amostra
Desvio padrão da população
Variância
Variância da amostra
Variância da população
Avançado sem agrupar por

Para uma utilização avançada do Data Mapper, como expressões, limpeza e constantes, consulte Utilização avançada do Data Mapper

Filtros de dados

Table Data Filters

Para permitir a máxima flexibilidade, existem filtros de dados disponíveis nos dados de origem e nos dados de destino. Em conjuntos de dados maiores, pode ser especialmente vantajoso filtrar linhas na origem, para que as restantes operações sejam executadas sobre um conjunto de dados mais pequeno.

Selecionar subconjunto de dados

Este tipo de filtro permite filtrar os dados de origem recebidos com base nas condições especificadas.

Aplicar filtro secundário aos dados de resultado

Este tipo de filtro permite aplicar um filtro aos dados de resultado depois de transformados, com base nas condições especificadas. A possibilidade de aplicar um filtro ao resultado transformado permite exclusões com base nos resultados de cálculos complexos, sumarizações ou funções de janela.

Divisão final da tabela de dados (limite)

A capacidade de divisão de linhas permite limitar as linhas do conjunto de resultados com base num intervalo e num ponto de partida.

Sintaxe de filtros

A sintaxe de filtros utiliza o Python SQLAlchemy, que é a mesma sintaxe das outras expressões.

Consulte exemplos e funções de expressão na área Expressões.

Exemplos

Ainda não há exemplos…