Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
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'aggiuntaazure.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:
- Installa interfaccia della riga di comando di Azure su Windows
- Installare interfaccia della riga di comando di Azure in Linux
- Installare interfaccia della riga di comando di Azure in macOS
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).
- Apri VS Code.
- Selezionare Visualizza>Riquadro comandi.
- Immettere e selezionare QDK: Connettersi a un'area Azure Quantum di lavoro.
- Scegliere Azure account.
- Quando un VS Code messaggio indica che QDK vuole eseguire l'accesso, selezionare Consenti.
- Selezionare l'account da usare.
- Selezionare un tenant e una sottoscrizione.
Per visualizzare l'area di lavoro Azure Quantum, selezionare l'icona Microsoft Quantum sulla barra delle attività.
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
- Accedi al portale di Azure.
- Vai all'area di lavoro Azure Quantum.
- Nel pannello dell'area di lavoro espandere l'elenco a discesa Operazioni e selezionare Chiavi di accesso.
- Se l'interruttore Chiavi di accesso è impostato su Disabilitato, impostarlo su Abilitato.
- 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_stringfunzione per creare unWorkspaceoggetto .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:
- Accedi al portale di Azure.
- Vai all'area di lavoro Azure Quantum.
- Nel pannello dell'area di lavoro selezionare Panoramica.
- Espandi il menu a tendina Elementi essenziali.
- 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 workspaceSpecificare 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