Delen via

Verbinding maken met uw Azure Quantum-werkruimte met het Azure-quantum Python-pakket

  • Artikel

Zodra u een Azure Quantum-werkruimte hebt gemaakt, kunt u er verbinding mee maken en uw code verzenden met behulp van het azure-quantum Python-pakket. Het azure-quantum pakket biedt een Workspace klasse die een Azure Quantum-werkruimte vertegenwoordigt.

Vereisten

Verbinding maken met behulp van een verbindingsreeks

U kunt een verbindingsreeks gebruiken om de verbindingsparameters op te geven voor een Azure Quantum-werkruimte. In de volgende scenario's kunt u een verbindingsreeks gebruiken:

  • U wilt de toegang tot de werkruimte delen met anderen die geen Azure-account hebben.
  • U wilt de toegang tot de werkruimte gedurende een beperkte periode delen met anderen.
  • U kunt Microsoft Entra-id niet gebruiken vanwege bedrijfsbeleid.

Tip

Elke Azure Quantum-werkruimte heeft primaire en secundaire sleutels en de bijbehorende verbindingsreeks s. Als u toegang tot uw werkruimte wilt toestaan voor anderen, kunt u uw secundaire sleutel delen en uw primaire sleutel gebruiken voor uw eigen services. Op deze manier kunt u de secundaire sleutel indien nodig vervangen zonder downtime in uw eigen services. Zie Uw werkruimtetoegang delen voor meer informatie over het delen van uw werkruimtetoegang.

De verbindingsreeks kopiëren

  1. Meld u aan bij Azure Portal en selecteer uw Azure Quantum-werkruimte.

  2. Navigeer in het linkerdeelvenster naar De sleutels van Operations > Access.

  3. Toegangssleutels moeten zijn ingeschakeld. Als toegangssleutels zijn uitgeschakeld, moet u deze eerst inschakelen. Zie hoe u dit doet in Uw toegangssleutels beheren.

  4. Klik op het pictogram Kopiëren om de verbindingsreeks te kopiëren. U kunt de primaire of secundaire verbindingsreeks selecteren.

    Schermopname van Azure Portal waarin wordt getoond hoe u de verbindingsreeks s kopieert.

Waarschuwing

Het opslaan van uw accounttoegangssleutels of verbindingsreeks in duidelijke tekst vormt een beveiligingsrisico en wordt niet aanbevolen. Sla uw accountsleutels op in een versleutelde indeling of migreer uw toepassingen om Microsoft Entra-autorisatie te gebruiken voor toegang tot uw Azure Quantum-werkruimte.

De verbindingsreeks gebruiken om toegang te krijgen tot uw Azure Quantum-werkruimte

Nadat u de verbindingsreeks hebt gekopieerd, kunt u deze gebruiken om verbinding te maken met uw Azure Quantum-werkruimte.

Als u met een Python-omgeving werkt, kunt u een Workspace object maken om verbinding te maken met uw Azure Quantum-werkruimte. Bij het maken van een Workspace object hebt u twee opties voor het identificeren van uw Azure Quantum-werkruimte.

  • U kunt een Workspace object maken door aan te roepen 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())

  • Als u uw verbindingsreeks niet in de code wilt kopiëren, kunt u ook uw verbindingsreeks opslaan in een omgevingsvariabele en gebruikenWorkspace().

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

Zie Uw toegangssleutels beheren voor meer informatie over het in-/uitschakelen en opnieuw genereren van uw sleutels.

Belangrijk

Wanneer toegangssleutels zijn uitgeschakeld, zijn alle aanvragen die gebruikmaken van verbindingsreeks s of toegangssleutels niet gemachtigd. U kunt nog steeds de werkruimteparameters gebruiken om verbinding te maken met uw werkruimte.

Verbinding maken met behulp van de werkruimteparameters

Elke Azure Quantum-werkruimte heeft een unieke set parameters die u kunt gebruiken om er verbinding mee te maken. U kunt de volgende parameters gebruiken om verbinding te maken met uw Azure Quantum-werkruimte:

Parameter Description
subscription_id De Azure-abonnements-id.
resource_group De naam van de Azure-resourcegroep.
name De naam van uw Azure Quantum-werkruimte.
location De Azure-regio waarin de Azure Quantum-werkruimte is ingericht. Dit kan worden opgegeven als een regionaam, zoals 'VS - oost' of een locatienaam, zoals 'eastus'.
resource_id De Azure-resource-id van de Azure Quantum-werkruimte.

U vindt de werkruimteparameters in het overzicht van uw Azure Quantum-werkruimte in Azure Portal.

  1. Meld u aan bij uw Azure-account, https://portal.azure.com

  2. Selecteer uw Azure Quantum-werkruimte en navigeer naar Overzicht.

  3. Kopieer de parameters in de velden.

    Schermopname van Visual Studio Code waarin wordt getoond hoe u het overzichtsvenster van uw Quantum-werkruimte uitvouwt.

De werkruimteparameters gebruiken om verbinding te maken met uw Azure Quantum-werkruimte

Maak een Workspace object om verbinding te maken met uw Azure Quantum-werkruimte. Bij het maken van een Workspace object hebt u twee opties voor het identificeren van uw Azure Quantum-werkruimte.

  • U kunt de locatie en resource-id opgeven (aanbevolen):

    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")
    )

  • U kunt de locatie, abonnements-id, resourcegroep en werkruimtenaam opgeven:

    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")
    )

Gerelateerde inhoud