Cómo ejecutar un trabajo de traducción por lotes - Amazon Translate

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Cómo ejecutar un trabajo de traducción por lotes

Puede ejecutar un trabajo de traducción por lotes mediante la consola de Amazon Translate, elAWS CLIo la API de Amazon Translate.

Notas
  • Los trabajos de traducción por lotes son operaciones de larga duración y pueden tardar mucho tiempo en completarse. Por ejemplo, la traducción por lotes de un conjunto de datos pequeño puede tardar unos minutos, mientras que los conjuntos de datos muy grandes pueden tardar hasta dos días o más. El tiempo de finalización depende también de la disponibilidad de los recursos.

  • Amazon Translate no detecta automáticamente un idioma de origen durante los trabajos de traducción por lotes.

Para ejecutar un trabajo de traducción mediante la consola de Amazon Translate, utilice laBatch Translationpágina para crear el trabajo:

  1. Abra la consola de Amazon Translate enhttps://console.aws.amazon.com/translate/

  2. En el menú de navegación de la izquierda, elijaBatch Translation.

  3. En la páginaTrabajos de traslaciónpágina, elijaCrear el trabajo. La consola muestra elCrear un trabajo de traducción(Se ha creado el certificado).

  4. UNDERConfiguración de la tarea, realice una de las siguientes opciones:

    1. ParaNombre, especifique un nombre personalizado para el trabajo de traducción por lotes.

    2. ParaIdioma de origen, seleccione el idioma de los archivos de origen que se están traduciendo.

    3. ParaIdioma de destino, seleccione el idioma al que se han traducido los archivos.

  5. UNDERDatos de entrada, realice una de las siguientes opciones:

    1. ParaInput S3 location, especifique la carpeta de entrada que contiene los archivos de origen de traducción en Amazon S3. Para proporcionar la carpeta navegando hasta ella en Amazon S3, elijaSeleccionar carpeta.

    2. ParaFormato de archivo, seleccione el formato de los archivos de origen de traducción.

  6. UNDERDatos de salida, realice una de las siguientes opciones:

    1. ParaOutput S3 location, especifique la carpeta de salida de Amazon S3 en la que Amazon Translate coloca la salida de la traducción. Para proporcionar la carpeta navegando hasta ella en Amazon S3, elijaSeleccionar carpeta.

    2. También puede seleccionarPersonalización de la configuración de cifrado (avanzada)si desea cifrar su salida con una clave administrada por el cliente que administra en elAWS Key Management Service(AWS KMS).

      De forma predeterminada, Amazon Translate cifra la salida de traducción mediante una clave de KMS que se crea, administra y usa en nombre de usted porAWS. Elija esta opción si desea cifrar su salida con su propia clave KMS.

      Si desea utilizar una clave de KMS de la actualAWScuenta, selecciónela enElija unAWS Key Management Serviceclave. O bien, si desea utilizar una clave de KMS de otra cuenta de AWS, especifique el nombre de recurso de Amazon (ARN) de esa clave.

      nota

      Antes de poder utilizar su propia clave KMS, debe agregar permisos al rol de servicio de Amazon Translate en IAM. Si desea utilizar una clave de KMS de otra cuenta, también debe actualizar la directiva de clave deAWS KMS. Para obtener más información, consulte Permisos de requisitos previos para personalizar el cifrado.

  7. UNDERPersonalizaciones - opcionales, puede elegir personalizar la salida del trabajo de traducción con la siguiente configuración:

    blasfemia

    Permita enmascarar palabras y frases profanas en la salida de traducción. Para obtener más información, consulte Enmascarar palabras y frases profanas en Amazon Translate.

    Formalidad

    La opción de formalidad no está disponible para trabajos de traducción por lotes.

    Terminología personalizada

    Consiste en ejemplos de términos fuente y la traducción deseada para cada término.

    Para obtener más información, consulte Personalización de las traducciones con terminología personalizada.

    Datos en paralelo

    Consiste en ejemplos que muestran cómo desea que se traduzcan segmentos de texto. Cuando agrega datos parallel a un trabajo de traducción por lotes, crea unPersonalización activatrabajo.

    nota

    Los trabajos de traducción personalizada activa tienen un precio superior al de otros trabajos que no utilizan datos parallel. Para obtener más información, consultePrecios de Amazon Translate.

    Para obtener más información, consulte Personalización de las traducciones con datos paralelos (Traducción personalizada activa).

  8. UNDERPermisos de acceso, proporciona a Amazon Translate un rol de IAM que otorga los permisos necesarios a los archivos de entrada y salida en Amazon S3:

    • Si ya tiene este rol de IAM en su cuenta de, elijaUso de un rol de IAM existente, y selecciónela enRol de IAM.

    • Si aún no tiene este rol de IAM en su cuenta de, elijaCreación de un rol de IAM. ParaRol de IAM, eligeCucharones S3 de entrada y salida. ParaNombre del rol, proporcione un nombre personalizado. Al crear el trabajo de traducción, Amazon Translate crea el rol automáticamente. El nombre del rol en IAM lleva el prefijoFunción de servicio Amazon Translate -.

      nota

      Si eligió cifrar la salida de la traducción con su propia clave KMS, no podrá elegirCreación de un rol de IAM. En este caso, debe utilizar un rol de IAM preexistente y la clave de KMS debe tener una política clave que permita al rol utilizar la clave.

      Para obtener más información, consultePermisos de requisitos previos para personalizar el cifrado

  9. Seleccione Create job (Crear trabajo).

    La consola vuelve a laTrabajos de traslación, donde el estado de creación del trabajo se muestra en un banner de la parte superior de la página. Después de unos minutos, su trabajo se muestra en la tabla.

  10. Elija el nombre del trabajo deNombrepara abrir la página de detalles del trabajo.

    Mientras se ejecuta su trabajo de traducción, elEstadomuestra campoEn curso.

  11. Cuando el estado se convierteCompleted, vaya a la salida de su traducción eligiendo el enlace enUbicación del archivo de salida. La consola va al depósito de salida en Amazon S3.

  12. Para descargar los archivos de salida, seleccione la casilla de verificación de cada uno de ellos y elijaDescargar.

Para ejecutar un trabajo de traducción mediante elAWS CLI, utilice elstart-text-translation-joby especifique el nombre del recurso de datos parallel para elparallel-data-namesparámetro.

ejemplo Comando Start-text-translation-job

En el ejemplo siguiente se ejecuta un trabajo de traducción enviando un archivo de Excel que se almacena en un depósito de entrada de Amazon S3. Este trabajo se personaliza mediante los datos parallel que se incluyen en la solicitud.

$ aws translate start-text-translation-job \ > --input-data-config ContentType=application/vnd.openxmlformats-officedocument.spreadsheetml.sheet,S3Uri=s3://my-s3-bucket/input/ \ > --output-data-config S3Uri=s3://my-s3-bucket/output/ \ > --data-access-role-arn arn:aws:iam::111122223333:role/my-iam-role \ > --source-language-code=en \ > --target-language-codes=es \ > --job-name my-translation-job

Si el comando se ejecuta correctamente, Amazon Translate responde con el ID de trabajo y el estado:

{ "JobId": "4446f95f20c88a4b347449d3671fbe3d", "JobStatus": "SUBMITTED" }

Si desea personalizar la salida del trabajo de traducción, puede utilizar los siguientes parámetros:

--settings

Configuración para configurar la salida de la traducción, incluida la opción de enmascarar palabras y frases profanas. Para habilitar el enmascaramiento de blasfemias, establezca este parámetro enProfanity=MASK. Para obtener más información, consulte Enmascarar palabras y frases profanas en Amazon Translate.

--terminology-names

Nombre de un recurso terminológico personalizado que se va a agregar al trabajo de traducción. Este recurso enumera ejemplos de términos de origen y la traducción deseada para cada término.

Este parámetro acepta solo un recurso terminológico personalizado.

Para obtener una lista de los recursos terminológicos personalizados disponibles, utilice lalist-terminologiescomando.

Para obtener más información, consulte Personalización de las traducciones con terminología personalizada.

--parallel-data-names

Nombre de un recurso de datos parallel que se va a agregar al trabajo de traducción. Este recurso consta de ejemplos que muestran cómo desea traducir segmentos de texto. Cuando agrega datos parallel a un trabajo de traducción, crea unPersonalización activatrabajo.

Este parámetro acepta solo un recurso de datos parallel.

nota

Los trabajos de traducción personalizada activa tienen un precio superior al de otros trabajos que no utilizan datos parallel. Para obtener más información, consultePrecios de Amazon Translate.

Para obtener una lista de los recursos de datos parallel disponibles, utilice lalist-parallel-datacomando.

Para obtener más información, consulte Personalización de las traducciones con datos paralelos (Traducción personalizada activa).

Para comprobar el estado de su trabajo de traducción, utilice ladescribe-text-translation-jobcomando.

ejemplo comando Describe-text-traducation-job

En el siguiente ejemplo se comprueba el estado del trabajo proporcionando el ID del trabajo. Amazon Translate proporcionó este ID cuando el trabajo fue iniciado por elstart-text-translation-jobcomando.

$ aws translate describe-text-translation-job \ > --job-id 4446f95f20c88a4b347449d3671fbe3d

Amazon Translate responde con las propiedades del trabajo, que incluyen su estado:

{ "TextTranslationJobProperties": { "JobId": "4446f95f20c88a4b347449d3671fbe3d", "JobName": "my-translation-job", "JobStatus": "COMPLETED", "JobDetails": { "TranslatedDocumentsCount": 0, "DocumentsWithErrorsCount": 0, "InputDocumentsCount": 1 }, "SourceLanguageCode": "en", "TargetLanguageCodes": [ "es" ], "SubmittedTime": 1598661012.468, "InputDataConfig": { "S3Uri": "s3://my-s3-bucket/input/", "ContentType": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet" }, "OutputDataConfig": { "S3Uri": "s3://my-s3-bucket/output/111122223333-TranslateText-4446f95f20c88a4b347449d3671fbe3d/" }, "DataAccessRoleArn": "arn:aws:iam::111122223333:role/my-iam-role" } }

Si el archivo deJobStatusel valor esIN_PROGRESS, deja que pasen unos minutos y corredescribe-text-translation-jobde nuevo hasta que el estado seaCOMPLETED. Cuando se complete el trabajo, puede descargar los resultados de traducción en la ubicación proporcionada por elS3Uricampo bajoOutputDataConfig.

Para enviar un trabajo de traducción por lotes mediante la API de Translate de Amazon Translate, utilice laStartTextTranslationJob.