Résolution des problèmes dans Azure Quantum

Lorsque vous travaillez avec le service Azure Quantum, vous pouvez rencontrer des problèmes de connexion ou de travail. Cet article explique comment résoudre ces problèmes.

Problèmes de connexion à l’espace de travail

Problème : je ne peux pas m'authentifier auprès de Azure Quantum avec pytket-azure

Lorsque vous essayez de vous authentifier auprès de Azure Quantum avec le package pytket-azure dans un environnement CI à l’aide des variables d’environnement "AZURE_TENANT_ID", "AZURE_CLIENT_ID" et "AZURE_CLIENT_SECRET", vous pouvez rencontrer l’erreur suivante :

Code: InsufficientPermissions
Message: There are not enough permissions to perform this operation.

Pour résoudre ce problème, utilisez une chaîne de connexion et la variable d’environnement "AZURE_QUANTUM_CONNECTION_STRING" pour vous authentifier à la place. Pour plus d’informations, consultez Connexion avec une chaîne de connexion.

connection_string = "" # Add your connection string

import os 

os.environ["AZURE_QUANTUM_CONNECTION_STRING"] = connection_string 

Problèmes de soumission de travaux

Problème : je ne trouve pas ce target que je veux soumettre mon travail à

Si le Azure Quantum target sur lequel vous souhaitez exécuter votre travail n'est pas dans la liste target disponible, effectuez une mise à jour vers la dernière version du Quantum Development Kit (QDK) pour Visual Studio Code (VS Code). Pour plus d’informations, consultez Mettre à jour le QDK.

Problème : l’opération renvoie un code d’état non valide « non autorisé »

Pour résoudre ce problème, procédez comme suit :

1. Connectez-vous au portail Azure et authentifiez votre compte.
2. Accédez à l’espace de travail Quantum auquel vous essayez d’envoyer un travail.
3. Dans le volet de navigation de l’espace de travail, sélectionnez Contrôle d’accès (IAM) .
4. Sélectionnez le bouton Afficher mon accès . Le volet affectations s’ouvre.
5. Dans la colonne Rôle de la table Attributions de rôles, vérifiez si vous avez le rôle Propriétaire ou Contributeur .
6. Si vous n’avez pas de rôle, demandez à votre administrateur d’abonnement de vous attribuer le rôle Propriétaire ou Contributeur pour cet espace de travail.

Problème : « AuthorizationFailure - Cette demande n’est pas autorisée à effectuer cette opération »

Si vous recevez ce message même si vous disposez d’une connexion valide au service Azure Quantum, le compte de stockage peut être configuré pour bloquer l’accès au réseau public. Le service Azure Quantum prend uniquement en charge les comptes de stockage disposant d’un accès Internet public.

Pour vérifier les paramètres du compte de stockage, procédez comme suit :

1. Connectez-vous au portail Azure.
2. Accédez à votre espace de travail Quantum.
3. Dans la page Vue d’ensemble , sélectionnez le compte de stockage.
4. Dans le volet de navigation, développez la liste déroulante Sécurité + mise en réseau , puis sélectionnez Mise en réseau.
5. Dans la section Accès réseau public de l’onglet Accès public , sélectionnez le bouton Gérer .
6. Pour le paramètre d’accès au réseau public , sélectionnez Activer. Pour le paramètre d’étendue d’accès au réseau public , sélectionnez Activer à partir de tous les réseaux.
7. Sélectionnez le bouton Enregistrer.

Problème : « Échec de la compilation du programme » lorsque vous envoyez un programme Q# à partir de Azure CLI

Lorsque vous envoyez un travail avec la commande az quantum submit Azure CLI, vous pouvez rencontrer le message d’erreur suivant :

az quantum job submit ...
Failed to compile program.
Command ran in 21.181 seconds (init: 0.457, invoke: 20.724)

Cette erreur se produit lorsqu’il existe un problème avec le programme Q# qui provoque l’échec de la compilation. Assurez-vous que votre code Q# a une syntaxe appropriée.

Problème : Erreur du compilateur « Nombre incorrect de paramètres de porte »

Lorsque vous envoyez un travail à Quantinuum à partir d'un environnement local Jupyter Notebook ou CLI, et que vous utilisez le traducteur QASM hérité (OPENQASM 2.0), vous pouvez rencontrer cette erreur :

Job ID <jobId> failed or was cancelled with the message: 1000: Compile error: [<file, line>] Wrong number of gate parameters

Cette erreur se produit lorsqu’une virgule « » ou un autre caractère non pointé est utilisé comme séparateur décimal. Remplacez tous les séparateurs décimaux autres que des points par des points « . ». Par exemple:

// replace this line:
rx(1,5707963267948966) q[0];

// with this:
rx(1.5707963267948966) q[0];

Problème : Erreur du compilateur « non disponible pour la configuration de compilation actuelle »

Lorsque vous exécutez une cellule de code Q# dans un Jupyter Notebook dans VS Code, vous pouvez rencontrer l’erreur :

<function name> not found. Found a matching item `<function name>' that is not available for the current compilation configuration

Cette erreur indique que vous définissez le profil QIR (représentation intermédiaire quantique) target sur Base lorsque la fonction requiert le profil Illimitétarget . Si vous ne spécifiez pas de target type de profil, le compilateur définit automatiquement la target valeur Non restreint.

Problème : l’opération a retourné un code d’état non valide : « Interdit ».

Lorsque vous envoyez votre premier travail, vous pouvez obtenir un code d’erreur 'forbidden' .

Ce problème se produit lorsque vous créez un espace de travail dans le portail Azure et que Azure Quantum ne parvient pas à terminer l’attribution de rôle qui lie l’espace de travail au compte de stockage spécifié. Cela peut se produire lorsque vous fermez l’onglet ou le navigateur web avant la création de l’espace de travail.

Pour vérifier que vous rencontrez ce problème d’attribution de rôle, procédez comme suit :

1. Accédez à votre espace de travail Quantum dans le portail Azure.
2. Dans la page Vue d’ensemble , sélectionnez le compte de stockage.
3. Dans le volet de navigation, sélectionnez Access Control (IAM).
4. Choisissez l’onglet Attributions de rôles .
5. Dans la colonne Rôle , vérifiez si le compte de stockage de votre espace de travail a le rôle Contributeur de compte de stockage et le rôle Contributeur aux données Blob de stockage .

Si l’espace de travail n’a pas ces deux rôles sur le compte de stockage, effectuez l’une des opérations suivantes :

• Créez un espace de travail et assurez-vous que la création de l’espace de travail se termine avant de fermer la fenêtre ou l’onglet du navigateur web.
• Attribuez les rôles Contributeur de compte de stockage et Contributeur aux données Blob de stockage à votre espace de travail sur le compte de stockage.

Problème : Échec du travail avec le code d’erreur : QIRPreProcessingFailed

Lorsque vous envoyez un travail à un Rigetti target et que le travail échoue, vous pouvez voir le message d’erreur suivant dans la gestion des tâches console de votre espace de travail Quantum dans le portail Azure :

Error code: QIRPreProcessingFailed
Error message: No match found for output recording set converter from outputrecordingset.v2.labeled to outputrecordingset.v1.nonlabeled

Cette erreur peut être due à un conflit de dépendances avec une version antérieure de pyqir ou qiskit-qir. Désinstallez toutes les versions de pyqir, pyqir-* et qiskit-qir sur votre ordinateur local, puis installez ou mettez à jour la bibliothèque qdk Python avec les azure et qiskit extras :

pip install --upgrade "qdk[azure,qiskit]"

Problème : récupération d’informations de base sur les travaux ayant échoué

Lorsque vous soumettez un travail à un périphérique target, votre travail peut rester dans la file d'attente pendant plusieurs heures ou jours avant d'échouer.

Pour récupérer plus d’informations sur l’échec du travail, effectuez l’une des opérations suivantes :

• Pour afficher la sortie du travail ou le message d’erreur, utilisez la méthode get_results() à partir du module qdk.azure Python :

  job.get_results()
  

• Dans votre espace de travail Quantum dans le portail Azure, allez au volet Gestion des tâches à partir de la liste déroulante Opérations, puis choisissez le nom de tâche Nom pour ouvrir le volet Détails de la tâche.

• Dans votre espace de travail Quantum dans le portail Azure, accédez au volet Providers dans le volet Operations. Vérifiez que le target matériel est disponible. Si l’état target est détérioré, les tâches peuvent rester dans la file d’attente plus longtemps qu’habituellement. Parfois, les travaux sont traités, mais parfois ils expirent et renvoient une erreur de target indisponible.

Problème : Azure Quantum m’invite à m’authentifier lorsque je me connecte par programmation à mon espace de travail

Si vous utilisez le Kit de développement logiciel (SDK) Azure Quantum Python et que vous vous connectez à votre espace de travail à l'aide de la classe AzureQuantumProvider, vous pouvez rencontrer une fenêtre contextuelle pour vous authentifier auprès de Azure chaque fois que vous exécutez votre script.

Cette fenêtre contextuelle se produit, car votre jeton de sécurité est réinitialisé chaque fois que vous exécutez le script.

Pour résoudre ce problème, exécutez az login à partir du Azure CLI. Pour plus d’informations, consultez az login.

problèmes d’estimateur de ressources quantum Microsoft

Les problèmes suivants peuvent entraîner l’échec des travaux d’estimation des ressources.

Problème : l’algorithme quantique doit contenir au moins un état T ou une mesure

Pour tenir compte du mappage d’un programme quantique quelconque à un tableau 2D de qubits logiques, l’estimateur de ressources suppose que la synthèse parallèle et le calcul séquentiel Pauli (PSSPC) sont effectués sur le programme d’entrée. Dans cette approche, toutes les opérations Clifford sont commutées à travers toutes les portes T, portes de rotation et opérations de mesure, laissant une seule opération Clifford qui peut être évaluée de manière classique et efficace. Par conséquent, un programme quantique qui ne contient pas d’états T, par exemple à partir de portes T ou de portes de rotation, ou les opérations de mesure ne nécessitent aucune ressource de calcul quantique physique. Pour plus d’informations sur le calcul séquentiel pauli de synthèse parallèle, consultez arXiv :2211.07629, annexe D.

Error message: Algorithm requires at least one T state or measurement to estimate resources

Problème : le taux d’erreur des portes T physiques est trop élevé

Le taux d’erreur d’état T logique dépend du budget d’erreur et du nombre d’états T dans le programme quantique. Les fabriques T sont utilisées pour créer des états T avec le taux d’erreur d’état T logique requis à partir de portes T physiques, qui ont un taux d’erreur de porte T physique. En règle générale, le taux d’erreur de porte T physique est plus élevé que le taux d’erreur de porte T logique requis. Dans certains scénarios, le taux d’erreur de porte T physique est considérablement plus élevé par rapport au taux d’erreur d’état T logique requis, de sorte qu’aucune fabrique T ne peut être trouvée qui peut produire des états T logiques de qualité suffisante.

Error message: No T factory can be found, because the required logical T state error rate is too low

Pour résoudre ce problème, effectuez l’une des opérations suivantes :

• Augmentez le budget d’erreur, soit le total, soit la partie pour les états T.
• Réduisez le taux d’erreur des portes T physiques dans les paramètres qubit.
• Réduisez le nombre d’états T dans le programme quantique en réduisant les portes T, les portes de rotation et les portes Toffoli.

Problème : le taux d’erreur des portes T physiques est trop faible

Lorsque le taux d’erreur de la porte T physique est inférieur au taux d’erreur d’état T logique requis, vous n’avez pas besoin d’une fabrique T, car le taux d’erreur de la porte T physique est suffisant. Toutefois, vous devez toujours tenir compte de l’impact des unités de transfert qui transfèrent les états T physiques de la distance de code 1 à la distance de code de l’algorithme (voir arXiv :2211.07629, Annexe C). En général, en présence d’usines T, le coût des unités de transfert est négligeable.

Error message: No T factory can be found, because the required logical T state error rate is too high; transfer units are necessary to perform a resource estimation accurately. One possibility to circumvent this problem is to increase the physical T gate error rate of the qubit parameters.

Pour résoudre ce problème, effectuez l’une des opérations suivantes :

• Le taux d’erreur des portes T physiques dans les paramètres de qubit doit être augmenté pour atteindre le taux d’erreur requis de l’état T logique.
• Réduisez le budget d'erreur ou simplement la partie consacrée aux états T.

Problème : le taux d’erreur doit être un nombre compris entre 0 et 1

Les taux d’erreur ne peuvent avoir qu’une valeur comprise entre 0 et 1. Pour que la correction des erreurs soit effective, le taux d’erreur physique pour les portes et les mesures doit être inférieur à une valeur qui dépend des propriétés du code de correction d’erreur et du taux d’erreur logique requis.

Pour résoudre ce problème, effectuez l’une des opérations suivantes :

• Augmentez le budget d’erreur, soit le total, soit la partie pour les erreurs logiques.
• Réduisez les taux d’erreur physiques dans les paramètres qubit.

Problème : le temps d’exécution maximal des contraintes et le nombre maximal de qubits physiques sont mutuellement exclusifs

L’estimateur de ressources n’accepte qu’une ou plusieurs maxDurationmaxPhysicalQubits contraintes. Si vous fournissez à la fois des contraintes maxDuration et maxPhysicalQubits pour un seul travail, le travail retourne l’erreur BothDurationAndPhysicalQubitsProvided.

Problème : exécuter le conteneur d’estimation QIR : symbole non défini __quantum__rt__result_record_output

Vous obtenez cette erreur lorsque vous générez QIR pour les circuits Qiskit avec le package qiskit_qir Python et que vous ne définissez pas le paramètre record_output sur False.

Pour éviter cette erreur, effectuez l’une des opérations suivantes :

• Utilisez le module qdk.azure Python pour envoyer des circuits Qiskit à Azure Quantum (recommandé).
• Lorsque vous utilisez le package qiskit_qir Python, définissez le paramètre record_output sur False avant de soumettre votre circuit.

problèmes de création d’espace de travail Azure Quantum

Vous pouvez rencontrer les problèmes suivants lorsque vous créez un espace de travail Quantum dans le portail Azure.

Problème : vous ne pouvez pas accéder au formulaire de création de l'espace de travail dans le portail Azure et vous êtes invité à vous inscrire à un abonnement à la place

Ce problème se produit parce que vous n'avez pas d'abonnement actif Azure.

Lorsque vous vous inscrivez à une version d'essai gratuite de 30 jours pour un abonnement Azure, vous bénéficiez de crédits Azure gratuits. Après avoir utilisé tous vos crédits gratuits, ou 30 jours après l’inscription, vous devez effectuer une mise à niveau vers un abonnement pay-as-you-go pour continuer à utiliser les services Azure Quantum. Lorsque vous disposez d’un abonnement actif, le portail Azure vous permet d’accéder au formulaire de création de l’espace de travail.

Pour afficher la liste de vos abonnements et rôles associés, consultez Vérifier vos abonnements.

Problème : l’option Création rapide n’est pas disponible

Vous devez être propriétaire d’un abonnement pour utiliser l’option Création rapide . Pour afficher la liste de vos abonnements et rôles associés, consultez Vérifier vos abonnements. Si vous êtes contributeur d’abonnement, vous pouvez utiliser l’option De création avancée pour créer un espace de travail.

Problème : vous ne pouvez pas créer ou sélectionner un groupe de ressources ou un compte de stockage

Ce problème se produit, car vous n’avez pas l’autorisation requise au niveau de l’abonnement, du groupe de ressources ou du compte de stockage. Pour plus d’informations sur les niveaux d’accès requis, consultez Les exigences de rôle pour la création d’un espace de travail.

Problème : un message d’erreur « Échec de la validation du déploiement » s’affiche lorsque vous choisissez Créer

Ce message d’erreur peut inclure plus de détails, tels que « Le client n’a pas l’autorisation d’effectuer une action ».

Ce problème se produit, car vous n’avez pas l’autorisation requise au niveau de l’abonnement, du groupe de ressources ou du compte de stockage. Pour plus d’informations sur les niveaux d’accès requis, consultez Les exigences de rôle pour la création d’un espace de travail.

Si on vous a récemment accordé l’accès, vous devrez peut-être actualiser la page. Les nouvelles attributions de rôles peuvent prendre jusqu’à une heure pour prendre effet sur les autorisations mises en cache sur la pile.

Problème : vous ne voyez pas de fournisseur de matériel quantique spécifique sous l’onglet Fournisseurs

Ce problème se produit parce que le fournisseur ne prend pas en charge la région de facturation dans laquelle votre abonnement est défini. Pour obtenir la liste des fournisseurs et leur disponibilité par pays/région, consultez Disponibilité globale des fournisseurs Azure Quantum.

Problème : la création ou la suppression de fournisseurs d’espace de travail échoue avec « ResourceDeploymentFailure » ou « ProviderDeploymentFailure »

Ce problème peut inclure plus de détails tels que « ResourceDeploymentFailure - L'opération de ressource 'AzureAsyncOperationWaiting' s'est terminée avec l'état de fourniture terminal 'Failed' », ou « ProviderDeploymentFailure - Échec de la création du plan pour le fournisseur : <Name of the provider> ».

Cette défaillance se produit parce que le locataire n'a pas activé Place de marché Azure achats. Suivez les étapes décrites dans Activer les achats Place de marché Azure pour activer les achats Place de marché Azure.

Problème : le déploiement d’un espace de travail quantique ou d’un compte de stockage échoue

Lorsque vous essayez de déployer un espace de travail Quantum ou un compte de stockage, vous pouvez obtenir l’une des erreurs suivantes :

• Espace de travail : « L’opération d’écriture de ressource ne s’est pas exécutée correctement, car elle a atteint l’état d’approvisionnement du terminal « Échec ». »
• Compte de stockage : « Échec du déploiement du modèle en raison d’une violation de stratégie ».

Ce problème peut se produire si votre stratégie de sécurité d’abonnement bloque la création de comptes de stockage dont l’accès public est activé. Le service Azure Quantum prend uniquement en charge les comptes de stockage disposant d’un accès Internet public.

Pour résoudre ce problème, collaborez avec votre administrateur d’abonnement pour obtenir une exception pour le compte de stockage que vous souhaitez utiliser.