Azure Quantum 작업 영역이 있는 경우 작업 영역에 연결하고 Python 모듈을 사용하여 qdk.azure 코드를 제출할 수 있습니다. 이 모듈은 qdk.azure Azure Quantum 작업 영역을 나타내는 클래스를 제공합니다Workspace.
필수 조건
qdk.azure 모듈을 사용하여 작업 영역에 연결하려면, 다음이 필요합니다.
활성 구독이 있는 Azure 계정. Azure 계정이 없는 경우 무료로 등록하고 종량제 구독에 등록할 수 있습니다.
Azure Quantum 작업 영역 작업 영역이 없는 경우 Azure Quantum 작업 영역 만들기를 참조하세요.
추가 기능이 있는
qdkazurePython 라이브러리의 최신 버전입니다.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(VS Code)를 통해 Azure Quantum 작업 영역에 연결할 수 있습니다.
Workspace Azure Quantum 작업 영역에 연결할 개체를 만듭니다. 개체를 만들 때 Azure Quantum 작업 영역을 식별하는 두 가지 옵션이 있습니다 Workspace .
from_connection_string함수를 호출할 때Workspace개체를 생성합니다.# Create a new Workspace object from a connection string from qdk.azure import Workspace connection_string = "[Copy connection string]" workspace = Workspace.from_connection_string(connection_string) print(workspace.get_targets())코드에서 연결 문자열을 복사하지 않으려면 연결 문자열을 환경 변수에 저장하고 사용합니다
Workspace().# Use an environment variable to connect with your connection string connection_string = "[Copy connection string]" import os os.environ["AZURE_QUANTUM_CONNECTION_STRING"] = connection_string from qdk.azure import Workspace workspace = Workspace() print(workspace.get_targets())
키로 작업하는 방법에 대한 자세한 내용은 액세스 키 관리를 참조하세요.
중요한
작업 영역에 대한 액세스 키를 사용하지 않도록 설정하면 연결 문자열을 사용하여 작업 영역에 연결할 수 없습니다. 하지만 작업 영역 매개 변수를 사용하여 작업 영역에 연결할 수 있습니다.
작업 영역 매개 변수를 사용하여 작업 영역에 연결
모든 Azure Quantum 작업 영역에는 작업 영역에 연결하는 데 사용할 수 있는 고유한 매개 변수 집합이 있습니다. 다음 매개 변수를 사용하여 Azure 작업 영역에 연결할 수 있습니다.
| 매개 변수 | 설명 |
|---|---|
subscription_id |
Azure 구독 ID. |
resource_group |
Azure 리소스 그룹 이름입니다. |
name |
Azure Quantum 작업 영역의 이름입니다. |
location |
작업 영역이 있는 Azure 지역입니다. |
resource_id |
Azure Quantum 작업 영역의 Azure 리소스 ID입니다. |
작업 영역 매개 변수를 찾으려면 다음 단계를 수행합니다.
- Azure Portal에 로그인합니다.
- Azure Quantum 작업 영역으로 이동합니다.
- 작업 영역 패널에서 개요를 선택합니다.
- Essentials 드롭다운을 확장합니다.
- 해당 필드에 매개 변수를 복사합니다.
비고
작업 영역에 연결하기 전에 올바른 테넌트에 로그인해야 합니다. 테넌트에 대한 자세한 내용은 Azure CLI를 사용하여 Azure 구독을 관리하는 방법을 참조하세요.
작업 영역 매개 변수를 사용하여 Azure Quantum 작업 영역에 연결
Python 스크립트를 실행할 때 로그인 상태를 유지하려면 작업 영역 매개 변수를 사용하여 작업 영역에 연결하기 전에 터미널을 열고 다음 Azure CLI 명령을 실행하여 작업 영역에 대한 구독을 설정합니다.
<subscriptionId>는 구독 ID로 바꿉니다.
az account set --subscription <subscriptionId>
작업 영역 매개변수를 사용하여 qdk.azure 모듈 또는 Azure CLI를 사용하여 Azure Quantum 작업 영역에 연결할 수 있습니다.
Workspace Azure Quantum 작업 영역에 연결할 개체를 만듭니다. Azure Quantum 작업 영역을 식별하는 세 가지 옵션이 있습니다 Workspace 객체를 만들 때.
리소스 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