Job 类
提交到给定工作区的 Azure Quantum 作业。
构造函数
Job(workspace: Workspace, job_details: JobDetails, **kwargs)
参数
| 名称 | 说明 |
|---|---|
|
workspace
必需
|
要将作业提交到的工作区实例 |
|
job_details
必需
|
作业详细信息模型,包含作业 ID、名称和其他详细信息 |
方法
| get_results |
通过从通过工作区链接的存储容器下载结果 Blob 来获取作业结果。 如果作业执行失败,则引发 RuntimeError。 ValueError如果作业输出格式不正确或输出格式不兼容,则引发。 JobFailedWithResultsError如果作业执行失败,则引发,但仍可以检索失败结果。 |
| get_results_histogram |
通过从通过工作区链接的存储容器下载结果 blob 来获取作业结果直方图。 如果作业执行失败,则引发 RuntimeError。 ValueError如果作业输出格式不正确或输出格式不兼容,则引发。 如果作业执行失败,则引发 JobFailedWithResultsError,但仍可以检索失败结果(例如针对“microsoft.dft”目标提交的作业)。 |
| get_results_shots |
通过从通过工作区链接的存储容器下载结果 Blob,获取每个快照数据的作业结果。 如果作业执行失败,则引发 RuntimeError。 ValueError如果作业输出格式不正确或输出格式不兼容,则引发。 JobFailedWithResultsError如果作业执行失败,则引发,但仍可以检索失败结果。 |
| has_completed |
检查作业是否已完成。 |
| has_succeeded |
检查作业是否已成功。 |
| refresh |
通过查询工作区来刷新作业的详细信息。 |
| submit |
将作业提交到 Azure Quantum。 |
| wait_until_completed |
不断刷新作业的详细信息,直到作业达到完成状态。 |
get_results
通过从通过工作区链接的存储容器下载结果 Blob 来获取作业结果。
如果作业执行失败,则引发 RuntimeError。
ValueError如果作业输出格式不正确或输出格式不兼容,则引发。
JobFailedWithResultsError如果作业执行失败,则引发,但仍可以检索失败结果。
get_results(timeout_secs: float = 300)
参数
| 名称 | 说明 |
|---|---|
|
timeout_secs
|
超时(以秒为单位,默认值为 300) 默认值: 300
|
返回
| 类型 | 说明 |
|---|---|
|
带有直方图镜头的结果字典,或者原始结果(如果不是 json 对象)。 |
get_results_histogram
通过从通过工作区链接的存储容器下载结果 blob 来获取作业结果直方图。
如果作业执行失败,则引发 RuntimeError。
ValueError如果作业输出格式不正确或输出格式不兼容,则引发。
如果作业执行失败,则引发 JobFailedWithResultsError,但仍可以检索失败结果(例如针对“microsoft.dft”目标提交的作业)。
get_results_histogram(timeout_secs: float = 300)
参数
| 名称 | 说明 |
|---|---|
|
timeout_secs
|
超时(以秒为单位,默认值为 300) 默认值: 300
|
返回
| 类型 | 说明 |
|---|---|
|
带有直方图镜头的结果字典,或者原始结果(如果不是 json 对象)。 |
get_results_shots
通过从通过工作区链接的存储容器下载结果 Blob,获取每个快照数据的作业结果。
如果作业执行失败,则引发 RuntimeError。
ValueError如果作业输出格式不正确或输出格式不兼容,则引发。
JobFailedWithResultsError如果作业执行失败,则引发,但仍可以检索失败结果。
get_results_shots(timeout_secs: float = 300)
参数
| 名称 | 说明 |
|---|---|
|
timeout_secs
|
超时(以秒为单位,默认值为 300) 默认值: 300
|
返回
| 类型 | 说明 |
|---|---|
|
带有直方图镜头的结果字典,或者原始结果(如果不是 json 对象)。 |
has_completed
检查作业是否已完成。
has_completed() -> bool
has_succeeded
检查作业是否已成功。
has_succeeded() -> bool
refresh
通过查询工作区来刷新作业的详细信息。
refresh()
submit
将作业提交到 Azure Quantum。
submit()
wait_until_completed
不断刷新作业的详细信息,直到作业达到完成状态。
wait_until_completed(max_poll_wait_secs=30, timeout_secs=None, print_progress=True) -> None
参数
| 名称 | 说明 |
|---|---|
|
max_poll_wait_secs
|
最长轮询等待时间,默认值为 30 默认值: 30
|
|
timeout_secs
|
超时(以秒为单位)默认为“无” 默认值: None
|
|
print_progress
|
打印“.”以 stdout 显示进度 默认值: True
|
例外
| 类型 | 说明 |
|---|---|
|
如果轮询总时间超过超时,则引发。 |