Freigeben über

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, müssen Sie folgendes haben:

  • Ein Azure-Konto mit einem aktiven Abonnement. Wenn Sie noch kein Azure-Konto haben, können Sie sich kostenlos registrieren und ein Pay-as-you-go-Abonnement abschließen.

  • Azure Quantum-Arbeitsbereich Wenn Sie keinen Arbeitsbereich haben, siehe Erstellen eines Azure Quantum Arbeitsbereichs.

  • Die neueste Version der qdk Python-Bibliothek mit dem azure extra.

    pip install --upgrade "qdk[azure]"

Wenn Sie Azure CLI verwenden, müssen Sie über die neueste Version verfügen. Installationsanweisungen finden Sie unter:

Verbinden mit einer Verbindungszeichenfolge

Sie können eine Verbindungszeichenfolge verwenden, 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 beim Azure-Portal an.
  2. Wechseln Sie zu Ihrem Azure Quantum-Arbeitsbereich.
  3. Erweitern Sie im Arbeitsbereich die Dropdown-Liste "Operationen" und wählen Sie "Zugriffstasten" aus.
  4. Sie müssen Zugriffstasten für Ihren Arbeitsbereich aktivieren. 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 diese 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. Es empfiehlt sich, Ihre Kontoschlüssel in einem verschlüsselten Format zu speichern oder Ihre Anwendungen zu migrieren, 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

Sie können die Verbindungszeichenfolge verwenden, die Sie soeben kopiert haben, um eine Verbindung mit Ihrem Azure Quantum-Arbeitsbereich mit dem qdk.azure Modul oder mit Visual Studio Code (VS Code) herzustellen.

Erstellen Sie ein Workspace Objekt, um eine Verbindung mit Ihrem Azure Quantum-Arbeitsbereich herzustellen. Es gibt zwei Optionen zum Identifizieren Ihres Azure Quantum-Arbeitsbereichs, wenn Sie ein Workspace Objekt erstellen.

  • Rufen Sie die from_connection_string Funktion auf, wenn Sie ein Workspace Objekt erstellen.

    # 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())

  • Wenn Sie ihre Verbindungszeichenfolge nicht in Ihren Code kopieren möchten, speichern Sie die Verbindungszeichenfolge in einer Umgebungsvariable und verwenden Sie Workspace()sie.

    # 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())

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

Wichtig

Wenn Sie Die Zugriffstasten für Ihren Arbeitsbereich deaktivieren, können Sie keine Verbindungszeichenfolgen verwenden, um eine Verbindung mit Ihrem Arbeitsbereich herzustellen. Sie können jedoch weiterhin Arbeitsbereichsparameter verwenden, um eine Verbindung mit Ihrem Arbeitsbereich 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. Sie können die folgenden Parameter verwenden, um eine Verbindung mit Ihrem Azure-Arbeitsbereich herzustellen:

Parameter Beschreibung
subscription_id Die Azure-Abonnement-ID.
resource_group Der Azure-Ressourcengruppenname.
name Der Name Ihres Azure Quantum-Arbeitsbereichs.
location Die Azure-Region, in der sich Ihr Arbeitsbereich befindet.
resource_id Die Azure-Ressourcen-ID des Azure Quantum-Arbeitsbereichs.

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

  1. Melden Sie sich beim 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 in dem korrekten Mandantenkonto 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 bei der Ausführung Ihrer Python-Skripts angemeldet zu bleiben, öffnen Sie ein Terminal, und führen Sie den folgenden Azure CLI-Befehl aus, um das Abonnement für Ihren Arbeitsbereich festzulegen, bevor Sie Arbeitsbereichsparameter verwenden, um eine Verbindung mit Ihrem Arbeitsbereich herzustellen. Ersetzen Sie <subscriptionId> durch Ihre Abonnement-ID.

az account set --subscription <subscriptionId>

Sie können Ihre Arbeitsbereichsparameter verwenden, um eine Verbindung mit Ihrem Azure Quantum-Arbeitsbereich mit dem qdk.azure Modul oder mit Azure CLI herzustellen.

Erstellen Sie ein Workspace Objekt, um eine Verbindung mit Ihrem Azure Quantum-Arbeitsbereich herzustellen. Es gibt drei Optionen zum Identifizieren Ihres Azure Quantum-Arbeitsbereichs, wenn Sie ein Workspace Objekt erstellen.

  • 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

Zugehöriger Inhalt

  • Last updated on