`%azure.target`

아티클
02/09/2024

경고

이 설명서는 최신 QDK로 대체된 클래식 QDK를 참조합니다.

최신 QDK는 '%%qsharp' 매직 명령만 지원합니다.

요약

Azure Quantum 작업 영역의 Q# 작업 제출에 대한 활성 실행 대상을 설정하거나 표시합니다.

Description

이 매직 명령을 사용하면 Azure Quantum 작업 영역에서 Q# 작업 제출에 대한 실행 대상을 지정하거나 표시할 수 있습니다.

이전에 매직 명령 매직 명령을 사용하여%azure.connect Azure Quantum 작업 영역을 초기화해야 합니다. 지정된 실행 대상은 작업 영역에서 사용할 수 있어야 하며 Q# 프로그램의 실행을 지원해야 합니다.

선택적 매개 변수

Q# 작업 제출의 활성 실행 대상으로 설정할 대상 ID입니다. 지정하지 않으면 현재 활성 실행 대상이 표시됩니다.

가능한 오류

NotConnected: Azure Quantum 작업 영역에 연결되지 않았습니다.
InvalidTarget: 지정된 대상이 이 작업 영역에서 사용하도록 설정되지 않았습니다. 대상 이름이 유효하고 연결된 공급자가 작업 영역에 추가되었는지 확인하세요. Azure Portal에서 양자 작업 영역에 공급자를 추가하려면 https://aka.ms/AQ/Docs/AddProvider
NoTarget: Azure Quantum 작업 제출에 대해 실행 대상이 구성되지 않았습니다.

대상 기능

대상을 설정할 때 대상 기능은 지정된 대상에서 지원하는 최대 기능 수준으로 설정되므로 대상에서 허용하는 모든 기능이 후속 Q# 컴파일 함수 및 작업에서 허용됩니다.

를 사용하여 qsharp.azure.target_capability()대상 기능 수준을 추가로 제한할 수 있습니다. 이는 instance 서로 다른 대상 간의 기능을 비교할 때 유용할 수 있습니다.

에 대한 예제 `%azure.target`

예 1

Q# 작업 제출의 현재 대상을 로 provider.qpu설정합니다.

In []: %azure.target provider.qpu
Out[]: Loading package Microsoft.Quantum.Providers.Provider and dependencies...
        Active target is now provider.qpu
        <detailed properties of active execution target>

예 2

현재 대상 정보를 지웁니다.

In []: %azure.target --clear

예제 3

현재 Azure Quantum 작업 영역에서 현재 대상 및 사용 가능한 모든 대상을 표시합니다.

In []: %azure.target
Out[]: Current execution target: provider.qpu
        Available execution targets: provider.qpu, provider.simulator
        <detailed properties of active execution target>

%azure.target

요약