Saltar al contenido

Complemento de obtención de AWS S3 (obsoleto) para la nube Jitterbit y grupos de agentes privados

Introducción

El complemento Get de AWS S3 lee, cambia el nombre o elimina un archivo de Amazon AWS S3. Un archivo leído se puede utilizar como origen en una operación.

Este complemento está disponible de forma predeterminada en grupos de agentes de nube Jitterbit y también pueden asociarse con grupos de agentes privados.

Esta página detalla los pasos para utilizar el complemento AWS S3 Get:

  1. Descargar y agregar el complemento
  2. Asociar el complemento con un grupo de agentes
  3. Asignar el complemento a una fuente
  4. Establecer variables globales para el complemento
  5. Configuración completa de la operación

Importante

Los complementos proporcionados por Jitterbit están obsoletos. Consulte Obsolescencia y soporte en Complementos.

Encriptación

El complemento AWS S3 Get pasa la ID de clave de acceso de AWS S3 proporcionada y la clave de acceso secreta (que se describe a continuación en Establecer variables globales para el complemento) a Amazon. La seguridad la gestiona Amazon como se describe en la documentación de Amazon sobre Credenciales de seguridad de AWS.

Uso

El complemento AWS S3 Get se puede utilizar siempre que necesite recuperar, cambiar el nombre o eliminar archivos de AWS.

Funcionalidad adicional

Además, estas opciones ofrecen funcionalidad adicional más allá del complemento AWS S3 Get:

Descargue y agregue el complemento

El complemento AWS S3 Get es un complemento Jitterbit estándar que ya está disponible en la Management Console Complementos página y no necesita descargarse ni agregarse a la organización.

Si el soporte lo indica, este complemento se puede descargar en el enlace que se proporciona a continuación y agregarlo a la organización.

Asociar el complemento con un grupo de agentes

El complemento AWS S3 Get está asociado con los grupos de agentes de nube Jitterbit de forma predeterminada.

Si usa un grupo de agentes privados, antes de poder usar el complemento debe asociarlo con el grupo de agentes privados para que el complemento esté disponible en todos los agentes del grupo.

El complemento aparece en la Management Console Complementos página con un nombre para mostrar de Jitterbit AWS S3 Get.

Asignar el complemento a una fuente

En un proyecto de Design Studio, debes asignar el complemento a una fuente dentro de una operación. Un ejemplo de configuración de operación se proporciona al final de esta página.

Dentro del proyecto:

  1. Crear una operación Se puede utilizar cualquier operación que utilice una fuente.
  2. Cree una fuente ficticia a la que se asignará el complemento. Esta fuente se utiliza como marcador de posición y no se leerá realmente. Recomendamos utilizar una fuente de variable global. Si se utilizan otras fuentes de tipo de archivo, como Almacenamiento temporal, archivo local, o FTP, durante la configuración de la fuente se recomienda proporcionar un valor Obtener archivos de [file].[ext].
  3. Asigna el complemento a la fuente. Para ello, haz clic con el botón derecho en la fuente y selecciona Complemento. En la ventana emergente, en Complementos disponibles, selecciona "Jitterbit AWS S3 Get" y haz clic en Asignar. Luego, haz clic en Aceptar.

Sugerencia

La documentación detallada sobre la asignación de complementos está disponible en Aplicación de complementos de canalización.

Establecer variables globales para el complemento

Para que un complemento asignado a una fuente sea funcional, cualquier variable global que requiere el complemento. Estas variables se configuran en un secuencia de comandos, que debe colocarse antes de la fuente en la operación para que las variables se puedan inicializar.

Para agregar un secuencia de comandos antes de la fuente:

  1. Haga clic derecho en la fuente en la operación y seleccione Insertar antes de esto > Secuencia de comandos.

  2. Crea un nuevo Jitterbit Script que establece las variables que utiliza el complemento para autenticarse con su depósito S3 y leer el archivo que especifique. A continuación, se proporciona una modelo de secuencia de comandos para las variables requeridas, seguida de documentación sobre todas las variables posibles que se pueden incluir en el secuencia de comandos.

    AWS S3 Get Script
    <trans>
    $AWS.S3.BUCKET_NAME="<YOUR_BUCKET_NAME>";
    $AWS.S3.ACCESS_KEY_ID="<YOUR_ACCESS_KEY>";
    $AWS.S3.SECRET_ACCESS_KEY="<YOUR_SECRET_KEY>";
    $AWS.S3.OBJECT_KEY="<myfile.txt>";
    </trans>
    
Nombre Tipo Obligatorio. Descripción
AWS.S3.ENDPOINT Cadena Opcional La URL del extremo de Amazon AWS S3. El valor predeterminado es "s3.amazonaws.com" Si no se configura, se proporcionan nombres de extremo válidos por región en la documentación de Amazon Regiones y Extremos de AWS.
AWS.S3.BUCKET_NAME Cadena Obligatorio El nombre del depósito de origen de S3. Para leer desde una carpeta dentro del depósito, agregue el nombre de la carpeta después de una barra diagonal (p. ej. "my_bucket/folder").
AWS.S3.ACCESS_KEY_ID Cadena Obligatorio La clave de acceso S3 (p. ej. "ABCDEFGHI1JK2LM3NOPQ").
AWS.S3.SECRET_ACCESS_KEY Cadena Obligatorio La clave de acceso secreta de S3 (p. ej. "1aBCd2e/F34gH56IJ7Kl/Mno8pqRsTUvw9x0yzzz").
AWS.S3.REGION Cadena Opcional La región S3. El valor predeterminado es "DEFAULT_REGION" Si no se configura (no se recomienda), los nombres de las regiones actuales se proporcionan en la documentación de Amazon Regiones y Extremos de AWS.
AWS.S3.OBJECT_KEY Cadena Obligatorio La clave del objeto S3 que se leerá. Este es el nombre del archivo específico que desea que se devuelva, como "myfile.txt" La clave del objeto distingue entre mayúsculas y minúsculas. No se admite la especificación de varios archivos ni el uso de comodines.TABLEROWEND
AWS.S3.DELETE Booleano Opcional Si se establece en "true", elimina el objeto del depósito S3 después de leerlo. El valor predeterminado es "false". No utilizar con el AWS.S3.NEWNAME variable.

Advertencia

Esta variable elimina el objeto especificado en el depósito S3 en sí.

AWS.S3.NEWNAME Cadena Opcional El nombre utilizado para cambiar el nombre del objeto en el depósito S3 después de leerlo. El uso de esta variable cambiará la clave del objeto S3. No utilice con el AWS.S3.DELETE variable.

Advertencia

Esta variable elimina el objeto especificado en el depósito S3 en sí.

Advertencia

Aunque está incluida en el manifiesto del complemento, la variable AWS.S3.OBJECT_KEY_PREFIX No está funcionando. En este momento, no es posible leer varios archivos a la vez; solo se puede leer un archivo a la vez.

Precaución

Algunas de las variables anteriores no deben utilizarse en combinación con otras. Si se utilizan juntas, esto provocará errores en la operación.

Configuración completa de la operación

La parte del complemento de la configuración de la operación se completa después de tener (1) el secuencia de comandos que define las variables que se usarán con el complemento y (2) el complemento asignado a una fuente en la operación.

Para completar la configuración de su operación, defina un objetivo para archivar sus datos S3, o agregar un destino y una transformación si desea transformar sus datos antes de alcanzar el objetivo.

operación de configuración

Precaución

Si utiliza un Almacenamiento temporal, archivo local, o sitio FTP destino, para que el nombre de archivo y la extensión S3 se escriban en el destino, se recomienda ingresar [AWS.S3.OBJECT_KEY] en el campo Nombre(s) de archivo para utilizar el mismo nombre de archivo en el destino que el que lee el complemento. Utilizando un valor de [file].[ext] devolverá el ID S3 del archivo en lugar del nombre del archivo S3.