Uso de trabajos en Azure Quantum

Al ejecutar un programa cuántico en Azure Quantum, creará y ejecutará un trabajo. Los pasos para crear y ejecutar un trabajo dependen del tipo de trabajo y del proveedor y target que configure para el área de trabajo.

Propiedades del trabajo

Todos los trabajos tienen las siguientes propiedades en común:

Propiedad	Descripción
Id	Un identificador único del trabajo. Debe ser único en el área de trabajo.
Proveedor	Quién desea que ejecute el trabajo.
Target	En qué desea ejecutar el trabajo. Por ejemplo, el hardware cuántico exacto o el simulador cuántico que ofrece el proveedor.
Nombre	Un nombre definido por el usuario para ayudar a organizar los trabajos.
Parámetros	Parámetros de entrada opcionales para targets. Consulte la documentación de la selección target para obtener una definición de los parámetros disponibles.

Una vez creado un trabajo, hay disponibles distintos metadatos sobre el estado y el historial de ejecución.

Ciclo de vida de trabajo

Una vez que haya escrito el programa cuántico, puede seleccionar y target enviar el trabajo.

En este diagrama se muestra el flujo de trabajo básico después de enviar el trabajo:

En primer lugar, Azure Quantum carga el trabajo en la cuenta Azure Storage que configuró en el área de trabajo. A continuación, el trabajo se agrega a la cola de trabajo para el proveedor que especificó en él. Entonces, Azure Quantum descarga el programa y lo traduce para el proveedor. El proveedor procesa el trabajo y devuelve la salida a Azure Storage, donde está disponible para su descarga.

Supervisión de trabajos

Una vez enviado un trabajo, puede supervisar el estado del trabajo. Los trabajos tienen los siguientes estados posibles:

Estado	Description
waiting	El trabajo está a la espera para ejecutarse. Algunos trabajos realizarán tareas de procesamiento previo mientras están en estado de espera. waiting es siempre el primer estado, sin embargo, un trabajo puede pasar al estado executing antes de poder observarlo en waiting.
executing	target está ejecutando actualmente el trabajo.
succeeded	El trabajo se ha realizado correctamente y la salida está disponible. Este es un estado final.
failed	Se ha producido un error en el trabajo y hay disponible información sobre él. Este es un estado final.
cancelled	El usuario solicitó cancelar la ejecución del trabajo. Este es un estado final. Para obtener más información, consulte Cancelación de trabajos en este artículo.

Los estados succeeded, failed y cancelled se consideran estados finales. Una vez que un trabajo se encuentra en uno de estos estados, no se producen más actualizaciones y los datos de salida del trabajo correspondiente no cambian.

En este diagrama se muestran las posibles transiciones de estado del trabajo:

Una vez que un trabajo se completa correctamente, muestra un vínculo a los datos de salida en la cuenta de Azure Storage. La forma de acceder a estos datos depende del SDK o de la herramienta que usó para enviar el trabajo.

Supervisión de trabajos

Puede supervisar trabajos a través de Python, Azure Portal y la CLI de Azure.

Python

Todas las propiedades del trabajo son accesibles en job.details. Por ejemplo, puede acceder al nombre, el estado y el identificador del trabajo de la siguiente manera:

Python

print(job.details)
print("\nJob name:", job.details.name)
print("Job status:", job.details.status)
print("Job ID:", job.details.id)

Output

{'additional_properties': {'isCancelling': False}, 'id': '0fc396d2-97dd-11ee-9958-6ca1004ff31f', 'name': 'MyPythonJob', 'provider_id': 'rigetti'...}
Job name: MyPythonJob
Job status: Succeeded
Job ID: fc396d2-97dd-11ee-9958-6ca1004ff31f

Azure Portal

Puede ver el estado del trabajo en Azure Portal, incluido el identificador de trabajo, target, el estado, el tiempo de envío y la estimación de costos, si procede.

Para supervisar trabajos en Azure Portal:

1. Inicie sesión en Azure Portal.

2. En el área de trabajo de Azure Quantum, seleccione Administración de trabajos de operaciones>.

3. Se muestra una lista de trabajos a los que tiene permiso de acceso. Puede comprobar el identificador de trabajo, el tipo, , targetel estado, el tiempo de envío y la estimación de costos, si procede.

   

4. Haga clic en el nombre del trabajo para ver detalles adicionales, como los parámetros de entrada y la entrada y salida del trabajo.

CLI de Azure

Para comprobar el estado del trabajo, copie el identificador del trabajo y use el job show comando . Por ejemplo:

Azure CLI

az quantum job show --job-id b0012975-744a-4405-970e-3d8dc4afb2c0 -o table

Output

Name      Id                                    Status     Target           Submission time                   Completion time                  
--------  ------------------------------------  ---------  ---------------  --------------------------------  -------------------------------- 
MyQuantumJob  b2f07cc4-b49b-40b0-b63b-9a4885e5fef5  Succeeded  rigetti.sim.qvm  2023-12-11T05:33:23.187773+00:00  2023-12-11T05:33:29.252742+00:00 

Recuentos de trabajos

Para obtener recuentos resultantes de un gran número de trabajos, puede que desee realizar una instalación local de las Quantum Development Kit herramientas. Con una instalación local, puede almacenar los identificadores de trabajo localmente.

Puede copiar el código siguiente para obtener la lista de trabajos y sus resultados:

Python

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

Cancelación de trabajos

Cuando un trabajo aún no está en un estado final (por ejemplo, succeeded, failed o cancelled), puede solicitar la cancelación del trabajo. Todos los proveedores cancelarán el trabajo si se encuentra en el estado waiting. Sin embargo, no todos los proveedores admiten la cancelación si el trabajo está en el estado executing.

Nota

Si cancela un trabajo después de que haya empezado a ejecutarse, es posible que se le facture a su cuenta la cantidad total o parcial por ese trabajo. Consulte la documentación de facturación del proveedor seleccionado.