Saltar al contenido

Conector de Amazon S3 en Jitterbit Studio

Resumen

El conector de Amazon S3 establece acceso a Amazon S3.

El conector de Amazon S3 proporciona una interfaz para crear una conexión de Amazon S3, la base utilizada para generar instancias de actividades de Amazon S3. Estas actividades, una vez configuradas, interactúan con Amazon S3 a través de la conexión.

Se accede al conector de Amazon S3 desde la pestaña Puntos finales y conectores del proyecto de la paleta de componentes de diseño (consulta Paleta de componentes de diseño).

Importante

Si utilizas una instancia de Vectores de Amazon S3 como almacén de vectores para una base de conocimientos de Amazon Bedrock, utiliza una actividad de Prompt de Amazon Bedrock para interactuar con ella. El conector de Amazon S3 no es necesario.

Descripción general del conector

Este conector se utiliza primero para configurar una conexión de Amazon S3. Los tipos de actividades asociados con esa conexión se utilizan luego para crear instancias de actividades que se pretende utilizar como orígenes (para proporcionar datos en una operación) o destinos (para consumir datos en una operación).

En conjunto, una conexión específica de Amazon S3 y sus actividades se denominan punto final de Amazon S3:

Tipos de actividades de Amazon S3

  • Mover objeto: Mueve un objeto de un bucket de Amazon S3 a otro y se pretende utilizar como destino en una operación.

  • Eliminar objeto: Elimina un objeto de un bucket de Amazon S3 y se pretende utilizar como destino en una operación.

  • Colocar objeto: Coloca un objeto en un bucket de Amazon S3 y se pretende utilizar como destino en una operación.

  • Obtener objeto: Recupera un objeto de un bucket de Amazon S3 y se pretende utilizar como origen en una operación.

  • Listar objetos: Devuelve algunos o todos (hasta 100,000) los objetos en un bucket de Amazon S3 y se pretende utilizar como destino en una operación.

Los puntos finales creados con este conector se incluyen en reportes de uso de puntos finales y cuentan hacia tu licencia.

Requisitos previos y versiones de API compatibles

Este conector se puede utilizar con agentes en la nube y agentes privados.

Los agentes descargan automáticamente la versión más reciente de este conector cuando es necesario. En agentes privados, puedes suspender estas actualizaciones con la política de organización Deshabilitar actualización automática de conector.

Para utilizar las actividades del conector de Amazon S3, la instancia de Amazon S3 debe tener ciertos permisos configurados. Todas las actividades del conector requieren el permiso s3:ListAllMyBuckets. Además, las actividades individuales requieren permisos específicos adicionales. La siguiente tabla resume los permisos necesarios:

Permiso necesario Funcionalidad
s3:ListAllMyBuckets Prueba de la [conexión] y recuperación de metadatos de actividades durante la configuración de actividades
s3:PutObject y s3:GetBucketLocation Ejecución de la [actividad Colocar objeto]
s3:GetObject, s3:ListBucket y s3:GetObjectTagging (opcional) Ejecución de la [actividad Obtener objeto]

Nota

El permiso s3:GetObjectTagging es necesario solo cuando la configuración opcional Incluir metadatos de etiquetado en respuesta está habilitada para la actividad Obtener objeto.
s3:GetObject, s3:ListBucket y s3:GetObjectTagging Ejecución de la [actividad Listar objetos]
s3:DeleteObject Ejecución de la [actividad Eliminar objeto]
s3:GetObject y s3:PutObject Ejecución de la [actividad Mover objeto]

El conector de Amazon S3 utiliza la API de Amazon Simple Storage Service. Consulta la documentación de acciones de la API de Amazon S3 para obtener información sobre los nodos de esquema y los campos.

Solución de problemas

Si experimentas problemas con el conector de Amazon S3, se recomiendan estos pasos para la solución de problemas:

  1. Haz clic en el botón Probar en la configuración de conexión para asegurar que la conexión sea exitosa y para descargar la versión más reciente del conector en el agente (a menos que uses la política de organización Deshabilitar actualización automática de conector).

  2. Revisa los registros de operación para obtener cualquier información escrita durante la ejecución de la operación.

  3. Habilita el registro de depuración de operación (para agentes en la nube o para agentes privados) para generar archivos de registro y datos adicionales.

  4. Si utilizas agentes privados, puedes habilitar el registro detallado del conector para este conector agregando esta entrada de configuración de registrador al archivo logback.xml de tu agente privado:

    <logger name="org.jitterbit.connector.amazon" level="DEBUG"/>

    Para obtener más información sobre el registro detallado del conector, consulta Registro detallado para conectores que utilizan agentes privados de Jitterbit.

  5. Si utilizas agentes privados, puedes revisar los registros del agente para obtener más información.

  6. Para consideraciones adicionales sobre la solución de problemas, consulta Solución de problemas de operación.