Utiliser des travaux Quantum Azure

Lorsque vous exécutez un programme quantique dans Azure Quantum, vous créez et exécutez un travail. Les étapes de création et d’exécution d’un travail dépendent du type de travail et du fournisseur que target vous configurez pour l’espace de travail.

Propriétés du travail

Toutes les tâches ont en commun les propriétés suivantes :

Propriété	Description
Identifiant	Identificateur unique du travail. Il doit être unique dans l’espace de travail.
Fournisseur	Qui devra exécuter votre tâche.
Cible	Sur quoi souhaitez-vous exécuter votre tâche. Par exemple, le matériel quantique lui-même ou le simulateur Quantum proposé par le fournisseur.
Nom	Nom défini par l’utilisateur pour vous aider à organiser vos tâches.
Paramètres	Paramètres d’entrée facultatifs pour targets. Consultez la documentation de l’élément sélectionné target pour obtenir une définition des paramètres disponibles.

Une fois que vous avez créé un travail, diverses métadonnées sont disponibles sur son état et son historique des exécutions.

Cycle de vie de tâche

Une fois que vous avez écrit votre programme quantique, vous pouvez sélectionner un target et envoyer votre travail.

Ce diagramme illustre le workflow de base après l’envoi de votre travail :

Tout d’abord, Azure Quantum charge le travail dans le compte de stockage Azure que vous avez configuré dans l’espace de travail. Ensuite, le travail est ajouté à la file d’attente des travaux pour le fournisseur que vous avez spécifié dans le travail. Azure Quantum télécharge ensuite votre programme et le traduit pour le fournisseur. Le fournisseur traite le travail et retourne la sortie au stockage Azure, où il devient disponible au téléchargement.

Analyse des tâches

Une fois que vous avez soumis un travail, vous devez interroger son état. Les états possibles des travaux sont les suivants :

État	Description
en attente	Le travail est en attente d’exécution. Certains travaux effectuent des tâches de prétraitement lorsqu’ils sont en attente. waiting est toujours le premier état. Toutefois, un travail peut passer à l’état executing avant que vous ne puissiez l’observer dans l’état waiting.
en cours d’exécution	le target est en cours d’exécution du travail.
succeeded	Le travail a abouti et la sortie est disponible. Il s’agit d’un état final.
échec	Le travail a échoué et des informations d’erreur sont disponibles. Il s’agit d’un état final.
annulé	L’utilisateur a demandé l’annulation de l’exécution du travail. Il s’agit d’un état final. Pour plus d’informations, consultez Annulation des travaux dans cet article.

Les états succeeded, failed et cancelled sont considérés comme des états finaux. Une fois qu’un travail est dans l’un de ces états, aucune autre mise à jour ne se produit et les données de sortie du travail correspondant ne changent pas.

Ce diagramme illustre les transitions d’état de travail possibles :

Une fois qu’un travail est correctement terminé, il présente un lien vers les données de sortie dans votre compte de stockage Azure. La façon dont vous accédez à ces données dépend du SDK ou de l’outil que vous avez utilisé pour soumettre le travail.

Nombre de travaux

Pour obtenir les nombres résultant d’un grand nombre de travaux, vous pouvez effectuer une installation locale des Quantum Development Kit outils. Avec une installation locale, vous pouvez stocker les ID de travail localement.

Vous pouvez copier le code suivant pour obtenir la liste des travaux et leurs résultats :

for job in workspace.list_jobs():
    print(job.id, job.details.name, job.details.output_data_uri)

Annulation des travaux

Quand un travail n’est pas encore dans un état final (par exemple, succeeded, failed ou cancelled), vous pouvez demander son annulation. Tous les fournisseurs annulent votre travail si son état est waiting. En revanche, tous les fournisseurs ne prennent pas en charge l’annulation si votre travail est dans l’état executing.

Notes

Si vous annulez un travail alors que son exécution a commencé, votre compte risque d’être quand même facturé partiellement ou intégralement pour ce travail. Consultez la documentation sur la facturation du fournisseur que vous avez sélectionné.