Ir para o conteúdo principal
Loading...
Skip to article
  • Qualtrics Platform
    Qualtrics Platform
  • Customer Journey Optimizer
    Customer Journey Optimizer
  • XM Discover
    XM Discover
  • Qualtrics Social Connect
    Qualtrics Social Connect

Extrair dados da tarefa de arquivos SFTP


Was this helpful?


This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.

The feedback you submit here is used only to help improve this page.

That’s great! Thank you for your feedback!

Thank you for your feedback!


Sobre a tarefa Extrair dados de arquivos SFTP

A tarefa Extrair dados dos arquivos SFTP permite que você importe dados do seu servidor SFTP para usar no Qualtrics. Você pode utilizar esta tarefa para processar somente um ou vários arquivos de cada vez. Você pode combinar essa tarefa com outras tarefas, como a tarefa Carregar dados no XM Directory, para importar dados para outros locais da Qualtrics.

Qdica: a Qualtrics oferece nossos próprios servidores SFTP para clientes por meio de nossa equipe de serviços profissionais. Há um custo associado a esse serviço; no entanto, garantimos que esses servidores funcionem com automações. Para mais informações, entre em contato com nossa equipe de serviços profissionais.

Para obter mais informações sobre configuração e solução de problemas de SFTP, consulte Solução de problemas de SFTP .

Atenção : Sua conta SFTP deve ter permissões de leitura, gravação e exclusão para que esta tarefa seja bem-sucedida.

Conexão de uma conta SFTP

Antes de usar a tarefa Extrair dados de arquivos SFTP, você precisa conectar uma conta SFTP da Qualtrics para extrair os dados de. As contas podem ser adicionadas pelos Administradores da marca para outros usuários na marca utilizarem ou por usuários individuais para seu uso pessoal.

Existem 3 opções de autenticação diferentes:

  • Senha: autenticar com um nome de usuário e senha.
  • Chave SSH: autentique usando uma chave Secure Shell (SSH) que você fornece ou uma chave fornecida pela Qualtrics.
  • Chave SSH criptografada: autenticar usando uma chave SSH criptografada.

Qdica: Ao configurar uma conexão SFTP, recomendamos que sua equipe de TI Liste os intervalos de IPs da Qualtrics como permitidos.

Adição de uma conta como administrador da marca

Se você for Administrador da Marca, siga as etapas nesta seção para adicionar uma conta SFTP para alguns ou todos os usuários em sua licença de uso.

  1. Usando o menu de navegação na parte superior esquerda, vá para Admin.
    navegando para a seção de ampliações do administrador e selecionando os dados de extração da extensão de arquivos sftp
  2. Vá para Extensões.
  3. Clique em Extrair dados da extensão de arquivos SFTP.
  4. Clique em Adicionar conta.
    clicando em adicionar conta
  5. Dê um nome à conta. Este nome é utilizado para fins organizacionais e para identificar a conta.
    dando um nome à conta, inserindo o nome do host e a porta e escolhendo um método de autenticação
  6. Insira o nome do host do servidor SFTP associado.
    Exemplo: geralmente, eles estão no formato sftp.exemplo.com
  7. Insira o número da Porta. Normalmente, isso é 22.
  8. Escolha seu método de autenticação. Suas opções incluem:
    • Senha: forneça um nome de usuário e senha para autenticação.
    • Chave SSH: forneça um nome de usuário e uma chave SSH para autenticação ou use uma chave SSH gerada pela Qualtrics.
    • Chave SSH criptografada: forneça sua própria chave SSH criptografada com uma frase-chave para autenticação.
  9. Se você escolher a senha, insira o nome de usuário e a senha da conta SFTP.
    inserindo um nome de usuário e senha
  10. Se estiver autenticando com uma chave SSH, execute uma das seguintes ações:
    • Se estiver usando uma chave SSH gerada pela Qualtrics, insira um Nome de usuário e clique em Gerar par de chaves SSH.clicando em Gerar par de chaves SSH
      Você pode clicar em Baixar chave SSH pública para baixar a chave pública como um arquivo .pem para o seu computador. A chave privada associada será armazenada pela Qualtrics. Clique em Copiar para o clipboard para copiar a impressão digital da chave para seu clipboard. Salve ambos em um local seguro para que você possa referenciá-los, se necessário.baixando a chave ssh
    • Se estiver usando sua própria chave SSH, clique em Fornecer uma chave privada.clique em para fornecer uma chave privada
      Em seguida, insira seu nome de usuário e a chave SSH.inserindo o nome de usuário e a chave ssh

      Qdica: Você deve inserir uma chave privada não protegida por senha nesta caixa. Além disso, a chave pública deve ser autorizada em seu servidor SFTP.
      Exemplo:
      É assim que uma chave SSH normalmente se parece (incluindo as linhas de chave RSA iniciais e finais):
      —–BEGIN RSA PRIVATE KEY—–
      a1b2c3d4…
      —–END RSA PRIVATE KEY—–
  11. Se estiver autenticando com a chave SSH criptografada, insira o Nome de usuário, a Chave SSH criptografada e a Frase-chave associada à sua chave.inserindo os detalhes para usar uma chave ssh criptografada
  12. Quando terminar, clique em Conectar conta.

Adição de uma conta como usuário individual

Siga as etapas nesta seção para adicionar uma conta SFTP para seu uso pessoal. Somente você poderá usar a conta que se conectar.

  1. Siga as etapas na seção Configuração de uma tarefa de extração de dados de arquivos SFTP até chegar à etapa de seleção de uma conta.
  2. Clique em Adicionar conta de usuário.
    clicando em adicionar conta de usuário
  3. Siga as instruções na subseção “Adicionando uma conta como Administrador da marca” acima para obter mais informações sobre como conectar sua conta. As mesmas opções e configurações de autenticação estão disponíveis para você ao adicionar uma conta como um usuário individual.

Testando a conexão

Depois de adicionar uma conta, você pode testar a conexão na tarefa Extrair dados de arquivos SFTP. Na parte inferior da tarefa, clique em Testar conexão . Isso fará upload de um pequeno arquivo de teste para seu servidor, lerá seu conteúdo e, em seguida, excluirá o arquivo.  o botão de teste

Baixando chaves SSH públicas

Se estiver usando uma chave SSH gerada pela Qualtrics, você pode baixar a chave pública para a conexão. Ao visualizar a lista de contas SFTP a serem usadas, clique no menu de três pontos à direita de uma conta e, em seguida, selecione Baixar chave SSH pública. Isso irá baixar a chave para o seu computador como um arquivo .pem.clicando em uma conta e selecionando baixar chave ssh pública

Atualizando chaves SSH geradas pela Qualtrics

Se estiver usando uma chave SSH gerada pela Qualtrics, você poderá gerar a chave novamente, se necessário. Isso é útil se você acredita que a chave foi comprometida ou se sua empresa exigir que você gire as chaves após um determinado período de tempo.

Atenção: esta ação atualizará automaticamente a chave SSH da sua conta e não pode ser revertida. Certifique-se de que deseja regerar a chave antes de seguir as etapas nesta seção.
  1. Ao visualizar a lista de contas SFTP a serem usadas, clique no menu de três pontos à direita da conta e clique em Editar conta.clicando em processar ao lado de uma conta
  2. Clique no hyperlink para gerar um novo par de chaves.
    clicando no link clique aqui para gerar novos pares de chaves
Qdica: clique em Baixar chave SSH pública e em Copiar para a área de transferência para salvar sua nova chave SSH.

Configuração de uma tarefa Extrair dados de arquivos SFTP

Atenção: a tarefa Extrair dados de arquivos SFTP tem um limite de 200 arquivos por execução, com cada arquivo individual com um limite de tamanho de arquivo de 1 GB e um limite de tamanho de arquivo total de 2 GBs para todos os arquivos. Se os arquivos excederem esses limites, a tarefa falhará, o que significa que nenhum dos arquivos será processado.
Atenção: Você não pode usar terminadores de linha de retorno de carro com esta tarefa.
  1. Criar um fluxo de trabalho ETL.
  2. Selecione Fonte de dados (extrator ETL).
    Adição de um extrator a uma tarefa ETL
  3. Selecione a tarefa Extrair dados de arquivos SFTP.
    selecionando os dados de extração da tarefa de arquivos sftp
  4. Escolha a conta do SFTP da qual extrair os arquivos. Quaisquer contas adicionadas pelos Administradores da marca, bem como as contas que você mesmo adicionou, serão listadas aqui.
    escolhendo uma conta ou adicionando uma nova
  5. Se você deseja adicionar novas credenciais de conta SFTP, clique em Adicionar uma conta de usuário e siga os passos no conectando uma seção de conta SFTP .
  6. Clique em Seguinte.
  7. Insira o Modelo de nome do arquivo, que é usado para identificar quais arquivos devem ser processados observando o prefixo do arquivo. Todos os arquivos com seu prefixo especificado serão processados. Insira o prefixo desejado na caixa.
    inserindo um nome de arquivo, diretório e prefixo zip

    Exemplo: digamos que tenho um arquivo chamado Qualtrics-DataImport.csv. Posso inserir “Q” ou “Qualtrics” como prefixo, dependendo de existirem outros arquivos no servidor que eu queira processar.
    Qdica: Clique no Use expressão regular caixa de seleção se você quiser usar regex para seu padrão de nome de arquivo.
  8. Insira o diretório Pickup ou o caminho do diretório para encontrar o arquivo no servidor. Você pode inserir um caminho relativo ou um caminho absoluto.
    Qdica: Este caminho do diretório diferencia maiúsculas de minúsculas e deve apontar para uma pasta existente ou o fluxo de trabalho falhará. A Qualtrics não poderá acessar arquivos se eles estiverem em um diretório de nível superior ao especificado no diretório de retirada.

    Exemplo: dependendo do caminho que você inserir, os diretórios de retirada potenciais podem ser:

    • /home/username/myFolder (caminho absoluto)
    • myFolder (caminho relativo)
  9. Se o seu arquivo estiver compactado, habilite o Você está extraindo de um arquivo zip opção. Em seguida, insira o Prefixo para arquivo dentro do zip que será usado para encontrar o arquivo correto para importar do arquivo zip.
    Qdica: Somente compressões .zip são suportadas. Os arquivos no arquivo .zip podem ser criptografados, mas o arquivo .zip em si não pode ser (por exemplo, filename.csv.pgp.zip é suportado, mas filename.csv.zip.pgp não é).
  10. Selecione um tipo de arquivo.
    escolhendo um arquivo e as opções de arquivo
    Suas opções incluem:

    • CSV
    • TSV
    • JSON

      Qdica: os arquivos JSON devem ter seu conteúdo entre colchetes, []. Por exemplo:

      [
         {
             "fruit": "Apple",
             "size": "Large",
             "color": "Red"
         ficha informativa
       ]
    • Excel (.xslx ou .xls)
  11. Se estiver processando um CSV, escolha o Delimitador para o arquivo. Suas opções incluem vírgula, ponto-e-vírgula, tabulador e tubo.
  12. Se desejar, selecione Decriptar arquivos antes de importar usando PGP. Para saber mais sobre este meio adicional de criptografia e proteção de dados, consulte Criptografia PGP.
    Qdica: Certifique-se de que os arquivos que você deseja importar estejam criptografados com a chave pública da Qualtrics antes de carregá-los no servidor SFTP. Para isso, talvez seja necessário conversar com sua equipe de TI.
  13. Se você quiser ignorar arquivos que não podem ser processados, selecione Ignorar arquivos inválidos. Se esta opção não estiver selecionada, todo o fluxo de trabalho falhará quando tentar processar o arquivo incorreto.
    Qdica: há vários motivos pelos quais um arquivo não pode ser processado. O mais comum é que ele é muito grande ou seus dados estão corrompidos de alguma forma.
  14. Escolha o que você gostaria que acontecesse após o processamento do arquivo. Suas opções incluem:
    • Excluir o arquivo processado: após processar o arquivo, o Qualtrics o exclui do seu servidor SFTP. Essa opção é ativada por padrão.
    • Manter o arquivo processado: depois de processar o arquivo, a Qualtrics deixa o arquivo no seu servidor SFTP.
  15. Decida se você gostaria de Use validação estrita , que rejeitará automaticamente os arquivos extraídos se eles tiverem certos problemas de formatação. Leia a mensagem na tarefa para obter mais informações sobre quais arquivos serão rejeitados.
    permitindo o uso de validação estrita

    Qdica: Habilitar Pular linhas malformadas para carregar seu arquivo e excluir quaisquer linhas com problemas de formatação.
  16. Clique em Escolher arquivo e carregue um arquivo de amostra, que informará à Qualtrics os campos que você deseja importar e determinará as tarefas subsequentes que você pode usar com esta tarefa. O arquivo que você carrega deve conter os campos que deseja importar como parte desta tarefa.
    Qdica: baixe os arquivos de amostra na tarefa ou baixe os arquivos na seção de arquivos de exemplo para modelos sobre como estruturar seus dados com base em seu caso de uso. O único formato de codificação de arquivo suportado é UTF-8. Alguns softwares de planilha salvam como Unicode UTF-8, que é diferente do UTF-8, se você estiver recebendo erros inesperados. Certifique-se de que você está exportando no formato UTF-8 e não no Unicode UTF-8.
    a janela arquivos de amostra
  17. Verifique se seu arquivo está importando os dados corretamente. Se você precisar alterar suas configurações, clique em Voltar na parte superior da tarefa.
    revisando os campos de importação

    Qdica: Se todos os seus dados estiverem sendo importados como uma coluna, você estará usando o delimitador incorreto. A captura de tela abaixo demonstra como isso se parece na janela de tarefas.

    a janela de importação quando o delimitador incorreto é selecionado. Todos os dados estão sendo importados como uma coluna

  18. Se os dados estiverem corretos, clique em Salvar.
  19. Conclua a criação do seu fluxo de trabalho ETL. Quando você escolhe uma tarefa de carregador, está decidindo o destino dos dados que extraiu. Consulte as tarefas de carregador disponíveis para obter uma lista de opções.
    adicionando uma tarefa do carregador ao fluxo de trabalho

Arquivos de exemplo

Abaixo estão arquivos de exemplo sobre como estruturar seus dados para importação, dependendo do tipo de dados que você deseja importar. Clique em um nome de arquivo para baixar o arquivo de exemplo.

Perguntas frequentes

Muitas das páginas neste site foram traduzidas do inglês original usando tradução automática. Embora na Qualtrics tenhamos feito nossa diligência prévia para obter as melhores traduções automáticas possíveis, a tradução automática nunca é perfeita. O texto original em inglês é considerado a versão oficial, e quaisquer discrepâncias entre o inglês original e as traduções automáticas não são juridicamente vinculativas.