Verwenden von Azure Quantum-Aufträgen

Wenn Sie ein Quantenprogramm in Azure Quantum ausführen, erstellen Sie einen Auftrag und führen es aus. Die Schritte zum Erstellen und Ausführen eines Auftrags hängen vom Auftragstyp und dem Anbieter ab target , den Sie für den Arbeitsbereich konfigurieren.

Auftragseigenschaften

Alle Aufträge verfügen über die folgenden gemeinsamen Eigenschaften:

Eigenschaft	BESCHREIBUNG
ID	Ein eindeutiger Bezeichner für den Auftrag. Er muss im Arbeitsbereich eindeutig sein.
Anbieter	Wer Ihren Auftrag ausführen soll.
Target	Worauf Ihr Auftrag ausgeführt werden soll. Beispielsweise die genaue Quantenhardware oder der vom Anbieter bereitgestellte Quantensimulator.
Name	Ein benutzerdefinierter Name zur Organisation Ihrer Aufträge.
Parameter	Optionale Eingabeparameter für targets. Eine Definition der verfügbaren Parameter finden Sie in der Dokumentation für die ausgewählte target .

Sobald Sie einen Auftrag erstellt haben, sind verschiedene Metadaten über seinen Zustand und seines Ausführungsverlauf verfügbar.

Auftragslebenszyklus

Nachdem Sie Ihr Quantenprogramm geschrieben haben, können Sie einen target auswählen und Ihren Auftrag übermitteln.

Dieses Diagramm zeigt den grundlegenden Arbeitsablauf, nachdem Sie Ihren Auftrag übermittelt haben:

Zunächst lädt Azure Quantum den Auftrag auf das Azure Storage-Konto hoch, das Sie im Arbeitsbereich konfiguriert haben. Anschließend wird der Auftrag in die Auftragswarteschlange für den Anbieter aufgenommen, den Sie im Auftrag angegeben haben. Azure Quantum lädt dann Ihr Programm herunter und übersetzt es für den Anbieter. Der Anbieter verarbeitet den Auftrag und gibt die Ausgabe an Azure Storage zurück, wo sie zum Download zur Verfügung steht.

Überwachen von Aufträgen

Nachdem Sie einen Auftrag übermittelt haben, müssen Sie den Status des Auftrags abfragen. Aufträge haben die folgenden möglichen Zustände:

Status	Beschreibung
warten	Der Auftrag wartet darauf, ausgeführt zu werden. Einige Aufträge führen Vorverarbeitungsaufgaben im Wartezustand aus. waiting ist immer der erste Zustand, jedoch kann ein Auftrag in den executing-Zustand wechseln, bevor Sie ihn in waiting.
wird ausgeführt	Der target -Wert führt den Auftrag derzeit aus.
succeeded	Der Auftrag war erfolgreich, und die Ausgabe ist verfügbar. Dies ist der finale Zustand.
fehlgeschlagen	Der Auftrag ist fehlgeschlagen, und es sind Fehlerinformationen verfügbar. Dies ist der finale Zustand.
abgebrochen	Der Benutzer hat angefordert, den Auftragslauf abzubrechen. Dies ist der finale Zustand. Weitere Informationen finden Sie in diesem Artikel unter Auftragsabbruch.

Diesucceeded, failed, und cancelled Zustände werden alsEndzustände betrachtet. Sobald sich ein Auftrag in einem dieser Zustände befindet, finden keine Aktualisierungen mehr statt, und die entsprechenden Auftragsausgangsdaten ändern sich nicht mehr.

Dieses Diagramm zeigt die möglichen Auftragszustandsübergänge:

Nachdem ein Auftrag erfolgreich abgeschlossen wurde, wird ein Link zu den Ausgabedaten in Ihrem Azure Storage angezeigt. Wie Sie auf diese Daten zugreifen, hängt vom SDK oder Tool ab, mit dem Sie den Auftrag übermittelt haben.

Auftragsanzahl

Um die Anzahl zu erhalten, die sich aus einer großen Anzahl von Aufträgen ergeben, sollten Sie eine lokale Installation der Quantum Development Kit Tools durchführen. Bei einer lokalen Installation können Sie die Auftrags-IDs lokal speichern.

Sie können den folgenden Code kopieren, um die Liste der Aufträge und deren Ergebnisse abzurufen:

for job in workspace.list_jobs():
    print(job.id, job.details.name, job.details.output_data_uri)

Auftragsabbruch

Wenn sich ein Auftrag noch nicht in einem endgültigen Zustand befindet (z. Bsucceeded, failed, oder cancelled), können Sie anfordern, den Auftrag abzubrechen. Alle Anbieter brechen Ihren Auftrag ab, wenn er sich im Zustand waiting befindet. Allerdings unterstützen nicht alle Anbieter den Abbruch, wenn sich Ihr Auftrag im Zustand executing befindet.

Hinweis

Wenn Sie einen Auftrag stornieren, nachdem er begonnen hat zu laufen, kann Ihrem Konto dennoch ein Teil- oder Gesamtbetrag für diesen Auftrag in Rechnung gestellt werden. Weitere Informationen finden Sie in der Abrechnungsdokumentation Ihres ausgewählten Anbieters.