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:
- Descargar y agregar el complemento
- Asociar el complemento con un grupo de agentes
- Asignar el complemento a una fuente
- Establecer variables globales para el complemento
- 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:
-
Creación de AWS S3: Creación de AWS S3 es un complemento proporcionado por Jitterbit que se utiliza para cargar un archivo a Amazon AWS S3 como un objetivo dentro de una operación en Design Studio.
-
API REST de AWS: Se puede acceder a la API REST de AWS a través de una fuente HTTP o objetivo HTTP en Design Studio. Durante la configuración, puede ser necesario utilizar el generador HMAC-SHA256 complemento según su método de autenticación. Si necesita ayuda, por favor contacte al soporte técnico.
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:
- Crear una operación Se puede utilizar cualquier operación que utilice una fuente.
- 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]
. - 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:
-
Haga clic derecho en la fuente en la operación y seleccione Insertar antes de esto > Secuencia de comandos.
-
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.
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.