Herstellen einer Verbindung mit Ihrem Azure Quantum-Arbeitsbereich mit QDK oder Azure CLI

Wenn Sie über einen Azure Quantum Arbeitsbereich verfügen, können Sie eine Verbindung mit Ihrem Arbeitsbereich herstellen und ihren Code mit dem qdk.azure Python Modul übermitteln. Das qdk.azure Modul stellt eine Workspace Klasse bereit, die einen Azure Quantum-Arbeitsbereich darstellt.

Voraussetzungen

Um eine Verbindung mit Ihrem Arbeitsbereich mit dem qdk.azure Modul herzustellen, benötigen Sie Folgendes:

Verbinden mit einer Verbindungszeichenfolge

Verwenden Sie eine Verbindungszeichenfolge, um die Verbindungsparameter für einen Azure Quantum Arbeitsbereich anzugeben. Verbindungszeichenfolgen sind in den folgenden Szenarien nützlich:

  • Sie möchten den Zugriff auf Ihren Arbeitsbereich für andere Personen freigeben, die nicht über ein Azure-Konto verfügen.
  • Sie möchten den Zugriff auf Ihren Arbeitsbereich für andere Personen für einen begrenzten Zeitraum freigeben.
  • Sie können microsoft Entra ID aufgrund von Unternehmensrichtlinien nicht verwenden.

Tipp

Jeder Azure Quantum-Arbeitsbereich verfügt über einen Primärschlüssel und einen sekundären Schlüssel, und jeder Schlüssel verfügt über eine eigene Verbindungszeichenfolge. Um anderen Benutzern den Zugriff auf Ihren Arbeitsbereich zu ermöglichen, geben Sie den sekundären Schlüssel frei, und verwenden Sie den Primärschlüssel nur für Ihre eigenen Dienste. Sie können den Sekundärschlüssel ersetzen, ohne ausfallzeiten in Ihren eigenen Diensten zu verursachen. Weitere Informationen zum Freigeben des Zugriffs auf Ihren Arbeitsbereich finden Sie unter Freigeben des Arbeitsbereichzugriffs.

Verbindungszeichenfolge kopieren

  1. Melden Sie sich im Azure-Portal an.
  2. Wechseln Sie zu Ihrem Azure Quantum-Arbeitsbereich.
  3. Erweitern Sie im Arbeitsbereich das Dropdown-Menü Vorgänge und wählen Sie Zugriffsschlüssel aus.
  4. Aktivieren Sie Zugriffstasten für Ihren Arbeitsbereich. Wenn der Schieberegler für Zugriffstasten auf "Deaktiviert" festgelegt ist, legen Sie den Schieberegler auf "Aktiviert" fest.
  5. Wählen Sie das Symbol "Kopieren" für die Verbindungszeichenfolge aus, die Sie kopieren möchten. Sie können entweder die primäre oder sekundäre Verbindungszeichenfolge auswählen.

Warnung

Es ist ein Sicherheitsrisiko, Ihre Kontozugriffsschlüssel oder Verbindungszeichenfolgen im Klartext zu speichern. Speichern Sie Ihre Kontoschlüssel in einem verschlüsselten Format, oder migrieren Sie Ihre Anwendungen, um die Microsoft Entra-Autorisierung für den Zugriff auf Ihren Azure Quantum-Arbeitsbereich zu verwenden.

Verwenden der Verbindungszeichenfolge für den Zugriff auf Ihren Azure Quantum-Arbeitsbereich

Verwenden Sie die Verbindungszeichenfolge, die Sie kopiert haben, um eine Verbindung mit Ihrem Azure Quantum Arbeitsbereich mit dem qdk.azure Modul oder der QDK-Erweiterung in Visual Studio Code herzustellen.

Um eine Verbindung mit Ihrem Azure Quantum Arbeitsbereich herzustellen, wählen Sie eine der folgenden Methoden aus.

  • Verwenden Sie die from_connection_string Funktion, um ein Workspace Objekt zu erstellen.

    from qdk.azure import Workspace 
    
    connection_string = "" # Add your connection string
    workspace = Workspace.from_connection_string(connection_string) 
    
    print(workspace.get_targets())
    
  • Speichern Sie Ihre Verbindungszeichenfolge in einer Umgebungsvariable.

    import os
    from qdk.azure import Workspace 
    
    connection_string = "" # Add your connection string  
    os.environ["AZURE_QUANTUM_CONNECTION_STRING"] = connection_string 
    
    workspace = Workspace() 
    print(workspace.get_targets()) 
    

Weitere Informationen zum Arbeiten mit Schlüsseln finden Sie unter Verwalten ihrer Zugriffstasten.

Wichtig

Wenn Sie Zugriffstasten für Ihren Arbeitsbereich deaktivieren, können Sie keine Verbindungszeichenfolgen verwenden, um eine Verbindung mit Ihrem Arbeitsbereich herzustellen. Verwenden Sie stattdessen Arbeitsbereichsparameter, um eine Verbindung herzustellen.

Verbinden Sie sich mit Ihrem Arbeitsbereich mithilfe von Arbeitsbereichsparametern

Jeder Azure Quantum-Arbeitsbereich verfügt über einen eindeutigen Satz von Parametern, mit denen Sie eine Verbindung mit dem Arbeitsbereich herstellen können.

Parameter Beschreibung Verwenden bei Herstellung einer Verbindung zu
subscription_id Die Azure-Abonnement-ID. Azure CLI
resource_group Der Azure-Ressourcengruppenname. Azure CLI
name Der Name Ihres Azure Quantum-Arbeitsbereichs. Azure CLI
resource_id Die Azure-Ressourcen-ID des Azure Quantum-Arbeitsbereichs. Python

Führen Sie die folgenden Schritte aus, um Die Arbeitsbereichsparameter zu finden:

  1. Melden Sie sich im Azure-Portal an.
  2. Wechseln Sie zu Ihrem Azure Quantum-Arbeitsbereich.
  3. Wählen Sie in Ihrem Arbeitsbereich Übersicht aus.
  4. Erweitern Sie das "Essentials" Dropdownmenü.
  5. Kopieren Sie die Parameter in den entsprechenden Feldern.

Hinweis

Stellen Sie sicher, dass Sie sich beim richtigen Mandanten anmelden, bevor Sie eine Verbindung mit Ihrem Arbeitsbereich herstellen. Weitere Informationen zu Mandanten finden Sie unter Verwalten von Azure-Abonnements mit der Azure CLI.

Verwenden von Arbeitsbereichsparametern zum Herstellen einer Verbindung mit Ihrem Azure Quantum-Arbeitsbereich

Um angemeldet zu bleiben, wenn Sie Ihre Python Skripts ausführen, öffnen Sie ein Terminal, und führen Sie den folgenden Azure CLI Befehl aus. Mit diesem Befehl wird das Abonnement für Ihren Arbeitsbereich festgelegt. Ersetzen Sie <subscriptionId> durch Ihre Abonnement-ID.

az account set --subscription <subscriptionId>

Sie können ihre Arbeitsbereichsparameter verwenden, um über das qdk.azure Modul oder über Azure CLI eine Verbindung mit Ihrem Azure Quantum Arbeitsbereich herzustellen.

Um eine Verbindung mit Ihrem Azure Quantum Arbeitsbereich herzustellen, wählen Sie eine der folgenden Optionen aus.

  • Geben Sie die Ressourcen-ID an (empfohlen):

    from qdk.azure import Workspace 
    
    workspace = Workspace(resource_id="") # Add the resource ID of your workspace
    
  • Geben Sie die Abonnement-ID, Ressourcengruppe und den Arbeitsbereichsnamen an:

    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
        name="" # Add the name of your workspace
        )
    
  • Geben Sie nur den Arbeitsbereichsnamen an. Diese Option schlägt möglicherweise fehl, wenn Sie mehrere Arbeitsbereiche haben, die denselben Namen im selben Mandanten haben.

    from qdk.azure import Workspace 
    workspace = Workspace(name="") # Add the name of your workspace