AWS S3 Get¶
Introducción¶
El complemento AWS S3 Get lee, cambia el nombre o elimina un archivo de Amazon AWS S3. Un archivo que se lee se puede utilizar como fuente en una operación.
Este complemento está disponible de forma predeterminada en grupos de agentes en la nube de Jitterbit y también pueden asociarse con grupos de agentes privados.
Esta página detalla los pasos para utilizar el complemento AWS S3 Get:
- Descargue y agregue el complemento
- Asociar el complemento con un grupo de agentes
- Asignar el complemento a una fuente
- Establecer variables globales para el complemento
- Configuración de operación completa
Importante
Los complementos proporcionados por Jitterbit están obsoletos. Consulte Obsolescencia y soporte en Complementos.
Encriptación¶
El complemento AWS S3 Get pasa el ID de la clave de acceso de AWS S3 y la clave de acceso secreta proporcionadas (que se describen a continuación en Establecer variables globales para el complemento) a Amazon. La seguridad está a cargo de 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 en Amazon AWS S3 como objetivo dentro de una operación en Design Studio.
-
AWS REST API: Se puede acceder a la API AWS REST 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 dependiendo de su método de autenticación. Si necesita ayuda, por favor contacte con el soporte.
Descargue y Agregue el Complemento¶
El complemento AWS S3 Get es un complemento Jitterbit estándar que ya está disponible en Management Console Complementos y no es necesario descargarlo ni agregarlo 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 (consulte Agregar nuevos complementos en Personalizaciones > Complementos).
Asociar el Complemento con un Grupo de Agentes¶
El complemento AWS S3 Get está asociado con grupos de agentes en la nube de Jitterbit de forma predeterminada.
Si utiliza un grupo de agentes privado, antes de poder utilizar el complemento, debe asociarlo con el grupo de agentes privado para que el complemento esté disponible para todos los agentes del grupo (consulte Asociar grupos de agentes en Personalizaciones > Complementos).
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. Una configuración de operación de ejemplo 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 en realidad no se leerá. 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]
. - Asigne el complemento a la fuente. Para hacer esto, haga clic derecho en la fuente y seleccione Complemento. En la ventana emergente, en Complementos disponibles, seleccione "Obtener Jitterbit AWS S3" y haga clic en Asignar. Luego haga 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 requerido por el complemento debe estar configurado. Estas variables se configuran en un secuencia de comandos, que debe colocarse antes de la fuente en la operación para que se puedan inicializar las variables.
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.
-
Cree un nuevo Jitterbit Script que establece las variables utilizadas por 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 pueden incluirse 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 está configurado. Los nombres de extremo válidos por región se proporcionan 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 está configurado (no recomendado). 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 se incluye 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 usarse en combinación con otras. Si se usan juntos, esto causará errores en su operación.
Configuración de Operación Completa¶
La parte del complemento de la configuración de la operación se completa después de que tenga (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 de S3, o agregue 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 usar el mismo nombre de archivo en el destino que el que lee el complemento. Usando un valor de [file].[ext]
devolverá el ID S3 del archivo en lugar del nombre del archivo S3.