次の方法で共有

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 portal にログインし、Azure Quantum ワークスペースを選択します。

  2. 左側のパネルで、Operations > Access キーに移動します。

  3. アクセス キー を有効にする必要があります。 アクセス キーが無効になっている場合は、最初に有効にする必要があります。 アクセス キーの管理でこれを行う方法を確認します。

  4. [コピー] アイコンをクリックして、接続文字列をコピーします。 プライマリ 接続文字列またはセカンダリ 接続文字列を選択できます。

    接続文字列をコピーする方法を示す Azure portal のスクリーンショット。

警告

アカウント のアクセス キーまたは接続文字列をクリア テキストに格納すると、セキュリティ 上のリスクが伴うので、お勧めしません。 暗号化された形式でアカウント キーを格納するか、Azure Quantum ワークスペースへのアクセスに Microsoft Entra 承認を使用するようにアプリケーションを移行します。

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

接続文字列をコピーしたら、それを使用して Azure Quantum ワークスペースに接続できます。

Python 環境を使用している場合は、Azure Quantum ワークスペースに接続するオブジェクトを作成 Workspace できます。 オブジェクトを Workspace 作成するときは、Azure Quantum ワークスペースを識別するための 2 つのオプションがあります。

  • を呼び出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 portal の Azure Quantum ワークスペースの概要で確認できます。

  1. Azure アカウントにログインします。 https://portal.azure.com

  2. Azure Quantum ワークスペースを選択し、[概要] に移動します。

  3. フィールド内のパラメーターをコピーします。

    Quantum ワークスペースの概要ウィンドウを展開する方法を示す Visual Studio Code のスクリーンショット。

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

Workspace Azure Quantum ワークスペースに接続するオブジェクトを作成します。 オブジェクトを Workspace 作成するときは、Azure Quantum ワークスペースを識別するための 2 つのオプションがあります。

  • 場所とリソース 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")
    )

関連するコンテンツ