Actividad de lista de objetos de Amazon S3¶

Introducción¶

Una actividad List Objects de Amazon S3, que utiliza su conexión de Amazon S3, devuelve algunos o todos (hasta 100 000) de los objetos en un bucket de Amazon S3 y está destinado a usarse como un destino para consumir datos en una operación.

Crear una actividad de objetos de lista de Amazon S3¶

Se crea una instancia de una actividad List Objects de Amazon S3 desde una conexión de Amazon S3 utilizando su tipo de actividad Objetos de lista.

Para crear una instancia de una actividad, arrastre el tipo de actividad al tela de diseño o copie el tipo de actividad y péguelo en el tela de diseño. Para obtener más detalles, consulte Creación de una instancia de actividad en Reutilización de componentes.

Se puede editar una actividad List Objects de Amazon S3 existente desde estas ubicaciones:

• El tela de diseño (vea menú de acciones del componente en Lienzo de diseño).
• La pestaña Componentes del panel del proyecto (vea menú de acciones de componentes en la pestañaComponentes del panel Proyecto).

Configurar una actividad de objetos de lista de Amazon S3¶

Siga estos pasos para configurar una actividad List Objects de Amazon S3:

• Paso 1: Ingrese un nombre y seleccione un depósito
  Proporcione un nombre para la actividad y seleccione un depósito que se utilizará.

• Paso 2: Revise los esquemas de datos
  Se muestran todos los esquemas de solicitud o respuesta generados desde el extremo.

Paso 1: Ingrese un nombre y seleccione un depósito¶

En este paso, proporcione un nombre para la actividad y seleccione el depósito que se utilizará.

La interfaz utilizada en este paso de la configuración de una actividad List Objects de Amazon S3 depende de las Bucket Options seleccionadas:

• Usar listas: Esta opción completará una lista de depósitos existentes para elegir.

• Usar entradas de texto: Para esta opción, ingresará manualmente el nombre de Amazon S3 cubo.

Utilice listas¶

Si se selecciona Usar listas para Opciones de depósito, se presenta esta interfaz:

• Nombre: Ingrese un nombre para identificar la actividad. El nombre debe ser único para cada actividad de Objetos de lista de Amazon S3 y no debe contener barras diagonales (/) o dos puntos (:).

• Seleccionar un depósito: De la lista completa, seleccione el depósito que contiene los objetos.

• Configuración opcional: Haga clic para expandir configuraciones opcionales adicionales:

  

  • Prefijo de objeto: Ingrese un prefijo para limitar la respuesta a las claves que comiencen con el prefijo especificado.

    • Excluir coincidencia exacta de prefijo de los resultados: Seleccione para excluir coincidencias exactas para el prefijo especificado en Prefijo de objeto.

  • Delimitador: Ingrese un carácter para usar como delimitador (máximo de 1 carácter).

  • Máximo de claves: Ingrese el número máximo de claves que se devolverán en la respuesta. De manera predeterminada, la actividad devuelve hasta 1000 nombres de clave. El máximo es 100 000 claves.

  • Comenzar después de: Ingrese una clave para devolver una respuesta que comience después de la clave especificada. El valor máximo es 1024 caracteres.

  • Región de AWS (anula la región del depósito): Seleccione una región de Amazon S3.

Utilizar entradas de texto¶

Si se selecciona Usar entradas de texto para Opciones de depósito, se presenta esta interfaz:

• Nombre: Ingrese un nombre para identificar la actividad. El nombre debe ser único para cada actividad de Objetos de lista de Amazon S3 y no debe contener barras diagonales (/) o dos puntos (:).

• Nombre del depósito: Ingrese el nombre del depósito de AmazonS3 que contiene los objetos.

• Configuración opcional: Haga clic para expandir configuraciones opcionales adicionales:

  

  • Prefijo de objeto: Ingrese un prefijo para limitar la respuesta a las claves que comiencen con el prefijo especificado.

    • Excluir coincidencia exacta de prefijo de los resultados: Seleccione para excluir coincidencias exactas para el prefijo especificado en Prefijo de objeto.

  • Delimitador: Ingrese un carácter para usar como delimitador (máximo de 1 carácter).

  • Máximo de claves: Ingrese el número máximo de claves que se devolverán en la respuesta. De manera predeterminada, la actividad devuelve 1000 claves. El máximo es 100 000 claves.

  • Comenzar después de: Ingrese una clave para devolver una respuesta que comience después de la clave especificada. El valor máximo es 1024 caracteres.

  • Región de AWS (anula la región del depósito): Seleccione una región de Amazon S3.

• Guardar y salir: Si está habilitado, haga clic para guardar la configuración de este paso y cerrar la configuración de la actividad.

• Siguiente: Haga clic para almacenar temporalmente la configuración de este paso y continuar con el siguiente paso. La configuración no se guardará hasta que haga clic en el botón Terminado en el último paso.

• Descartar cambios: Después de realizar cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le solicitará que confirme que desea descartar los cambios.

Paso 2: Revisar los esquemas de datos¶

Se muestran todos los esquemas de solicitud o respuesta generados desde el extremo. A continuación, se describe cada elemento de la interfaz de usuario de este paso.

• Esquemas de datos: Se muestran los esquemas de solicitud y respuesta para esta actividad. Estos esquemas de datos son heredados por las transformaciones adyacentes y se muestran nuevamente durante el mapeo de la transformación.

  El conector de Amazon S3 utiliza el AWS SDK para Java versión 1.12.770. Consulte la documentación de la API para obtener información sobre los nodos y campos del esquema.

  Los esquemas de datos de solicitud y respuesta constan de estos nodos y campos:

  Campo de esquema de respuesta	Descripción
  keyCount	La cantidad de claves devueltas
  Lista	La lista de claves, resultados devueltos en orden binario UTF-8
  clave	Cadena con la clave de la carga multiparte iniciada
  talla	Talla
  ETag	La etiqueta de entidad que identifica el nuevo objeto mediante getETag método
  lastModified	Valor de fecha y hora del encabezado Last-Modified, que indica la fecha y hora en la que Amazon S3 registró por última vez una modificación en el objeto asociado, utilizando getLastModified método
  error	Contenedor para todos los elementos de error
  errorCode	Una cadena que identifica de forma única una condición de error
  mensaje	Una descripción genérica de la condición de error

• Actualizar: Haga clic en el ícono de actualización o la palabra Actualizar para regenerar esquemas desde el extremo de Amazon S3. Esta acción también regenera un esquema en otras ubicaciones en todo el proyecto donde se hace referencia al mismo esquema, como en una transformación adyacente.

• Atrás: Haga clic para almacenar temporalmente la configuración de este paso y regresar al paso anterior.

• Terminado: Haga clic para guardar la configuración de todos los pasos y cerrar la configuración de la actividad.

• Descartar cambios: Después de realizar los cambios, haga clic para cerrar la configuración sin guardar los cambios realizados en ningún paso. Un mensaje le solicitará que confirme que desea descartar los cambios.

Próximos pasos¶

Después de configurar una actividad List Objects de Amazon S3, complete la configuración de la operación agregando y configurando otras actividades, transformaciones o secuencias de comandos como pasos de la operación. También puede configurar los ajustes de la operación, que incluyen la capacidad de encadenar operaciones que se encuentran en el mismo flujo de trabajo o en flujos de trabajo diferentes.

Se puede acceder a las acciones del menú de una actividad desde el panel del proyecto y el tela de diseño. Para obtener más información, consulte menú de acciones de la actividad en Conceptos básicos del conector.

Las actividades de Objetos de lista de Amazon S3 se pueden usar como destino con estos patrones de operación:

• Patrón de Transformación
• Patrón de archivo de dos objetivos (solo como primera fuente)
• Patrón de archivo HTTP de dos destinos (solo como primera fuente)

Para utilizar la actividad con funciones de script, escriba los datos en una ubicación temporal y luego use esa ubicación temporal en la función de script.

Cuando esté listo, desplegar y ejecute la operación y validar el comportamiento comprobando los registros de operación.