Extrair dados da tarefa do Amazon S3
Sobre a extração de dados do Amazon S3
O Amazon Simple Storage Service (também conhecido como Amazon S3) é um serviço onde você pode armazenar dados. Com fluxos de trabalho, você pode automatizar facilmente a extração de dados do Amazon S3 para uso no Qualtrics.
Antes de começar
Antes de começar a extrair dados do Amazon S3, considere as seguintes considerações:
- O que você quer fazer com seus dados? Observe as tarefas de carregador disponíveis para obter uma lista de opções.
- Seus arquivos se encaixam em um formato consistente? Por exemplo, os arquivos que você espera importar no mesmo fluxo de trabalho devem ter os mesmos cabeçalhos/colunas/campos, mesmo que os valores sejam diferentes.
Conectando o Qualtrics à AWS
Permissão S3 necessária para uma função IAM
As funções do IAM devem ter as seguintes permissões do S3 para conectar sua conta AWS. Para obter mais detalhes sobre o gerenciamento de acesso do S3, consulte a documentação da AWS.
- s3:DeleteObject
- s3:GetObject
- s3:ListBucket
- s3:PutObject
- s3:AbortMultipartUpload
- s3:ListMultipartUploadParts
Exemplo: Abaixo está um amostra de política de função. Para a ação “s3:ListBucket”, o recurso associado deve apontar para um bucket inteiro. Não pode haver uma barra final nem um caractere curinga após o nome do bucket.
{
"actualmente
Versão": "2012-10-17"
,
"Statement": [
{
"Effect": "Permitir",
"Action": [
"s3:ListBucket"
} },
"Prefect": [
"Multiarn:aws:s3: "s3bucketname"
DeleteObject "
"S
": "Gets
",
"s
"
"Action": Delete
"
"S
"
Exemplo: Abaixo está um exemplo de política de confiança:
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Permitir",
"Action": "sts:AssumeRole",
"Principal": {
"AWS": "604163242721"
},
"Condition": {
"StringEquals": {
"sts:ExternalId": "60ebef7bdexali
Nota de
RECURSOS S3 NECESSÁRIOS PARA UM USUÁRIO IAM
Os usuários do IAM devem ter os seguintes recursos do S3 para conectar sua conta AWS. Para obter mais detalhes sobre o gerenciamento de acesso do S3, consulte a documentação da AWS.
- arn:aws:s3:::bucket-name/*
- arn:aws:s3:::bucket-name
Adição de uma conta AWS
Estas etapas cobrem como conectar sua conta Qualtrics pessoal a uma conta Amazon Web Services (AWS).
- Crie um fluxo de trabalho com uma tarefa Extrair dados do Amazon S3.
- Clique em Adicionar uma conta de usuário.
- Adicione um nome de exibição para a conta. Esse nome só será usado para se referir à conta internamente.
- Copie o ID da conta e o ID externo exibidos para você.
- No AWS, configure uma função IAM usando o ID da conta e o ID externo. Consulte esta página de suporte da AWS para obter mais informações sobre as funções do IAM na AWS.
- Insira o nome do recurso Amazon associado à função IAM que você criou.
- Insira sua região. Consulte esta página de suporte da AWS se precisar de ajuda para encontrar sua região.
- Clique em Conectar conta.
Qdica: A capacidade de autenticação usando uma chave de acesso e uma chave secreta foi descontinuada. Você ainda pode visualizar e usar credenciais anteriores, mas elas não podem mais ser editadas. Todas as novas credenciais devem ser configuradas usando uma função do AWS IAM, conforme descrito acima.
Conectar uma conta como administrador da marca
Como Administrador da marca, você pode adicionar uma conta da AWS para compartilhar com vários usuários em sua licença. Para adicionar uma conta compartilhada da AWS, vá para a seção Extensões da guia Admin e procure a extensão da AWS para a qual você deseja adicionar uma conta.
Depois de selecionar sua extensão, siga as etapas acima para adicionar uma conta da AWS. Você também pode escolher quais usuários têm acesso à conta.
Configuração de uma tarefa Extrair dados do Amazon S3
- Criar um fluxo de trabalho ETL.
- Selecione Fonte de dados (extrator ETL).
- Selecione Extrair dados do Amazon S3.
- Selecione a conta do Amazon Web Services (AWS) para extrair arquivos do. Quaisquer contas adicionadas pelos Administradores da marca, bem como as contas que você mesmo adicionou, serão listadas aqui.
- Se você quiser adicionar novas credenciais de conta da AWS, clique em Adicionar uma conta de usuário e siga as etapas na seção de conexão de uma conta da AWS.
- Clique em Seguinte.
- Insira o nome do bucket S3 do qual você deseja extrair dados.
Qdica: Para obter mais diretrizes sobre nomenclatura de buckets, consulte Documentação da AWS . - Digite um prefixo do nome do arquivo. Todos os arquivos com seu prefixo especificado serão processados. Se a função s3 só permitir o acesso a um prefixo de bucket S3 específico, você deve incluir o prefixo aqui.
- Selecione um tipo de arquivo para processar. Você pode selecionar entre os seguintes:
- CSV (valores separados por vírgulas)
- TSV (valores separados por tabulação)
- Em Processamento de arquivo após importação, selecione entre os seguintes:
- Exclua os arquivos processados (padrão): exclua arquivos da AWS depois que eles forem extraídos.
- Mover os arquivos processados: mova os arquivos processados para outro bucket. Se você escolher essa opção, será solicitado a digitar o nome do bucket do S3 em que deseja que os arquivos processados sejam armazenados.
- Renomeie os arquivos processados: renomeie os arquivos depois de serem processados. Se você selecionar esta opção, será solicitado que você forneça um prefixo que gostaria de adicionar aos nomes de arquivo depois de serem processados.
- Selecione esta opção se você quiser Usar PGP para criptografar seus arquivos.
- Em Carregar arquivo de amostra, adicione um arquivo de amostra que tenha os mesmos cabeçalhos que os arquivos que serão processados sempre que o fluxo de trabalho for executado. Clique em Escolher arquivo para carregar o arquivo de seu computador.
Qdica: Se desejar, você pode baixar os arquivos de amostra na tarefa ou baixar os arquivos na seção Arquivos de exemplo. O único formato de codificação de arquivo suportado é UTF-8. Alguns softwares de planilha salvam arquivos como Unicode UTF-8, que é diferente de 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. Consulte Problemas de upload de CSV & TSV para obter mais etapas de solução de problemas.
- Verifique os campos no arquivo. A tabela exibirá os cabeçalhos de coluna (que representam os campos individuais) e seus valores para as duas primeiras linhas de dados.
Qdica: Se você quiser carregar um arquivo diferente ou fazer outras alterações, clique em Editar a configuração. - Quando terminar, clique em Salvar.
- 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.