你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Q# 和 Azure Quantum 笔记本入门

  • 项目

提示

首次使用的用户在创建工作区时会自动获得 500 美元免费 Azure Quantum 额度，可以在每家参与方提供商的量子硬件上使用。 如果你已用完所有额度，且需要更多额度，可以申请 Azure Quantum 额度计划。 有关详细信息，请参阅申请 Azure Quantum 额度计划。

了解如何在 Azure Quantum 门户中运行 Jupyter 笔记本中的 Q# 代码。 Jupyter 笔记本是包含丰富格式文本和代码的文档，可以在浏览器中运行，并且可以在 Azure Quantum 中运行 Q# 和 Python 代码。 可以直接在 Azure Quantum 门户中创建笔记本，它们提供预加载连接信息和标准 Q# 库等功能。

在本文中，你将在 Azure Quantum 上运行一个示例笔记本，该笔记本执行一个以 Q# 和 Python 编写的简单量子随机数生成器。

有关将 Jupyter 笔记本与 Azure Quantum 结合使用的详细信息，请参阅在 Azure Quantum 工作区中运行 Jupyter 笔记本。

先决条件

在开始之前，需要满足以下在 Azure Quantum 工作区中使用 Jupyter 笔记本的先决条件。

复制示例笔记本

若要开始，请从笔记本库复制一个示例笔记本。

  1. 登录到 Azure 门户并选择你的 Azure Quantum 工作区。

  2. 选择“笔记本”。

  3. 在“示例库”中，找到“Hello, world: Q#”笔记本磁贴，选择“IonQ”或“Quantinuum”提供商（示例代码相同），然后选择“复制到我的笔记本”。

  4. 可以在“我的笔记本”下找到示例笔记本，现在可以运行该笔记本。

    加载示例 Jupyter 笔记本。

运行笔记本

若要运行示例笔记本，请根据所选的提供商执行以下步骤。

  1. 在“我的笔记本”中，选择“hello-world-qsharp-ionq”笔记本。

  2. 若要从前到后运行整个程序，请选择“全部运行”。

  3. 若要演练示例并从前到后分别运行每个单元，请选择要运行的单元，然后选择“运行”图标。

    运行 Jupyter 笔记本。

在 IonQ 上逐步执行程序

“hello world”程序运行一个简单的量子随机数生成器，并显示结果的直方图。

需要注意的一些事项：

  • 内核：在笔记本的右上角，可以看到笔记本正在运行“Python 3 (ipykernel)”内核，这是 Juptyer Notebook 的默认 Python shell。 在 Azure Quantum 中创建笔记本时，可以选择“Python 3 (ipykernel)”或“Azure Quantum Q#”内核。 这两个内核与 Q# 代码完全兼容。
  • 第 1 个单元：预加载订阅信息以连接到 Azure Quantum 服务。
  • 第 2 个单元：检索工作区中可用的目标（量子计算机和模拟器）。
  • 第 3 和第 4 个单元：用于定义程序的 Q# 代码。 请注意 %%qsharp magic 命令，使用“Python 3 (ipykernel)”时，可以通过此命令直接在笔记本中输入 Q# 代码。
  • 第 5 个单元：设置目标并提交作业。
  • 第 6 和第 7 个单元：绘制并显示结果。 结果应大致在 0 和 1 之间划分。

注意

如果你对工作区创建过程有任何疑问或者在使用 Azure Quantum 时遇到任何问题，请将 Azure Quantum 办公时间加入书签，并在太平洋标准时区 (PST) 每周四上午 8:30 的营业时间联系我们。

后续步骤