通过

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

使用 azure-quantum Python 包连接到 Azure Quantum 工作区

  • 项目

创建 Azure Quantum 工作区后，可以使用 Python 包连接到它并提交代码 azure-quantum 。 该 azure-quantum 包提供表示 Workspace Azure Quantum 工作区的类 。

先决条件

使用连接字符串进行连接

可以使用连接字符串指定 Azure Quantum 工作区的连接参数。 在以下方案中，可以使用连接字符串：

  • 你希望与没有 Azure 帐户的其他人共享工作区访问权限。
  • 你想要在有限的时间内与他人共享工作区访问权限。
  • 由于公司策略，无法使用 Microsoft Entra ID。

提示

每个 Azure Quantum 工作区都有主密钥和辅助密钥及其相应的连接字符串。 如果希望允许他人访问工作区，可以共享辅助密钥，并将主密钥用于自己的服务。 这样，就可以根据需要替换辅助密钥，而无需在自己的服务中停机。 有关共享工作区访问权限的详细信息，请参阅 “共享工作区访问权限”。

复制连接字符串

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

  2. 在左侧面板中，导航到 “操作 > 访问”键。

  3. 必须启用访问密钥 。 如果禁用访问密钥，则需要先启用它们。 了解如何在“管理访问密钥”中执行此操作。

  4. 单击“复制”图标以复制连接字符串。 可以选择主要或辅助连接字符串。

    显示如何复制连接字符串的Azure 门户屏幕截图。

警告

以明文形式存储帐户访问密钥或连接字符串会带来安全风险，不建议这样做。 以加密格式存储帐户密钥，或迁移应用程序以使用 Microsoft Entra 授权访问 Azure Quantum 工作区。

使用连接字符串访问 Azure Quantum 工作区

复制连接字符串后，可以使用它连接到 Azure Quantum 工作区。

如果使用的是 Python 环境，可以创建一个 Workspace 对象以连接到 Azure Quantum 工作区。 创建 Workspace 对象时，有两个选项用于标识 Azure Quantum 工作区。

  • 可以通过调用from_connection_string创建对象Workspace。

    # Creating a new Workspace object from a connection string 
from azure.quantum import Workspace 

connection_string = "[Copy connection string]" 
workspace = Workspace.from_connection_string(connection_string) 

print(workspace.get_targets())

  • 如果不想在代码中复制连接字符串，还可以将连接字符串存储在环境变量中并使用Workspace()。

    # Using environment variable to connect with  connection string

connection_string = "[Copy connection string]" 

import os 

os.environ["AZURE_QUANTUM_CONNECTION_STRING"] = connection_string 

from azure.quantum import Workspace 

workspace = Workspace() 
print(workspace.get_targets())

有关如何启用/禁用和重新生成密钥的详细信息，请参阅 “管理访问密钥”。

重要

禁用访问密钥后，使用连接字符串或访问密钥的所有请求均未经授权。 你仍然可以使用工作区参数连接到工作区。

使用工作区参数进行连接

每个 Azure Quantum 工作区都有一组唯一的参数，可用于连接到它。 可以使用以下参数连接到 Azure Quantum 工作区：

参数 说明
subscription_id Azure 订阅 ID。
resource_group Azure 资源组名称。
name Azure Quantum 工作区的名称。
location 预配 Azure Quantum 工作区的 Azure 区域。 这可以指定为区域名称，例如“美国东部”或位置名称，例如“eastus”。
resource_id Azure Quantum 工作区的 Azure 资源 ID。

可以在 azure Quantum 工作区概述中找到Azure 门户中的工作区参数。

  1. 登录到 Azure 帐户， https://portal.azure.com

  2. 选择 Azure Quantum 工作区，然后导航到 “概述”。

  3. 复制字段中的参数。

    Visual Studio Code 的屏幕截图，其中显示了如何展开 Quantum 工作区的概述窗格。

使用工作区参数连接到 Azure Quantum 工作区

创建一个 Workspace 对象以连接到 Azure Quantum 工作区。 创建 Workspace 对象时，有两个选项用于标识 Azure Quantum 工作区。

  • 可以指定位置和资源 ID（建议）：

    from azure.quantum import Workspace 

workspace = Workspace(  
    resource_id = "", # Add the resource ID of your workspace
    location = "" # Add the location of your workspace (for example "westus")
    )

  • 可以指定位置、订阅 ID、资源组和工作区名称：

    from azure.quantum import Workspace 

workspace = Workspace(  
    subscription_id = "", # Add the subscription ID of your workspace
    resource_group = "", # Add the resource group of your workspace
    workspace_name = "", # Add the name of your workspace
    location = "" # Add the location of your workspace (for example "westus")
    )

相关内容