Share via

%azure.target

  • Articolo

Avviso

Questa documentazione fa riferimento alla QDK classica, sostituita dalla QDK moderna.

Il QDK moderno supporta solo il comando magic '%%qsharp'.

Riepilogo

Imposta o visualizza la destinazione di esecuzione attiva per l'invio di processi Q# in un'area di lavoro di Azure Quantum.

Descrizione

Questo comando magic consente di specificare o visualizzare la destinazione di esecuzione per l'invio di processi Q# in un'area di lavoro Di Azure Quantum.

L'area di lavoro Azure Quantum deve essere stata inizializzata in precedenza usando il %azure.connect comando magic command magic . La destinazione di esecuzione specificata deve essere disponibile nell'area di lavoro e supportare l'esecuzione di programmi Q#.

Parametri facoltativi

  • ID di destinazione da impostare come destinazione di esecuzione attiva per l'invio di processi Q#. Se non specificato, viene visualizzata la destinazione di esecuzione attualmente attiva.

Possibili errori

  • NotConnected: non connesso a un'area di lavoro di Azure Quantum.
  • InvalidTarget: la destinazione specificata non è abilitata in questa area di lavoro. Assicurarsi che il nome di destinazione sia valido e che il provider associato venga aggiunto all'area di lavoro. Per aggiungere un provider all'area di lavoro quantistica nel portale di Azure, vedere https://aka.ms/AQ/Docs/AddProvider
  • NoTarget: non è stata configurata alcuna destinazione di esecuzione per l'invio di processi di Azure Quantum.

Funzionalità di destinazione

Quando si imposta una destinazione, la funzionalità di destinazione è impostata sul livello massimo di funzionalità supportato dalla destinazione specificata, in modo che tutte le funzionalità consentite dalla destinazione siano consentite nelle successive funzioni e operazioni di compilazione Q#.

È possibile limitare ulteriormente i livelli di funzionalità di destinazione usando qsharp.azure.target_capability(). Questo può essere utile, ad esempio, quando si confrontano funzionalità tra destinazioni diverse.

Esempi per %azure.target

Esempio 1

Imposta la destinazione corrente per l'invio di processi Q# su provider.qpu:

In []: %azure.target provider.qpu
Out[]: Loading package Microsoft.Quantum.Providers.Provider and dependencies...
        Active target is now provider.qpu
        <detailed properties of active execution target>

Esempio 2

Cancella le informazioni di destinazione correnti:

In []: %azure.target --clear

Esempio 3

Visualizza la destinazione corrente e tutte le destinazioni disponibili nell'area di lavoro Azure Quantum corrente:

In []: %azure.target
Out[]: Current execution target: provider.qpu
        Available execution targets: provider.qpu, provider.simulator
        <detailed properties of active execution target>