共用方式為

使用 azure-quantum Python 套件連線到您的 Azure Quantum 工作區

  • 發行項

建立 Azure Quantum 工作區之後，您就可以連線到該工作區，並使用 azure-quantum Python 套件提交程式代碼。 套件 azure-quantum 提供代表 Workspace Azure Quantum 工作區的類別 。

必要條件

使用連接字串進行連線

您可以使用 連接字串 來指定 Azure Quantum 工作區的連線參數。 在下列案例中，您可以使用 連接字串：

  • 您想要與沒有 Azure 帳戶的其他人共用工作區存取權。
  • 您想要在有限的時間內與其他人共用工作區存取權。
  • 由於公司原則，您無法使用 Microsoft Entra 識別碼。

提示

每個 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 訂閱識別碼。
resource_group Azure 資源群組名稱。
name Azure Quantum 工作區的名稱。
location 布建 Azure Quantum 工作區的 Azure 區域。 這可以指定為區域名稱，例如「美國東部」或位置名稱，例如 「eastus」。。
resource_id Azure Quantum 工作區的 Azure 資源識別碼。

您可以在 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 工作區。

  • 您可以指定位置和資源識別碼（建議）：

    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")
    )

  • 您可以指定位置、訂用帳戶標識碼、資源群組和工作區名稱：

    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")
    )

相關內容