Import SPSS

Descrição

Importa arquivos de dados SPSS (formatos .sav e .zsav) para tabelas de projeto do PlaidCloud. Útil para dados de pesquisas, dados de pesquisa em ciências sociais ou qualquer pipeline que interopere com ferramentas baseadas em SPSS.

Os rótulos de variáveis e de valores são preservados quando o formato os oferece.

Exemplos

Ainda não há exemplos…

Itens de configuração exclusivos

Nenhum

Itens de configuração comuns

Opção Remover caracteres não ASCII

Ao selecionar esta opção, a importação remove qualquer conteúdo que não seja ASCII. Embora o PlaidCloud ofereça suporte total a Unicode (UTF-8), arquivos do mundo real podem conter todo tipo de codificação e caracteres soltos que dificultam o processamento.

Se o conteúdo do arquivo deve conter somente ASCII, marcar esta caixa ajuda a garantir que o processo de importação seja executado sem problemas.

Opção Excluir Arquivos Após a Importação

Esta opção permite que o processo de importação exclua o arquivo da conta de documentos do PlaidCloud após a conclusão bem-sucedida da importação.

Isso pode ser útil se os arquivos de importação são gerados e podem ser recriados a partir de um sistema de registro, ou se não há motivo para reter os arquivos de entrada brutos depois de processados.

Somente os arquivos importados são excluídos. Um arquivo que foi ignorado ou que gerou um aviso durante a importação permanece na pasta.

Seletor de arquivo de importação

O seletor de arquivo desta transformação permite escolher um arquivo armazenado em um local de documentos do PlaidCloud para importação.

Você também pode escolher um diretório para importar, e todos os arquivos dentro dele serão importados como parte da execução da transformação.

Seleção de uma conta de documentos

Escolha uma conta de documentos do PlaidCloud à qual você tenha acesso. Isso permite selecionar um diretório ou arquivo na próxima seleção.

Dentro de um projeto, a lista também oferece Project Default no topo, que representa a conta definida atualmente como padrão do projeto. Uma nova etapa pré-seleciona Project Default quando o projeto tem uma conta padrão; uma etapa existente mantém a conta com a qual foi salva até você alterá-la. Uma etapa deixada em Project Default é executada na conta que for a padrão do projeto no momento da execução; se nenhuma estiver definida, a execução falha e informa o nome do projeto, em vez de recorrer a outra conta.

Opção de pesquisa

A opção Pesquisar permite encontrar todos os arquivos correspondentes abaixo de um caminho de diretório especificado para importação. Isso pode ser especialmente útil quando é preciso incluir muitos arquivos, mas eles estão armazenados em diretórios aninhados ou misturados com outros arquivos do mesmo diretório que você não quer importar.

O caminho de pesquisa selecionado é o diretório inicial da busca. O processo de pesquisa procura todos os arquivos nesse diretório, bem como nos subdiretórios, que correspondam às condições de pesquisa especificadas. Verifique se os critérios de pesquisa também podem ser aplicados aos arquivos dos subdiretórios.

A pesquisa pode ser aplicada com as seguintes condições:

Exata: corresponde exatamente ao texto da pesquisa
Começa com: corresponde a qualquer arquivo que comece com o texto da pesquisa
Contém: corresponde a qualquer arquivo que contenha o texto da pesquisa
Termina com: corresponde a qualquer arquivo que termine com o texto da pesquisa

Um assistente de IA ou a API REST também pode definir a pesquisa como glob, um padrão com curinga como CO Store*.yxdb comparado com o nome completo do arquivo sem diferenciar maiúsculas de minúsculas, ou regex, uma expressão regular com a qual o nome completo do arquivo deve corresponder. Uma expressão regular diferencia maiúsculas de minúsculas, a menos que comece com (?i).

Opção de seleção de arquivo ou diretório

Quando é necessário importar um arquivo ou diretório de arquivos específico, escolher o arquivo ou o diretório é uma opção melhor do que usar a pesquisa.

Para selecionar o arquivo ou o diretório, basta usar o botão de procura para escolher o caminho na conta de documentos selecionada acima.

Substituição de variáveis

Tanto na opção de pesquisa quanto na opção de arquivo ou diretório específico, é possível usar variáveis no caminho, no texto da pesquisa e nos nomes de arquivo.

Um exemplo que usa a variável current_month para apontar dinamicamente para o arquivo correto:

legal_entity/inputs/{current_month}/ledger_values.csv

Tabela de destino

A seleção de destino para importações é limitada a tabelas, pois as visões não contêm dados subjacentes.

Opção dinâmica

A opção dinâmica permite especificar uma tabela por meio de texto, incluindo variáveis. Isso é útil ao usar fluxos de trabalho orientados por variáveis, nos quais as referências a tabelas e visões são relativas às variáveis especificadas.

Um exemplo que usa a variável current_month para apontar dinamicamente para a tabela de destino:

legal_entity/inputs/{current_month}/ledger_values

Opção estática

Quando você quiser uma tabela específica como destino da importação, deixe a caixa Dinâmico desmarcada e selecione a tabela de destino.

Se a tabela de destino não existir, selecione o botão Criar novo para criar a tabela no local desejado.

O Explorador de tabelas está sempre disponível em qualquer seleção de tabela. Clique no botão Explorador de tabelas à direita da seleção de tabela e uma janela do Explorador de tabelas será aberta.

Configuração do Data Mapper

Data Mapper de tabela

O Data Mapper é usado para mapear as colunas dos dados de origem para a tabela de dados de destino.

Inspeção e Preenchimento do Mapeador

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. Este é o comportamento padrão.
Preencher somente a tabela de mapeamento de origem: mapeia apenas todos os valores da tabela de dados de origem. Isso é útil ao modificar um fluxo de trabalho existente quando a estrutura de colunas da origem mudou.
Preencher somente a tabela de mapeamento de destino: propaga todos os valores apenas para a tabela de dados de destino.

Se as opções de coluna de origem e de destino não forem suficientes, é possível adicionar outras colunas à tabela de dados de destino de várias maneiras:

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

Exclusão de Colunas

Para excluir colunas da tabela de dados de destino, selecione as colunas desejadas, clique com o botão direito e selecione Excluir.

Colunas de Origem que Não Estão Mais Listadas

Uma linha de destino pode indicar uma Coluna de origem que a tabela de dados de origem não lista mais, por exemplo depois que a origem foi inspecionada novamente. A etapa nunca remove essa linha por você. Em vez disso, o nome da coluna aparece em vermelho, após um sinal de aviso ⚠, e ao passar o mouse sobre ele é exibida a informação de que a coluna não está nas colunas de origem. Em uma etapa com várias tabelas, como uma união, cada tabela é verificada em relação às suas próprias colunas de origem.

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

Ao salvar uma etapa que ainda tem linhas sinalizadas, uma caixa de diálogo Colunas obsoletas encontradas as lista sob a guia ou a tabela em que estão e oferece três opções:

Remover todas e salvar — remove as linhas sinalizadas e, em seguida, salva.
Salvar mesmo assim — salva a etapa como está.
Cancelar — volta para a etapa sem salvar.

Para manter uma linha e eliminar o aviso dela, 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

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

Uma etapa salva com uma coluna sem nenhum tipo ainda é executada. O tipo é determinado quando a etapa é iniciada, a partir da coluna de origem que essa coluna lê. Onde não há de onde lê-lo, ele é tratado como texto: as colunas de uma etapa Extrair SQL vêm da consulta que você escreveu, e não de uma origem mapeada, e onde várias origens têm o mesmo nome de coluna com tipos divergentes, usa-se texto em vez de adivinhar um deles — um palpite errado gera uma conversão que o data warehouse pode rejeitar, e qualquer coisa pode ser convertida em texto.

Definir o Tipo você mesmo continua sendo a forma de dizer o que uma coluna deve ser. Deixá-lo sem definição significa aceitar o tipo que a coluna de origem tiver.

Alteração da Ordem das Colunas

Para reorganizar as colunas na tabela de dados de destino, selecione as colunas desejadas. Você pode usar:

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

Reduzir o Resultado a Registros Distintos

Para retornar apenas opções distintas, selecione a opção de menu Distintos. Isso exibe um conjunto de caixas de seleção para cada coluna da origem. Basta marcar a caixa ao lado da coluna correspondente para retornar apenas resultados distintos.

Dependendo da situação, talvez seja melhor considerar o uso de resumo.

O processo de distinção mantém o primeiro registro exclusivo encontrado e descarta os demais. Talvez você queira aplicar uma ordenação aos dados se a consistência entre execuções for importante.

Agregação e Agrupamento

Para agregar resultados, selecione a opção de menu Resumir. Isso exibe um conjunto de caixas de seleção para cada coluna da tabela de dados de destino. Escolha um método de resumo 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 dela se parecer com um identificador, como id, customer_id, Order No ou CustomerKey, se a tabela dela a definir como chave ou se a junção a usar como chave.

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

Para uso avançado do Data Mapper, como expressões, limpeza e constantes, consulte Uso avançado do Data Mapper

Filtros de dados da tabela

Para oferecer o máximo de flexibilidade, há filtros de dados tanto nos dados de origem quanto nos dados de destino. Em conjuntos de dados maiores, filtrar linhas na origem pode ser especialmente vantajoso, pois as demais operações são executadas sobre um conjunto de dados menor.

Selecionar subconjunto de dados

Este tipo de filtro permite filtrar os dados de origem de entrada 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 já transformados, com base nas condições especificadas. Aplicar um filtro ao resultado transformado permite fazer exclusões com base em resultados de cálculos complexos, sumarizações ou funções de janela.

Divisão final da tabela de dados (limite)

O recurso de divisão de linhas permite limitar as linhas do conjunto de resultados com base em um intervalo e um ponto de partida.

Sintaxe de filtro

A sintaxe de filtro usa o Python SQLAlchemy, a mesma sintaxe das outras expressões.

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