Verschiedene Möglichkeiten zum Herstellen einer Verbindung mit Ihrem Azure Quantum-Arbeitsbereich

Nachdem Sie einen Azure Quantum-Arbeitsbereich erstellt haben, können Sie eine Verbindung mit diesem herstellen und Ihren Code mithilfe des Python-Pakets azure-quantum übermitteln. Das azure-quantum Paket stellt eine Workspace Klasse bereit, die einen Azure Quantum-Arbeitsbereich darstellt.

Weitere Möglichkeiten zum Zugriff auf Ihren Arbeitsbereich finden Sie unter Authentifizieren mit einem Dienstprinzipal oder Authentifizieren mit einer verwalteten Identität.

Voraussetzungen

• Ein Azure-Konto mit einem aktiven Abonnement. Wenn Sie über kein Azure-Konto verfügen, registrieren Sie sich kostenlos, und registrieren Sie sich für ein Abonnement mit nutzungsbasierter Bezahlung.

• Einen Azure Quantum-Arbeitsbereich. Weitere Informationen finden Sie unter Erstellen eines Azure Quantum-Arbeitsbereichs.

• Die neueste Version des Azure Quantum-Pakets azure-quantum .

  python -m pip install --upgrade azure-quantum
  

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

  • Installieren der Azure CLI unter Windows
  • Installieren der Azure CLI unter Linux
  • Installieren der Azure CLI unter macOS

Verbinden mit einer Verbindungszeichenfolge

Sie können eine Verbindungszeichenfolge verwenden, um die Verbindungsparameter für einen Azure Quantum-Arbeitsbereich anzugeben. In den folgenden Szenarien können Sie eine Verbindungszeichenfolge verwenden:

• Sie möchten den Arbeitsbereichszugriff für andere Personen freigeben, die über kein Azure-Konto verfügen.
• Sie möchten den Arbeitsbereichszugriff für einen begrenzten Zeitraum für andere Personen freigeben.
• Sie können Microsoft Entra ID aufgrund von Unternehmensrichtlinien nicht verwenden.

Tipp

Jeder Azure Quantum-Arbeitsbereich verfügt über primäre und sekundäre Schlüssel und die entsprechenden Verbindungszeichenfolgen. Wenn Sie anderen den Zugriff auf Ihren Arbeitsbereich erlauben möchten, können Sie Ihren sekundären Schlüssel freigeben und Ihren primären Für Ihre eigenen Dienste verwenden. Auf diese Weise können Sie den sekundären Schlüssel bei Bedarf ersetzen, ohne dass es zu Ausfallzeiten in Ihren eigenen Diensten geht. Weitere Informationen zum Freigeben des Arbeitsbereichszugriffs finden Sie unter Freigeben des Arbeitsbereichszugriffs.

Verbindungszeichenfolge kopieren

1. Melden Sie sich beim Azure-Portal an, und wählen Sie Ihren Azure Quantum-Arbeitsbereich aus.

2. Navigieren Sie im linken Bereich zu Betriebszugriffsschlüsseln>.

3. Zugriffsschlüssel müssen aktiviert sein. Wenn Zugriffsschlüssel deaktiviert sind, müssen Sie sie zuerst aktivieren. Informationen dazu finden Sie unter Verwalten Ihrer Zugriffsschlüssel.

4. Klicken Sie auf das Symbol Kopieren, um die Verbindungszeichenfolge zu kopieren. Sie können die primäre oder sekundäre Verbindungszeichenfolge auswählen.

   

Warnung

Das Speichern von Kontozugriffsschlüssel oder Verbindungszeichenfolge in Klartext stellt ein Sicherheitsrisiko dar und wird nicht empfohlen. Speichern Sie Ihre Kontoschlüssel in einem verschlüsselten Format, oder migrieren Sie Ihre Anwendungen, um Microsoft Entra Autorisierung für den Zugriff auf Ihren Azure Quantum-Arbeitsbereich zu verwenden.

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

Nachdem Sie die Verbindungszeichenfolge kopiert haben, können Sie damit eine Verbindung mit Ihrem Azure Quantum-Arbeitsbereich herstellen.

Python

Wenn Sie mit einer Python-Umgebung arbeiten, können Sie ein Objekt erstellen, um eine Workspace Verbindung mit Ihrem Azure Quantum-Arbeitsbereich herzustellen. Beim Erstellen eines Workspace Objekts haben Sie zwei Optionen zum Identifizieren Ihres Azure Quantum-Arbeitsbereichs.

• Sie können ein Workspace -Objekt erstellen, indem Sie aufrufen from_connection_string.

  # Creating a new Workspace object from a connection string 
  from azure.quantum import Workspace 
  
  connection_string = "[Copy connection string]" 
  workspace = Workspace.from_connection_string(connection_string) 
  
  print(workspace.get_targets()) 
  

• Wenn Sie Ihre Verbindungszeichenfolge nicht im Code kopieren möchten, können Sie Ihre Verbindungszeichenfolge auch in einer Umgebungsvariable speichern und verwendenWorkspace().

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

VS-Code

1. Öffnen Sie Visual Studio Code.

2. Wählen Sie Ansicht –> Befehlspalette aus , und geben Sie folgendes ein Q#: Herstellen einer Verbindung mit einem Azure Quantum-Arbeitsbereich. Drücke die EINGABETASTE.

3. Wählen Sie Verbindungszeichenfolge aus.

4. Fügen Sie die Verbindungszeichenfolge ein, die Sie aus dem Azure-Portal kopiert haben, und drücken Sie die EINGABETASTE.

5. Ihr Azure Quantum-Arbeitsbereich wird im bereich Explorer unter Quantum Workspaces angezeigt. Sie können den Arbeitsbereich erweitern, um die in Ihrem Arbeitsbereich verfügbaren Ziele und die Liste der Aufträge anzuzeigen.

   

Weitere Informationen zum Aktivieren/Deaktivieren und Generieren Ihrer Schlüssel finden Sie unter Verwalten Ihrer Zugriffsschlüssel.

Wichtig

Wenn Zugriffsschlüssel deaktiviert sind, sind alle Anforderungen, die Verbindungszeichenfolgen oder Zugriffsschlüssel verwenden, nicht autorisiert. Sie können weiterhin die Arbeitsbereichsparameter verwenden, um eine Verbindung mit Ihrem Arbeitsbereich herzustellen.

Herstellen einer Verbindung mit Arbeitsbereichsparametern

Jeder Azure Quantum-Arbeitsbereich verfügt über einen eindeutigen Satz von Parametern, mit denen Sie eine Verbindung herstellen können. Sie können die folgenden Parameter verwenden, um eine Verbindung mit Ihrem Azure Quantum-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 der Azure Quantum-Arbeitsbereich bereitgestellt wird. Dies kann als Regionsname wie "USA, Osten" oder als Standortname wie "eastus" angegeben werden.
resource_id	Die Azure-Ressourcen-ID des Azure Quantum-Arbeitsbereichs.

Die Arbeitsbereichsparameter finden Sie in der Übersicht ihres Azure Quantum-Arbeitsbereichs in Azure-Portal.

1. Melden Sie sich bei Ihrem Azure-Konto an, https://portal.azure.comund

2. Wählen Sie Ihren Azure Quantum-Arbeitsbereich aus, und navigieren Sie zu Übersicht.

3. Kopieren Sie die Parameter in die Felder.

   

Verwenden der Arbeitsbereichsparameter zum Herstellen einer Verbindung mit Ihrem Azure Quantum-Arbeitsbereich

Python

Erstellen Sie ein Workspace Objekt, um eine Verbindung mit Ihrem Azure Quantum-Arbeitsbereich herzustellen. Beim Erstellen eines Workspace Objekts haben Sie zwei Optionen zum Identifizieren Ihres Azure Quantum-Arbeitsbereichs.

• Sie können den Speicherort und die Ressourcen-ID angeben (empfohlen):

  from azure.quantum import Workspace 
  
  workspace = Workspace(  
      resource_id = "", # Add the resource ID of your workspace
      location = "" # Add the location of your workspace (for example "westus")
      )
  

• Sie können den Standort, die Abonnement-ID, die Ressourcengruppe und den Namen des Arbeitsbereichs angeben:

  from azure.quantum 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 (for example "westus")
      )
  

Azure-Befehlszeilenschnittstelle

Sie können die Azure Command-Line-Schnittstelle (Azure CLI) verwenden, um eine Verbindung mit Ihrem Arbeitsbereich herzustellen. Weitere Informationen finden Sie unter Verwalten von Quantenarbeitsbereichen mit der Azure CLI.

1. Melden Sie sich mit der Azure CLI bei Ihrem Azure-Konto an.

   az login
   

2. Wählen Sie das Abonnement aus, das Sie verwenden möchten. Ersetzen Sie SubscriptionName durch den Abonnementnamen. Sie können auch die Abonnement-ID anstelle des Abonnementnamens verwenden.

   az account set --subscription SubscriptionName
   

3. Legen Sie den Arbeitsbereich fest, den Sie verwenden möchten. Ersetzen Sie WorkspaceLocation, ResourceGroupNameund WorkspaceName durch Ihren Arbeitsbereichsspeicherort, Ressourcengruppennamen und Arbeitsbereichsnamen.

   az quantum workspace set --location WorkspaceLocation --resource-group ResourceGroupName --workspace-name WorkspaceName
   

Nächste Schritte

• Verwalten von Quantenarbeitsbereichen mit der Azure CLI
• Freigeben des Zugriffs auf Ihren Azure Quantum-Arbeitsbereich
• Verwalten von Quantenarbeitsbereichen mit dem Azure Resource Manager
• Authentifizieren mithilfe eines Dienstprinzipals
• Authentifizieren mit einer verwalteten Identität