Ferramenta Dados de Saída
Use a ferramenta Dados de Saída para gravar os resultados de um fluxo de trabalho em arquivos ou fontes de dados compatíveis.
Selecione a ferramenta Dados de Saída na paleta de ferramentas e arraste-a para a tela do fluxo de trabalho.
Componentes da ferramenta
 |
Figura: ferramenta Dados de Saída com âncora.
A ferramenta Dados de Saída tem uma âncora.
Âncora de entrada: conecte a âncora de entrada ao seu fluxo de trabalho para gravar os resultados em uma fonte de dados ou em um tipo de arquivo compatível.
Configurar a ferramenta
Salvar em conexões baseadas em arquivo
Para gravar os resultados do seu fluxo de trabalho em uma conexão baseada em arquivo:
Na janela de configuração da ferramenta, clique em Selecionar local de saída para abrir a janela da ferramenta Dados de Saída.
Selecione uma conexão de dados em nuvem em Conexões ou selecione entre seus Conjuntos de dados existentes.
Insira o Nome do arquivo. Opcionalmente, selecione o ícone {x} (Adicionar parâmetro) para adicionar parâmetros ao Nome do arquivo. Para obter detalhes, consulte a seção Parâmetros.
Selecione o Formato do arquivo:
CSV: valores separados por vírgula (.csv)
XLS: Microsoft Excel 1997–2003 (.xls)
XLSX: Microsoft Excel (.xlsx)
Em seguida, escolha onde você quer salvar os dados de saída. Você pode usar o Caminho do arquivo padrão ou marcar a caixa de seleção Personalizar local para escolher um local diferente. Se você selecionar um local personalizado, poderá adicionar parâmetros ao caminho do arquivo com o ícone {x} (Adicionar parâmetro). Para obter detalhes, consulte a seção Parâmetros.
Selecione Próximo para personalizar suas Opções de saída.
Use o menu suspenso Ações de saída em cada execução para selecionar uma ação a ser executada se existir um arquivo com o mesmo nome no momento da execução do trabalho.
Para arquivos CSV:
Criar novo
Substituir
Para arquivos do Excel:
Criar nova pasta de trabalho
Substituir pasta de trabalho
Criar nova planilha
Substituir planilha existente
Acrescentar à planilha
Agora você pode gravar em planilhas diferentes em uma pasta de trabalho do Excel simultaneamente. Isso significa que você pode usar duas ou mais ferramentas de saída para gravar na mesma pasta de trabalho em planilhas separadas. Você não precisa da ferramenta Bloquear até Concluir para executar isso. A simultaneidade só tem suporte quando a opção Substituir planilha existente está selecionada.
Se você selecionou CSV, escolha um Delimitador de coluna. Suas opções são Vírgula, Tabulação, Barra vertical e Ponto e vírgula.
Escolha opções adicionais para a saída:
Incluir aspas (apenas para formato de arquivo CSV)
Nome da planilha (somente formatos XLS e XLSX)
Particionar saída (somente formatos XLS e XLSX): escolha se você deseja publicar seu arquivo como um único arquivo ou como um arquivo com múltiplas planilhas. Se selecionado, use o menu suspenso Particionar usando coluna para selecionar a coluna que será usada para particionar as planilhas com base nos valores dessa coluna.
Manter coluna de partição na saída (somente formatos XLS e XLSX): desmarque para excluir a coluna usada para partição da saída final. Por exemplo, se a divisão é por trimestre, você pode excluir a coluna "Trimestre" da saída.
Incluir os nomes das colunas como primeira linha
Selecione Confirmar para salvar os detalhes dos dados de saída. Em seguida, você pode revisar sua seleção no painel de configuração da ferramenta Dados de Saída e usar o ícone de lápis para fazer alterações, se necessário.
Clique em Executar trabalho para executar o fluxo de trabalho e salvar o arquivo na conexão escolhida.
Salvar em conexões baseadas em SQL
Para gravar os resultados do seu fluxo de trabalho em uma conexão baseada em SQL:
Na janela de configuração da ferramenta, clique em Selecionar local de saída para abrir a janela da ferramenta Dados de Saída.
Selecione uma conexão de dados em nuvem em Conexões ou selecione entre seus Conjuntos de dados existentes.
Insira um Nome da tabela. Opcionalmente, selecione o ícone {x} (Adicionar parâmetro) para adicionar parâmetros ao Nome da tabela. Para obter detalhes, consulte a seção Parâmetros.
Em seguida, selecione um esquema onde deseja salvar sua tabela e clique em Avançar.
Use o menu suspenso Ações de saída em cada execução para selecionar uma ação a ser executada se uma tabela com o mesmo nome já existir no momento da execução do trabalho.
Criar nova tabela: cria uma nova tabela.
Acrescentar a uma tabela: os dados são acrescentados ao final da tabela existente.
Truncar tabela existente: os dados existentes da tabela são excluídos e substituídos por novos dados.
Descartar tabela existente: a tabela existente é descartada e substituída pela nova tabela.
Mesclar com a tabela existente: os dados de saída são mesclados com a tabela existente.
Selecione Confirmar para salvar os detalhes dos dados de saída. Em seguida, você pode revisar sua seleção no painel de configuração da ferramenta Dados de Saída e usar o ícone de lápis para fazer alterações, se necessário.
Clique em Executar trabalho para executar o fluxo de trabalho e salvar o arquivo na conexão escolhida.
Baixar arquivo
Para baixar os dados de saída no seu computador, comece salvando-os no Alteryx One. A opção mais rápida é salvar o arquivo em um local padrão no armazenamento base. Você também pode personalizar o local no armazenamento base ou escolher outro conector.
Depois de executar o fluxo de trabalho, navegue até a ferramenta de saída na tela e selecione Baixar na seção Trabalho do painel do lado direito.
Parâmetros
Use parâmetros para aplicar valores dinâmicos de cadeia de caracteres (string) ou carimbo de data/hora aos dados de saída. Você pode aplicar parâmetros a "Nome do arquivo", "Caminho do arquivo" ou "Nome da tabela", dependendo do tipo de conexão em nuvem.
Os parâmetros de cadeia de caracteres (string) têm um valor padrão que pode ser substituído para cada execução de trabalho, em um agendamento ou plano.
Os parâmetros de carimbo de data/hora são preenchidos automaticamente com um carimbo de data/hora formatado no momento da execução do trabalho.
Para usar um parâmetro no Nome do arquivo ou no Nome da tabela...
No campo Nome do arquivo ou Nome da tabela, selecione o ícone {x} (Adicionar parâmetro) para abrir a janela Parâmetros.
Se você criou um parâmetro anteriormente, selecione-o na seção Parâmetros do espaço de trabalho. Observe que os parâmetros são inseridos no local do cursor no campo "Nome do arquivo". Para remover um parâmetro do nome do arquivo, selecione o parâmetro e, em seguida, Remover.
Se precisar criar um novo parâmetro, selecione + Novo. Você também pode selecionar o link Gerenciar parâmetros para abrir a página "Parâmetros", onde você pode criar novos parâmetros e editar os existentes.
Para usar um parâmetro no Caminho do arquivo...
Selecione a caixa de seleção "Personalizar local".
Selecione o ícone de edição (lápis) ao lado do Caminho do arquivo.
Selecione o ícone {x} (Adicionar parâmetro) para abrir a janela Parâmetros.
Se você criou um parâmetro anteriormente, selecione-o na seção Parâmetros do espaço de trabalho. Observe que os parâmetros são inseridos no local do cursor no campo "Nome do arquivo". Para remover um parâmetro do nome do arquivo, selecione o parâmetro e, em seguida, Remover.
Se precisar criar um novo parâmetro, selecione + Novo. Você também pode selecionar o link Gerenciar parâmetros para abrir a página "Parâmetros", onde você pode criar novos parâmetros e editar os existentes.
Criar parâmetro de cadeia de caracteres (String)
Use um parâmetro de cadeia de caracteres (string) para rotular dinamicamente os dados de saída.
Para criar um parâmetro de cadeia de caracteres (string), selecione + Novo na janela "Parâmetros" e depois selecione String no menu suspenso Tipo.
Insira um Nome de parâmetro. Isso é o que será mostrado no campo de nome do arquivo se você usar o parâmetro.
Insira uma Descrição. Ela deve ser algo claro que ajudará você e outros usuários no futuro.
Insira um Valor padrão para o parâmetro. Esse valor é usado quando o parâmetro não é atualizado dinamicamente.
Selecione Criar para criar o parâmetro e adicioná-lo ao nome ou caminho. Para remover um parâmetro, selecione-o e clique em Remover.
Criar parâmetro de carimbo de data/hora
Use um parâmetro de carimbo de data/hora para preencher automaticamente um carimbo de data/hora formatado no momento da execução do trabalho.
Nota
Diferentemente dos parâmetros de cadeia de caracteres (string), os parâmetros de carimbo de data/hora não ficam armazenados na página Parâmetros.
Para criar um parâmetro de carimbo de data/hora, selecione + Novo na janela "Parâmetros" e, em seguida, selecione Carimbo de data/hora no menu suspenso Tipo.
Personalize o Formato do carimbo de data/hora conforme necessário. O formato padrão é yyyy-MM-dd (aaaa-MM-dd). Selecione o botão + para visualizar suas opções de personalização. Formatar visualização exibe a data de hoje usando o formato selecionado.
Em seguida, defina o Valor de carimbo de data/hora. Escolha entre...
Exato no início do trabalho: gera o valor exato do carimbo de data/hora de quando o trabalho é iniciado.
Em relação ao início do trabalho: gera o carimbo de data/hora em relação à hora de início do trabalho. Por exemplo, você pode querer um carimbo de data/hora após uma hora do início do trabalho.
Ocorrência: escolha gerar um carimbo de data/hora Após ou Antes da hora de início do trabalho.
Valor: escolha um valor numérico para o carimbo de data/hora relativo.
Unidade: escolha uma unidade para o carimbo de data/hora relativo. As opções incluem:
Minutos
Horas
Dias
Semanas
Meses
Trimestres
Anos
Em seguida, selecione um Fuso horário para o parâmetro do carimbo de data/hora.
Por último, selecione Criar para criar o parâmetro e inseri-lo na posição do cursor.
Substituir parâmetros
Quando você executa o fluxo de trabalho com parâmetros de cadeia de caracteres (string), o fluxo de trabalho usa o valor padrão definido quando você criou o parâmetro. No entanto, você tem a opção de substituir esse valor.
Para substituir o valor padrão dos parâmetros de cadeia de caracteres (string)...
Selecione o ícone de menu suspenso que faz parte do botão Executar trabalho.
Selecione Parâmetros para abrir a janela Substituir parâmetros.
Insira valores de substituição na coluna Substituição de valor para todos os parâmetros em que você não deseja usar o padrão.
Selecione Salvar e executar trabalho para executar o fluxo de trabalho com os valores de parâmetro atualizados.