QDK または Azure CLI で Azure Quantum ワークスペースに接続する

Azure Quantum ワークスペースがある場合は、qdk.azurePython 接続モジュールを使用してワークスペースに接続し、Azure Quantum で実行するコードを送信できます。 qdk.azure モジュールは、ワークスペースを表すWorkspaceを提供します。

警告

2027 年 1 月 11 日以降、 Azure Quantum では、Quantum ワークスペースのユーザーに、ジョブの結果を表示するための Quantum ワークスペース データ 閲覧者 ロールまたは Quantum ワークスペース データ共同作成者 ロールが必要です。 ジョブを送信するには、Quantum ワークスペース データ共同作成者 ロールが必要となります。 Azure Quantum ワークフローの中断を回避するには、期限前にこれらのロールを適切なユーザーに割り当てます。 詳細については、「 ワークスペース内のユーザーにデータ アクセス ロールを割り当てる」を参照してください。

前提条件

qdk.azure モジュールを使用してワークスペースに接続するには、次のものが必要です。

  • アクティブなサブスクリプションが含まれる Azure アカウント。 Azure アカウントをお持ちでない場合は、無料で登録し、従量課金制サブスクリプションにサインアップしてください。

  • あるAzure Quantumワークスペース。 ワークスペースがない場合は、「ワークスペースを作成するAzure Quantum」を参照してください。

  • azure qdk パッケージのPython追加機能付き最新バージョン。

    pip install --upgrade "qdk[azure]"

Azure CLIを使用する場合は、最新バージョンに更新してください。 インストール手順については、以下を参照してください。

Azure アカウントで接続する

Azure アカウントを使用して、QDK (Azure Quantum) の VS Code (Microsoft Quantum Development Kit) 拡張機能で Visual Studio Code ワークスペースに接続します。

  1. VS Code を開きます。
  2. [ 表示>コマンド パレット] を選択します。
  3. 入力して QDK を選択: Azure Quantum ワークスペースに接続します。
  4. Azure アカウントを選択します。
  5. QDKメッセージに VS Code がサインインしようとしていますと表示されたら、[許可] を選択します。
  6. 使用するアカウントを選択します。
  7. テナントとサブスクリプションを選択します。

Azure Quantum 自分のワークスペースを表示するには、アクティビティ バーの Microsoft Quantum アイコンを選択します。

Microsoft Quantum のアクティビティ バーにある Visual Studio Code パネル アイコンのスクリーンショット。

接続文字列を使用して接続する

注

接続文字列は、Azure アカウントよりも安全性が低くなります。

接続文字列を使用して、Azure Quantum ワークスペースの接続パラメーターを指定します。 接続文字列は、次の場合に便利です。

  • ワークスペースへのアクセス権を、Azure アカウントを持たない他のユーザーと共有する必要があります。
  • 限られた期間、ワークスペースへのアクセスを他のユーザーと共有する必要があります。
  • 会社のポリシーのため、 Microsoft Entra ID を使用することはできません。

ヒント

すべてのAzure Quantum ワークスペースには主キーとセカンダリ キーがあり、各キーには独自の接続文字列があります。 他のユーザーがワークスペースを使用できるようにするには、セカンダリ キーを共有し、独自のサービス用にプライマリ キーを保持します。 そうすることで、サービスでダウンタイムを発生させることなく、セカンダリ キーを置き換えることができます。 ワークスペースへのアクセスの共有の詳細については、「ワークスペースアクセス を共有する」を参照してください。

接続文字列のコピー

  1. Azure portal にサインインする
  2. Azure Quantum ワークスペースに移動してください。
  3. ワークスペース パネルで、[ 操作 ] ドロップダウンを展開し、[ アクセス キー] を選択します。
  4. [アクセス キー] スライダーが [無効] に設定されている場合は、[有効] に設定します。
  5. コピーする接続文字列の コピー アイコンを選択します。 プライマリ接続文字列またはセカンダリ接続文字列を選択できます。

警告

アカウント アクセス キーまたは接続文字列をクリア テキストで格納することは、セキュリティ上のリスクです。 アカウント キーを暗号化された形式で保存するか、Azure Quantum ワークスペースに対して Microsoft Entra 承認を使用するようにアプリを移行します。

接続文字列を使用してAzure Quantum ワークスペースにアクセスする

コピーした接続文字列を使用して、Azure Quantum で VS Code モジュールまたは QDK 拡張機能を使用して qdk.azure ワークスペースに接続します。

Azure Quantum ワークスペースに接続するには、次のいずれかの方法を選択します。

  • from_connection_string関数を使用して、Workspace オブジェクトを作成します。

    from qdk.azure import Workspace 

connection_string = "<ConnectionString>" # Replace with your connection string
workspace = Workspace.from_connection_string(connection_string) 

print(workspace.get_targets())

  • 環境変数に接続文字列を格納します。

    import os
from qdk.azure import Workspace 

connection_string = "<ConnectionString>" # Replace with your connection string
os.environ["AZURE_QUANTUM_CONNECTION_STRING"] = connection_string 

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

キーの操作方法の詳細については、「 アクセス キーを使用してワークスペースで認証する」を参照してください。

重要

ワークスペースのアクセス キーを無効にした場合、接続文字列で接続することはできません。 代わりにワークスペース パラメーターを使用してください。

ワークスペース パラメーターを使用してワークスペースに接続する

すべての Azure Quantum ワークスペースには、ワークスペースへの接続に使用する一意のパラメーター セットがあります。

パラメーター 説明 接続時に使用する
subscription_id Azure サブスクリプション ID。 Azure CLI
resource_group Azure リソース グループ名です。 Azure CLI
name Azure Quantum ワークスペースの名前。 Azure CLI
resource_id Azure Quantum ワークスペースのAzure リソース ID。 Python

ワークスペースのパラメーターを見つけるには、次の手順に従います。

  1. Azure portal にサインインする
  2. Azure Quantum ワークスペースに移動してください。
  3. ワークスペース パネルから、概要を選択します。
  4. [ 要点 ] ドロップダウンを展開します。
  5. 対応するフィールドからパラメーターをコピーします。

注

ワークスペースに接続する前に、必ず正しいテナントにサインインしてください。 テナントについての詳細は、「Azure サブスクリプションを Azure CLI で管理する方法」を参照してください。

ワークスペース パラメーターを使用して Azure Quantum ワークスペースに接続してください

Python スクリプトの実行時にサインインを維持するには、ターミナルを開き、次の Azure CLI コマンドを実行してワークスペースで使用するサブスクリプションを設定します。 <subscriptionId> は、サブスクリプション ID で置き換えてください。

az account set --subscription <subscriptionId>

ワークスペース パラメーターを使用して、Azure CLI モジュールまたは Azure Quantum を介して qdk.azure ワークスペースに接続します。

Azure Quantum ワークスペースに接続するには、次のいずれかのオプションを選択します。

  • リソース ID を指定します (推奨)。

    from qdk.azure import Workspace 

workspace = Workspace(resource_id="") # Add the resource ID of your workspace

  • サブスクリプション ID、リソース グループ、ワークスペース名を指定します。

    from qdk.azure import Workspace 

workspace = Workspace(  
    subscription_id="", # Add the subscription ID of your workspace
    resource_group="", # Add the resource group of your workspace
    name="" # Add the name of your workspace
    )

  • ワークスペース名のみを指定します。 同じテナント内に同じ名前のワークスペースが複数ある場合、このオプションは失敗する可能性があります。

    from qdk.azure import Workspace 
workspace = Workspace(name="") # Add the name of your workspace

関連するコンテンツ

  • 最終更新: