Mise en file d’attente des tâches - Amazon Transcribe

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Mise en file d’attente des tâches

Utilisez la mise en file d’attente des tâches pour soumettre plus de demandes de tâches de transcription qu’il n’est possible d’en traiter simultanément. Sans mise en file d’attente des tâches, une fois que vous avez atteint le quota de demandes simultanées autorisées, vous devez attendre qu’une ou plusieurs demandes soient terminées pour soumettre une nouvelle demande.

La mise en file d’attente des tâches est facultative pour les demandes de tâches de transcription. La mise en file d’attente des tâches est automatiquement activée pour les demandes d’analyse après appel.

Si vous activez la mise en file d'attente des tâches, Amazon Transcribe crée une file d'attente contenant toutes les demandes dépassant votre limite. Dès qu’une demande est terminée, une nouvelle demande est extraite de votre file d’attente et traitée. Les demandes mises en file d’attente sont traitées selon l’ordre FIFO (premier entré, premier sorti).

Vous pouvez ajouter jusqu’à 10 000 tâches à votre file d’attente. Si vous dépassez cette limite, vous recevez un message d’erreur LimitExceededConcurrentJobException. Pour maintenir des performances optimales, Amazon Transcribe n'utilise que 90 % de votre quota (un ratio de bande passante de 0,9) pour traiter les tâches en file d'attente. Notez qu’il s’agit de valeurs par défaut qui peuvent être augmentées à la demande.

Astuce

Vous trouverez une liste des limites et quotas par défaut pour les Amazon Transcribe ressources dans le manuel de référence AWS général. Certains de ces paramètres par défaut peuvent être augmentés à la demande.

Si vous activez la mise en file d’attente des tâches mais que vous ne dépassez pas le quota de demandes simultanées, toutes les demandes sont traitées simultanément.

Activation de la mise en file d’attente des tâches

Vous pouvez activer la mise en file d'attente des tâches à l'aide de AWS Management ConsoleAWS CLI, ou AWS SDKs; consultez les exemples suivants ; consultez les exemples suivants :

  1. Connectez-vous à la AWS Management Console.

  2. Dans le volet de navigation, choisissez Tâches de transcription, puis sélectionnez Créer une tâche (en haut à droite). La page Spécifier les détails de la tâche s’ouvre.

  3. La zone Paramètres de la tâche contient un volet paramètres supplémentaires. Si vous développez ce volet, vous pouvez sélectionner la case Ajouter à la file d’attente des tâches pour activer la mise en file d’attente des tâches.

    Amazon Transcribe capture d'écran de la console : la page « Spécifier les détails de la tâche ».
  4. Renseignez les autres champs que vous souhaitez inclure sur la page Spécifier les détails de la tâche, puis sélectionnez Suivant. Vous accédez alors à la page Configurer la tâche - facultatif.

  5. Sélectionnez Créer une tâche pour exécuter votre tâche de transcription.

Cet exemple utilise la start-transcription-jobcommande et le job-execution-settings paramètre avec le AllowDeferredExecution sous-paramètre. Notez que si vous incluez AllowDeferredExecution dans votre demande, vous devez également inclure DataAccessRoleArn.

Pour plus d’informations, consultez StartTranscriptionJob et JobExecutionSettings.

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

Voici un autre exemple d'utilisation de la start-transcription-jobcommande et d'un corps de requête qui permet la mise en file d'attente.

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

Le fichier my-first-queueing-request.json contient le corps de requête suivant.

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

Cet exemple utilise le AWS SDK for Python (Boto3) pour activer la mise en file d'attente des tâches à l'aide de l'AllowDeferredExecutionargument de la méthode start_transcription_job. Notez que si vous incluez AllowDeferredExecution dans votre demande, vous devez également inclure DataAccessRoleArn. Pour plus d’informations, consultez StartTranscriptionJob et JobExecutionSettings.

Pour des exemples supplémentaires utilisant le AWS SDKs, notamment des exemples spécifiques aux fonctionnalités, des scénarios et des exemples multiservices, reportez-vous au chapitre. Exemples de code pour Amazon Transcribe à l'aide de AWS SDKs

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://amzn-s3-demo-bucket/my-input-files/my-media-file.flac" transcribe.start_transcription_job( TranscriptionJobName = job_name, Media = { 'MediaFileUri': job_uri }, OutputBucketName = 'amzn-s3-demo-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)

Vous pouvez consulter la progression d'une tâche en file d'attente via AWS Management Console ou en soumettant une GetTranscriptionJobdemande. Lorsqu’une tâche est mise en file d’attente, son Status est QUEUED. Le statut passe à IN_PROGRESS lorsque le traitement de votre tâche commence, puis à COMPLETED ou FAILED lorsque le traitement est terminé.