Azure Quantum ワークスペースがある場合は、ワークスペースに接続し、qdk.azure Python モジュールを使用してコードを送信できます。
qdk.azure モジュールは、Azure Quantum ワークスペースを表すWorkspace クラスを提供します。
前提条件
qdk.azure モジュールを使用してワークスペースに接続するには、次のものが必要です。
アクティブなサブスクリプションが含まれる Azure アカウント。 Azure アカウントをお持ちでない場合は、無料で登録し、従量課金制サブスクリプションにサインアップ してください。
Azure Quantum ワークスペース。 ワークスペースがない場合は、「Azure Quantum ワークスペースを作成する」を参照してください。
qdkextra 付きのazurePython パッケージの最新バージョン。pip install --upgrade "qdk[azure]"
Azure CLIを使用する場合は、最新バージョンに更新します。 インストール手順については、以下を参照してください。
接続文字列を使用して接続する
接続文字列を使用して、Azure Quantum ワークスペースへの接続パラメーターを指定します。 接続文字列は、次のシナリオで役立ちます。
- ワークスペースへのアクセス権を、Azure アカウントを持たない他のユーザーと共有する必要があります。
- 限られた期間、ワークスペースへのアクセスを他のユーザーと共有する必要があります。
- 会社のポリシーのため、Microsoft Entra ID を使用することはできません。
ヒント
すべての Azure Quantum ワークスペースには主キーとセカンダリ キーがあり、各キーには独自の接続文字列があります。 他のユーザーがワークスペースにアクセスできるようにするには、セカンダリ キーを共有し、独自のサービスにのみ主キーを使用します。 セカンダリ キーは、独自のサービスでダウンタイムを発生させることなく置き換えることができます。 ワークスペースへのアクセスの共有の詳細については、「ワークスペースアクセス を共有する」を参照してください。
接続文字列のコピー
- Azure portal にサインインする
- Azure Quantum ワークスペースに移動します。
- ワークスペース パネルで、[ 操作 ] ドロップダウンを展開し、[ アクセス キー] を選択します。
- ワークスペースのアクセス キーを有効にします。 [アクセス キー] スライダーが [無効] に設定されている場合は、スライダーを [有効] に設定します。
- コピーする接続文字列の コピー アイコンを選択します。 プライマリ接続文字列またはセカンダリ接続文字列を選択できます。
警告
アカウント アクセス キーまたは接続文字列をクリア テキストに格納することはセキュリティ上のリスクです。 暗号化された形式でアカウント キーを格納するか、Azure Quantum ワークスペースへのアクセスに Microsoft Entra 承認を使用するようにアプリケーションを移行します。
接続文字列を使用して Azure Quantum ワークスペースにアクセスする
コピーした接続文字列を使用して、qdk.azure モジュールまたは Visual Studio Code の QDK 拡張機能を使用してAzure Quantum ワークスペースに接続します。
Azure Quantum ワークスペースに接続するには、次のいずれかの方法を選択します。
from_connection_string関数を使用して、Workspaceオブジェクトを作成します。from qdk.azure import Workspace connection_string = "" # Add your connection string workspace = Workspace.from_connection_string(connection_string) print(workspace.get_targets())環境変数に接続文字列を格納します。
import os from qdk.azure import Workspace connection_string = "" # Add 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 |
ワークスペースのパラメーターを見つけるには、次の手順に従います。
- Azure portal にサインインする
- Azure Quantum ワークスペースに移動します。
- ワークスペース パネルで、[ 概要] を選択します。
- [ 要点 ] ドロップダウンを展開します。
- 対応するフィールドのパラメーターをコピーします。
注
ワークスペースに接続する前に、必ず正しいテナントにサインインしてください。 テナントの詳細については、「 Azure CLI を使用して Azure サブスクリプションを管理する方法」を参照してください。
ワークスペース パラメーターを使用して Azure Quantum ワークスペースに接続する
Python スクリプトの実行時にサインインを維持するには、ターミナルを開き、次の Azure CLI コマンドを実行します。 このコマンドは、ワークスペースのサブスクリプションを設定します。
<subscriptionId> は、サブスクリプション ID で置き換えてください。
az account set --subscription <subscriptionId>
ワークスペース パラメーターを使用して、qdk.azure モジュールまたはAzure CLIを使用して、Azure Quantum ワークスペースに接続できます。
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