Colocación de Job en cola

Con la cola de trabajos, puede enviar más solicitudes de trabajo de transcripción de las que se pueden procesar simultáneamente. Sin colas de trabajo, una vez que alcance la cuota de solicitudes simultáneas permitidas, debe esperar a que se completen una o más solicitudes antes de enviar una nueva solicitud.

La espera de trabajos es opcional para las solicitudes de Job de transcripción. Las solicitudes de análisis posteriores a la llamada tienen habilitada automáticamente la cola de trabajos.

Si habilita la cola de trabajos,Amazon Transcribe crea una cola que contiene todas las solicitudes que superen su límite. Tan pronto como se complete una solicitud, se extraerá una nueva solicitud de la cola y se procesará. Las solicitudes en cola se procesan en orden FIFO (primero en entrar, primero en salir).

Puede tener hasta 10 000 trabajos en Cola. Si superas este límite, aparecerá unLimitExceededConcurrentJobException error. Para mantener un rendimiento óptimo,Amazon Transcribe solo utiliza hasta el 90 por ciento de su cuota (una relación de ancho de banda de 0,9) para procesar los trabajos en cola. Tenga en cuenta que estos son valores predeterminados que se pueden aumentar previa solicitud.

sugerencia

Puede encontrar una lista de límites y cuotas predeterminados paraAmazon Transcribe los recursos en la ReferenciaAWS general. Algunos de estos valores predeterminados se pueden aumentar previa solicitud.

Si habilitas la cola de trabajos pero no superas la cuota de solicitudes simultáneas, todas las solicitudes se procesarán simultáneamente.

Habilitación de Cola de trabajos

Puede habilitar la cola de trabajos mediante los AWSSDK AWS Management ConsoleAWS CLI, o; consulte los siguientes ejemplos; consulte los siguientes para ver ejemplos:

AWS Management Console

1. Inicie sesión en AWS Management Console.

2. En el panel de navegación, selecciona Trabajos de transcripción y, a continuación, selecciona Crear trabajo (arriba a la derecha). Se abre la página Especificar detalles del trabajo.

3. En el cuadro Configuración del Job, hay un panel de ajustes adicionales. Si expande este panel, puede seleccionar la casilla Agregar a la cola de trabajos para habilitar la cola de trabajos.

   

4. Rellene cualquier otro campo que desee incluir en la página Especificar detalles del trabajo y, a continuación, seleccione Siguiente. Esto le llevará a la página Configurar trabajo: opcional.

5. Selecciona Crear trabajo para ejecutar tu trabajo de transcripción.

AWS CLI

En este ejemplo se utilizan el start-transcription-jobcomando y eljob-execution-settings parámetro junto con elAllowDeferredExecution subparámetro. Tenga en cuenta que cuando incluyaAllowDeferredExecution en su solicitud, también debe incluirloDataAccessRoleArn.

Para obtener más información, consulte StartTranscriptionJob y JobExecutionSettings.

aws transcribe start-transcription-job \
--region us-west-2 \
--transcription-job-name my-first-transcription-job \
--media MediaFileUri=s3://DOC-EXAMPLE-BUCKET/my-input-files/my-media-file.flac \
--output-bucket-name DOC-EXAMPLE-BUCKET \
--output-key my-output-files/ \
--language-code en-US \
--job-execution-settings AllowDeferredExecution=true,DataAccessRoleArn=arn:aws:iam::111122223333:role/ExampleRole

Este es otro ejemplo de uso del start-transcription-jobcomando y un cuerpo de solicitud que permite hacer cola.

aws transcribe start-transcription-job \
--region us-west-2 \
--cli-input-json file://my-first-queueing-request.json

El archivo my-first-queueing-request.json contiene el siguiente cuerpo de solicitud.

{
  "TranscriptionJobName": "my-first-transcription-job",
  "Media": {
        "MediaFileUri": "s3://DOC-EXAMPLE-BUCKET/my-input-files/my-media-file.flac"
  },
  "OutputBucketName": "DOC-EXAMPLE-BUCKET",
  "OutputKey": "my-output-files/", 
  "LanguageCode": "en-US",
  "JobExecutionSettings": {
        "AllowDeferredExecution": true,
        "DataAccessRoleArn": "arn:aws:iam::111122223333:role/ExampleRole"
  }
}

AWS SDK for Python (Boto3)

En este ejemplo se utiliza elAWS SDK for Python (Boto3) para habilitar la cola de trabajos mediante elAllowDeferredExecution argumento del método start_transcription_job. Tenga en cuenta que cuando incluyaAllowDeferredExecution en su solicitud, también debe incluirloDataAccessRoleArn. Para obtener más información, consulte StartTranscriptionJob y JobExecutionSettings.

Para ver más ejemplos de uso deAWS los SDK, incluidos ejemplos de funciones específicas, escenarios y multiservicios, consulte elEjemplos de código para Amazon Transcribe mediante SDK AWS capítulo.

from __future__ import print_function
import time
import boto3
transcribe = boto3.client('transcribe', 'us-west-2')
job_name = "my-first-queueing-request"
job_uri = "s3://DOC-EXAMPLE-BUCKET/my-input-files/my-media-file.flac"
transcribe.start_transcription_job(
    TranscriptionJobName = job_name,
    Media = {
        'MediaFileUri': job_uri
    },
    OutputBucketName = 'DOC-EXAMPLE-BUCKET',
    OutputKey = 'my-output-files/', 
    LanguageCode = 'en-US', 
    JobExecutionSettings = {
        'AllowDeferredExecution': True,
        'DataAccessRoleArn': 'arn:aws:iam::111122223333:role/ExampleRole'
   }
)

while True:
    status = transcribe.get_transcription_job(TranscriptionJobName = job_name)
    if status['TranscriptionJob']['TranscriptionJobStatus'] in ['COMPLETED', 'FAILED']:
        break
    print("Not ready yet...")
    time.sleep(5)
print(status)

Puede ver el progreso de un trabajo en cola a través deAWS Management Console o enviando una GetTranscriptionJobsolicitud. Cuando un trabajo está en cola, elStatus esQUEUED. El estado cambia aIN_PROGRESS una vez que el trabajo comienza a procesarse y, a continuación, cambia aCOMPLETED oFAILED cuando finaliza el procesamiento.