Extraer datos de la tarea de Amazon S3
Acerca de la extracción de datos de Amazon S3
Amazon Simple Storage Service (también conocido como Amazon S3) es un servicio en el que puede almacenar datos. Con los flujos de trabajo, puede automatizar fácilmente la extracción de datos de Amazon S3 para su uso en Qualtrics.
Antes de comenzar
Antes de empezar a extraer datos de Amazon S3, tenga en cuenta las siguientes consideraciones:
- ¿Qué desea hacer con sus datos? Observe las tareas de cargador disponibles para obtener una lista de opciones.
- ¿Sus archivos tienen un formato consistente? Por ejemplo, los archivos que espera importar en el mismo flujo de trabajo deben tener las mismas cabeceras/columnas/campos, incluso si los valores difieren.
Conexión de Qualtrics a AWS
Autorización S3 necesaria para una función IAM
Las funciones de IAM deben tener los siguientes permisos S3 para conectar su cuenta AWS. Para obtener más detalles sobre la administración de acceso S3, consulte la documentación de AWS.
- s3:DeleteObject
- s3:GetObject
- s3:ListBucket
- s3:PutObject
- s3:AbortMultipartUpload
- s3:ListMultipartUploadParts
Ejemplo: A continuación se muestra un ejemplo de política de roles. Para la acción “s3:ListBucket”, el recurso asociado debe apuntar a un depósito completo. No puede haber una barra diagonal final ni un comodín después del nombre del depósito.
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "allow",
"Action": [
"s3:ListBucket"
],
"Resource"
"Arn
:aws:s3
""
3":3:3"3":
},
"Effect": "Permitir",
"Action""
3":3"3": 3:3:3":
},
"Effect": "Permitir",
"Action" "t3""3": 3:3"3": 3:
3:3"3":
},
Ejemplo: A continuación se muestra una política de confianza de muestra:
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Permitir",
"Action": "sts:AssumeRole",
"Principal": {
"AWS": "604163242721"
},
"Condition": {
"StringEquals": {
"sts:ExternalId
": "60e}bef7bdexali": {
"sts:ExternalId
": "60e}bef7bdexali": {
"sts:ExternalId
": "60e}bef7bternali dc38d36bc2a6b75cd14f02c73"
RECURSOS S3 REQUERIDOS PARA UN USUARIO IAM
Los usuarios de IAM deben tener los siguientes recursos S3 para conectar su cuenta de AWS. Para obtener más detalles sobre la administración de acceso S3, consulte la documentación de AWS.
- arn:aws:s3:::bucket-name/*
- arn:aws:s3:::bucket-name
Añadir una cuenta de AWS
En estos pasos se explica cómo conectar su cuenta personal de Qualtrics a una cuenta de Amazon Web Services (AWS).
- Cree un flujo de trabajo con una tarea Extraer datos de Amazon S3.
- Haga clic en Añadir una cuenta de usuario.
- Añada un nombre de visualización para la cuenta. Este nombre solo será usado internamente para referirse a esta cuenta.
- Copie el ID de cuenta y el ID externo que se muestran.
- En AWS, configure una función IAM utilizando el ID de cuenta y el ID externo. Consulte esta página de soporte técnico de AWS para obtener más información sobre los roles de IAM en AWS.
- Introduzca el nombre del recurso de Amazon asociado con el rol IAM que ha creado.
- Introduzca su región. Consulte esta página de soporte técnico de AWS si necesita ayuda para encontrar su región.
- Haga clic en Conectar cuenta.
Bastoncillo de algodón: La capacidad de autenticarse usando una clave de acceso y una clave secreta ha quedado obsoleta. Todavía puedes ver y usar credenciales anteriores, pero ya no se pueden editar. Todas las credenciales nuevas deben configurarse utilizando un rol de AWS IAM como se describe anteriormente.
Conexión de una cuenta como administrador de organización
Como administrador de organización, puede añadir una cuenta de AWS para compartir con varios usuarios de su licencia. Para añadir una cuenta AWS compartida, vaya a la sección Extensiones de la ficha Administración y busque la extensión AWS para la que desea añadir una cuenta.
Una vez que haya seleccionado su extensión, siga los pasos anteriores para agregar una cuenta de AWS. También puede seleccionar qué usuarios tienen acceso a la cuenta.
Configuración de una tarea Extraer datos de Amazon S3
- Cree un flujo de trabajo ETL.
- Seleccione Fuente de datos (extractor ETL).
- Seleccione Extraer datos de Amazon S3.
- Seleccione la cuenta de Amazon Web Services (AWS) de la que extraer archivos. Todas las cuentas añadidas por los administradores de organización, así como las cuentas que haya añadido usted mismo, se enumerarán aquí.
- Si desea agregar nuevas credenciales de cuenta de AWS, haga clic en Agregar una cuenta de usuario y siga los pasos en la sección de conexión de una cuenta de AWS.
- Haga clic en Siguiente.
- Introduzca el nombre del intervalo S3 del que desea extraer datos.
Bastoncillo de algodón: Para obtener más pautas sobre nombres de depósitos, consulte la Documentación de AWS. - Escriba un prefijo de nombre de archivo. Se procesarán todos los archivos con el prefijo especificado. Si el rol s3 solo permite el acceso a un prefijo de intervalo S3 específico, debe incluir el prefijo aquí.
- Seleccione un tipo de archivo para procesar. Puede seleccionar una de las siguientes opciones:
- CSV (valores separados por comas)
- TSV (valores separados por tabuladores)
- En Procesamiento de archivos después de la importación, seleccione entre las siguientes:
- Eliminar los archivos procesados (predeterminado): Elimine los archivos de AWS después de extraerlos.
- Mover los archivos procesados: Mueva los archivos procesados a otro intervalo. Si elige esta opción, se le pedirá que introduzca el nombre del cubo S3 donde desea que se almacenen los archivos procesados.
- Renombrar los archivos procesados: Renombrar los archivos después de procesarlos. Si selecciona esta opción, se le pedirá que proporcione un prefijo que le gustaría que se agregara a los nombres de archivo después de que se procesen.
- Seleccione esta opción si desea Use PGP para encriptar sus archivos.
- En Cargar archivo de muestra, añada un archivo de muestra que tenga las mismas cabeceras que los archivos que se procesarán cada vez que se ejecute el workflow. Haga clic en Seleccionar archivo para cargar el archivo desde su ordenador.
Consejo Q: Si lo desea, puede descargar los archivos de muestra en la tarea o descargar los archivos en la sección Archivos de ejemplo. El único formato de codificación de archivo admitido es UTF-8. Algunas hojas de cálculo guardan archivos como Unicode UTF-8, que es diferente de UTF-8, si obtiene errores inesperados. Asegúrese de que está exportando en formato UTF-8 y no Unicode UTF-8. Consulte problemas de carga de CSV y TSV para obtener más pasos de resolución de problemas.
- Verifique los campos en el archivo. La tabla mostrará las cabeceras de columna (que representan los campos individuales) y sus valores para las 2 primeras filas de datos.
Consejo Q: Si desea cargar un archivo diferente o realizar otros cambios, haga clic en Editar la configuración. - Cuando haya terminado, haga clic en Guardar.
- Finalice la creación de su flujo de trabajo ETL. Cuando selecciona una tarea de cargador, decide el destino de los datos que ha extraído. Consulte las tareas de cargador disponibles para obtener una lista de opciones.