Connettersi all'area di lavoro di Azure Quantum con QDK o l'interfaccia della riga di comando di Azure

Se si dispone di un'area di lavoro Azure Quantum, è possibile connettersi all'area di lavoro e inviare il codice con il qdk.azure modulo Python. Il qdk.azure modulo fornisce una classe che rappresenta un'area Workspace di lavoro di Azure Quantum.

Prerequisiti

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

Connettersi con una stringa di connessione

Usare un stringa di connessione per specificare i parametri di connessione a un'area di lavoro Azure Quantum. Le stringhe di connessione sono utili 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 Microsoft Entra ID a causa dei criteri aziendali.

Suggerimento

Ogni area di lavoro di Azure Quantum ha una chiave primaria e una chiave secondaria e ogni chiave ha una propria stringa di connessione. Per consentire ad altri utenti di accedere all'area di lavoro, condividere la chiave secondaria e usare la chiave primaria solo per i propri servizi. È possibile sostituire la chiave secondaria senza causare 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. Accedi al portale di Azure.
  2. Passare all'area di lavoro di Azure Quantum.
  3. Nel pannello dell'area di lavoro espandere l'elenco a discesa Operazioni e selezionare Chiavi di accesso.
  4. Abilitare le chiavi di accesso per l'area di lavoro. Se il dispositivo di scorrimento Tasti di scelta è impostato su Disabilitato, impostare il dispositivo di scorrimento su Abilitato.
  5. Selezionare l'icona Copia per il stringa di connessione da copiare. È possibile scegliere la stringa di connessione primaria o secondaria.

Avviso

È un rischio per la sicurezza archiviare le chiavi di accesso dell'account o le stringhe di connessione in testo non crittografato. 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 la stringa di connessione per accedere all'area di lavoro di Azure Quantum

Usa la stringa di connessione che hai copiato per connetterti all'area di lavoro di Azure Quantum con il modulo qdk.azure o l'estensione QDK in Visual Studio Code.

Per connettersi all'area 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 = "" # Add 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 = "" # Add your connection string  
    os.environ["AZURE_QUANTUM_CONNECTION_STRING"] = connection_string 
    
    workspace = Workspace() 
    print(workspace.get_targets()) 
    

Per altre informazioni sull'uso delle chiavi, vedere Gestire le chiavi di accesso.

Importante

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

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

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

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

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

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

Annotazioni

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

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

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

az account set --subscription <subscriptionId>

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

Per connettersi all'area di lavoro Azure Quantum, 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 riuscire quando 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