Connettiti al tuo spazio di lavoro con QDK o interfaccia della riga di comando di AzureAzure Quantum

Se si dispone di un workspace Azure Quantum, è possibile usare il modulo qdk.azurePython per connettersi al workspace e inviare il codice per l'esecuzione in Azure Quantum. Il qdk.azure modulo fornisce una Workspace classe che rappresenta un'area Azure Quantum di lavoro.

Avviso

A partire dall'11 gennaio 2027, Azure Quantum richiede che gli utenti in un'area di lavoro Quantum abbiano il ruolo di Quantum Workspace Data Reader o Quantum Workspace Data Contributor per visualizzare i risultati del processo. Per inviare job, sarà necessario il ruolo Quantum Workspace Data Contributor. Per evitare interruzioni dei Azure Quantum flussi di lavoro, assegnare questi ruoli agli utenti appropriati prima della scadenza. Per altre informazioni, vedere Assegnare ruoli di accesso ai dati per gli utenti nell'area di lavoro.

Prerequisiti

Per connettersi all'area di lavoro con il qdk.azure modulo, è necessario:

  • 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 Azure Quantum di lavoro. Se non si ha un'area di lavoro, vedere Creare un' Azure Quantum area di lavoro.

  • La versione più recente del qdkPython pacchetto con l'aggiunta azure .

    pip install --upgrade "qdk[azure]"
    

Se si usa interfaccia della riga di comando di Azure, aggiornare alla versione più recente. Per istruzioni sull'installazione, vedere:

Connettersi con un account Azure

Usare un account Azure per connettersi all'area Azure Quantum di lavoro con l'estensione Microsoft Quantum Development Kit (QDK) in Visual Studio Code (VS Code).

  1. Apri VS Code.
  2. Selezionare Visualizza>Riquadro comandi.
  3. Immettere e selezionare QDK: Connettersi a un'area Azure Quantum di lavoro.
  4. Scegliere Azure account.
  5. Quando un VS Code messaggio indica che QDK vuole eseguire l'accesso, selezionare Consenti.
  6. Selezionare l'account da usare.
  7. Selezionare un tenant e una sottoscrizione.

Per visualizzare l'area di lavoro Azure Quantum, selezionare l'icona Microsoft Quantum sulla barra delle attività.

Screenshot dell'icona del pannello Microsoft Quantum sulla Barra attività in Visual Studio Code.

Connettersi con una stringa di connessione

Annotazioni

Le stringhe di connessione sono meno sicure di un account Azure.

Usare un stringa di connessione per specificare i parametri di connessione per un'area di lavoro Azure Quantum. Le stringhe di connessione sono utili quando:

  • 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 Microsoft Entra ID a causa dei criteri aziendali.

Suggerimento

Ogni Azure Quantum area di lavoro ha una chiave primaria e una chiave secondaria e ogni chiave ha una propria stringa di connessione. Per consentire ad altri utenti di usare l'area di lavoro, condividere la chiave secondaria e mantenere la chiave primaria per i propri servizi. In questo modo, è possibile sostituire la chiave secondaria senza causare tempi di inattività nei 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. Accedi al portale di Azure.
  2. Vai all'area di lavoro Azure Quantum.
  3. Nel pannello dell'area di lavoro espandere l'elenco a discesa Operazioni e selezionare Chiavi di accesso.
  4. Se l'interruttore Chiavi di accesso è impostato su Disabilitato, impostarlo su Abilitato.
  5. Selezionare l'icona Copia per il stringa di connessione da copiare. È possibile scegliere la stringa di connessione primaria o secondaria.

Avviso

L'archiviazione delle chiavi di accesso dell'account o delle stringhe di connessione in testo non crittografato rappresenta un rischio per la sicurezza. Archivia le chiavi dell'account in un formato crittografato oppure esegui la migrazione delle app per usare l'autorizzazione di Microsoft Entra per l'area Azure Quantum di lavoro.

Usare la stringa di connessione per accedere alla tua Azure Quantum area di lavoro

Usare la stringa di connessione copiata per connettersi all'Azure Quantum area di lavoro con il qdk.azure modulo o l'estensione QDK in VS Code.

Per connettersi allo spazio di lavoro Azure Quantum, scegliere uno dei metodi seguenti.

  • Usare la from_connection_string funzione per creare un Workspace oggetto .

    from qdk.azure import Workspace 
    
    connection_string = "<ConnectionString>" # Replace with your connection string
    workspace = Workspace.from_connection_string(connection_string) 
    
    print(workspace.get_targets())
    
  • Archiviare il stringa di connessione in una variabile di ambiente.

    import os
    from qdk.azure import Workspace 
    
    connection_string = "<ConnectionString>" # Replace with your connection string
    os.environ["AZURE_QUANTUM_CONNECTION_STRING"] = connection_string 
    
    workspace = Workspace() 
    print(workspace.get_targets()) 
    

Per altre informazioni su come usare le chiavi, vedere Eseguire l'autenticazione nell'area di lavoro usando una chiave di accesso.

Importante

Se si disabilitano le chiavi di accesso per l'area di lavoro, non è possibile connettersi con le stringhe di connessione. Usare invece i parametri dell'area di lavoro.

Connettersi all'area di lavoro con i parametri dell'area di lavoro

Ogni Azure Quantum area di lavoro ha un set univoco di parametri usati per connettersi all'area di lavoro.

Parametro Descrizione Usa quando ti connetti con
subscription_id ID sottoscrizione di Azure. Azure CLI
resource_group Nome del gruppo di risorse di Azure. Azure CLI
name Nome dell'area di lavoro Azure Quantum. Azure CLI
resource_id ID risorsa Azure del Azure Quantum workspace. Python

Per trovare i parametri dell'area di lavoro, seguire questa procedura:

  1. Accedi al portale di Azure.
  2. Vai all'area di lavoro Azure Quantum.
  3. Nel pannello dell'area di lavoro selezionare Panoramica.
  4. Espandi il menu a tendina Elementi essenziali.
  5. Copiare i parametri dai campi corrispondenti.

Annotazioni

Assicurarsi di accedere al tenant corretto prima di connettersi all'area di lavoro. Per altre informazioni sui tenant, vedere Come gestire le sottoscrizioni di Azure con il interfaccia della riga di comando di Azure.

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

Per rimanere autenticati quando si eseguono Python gli script, aprire un terminale ed eseguire il comando seguente interfaccia della riga di comando di Azure per impostare l'abbonamento per l'area di lavoro. Sostituire <subscriptionId> con l'ID della sottoscrizione.

az account set --subscription <subscriptionId>

Usare i parametri dell'area di lavoro per connettersi all'area Azure Quantum di lavoro tramite il modulo qdk.azure o il interfaccia della riga di comando di Azure.

Per connettersi all'area Azure Quantum di lavoro, scegliere una delle opzioni seguenti.

  • Specificare l'ID risorsa (scelta consigliata):

    from qdk.azure import Workspace 
    
    workspace = Workspace(resource_id="") # Add the resource ID of your workspace
    
  • Specificare l'ID sottoscrizione, il gruppo di risorse e il nome dell'area di lavoro:

    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
        )
    
  • Specificare solo il nome dell'area di lavoro. Questa opzione potrebbe non funzionare se sono presenti più aree di lavoro con lo stesso nome nello stesso tenant.

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