Ferramenta Dados de Entrada
Ferramenta Dados de Entrada
Dataset Support in Preview in 2026.1
This initial release of Alteryx One dataset support is in preview. Please refer to Datasets for requirements and limitations.
Requisitos da função de usuário
Função de usuário* | Acesso à ferramenta/ao recurso |
|---|---|
Usuário completo | ✓ |
Usuário básico | ✓ |
*Aplica-se a clientes do Alteryx OneProfessional e Enterprise Edition nas versões 2025.1 e posteriores do Designer.
Use a ferramenta Dados de Entrada para trazer dados para seu fluxo de trabalho conectando-se a um arquivo ou banco de dados.
Fluxo de trabalho de exemplo
Esta ferramenta tem um fluxo de trabalho de exemplo. Acesse Exemplos de fluxos de trabalho para saber como acessar esse e muitos outros exemplos diretamente no Designer.
Importante
O uso de caracteres curinga para ler múltiplos arquivos CSV com o Sistema de arquivos distribuídos Hadoop produz um erro.
Configurar a ferramenta
A janela Configuração da ferramenta Dados de Entrada tem duas seções: Conectar a um arquivo ou banco de dados e Opções. Observe que as opções de configuração "Conectar a um arquivo ou banco de dados" variam dependendo se o DCM está habilitado.
Conectar com o DCM (padrão)
As etapas abaixo descrevem o processo padrão com o Gerenciador de Conexões de Dados (DCM) habilitado.
Com a ferramenta Dados de Entrada na tela, siga estas etapas:
Na janela Configuração, na seção Conectar a um arquivo ou banco de dados, você pode inserir o caminho do arquivo de entrada ou selecionar...
Abrir arquivo: procure e se conecte a um arquivo em um diretório local ou de rede. Consulte a sessão Arquivos abaixo.
Conectar-se a: abra a janela Configuração do conector.
Quando você seleciona Conectar-se a, o Designer exibe a janela Configuração do conector. Configure suas conexões de dados usando uma destas guias: Recentes, Conjuntos de dados, Conexões. Você também pode acessar Cofres externos e Sincronizar pelo menu suspenso Mais na parte inferior da página.
Recentes
Use a guia Recentes para exibir e acessar uma lista de conexões usadas recentemente. A seção também contém links para estas opções:
Criar ou procurar uma conexão de dados: use o DCM para criar uma nova conexão ou procurar conexões criadas anteriormente. Para obter detalhes, acesse Gerenciador de Conexões de Dados.
Selecionar um arquivo em seu armazenamento local: selecione um arquivo armazenado localmente para usar na ferramenta Dados de Entrada.
Selecionar um conjunto de dados no Alteryx One: você pode conectar a ferramenta Dados de Entrada aos conjuntos de dados disponíveis no seu espaço de trabalho do Alteryx One. Isso permite que você use conjuntos de dados gerenciados centralmente diretamente nos fluxos de trabalho do Designer.
Conjuntos de dados
Suporte a conjuntos de dados na pré-visualização na versão 2026.1
Esta versão inicial do suporte a conjuntos de dados do Alteryx One está em pré-visualização. Observe estes requisitos e limitações:
No momento, este recurso está na versão prévia, com desenvolvimento ativo. À medida que o Designer é atualizado, alterações importantes podem afetar ativos criados em versões anteriores, e a configuração do conjunto de dados pode precisar ser atualizada.
Para se conectar a conjuntos de dados por meio da ferramenta Dados de Entrada, você deve habilitar o AMP Engine.
Você pode acessar apenas conjuntos de dados para os quais tem permissão como parte da sua função de usuário do Alteryx One (os conjuntos de dados devem estar disponíveis no seu espaço de trabalho).
Você pode acessar um conjunto de dados por ferramenta Dados de Entrada.
Use a guia Conjuntos de dados para conectar a ferramenta Dados de Entrada aos conjuntos de dados disponíveis no seu espaço de trabalho do Alteryx One. Isso permite que você use conjuntos de dados gerenciados centralmente diretamente nos fluxos de trabalho do Designer. Para usar um conjunto de dados do Alteryx One no seu fluxo de trabalho...
Selecione Conjuntos de dados no menu à esquerda da janela Configuração do conector.
Uma lista de conjuntos de dados disponíveis é exibida, incluindo Nome, Fonte, Proprietário, com quem o conjunto de dados foi compartilhado e quando foi sua última atualização. Observe que você só pode acessar conjuntos de dados que tem permissão para acessar.
Você pode filtrar a lista para mostrar todos os conjuntos de dados, apenas os de sua propriedade ou apenas os compartilhados com você. Você também pode usar a barra de pesquisa para encontrar um conjunto de dados pelo nome.
Escolha um conjunto de dados na lista de conjuntos de dados disponíveis.
Depois de selecionar o conjunto de dados, a ferramenta Dados de Entrada é configurada para usá-lo em seu fluxo de trabalho.
Conexões
Use a guia Conexões para acessar ou criar conexões por meio do Gerenciador de Conexões de Dados (DCM). Apenas conexões compatíveis com o DCM estão disponíveis.
A guia Conexões lista todas as conexões criadas anteriormente (incluindo informações de Nome, Tecnologia e Última atualização), juntamente com a opção de criar conexões. Use o ícone de 3 pontos para copiar o ID da conexão, testar ou excluir a conexão se ela não for mais necessária.
Para conectar a ferramenta Dados de Entrada a uma conexão criada anteriormente, localize-a na lista e clique em Conectar.
Adicionar nova conexão
Para criar uma conexão por meio da ferramenta Dados de Entrada, siga estes passos:
Na guia Conexões, clique no botão + Novo para abrir a janela Selecionar uma tecnologia.
Em seguida, você pode selecionar a tecnologia de conexão na lista de Conexões compatíveis. Se necessário, você também pode usar a caixa de pesquisa Tecnologia de pesquisa.
Se a tecnologia selecionada for compatível com vários tipos de conexão, a janela Selecionar tipo de conexão será exibida. Escolha o tipo de conexão. Isso pode incluir Conexão rápida, Conexão com administrador do ODBC, Em massa com preparo local, Em massa com preparo no Amazon S3 etc.
Se você selecionar uma conexão em massa que exija múltiplas conexões, uma tela será exibida solicitando que você selecione as conexões em massa existentes.
Use os botões Selecionar para navegar até a seção Conexões em massa e selecione Conectar para escolher as conexões.
Após escolher várias conexões em massa, clique em Continuar para usá-las no fluxo de trabalho.
Na tela Nova conexão, preencha os campos relevantes:
Detalhes da conexão: forneça um nome de conexão.
Fonte de dados: forneça um nome da fonte de dados, bem como outras informações necessárias específicas da fonte de dados (consulte Fontes de dados para obter mais informações).
Credenciais: selecione um método de autenticação e insira as informações de credencial necessárias (por exemplo, ID do cliente, chave secreta, nome de usuário e senha) para o método de autenticação selecionado.
Após fornecer as informações necessárias, clique em Salvar para criar a conexão. Você verá os detalhes de sua conexão serem exibidos. Clique em Conectar para usar a conexão no fluxo de trabalho.
Cofres externos
Use a guia Cofres externos para acessar ou configurar cofres externos por meio do DCM. Para obter mais informações e instruções, acesse Cofres externos no DCM.
A guia "Cofres" externos lista todos os cofres criados anteriormente (incluindo informações de Nome do cofre, Tecnologia e Última atualização), juntamente com a opção de criar novos cofres.
Sincronizar
Com o DCM, você pode sincronizar credenciais em todos os seus aplicativos Alteryx. Para obter mais informações, acesse DCM do Designer.
Conectar sem o DCM
Importante
Não há suporte para fluxos de trabalho que não são do DCM com a Execução do espaço de trabalho. Dessa forma, essa não é a abordagem recomendada para criar conexões dentro da ferramenta Dados de Entrada.
As etapas abaixo descrevem o processo com o Gerenciador de Conexões de Dados (DCM) desabilitado.
Com a ferramenta Dados de Entrada na tela, siga estas etapas:
Na janela Configuração, na seção Conectar a um arquivo ou banco de dados, você pode inserir o caminho do arquivo de entrada ou selecionar...
Abrir arquivo: procure e se conecte a um arquivo em um diretório local ou de rede. Consulte a sessão Arquivos abaixo.
Conectar-se a: para abrir a janela Conexões de dados.
Usar o Gerenciador de Conexões de Dados (DCM): marque esta caixa para se conectar aos dados com o DCM. Observe que isso redefine a configuração da ferramenta Entrada. Consulte a seção Conectar com o DCM acima.
Quando você seleciona Conectar-se a, o Designer exibe a janela Conexões de dados. Configure a conexão de dados usando uma dessas guias: Recente, Salvo, Arquivos, Fontes de dados ou Server.
Recente (não DCM)
A seção Conexões recentes contém arquivos e conexões de dados que foram configurados recentemente. Você pode selecionar uma conexão ou clicar em Limpar lista para excluir as conexões recentes.
Salvo
Selecione entre as Conexões salvas. Para renomear e editar conexões, use Gerenciar conexões salvas.
Arquivos
Para se conectar a um arquivo em um diretório local ou de rede, existem várias opções:
Clique em Abrir arquivo na seção Conectar arquivo ou Banco de dados da configuração da ferramenta para procurar um arquivo.
Janela "Configuração do conector" (DCM): na guia Recentes, use Selecionar um arquivo em seu armazenamento local.
Janela Conexões de dados (não DCM):
Em Conexões de arquivo, clique no botão Selecionar arquivo para procurar um arquivo.
Arraste um arquivo para a área de arrastar e soltar de Conexões de arquivo.
Na seção Todos os tipos de arquivos compatíveis, clique em uma extensão para procurar um arquivo com essa extensão.
Como alternativa, arraste um arquivo diretamente para a tela.
Na janela do explorador de arquivos, digite um caractere curinga como parte do caminho do arquivo.
Considere um caso em que você tenha múltiplos arquivos de dados com...
O mesmo número de campos em que os tipos de dados para cada campo são os mesmos.
Nomes semelhantes no mesmo diretório.
Considerações sobre caracteres curinga
Uma única ferramenta Dados de Entrada lê múltiplos arquivos usando um formato de caractere curinga, como *.csv ou 2019*.csv, contanto que todos os arquivos tenham o mesmo número de campos e que os tipos de dados para cada campo sejam os mesmos.
O Designer define o número de campos e os tipos de arquivo com base no primeiro arquivo lido. Quaisquer arquivos subsequentes que não corresponderem são ignorados e um aviso aparece. Não é possível controlar qual arquivo é lido primeiro ao usar sintaxe de caractere curinga como *.csv. Cabe ao sistema designar qual arquivo é o primeiro.
Digite o nome que os vários arquivos têm em comum e adicione um * (asterisco) para substituir todos os caracteres subsequentes ou uma ? (interrogação) para substituir um caractere. Inclua a extensão de arquivo comum ao especificar os nomes dos arquivos.
Exemplo 1
Este caminho inclui todos os arquivos .csv contidos no diretório data\datafiles que tenham o nome começando com ABCD.
data\datafiles\ABCD*.csv
Ele inclui os arquivos ABCD_4.csv e ABCD_012.csv.
Exemplo 2
Este caminho inclui todos os arquivos .csv contidos no diretório data\datafiles que tenham o nome começando com ABCD_ e tenha um caractere adicional.
data\datafiles\ABCD_?.csv
Em Selecionar entrada do Excel, selecione uma das entradas do Excel:
Selecionar uma planilha: escolha entre as planilhas disponíveis no arquivo do Excel.
Selecionar um intervalo (células, linhas ou colunas): opcionalmente, selecione um intervalo de células, linhas ou colunas dentro da planilha.
Selecionar um intervalo nomeado: escolha entre os intervalos nomeados disponíveis no arquivo do Excel.
Importar somente a lista de nomes das planilhas: crie saída com uma única coluna contendo os nomes das planilhas como valores. Não é feita a saída de nenhum dado relacionado quando essa opção é selecionada.
Se a planilha do Excel que você selecionou estiver aberta, uma mensagem de erro será exibida e não será possível prosseguir. Feche a planilha, clique no botão Atualizar na janela Selecionar entrada do Excel e finalize o processo de entrada.
A ferramenta Dados de Entrada ignora colunas que não estão definidas. Uma coluna definida é uma coluna que contém dados ou que continha dados que foram apagados pelo usuário. Para incluir colunas que não estão definidas, especifique um intervalo por meio da opção Selecionar um intervalo (células, linhas ou colunas) na caixa de diálogo Selecionar entrada do Excel.
Ao selecionar um arquivo. gz, .tgz ou .zip, a janela Extrair arquivo é exibida. Consulte Suporte a arquivos Gzip e Suporte a arquivos Zip para obter mais informações.
Use o menu suspenso Selecionar o tipo de arquivo a ser extraído para selecionar o tipo de arquivo.
Selecionar arquivos: marque a caixa de seleção ao lado do arquivo que você deseja extrair.
Para exibir todos os arquivos no arquivo Gzip ou Zip, incluindo arquivos que não são compatíveis com o Alteryx... Selecione um tipo de arquivo na opção Analisar outros arquivos como.
Use o menu suspenso Selecionar o tipo de arquivo a ser extraído para selecionar Outros arquivos.
Selecione um tipo de arquivo na opção Analisar outros arquivos como.
Clique em Abrir para continuar.
Importante
A Alteryx não oferece suporte para arquivos Gzip e Zip no Gallery.
Tipo de arquivo | Extensão de arquivo |
|---|---|
.cydb | |
.yxdb | |
Alteryx Spatial Zip | .sz |
.avro | |
Valores separados por vírgula | .csv |
dBase | .dbf |
Base de dados geográficos pessoal ESRI | .mdb |
ESRI Shapefile | .shp |
Linguagem de marcação extensível | .xml |
.flat | |
GIS | .grc, .grd |
Google Earth/Google Maps | .kml |
.gz, .tgz | |
IBM SPSS | .sav |
.json | |
Tabela MapInfo Professional | .tab |
Microsoft Access 2000-2003 | .mdb |
Microsoft Access 2007, 2010, 2013, 2016 | .accdb |
Microsoft Excel Binary | .xlsb |
Microsoft Excel 1997-2003 | .xls |
.xlsx | |
Microsoft Excel habilitado para macros | .xlsm |
QlikView | .qvx |
SAS | .sas7bdat |
SQLite | .sqlite |
Texto | .txt, .asc |
.zip |
Tipos de arquivo desconhecidos incluem qualquer outro tipo de arquivo que o Alteryx não pode ler nativamente. Se você usar a ferramenta Dados de Entrada para ler um tipo de arquivo desconhecido, a janela Resolver tipo de arquivo será exibida com estas opções:
Ler como um tipo nativo: selecione o tipo que se assemelha à estrutura do seu arquivo.
Ler como um arquivo de texto de largura fixa: quando você seleciona essa opção, é possível atribuir colunas utilizando uma régua deslizante. Acesse Layout de arquivos simples para obter mais informações sobre essa opção.
Ler como um arquivo de texto delimitado: selecione essa opção se houver um único delimitador que indique quebras de coluna em seus dados. Selecione o tipo de delimitador apropriado e determine se a primeira linha em seus dados contém nomes de campo.
Fontes de dados
A janela Fontes de dados exibe fontes de dados compatíveis e frequentemente usadas.
Ferramentas: se você selecionar Conexão rápida para uma ferramenta que não está instalada, um navegador será aberto na Comunidade Alteryx para baixar e instalar essa ferramenta. Leia atentamente as instruções na página. Depois que a ferramenta é instalada, a ferramenta Dados de Entrada na tela é alterada para a ferramenta que você selecionou na guia "Fontes de dados".
Fontes de dados:
ODBC: abra a janela de conexão do ODBC. Ela exibe uma lista filtrada de DSNs no sistema que usam esse driver específico.
OleDB: inicie o gerenciador de OleDB nativo do Windows.
OCI: inicie o gerenciador de conexões nativo do Oracle OCI. A partir daí, selecione o nome do serviço de rede conforme definido no arquivo
tnsnames.oraque você deseja usar para essa conexão, bem como as credenciais de nome de usuário e senha.A opção "Em massa" abre uma caixa de diálogo especial que permite configurar uma conexão em massa para o tipo de conexão selecionado.
Conexão rápida: para SQL ou Oracle, é possível utilizar uma conexão salva preexistente ou criar uma nova conexão salva. Consulte estas páginas para obter detalhes:
Todas as outras conexões rápidas usam outra ferramenta.
Fontes de dados compatíveis
Para obter uma lista detalhada das fontes de dados compatíveis, acesse Fontes de dados.
Server
A guia "Server" exibe cada IU do Alteryx Server (e seu URL) adicionada ao computador local. Uma lista abaixo de cada nome de Server contém as conexões salvas armazenadas no Server para as quais você tem acesso.
Clique em + Server para adicionar outra conexão ao Alteryx Server.
Opções
Use esta seção para configurar as opções de formato de arquivo. Essas opções variam dependendo do arquivo ou banco de dados ao qual você se conecta. Para obter mais informações, incluindo opções e descrições específicas do arquivo, acesse Opções de formato de arquivo.
Visualizar layout dos dados
Pré-visualize o layout dos dados na seção Pré-visualização da janela de configuração da ferramenta Dados de Entrada. A pré-visualização do layout dos dados é limitada a 100 registros, ou menos em arquivos grandes. Se os dados contiverem 1.500 colunas, aparecerão pelo menos um registro e até duas linhas. Para ver todos os dados, use uma ferramenta Navegar.
Nomes de coluna duplicados
Se o arquivo de entrada contiver múltiplas colunas com o mesmo nome, o Designer renomeia automaticamente as colunas duplicadas de acordo com estas regras:
Se o último caractere no nome duplicado for 1 ou 9, o Designer acrescenta ao nome de coluna duplicado um sublinhado (_) e um número começando com 2.
Nome da coluna original | Coluna duplicada (renomeada pelo Designer) |
|---|---|
A1 | A1_2 |
A9 | A9_2 |
Se o último caractere no nome duplicado for um dígito entre 2 e 8 (inclusive), o Designer incrementa esse dígito para renomear a coluna.
No entanto, se o penúltimo caractere também for um dígito, o Designer acrescenta um sublinhado (_) e um número, começando com 2, ao nome duplicado.
Nome da coluna original | Coluna duplicada (renomeada pelo Designer) |
|---|---|
A2 | A3 |
A5 | A6 |
A22 | A22_2 |
Se o último caractere no nome duplicado for uma letra ou um caractere especial, o Designer acrescenta um número (começando com 2) para renomear a coluna.
Nome da coluna original | Coluna duplicada (renomeada pelo Designer) |
|---|---|
age | age2 |
registered? | registered?2 |
Nota
O construtor de consultas visual não consegue exibir caracteres multibyte corretamente. Use a guia "Tabelas".
Converter ferramenta Dados de Saída em ferramenta Dados de Entrada
Você pode converter uma ferramenta Dados de Saída em uma ferramenta Dados de Entrada. Siga estas etapas:
Na tela do fluxo de trabalho, clique com o botão direito do mouse na ferramenta Dados de Saída que você deseja converter em uma ferramenta Dados de Entrada.
Selecione Converter para Dados de Entrada.
Os dados de saída tornam-se os dados de entrada.