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 :
-
Connectez-vous à la AWS Management Console
. -
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.
-
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.
-
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.
-
Sélectionnez Créer une tâche pour exécuter votre tâche de transcription.
Cet exemple utilise la start-transcription-jobjob-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-namemy-first-transcription-job
\ --media MediaFileUri=s3://amzn-s3-demo-bucket
/my-input-files
/my-media-file
.flac
\ --output-bucket-nameamzn-s3-demo-bucket
\ --output-keymy-output-files
/ \ --language-codeen-US
\ --job-execution-settings AllowDeferredExecution=true,DataAccessRoleArn=arn:aws:iam::111122223333
:role/ExampleRole
Voici un autre exemple d'utilisation de la start-transcription-job
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'AllowDeferredExecution
argument de la méthode start_transcription_jobAllowDeferredExecution
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 GetTranscriptionJob
demande. 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é.