Extrair dados da Tarefa do Amazon S3
O que há nesta página
Sobre a extração de dados do Amazon S3
O Amazon Simple Storage Service (também conhecido como Amazon S3) é um serviço no qual você pode armazenar dados. Com os fluxos de trabalho, você pode automatizar facilmente a extração de dados do Amazon S3 para uso no Qualtrics.
Exemplo: Você mantém planilhas atualizadas de informações contato colaborador armazenadas no Amazon S3. Você gostaria de enviar periodicamente esses dados de colaborador para o Qualtrics para uso em seus programas de experiência dos colaboradores, Employee Experience.
Qdica: para obter informações sobre os limites gerais que aplicar aos fluxos de trabalho de ETL, consulte Limites Fluxo de trabalho. Para saber quais são os limites específicos da tarefa, consulte as informações nesta página.
Antes de começar
Antes de começar a extrair dados do Amazon S3, leve em conta as seguintes considerações:
- O que você deseja fazer com seus dados? Dê uma olhada nas tarefas do carregador disponíveis para obter uma lista de opções.
- Seus arquivos têm 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.
Exemplo: Você configura um fluxo de trabalho para carregar regularmente contatos do Amazon S3 para o Diretório XM. Cada arquivo tem colunas para Firstname, Lastname, E-mail, Telefone, UniqueID e Local.
Conectando o Qualtrics ao AWS
Permissão S3 necessária para uma função de IAM
As funções do IAM devem ter as seguintes permissões do S3 para conectar sua conta do AWS. Para obter mais detalhes sobre o gerenciamento de acesso ao S3, consulte a documentação da AWS.
- s3:DeleteObject
- s3:GetObject
- s3:ListBucket
- s3:PutObject
- s3:AbortMultipartUpload
- s3:ListMultipartUploadParts
Exemplo: Abaixo está um amostra 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 curinga após o nome do bucket.
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow" (Permitir),
"Action" (Ação): [
"s3:ListBucket"
],
"Resource": [
"arn:aws:s3:::s3bucketname"
]
},
{
"Effect": "Allow" (Permitir),
"Action" (Ação): [
"s3:DeleteObject",
"s3:GetObject",
"s3:PutObject",
"s3:AbortMultipartUpload",
"s3:ListMultipartUploadParts"
],
"Resource": [
"arn:aws:s3:::s3bucketname/QualtricsPrefix/*"
]
}
]
}
Exemplo: Abaixo está um amostra política de confiança:
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow" (Permitir),
"Action" (Ação): "sts:AssumeRole",
"Principal": {
"AWS": "604163242721"
},
"Condição"): {
"StringEquals": {
"sts:ExternalId": "60ebef7bdexternalidc38d36bc2a6b75cd14f02c73"
}
}
}
]
}
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 do AWS. Para obter mais detalhes sobre o gerenciamento de acesso ao 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 abrangem como conectar sua conta pessoal do Qualtrics a uma conta do Amazon Web Services (AWS).
Qdica: veja mais sobre chaves de acesso da AWS, chaves secretas e política de IAM na documentação da AWS.
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.
Conexão de uma Conta como administrador Marca
Como Administrador Marca, você pode adicionar uma conta AWS para compartilhar com vários usuários em sua licença. Para adicionar uma conta compartilhada do AWS, acesse a seção Extensões da guia Admin e pesquise a extensão do AWS à qual deseja adicionar uma conta.
Depois de selecionar sua extensão, siga as etapas acima para adicionar uma conta do AWS. Você também pode escolher quais usuários têm acesso à conta.
Configuração de uma Tarefa de extração de dados do Amazon S3
Qdica: há um limite de tamanho de arquivo de 5 GB.
Qdica: para obter mais diretrizes de nomeação de buckets, consulte a documentação do AWS.
- CSV (valores separados por vírgulas)
- TSV (valores separados por tabulação)
- Excluir os arquivos processados (padrão): Exclui os arquivos do AWS depois que eles são extraídos.
- Mover os arquivos processados: Mova os arquivos processados para outro bucket. Se escolher essa opção, você será solicitado a digitar o nome do bucket do S3 onde deseja armazenar os arquivos processados.
- Renomear os arquivos processados: Renomeie os arquivos depois que eles forem processados. Se selecionar essa opção, será solicitado que você forneça um prefixo que gostaria que fosse adicionado aos nomes dos arquivos depois de processados.
Qdica: se desejar, baixe os arquivos amostra na tarefa ou baixe os arquivos na seção Arquivos de exemplo. O único formato de codificação de arquivo compatível é o 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 esteja exportando no formato UTF-8 e não no Unicode UTF-8. Consulte Problemas de upload de CSV e TSV para obter mais etapas de solução de problemas.
Qdica: se você quiser carregar um arquivo diferente ou fazer outras alterações, clique em Edit the setup (Editar a configuração).
Isso é ótimo! Obrigado pelo seu feedback!
Obrigado pelo seu feedback!