Partager via


Se connecter à votre espace de travail Azure Quantum avec le qdk.azure module Python

Si vous disposez d’un espace de travail Azure Quantum, vous pouvez vous connecter à votre espace de travail et envoyer votre code avec le qdk.azure module Python. Le qdk.azure module fournit une Workspace classe qui représente un espace de travail Azure Quantum.

Prérequis

Pour vous connecter à votre espace de travail avec le qdk.azure module, vous devez disposer des éléments suivants :

  • Compte Azure avec un abonnement actif. Si vous n’avez pas de compte Azure, vous pouvez vous inscrire gratuitement et vous inscrire à un abonnement de paiement à l’utilisation.

  • Un espace de travail Azure Quantum. Si vous n’avez pas d’espace de travail, consultez Créer un espace de travail Azure Quantum.

  • La dernière version de la bibliothèque Python avec le module complémentaire azure.

    pip install --upgrade "qdk[azure]"
    

Si vous utilisez Azure CLI, vous devez disposer de la dernière version. Pour les instructions d’installation, consultez :

Se connecter avec une chaîne de connexion

Vous pouvez utiliser un chaîne de connexion pour spécifier les paramètres de connexion à un espace de travail Azure Quantum. Les chaînes de connexion sont utiles dans les scénarios suivants :

  • Vous souhaitez partager l’accès à votre espace de travail avec d’autres personnes qui n’ont pas de compte Azure.
  • Vous souhaitez partager l’accès à votre espace de travail avec d’autres personnes pendant une durée limitée.
  • Vous ne pouvez pas utiliser l’ID Microsoft Entra en raison de stratégies d’entreprise.

Conseil

Chaque espace de travail Azure Quantum a une clé primaire et une clé secondaire, et chaque clé a sa propre chaîne de connexion. Pour permettre aux autres utilisateurs d’accéder à votre espace de travail, partagez la clé secondaire et utilisez la clé primaire uniquement pour vos propres services. Vous pouvez remplacer la clé secondaire sans provoquer de temps d’arrêt dans vos propres services. Pour plus d’informations sur le partage d’accès à votre espace de travail, consultez Partager l’accès à votre espace de travail.

Copier la chaîne de connexion

  1. Connectez-vous au portail Azure.
  2. Accédez à votre espace de travail Azure Quantum.
  3. Dans le panneau de l’espace de travail, développez la liste déroulante Opérations et choisissez Clés d’accès.
  4. Vous devez activer les clés d’accès pour votre espace de travail. Si le curseur Touches d’accès est défini sur Désactivé, définissez le curseur sur Activé.
  5. Choisissez l’icône Copier pour cette chaîne de connexion que vous souhaitez copier. Vous pouvez choisir la chaîne de connexion primaire ou secondaire.

Avertissement

Il s’agit d’un risque de sécurité pour stocker vos clés d’accès de compte ou les chaînes de connexion en texte clair. Il est recommandé de stocker vos clés de compte dans un format chiffré ou de migrer vos applications pour utiliser l’autorisation Microsoft Entra pour accéder à votre espace de travail Azure Quantum.

Utilisez le chaîne de connexion pour accéder à votre espace de travail Azure Quantum

Vous pouvez utiliser la chaîne de connexion que vous venez de copier pour vous connecter à votre espace de travail Azure Quantum avec le qdk.azure module ou visual Studio Code (VS Code).

Créez un Workspace objet pour vous connecter à votre espace de travail Azure Quantum. Il existe deux options pour identifier votre espace de travail Azure Quantum lorsque vous créez un Workspace objet.

  • Appelez la from_connection_string fonction lorsque vous créez un Workspace objet.

    # Create a new Workspace object from a connection string 
    from qdk.azure import Workspace 
    
    connection_string = "[Copy connection string]" 
    workspace = Workspace.from_connection_string(connection_string) 
    
    print(workspace.get_targets()) 
    
  • Si vous ne souhaitez pas copier votre chaîne de connexion dans votre code, stockez votre chaîne de connexion dans une variable d’environnement et utilisez Workspace().

    # Use an environment variable to connect with your connection string
    
    connection_string = "[Copy connection string]" 
    
    import os 
    
    os.environ["AZURE_QUANTUM_CONNECTION_STRING"] = connection_string 
    
    from qdk.azure import Workspace 
    
    workspace = Workspace() 
    print(workspace.get_targets()) 
    

Pour plus d’informations sur l’activation, la désactivation et la régénération de vos clés, consultez Gérer vos clés d’accès.

Important

Si vous désactivez les clés d’accès pour votre espace de travail, vous ne pouvez pas utiliser de chaînes de connexion pour vous connecter à votre espace de travail. Toutefois, vous pouvez toujours utiliser des paramètres d’espace de travail pour vous connecter à votre espace de travail.

Se connecter à votre espace de travail avec des paramètres d’espace de travail

Chaque espace de travail Azure Quantum a un ensemble unique de paramètres que vous pouvez utiliser pour vous connecter à l’espace de travail. Vous pouvez utiliser les paramètres suivants pour vous connecter à votre espace de travail Azure :

Paramètre Description
subscription_id ID de l’abonnement Azure.
resource_group Le nom du groupe de ressources Azure.
name Nom de votre espace de travail Azure Quantum.
location Région Azure dans laquelle se trouve votre espace de travail.
resource_id ID de ressource Azure de l’espace de travail Azure Quantum.

Pour rechercher les paramètres de votre espace de travail, procédez comme suit :

  1. Connectez-vous au portail Azure.
  2. Accédez à votre espace de travail Azure Quantum.
  3. Dans le panneau de votre espace de travail, choisissez Vue d’ensemble.
  4. Développez la liste déroulante Essentials .
  5. Copiez les paramètres dans leurs champs correspondants.

Note

Veillez à vous connecter au locataire approprié avant de vous connecter à votre espace de travail.

Utiliser des paramètres d’espace de travail pour vous connecter à votre espace de travail Azure Quantum

Vous pouvez utiliser les paramètres de votre espace de travail pour vous connecter à votre espace de travail Azure Quantum avec le qdk.azure module ou Avec Azure CLI.

Créez un Workspace objet pour vous connecter à votre espace de travail Azure Quantum. Il existe deux options pour identifier votre espace de travail Azure Quantum lorsque vous créez un Workspace objet.

  • Spécifiez l’ID de ressource (recommandé) :

    from qdk.azure import Workspace 
    
    workspace = Workspace(  
        resource_id = "", # Add the resource ID of your workspace
        location = "" # Add the location of your workspace
        )
    
  • Spécifiez l’ID d’abonnement, le groupe de ressources et le nom de l’espace de travail et l’emplacement :

    from qdk.azure import Workspace 
    
    workspace = Workspace(  
        subscription_id = "", # Add the subscription ID of your workspace
        resource_group = "", # Add the resource group of your workspace
        workspace_name = "" # Add the name of your workspace
        location = "" # Add the location of your workspace
        )