Connettersi all'area di lavoro di Azure Quantum con il pacchetto Python azure-quantum

Dopo aver creato un'area di lavoro di Azure Quantum, è possibile connettersi e inviare il codice usando il azure-quantum pacchetto Python. Il azure-quantum pacchetto fornisce una Workspace classe che rappresenta un'area di lavoro di Azure Quantum.

Prerequisiti

• Un account Azure con una sottoscrizione attiva. Se non si ha un account Azure, registrarsi gratuitamente e iscriversi per ottenere una sottoscrizione con pagamento in base al consumo.

• Un'area di lavoro di Azure Quantum. Vedere Creare un'area di lavoro di Azure Quantum.

• Versione più recente del pacchetto Azure Quantum azure-quantum .

  !pip install --upgrade azure-quantum
  

• Se si usa l'interfaccia della riga di comando di Azure, è necessario avere la versione più recente. Per le istruzioni di installazione, vedere:

  • Installare l'interfaccia della riga di comando di Azure in Windows
  • Installare l'interfaccia della riga di comando di Azure in Linux
  • Installare l'interfaccia della riga di comando di Azure in macOS

Connettersi usando un stringa di connessione

È possibile usare un stringa di connessione per specificare i parametri di connessione a un'area di lavoro di Azure Quantum. È possibile usare un stringa di connessione negli scenari seguenti:

• Si vuole condividere l'accesso all'area di lavoro con altri utenti che non hanno un account Azure.
• Si vuole condividere l'accesso all'area di lavoro con altri utenti per un periodo di tempo limitato.
• Non è possibile usare l'ID Microsoft Entra a causa dei criteri aziendali.

Suggerimento

Ogni area di lavoro di Azure Quantum ha chiavi primarie e secondarie e le stringa di connessione corrispondenti. Se si vuole consentire l'accesso all'area di lavoro ad altri utenti, è possibile condividere la chiave secondaria e usare la chiave primaria per i propri servizi. In questo modo, è possibile sostituire la chiave secondaria in base alle esigenze senza avere tempi di inattività nei propri servizi. Per altre informazioni sulla condivisione dell'accesso all'area di lavoro, vedere Condividere l'accesso all'area di lavoro.

Copiare la stringa di connessione

1. Accedere al portale di Azure e selezionare l'area di lavoro di Azure Quantum.

2. Nel pannello sinistro passare a Chiavi di accesso alle operazioni>.

3. Le chiavi di accesso devono essere abilitate. Se le chiavi di accesso sono disabilitate, è prima necessario abilitarle. Vedere come eseguire questa operazione in Gestire le chiavi di accesso.

4. Fare clic sull'icona Copia per copiare il stringa di connessione. È possibile selezionare il stringa di connessione primario o secondario.

   

Avviso

L'archiviazione delle chiavi di accesso dell'account o stringa di connessione in testo non crittografato presenta un rischio per la sicurezza e non è consigliata. Archiviare le chiavi dell'account in un formato crittografato o eseguire la migrazione delle applicazioni per usare l'autorizzazione di Microsoft Entra per l'accesso all'area di lavoro di Azure Quantum.

Usare il stringa di connessione per accedere all'area di lavoro di Azure Quantum

Dopo aver copiato il stringa di connessione, è possibile usarlo per connettersi all'area di lavoro di Azure Quantum.

Python

Se si usa un ambiente Python, è possibile creare un Workspace oggetto per connettersi all'area di lavoro di Azure Quantum. Quando si crea un Workspace oggetto, sono disponibili due opzioni per identificare l'area di lavoro di Azure Quantum.

• È possibile creare un Workspace oggetto chiamando 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()) 
  

• Se non si vuole copiare il stringa di connessione nel codice, è anche possibile archiviare il stringa di connessione in una variabile di ambiente e usare Workspace().

  # 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. Aprire Visual Studio Code.

2. Selezionare Visualizza -> Riquadro comandi e digitare Q#: Connettersi a un'area di lavoro di Azure Quantum. Premere Invio.

3. Selezionare Stringa di connessione.

4. Incollare il stringa di connessione copiato dal portale di Azure e premere INVIO.

5. L'area di lavoro di Azure Quantum viene visualizzata nel riquadro Esplora risorse in Aree di lavoro quantistiche. È possibile espandere l'area di lavoro per visualizzare le destinazioni disponibili nell'area di lavoro e l'elenco dei processi.

   

Per altre informazioni su come abilitare/disabilitare e rigenerare le chiavi, vedere Gestire le chiavi di accesso.

Importante

Quando le chiavi di accesso sono disabilitate, tutte le richieste che usano stringa di connessione o chiavi di accesso non sono autorizzate. È comunque possibile usare i parametri dell'area di lavoro per connettersi all'area di lavoro.

Connettersi usando i parametri dell'area di lavoro

Ogni area di lavoro di Azure Quantum ha un set univoco di parametri che è possibile usare per connettersi. È possibile usare i parametri seguenti per connettersi all'area di lavoro di Azure Quantum:

Parametro	Descrizione
subscription_id	ID sottoscrizione di Azure.
resource_group	Nome del gruppo di risorse di Azure.
name	Nome dell'area di lavoro di Azure Quantum.
location	Area di Azure in cui viene effettuato il provisioning dell'area di lavoro di Azure Quantum. Può essere specificato come nome di area, ad esempio "Stati Uniti orientali" o come nome della località, ad esempio "eastus".
resource_id	ID risorsa di Azure dell'area di lavoro di Azure Quantum.

I parametri dell'area di lavoro sono disponibili nella panoramica dell'area di lavoro di Azure Quantum in portale di Azure.

1. Accedere all'account Azure, https://portal.azure.com,

2. Selezionare l'area di lavoro di Azure Quantum e passare a Panoramica.

3. Copiare i parametri nei campi.

   

Usare i parametri dell'area di lavoro per connettersi all'area di lavoro di Azure Quantum

Python

Creare un Workspace oggetto per connettersi all'area di lavoro di Azure Quantum. Quando si crea un Workspace oggetto, sono disponibili due opzioni per identificare l'area di lavoro di Azure Quantum.

• È possibile specificare il percorso e l'ID risorsa (scelta consigliata):

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

• È possibile specificare il percorso, l'ID sottoscrizione, il gruppo di risorse e il nome dell'area di lavoro:

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

Interfaccia della riga di comando di Azure

È possibile usare il interfaccia della riga di comando di Azure (interfaccia della riga di comando di Azure) per connettersi all'area di lavoro. Per altre informazioni, vedere Gestire le aree di lavoro quantistiche con l'interfaccia della riga di comando di Azure.

1. Accedere all'account Azure usando l'interfaccia della riga di comando di Azure.

   az login
   

2. selezionare la sottoscrizione da usare. Sostituire SubscriptionName con il nome della sottoscrizione. Invece del nome della sottoscrizione, è anche possibile usare un ID sottoscrizione.

   az account set --subscription SubscriptionName
   

3. Impostare l'area di lavoro da usare. Sostituire WorkspaceLocation, ResourceGroupNamee WorkspaceName con la posizione dell'area di lavoro, il nome del gruppo di risorse e il nome dell'area di lavoro, rispettivamente.

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

Contenuto correlato

• Gestire le aree di lavoro quantistiche con l'interfaccia della riga di comando di Azure
• Condividere l'accesso all'area di lavoro di Azure Quantum
• Gestire le aree di lavoro quantistiche con Azure Resource Manager
• Eseguire l'autenticazione con un'entità servizio
• Autenticazione con un'identità gestita