Подключение к рабочей области Azure Quantum с помощью QDK или Azure CLI

Если у вас есть рабочая область Azure Quantum, вы можете подключиться к своей рабочей области и отправить свой код с помощью qdk.azure модуля Python. Модуль qdk.azure предоставляет Workspace класс , представляющий рабочую область Azure Quantum.

Предварительные условия

Чтобы подключиться к рабочей области с помощью модуля qdk.azure, вам потребуется следующее:

  • Учетная запись Azure с активной подпиской. Если у вас нет учетной записи Azure, зарегистрируйтесь бесплатно и зарегистрируйтесь для подписки с оплатой по мере использования.

  • Рабочая область Azure Quantum. Если у вас нет рабочей области, см. Создание рабочей области Azure Quantum.

  • Последняя версия пакета python qdk с дополнительным компонентом azure.

    pip install --upgrade "qdk[azure]"
    

Если вы используете Azure CLI, обновите его до последней версии. Для получения инструкций по установке, см. документацию.

Подключитесь с помощью строки подключения

Используйте строка подключения, чтобы указать параметры подключения к рабочей области Azure Quantum. Строки подключения полезны в следующих сценариях:

  • Вы хотите предоставить доступ к рабочей области другим пользователям, у которых нет учетной записи Azure.
  • Вы хотите предоставить доступ к рабочей области другим пользователям в течение ограниченного времени.
  • Не удается использовать идентификатор Microsoft Entra из-за политик компании.

Совет

Каждая рабочая область Azure Quantum имеет первичный ключ и вторичный ключ, и каждый ключ имеет собственную строку подключения. Чтобы разрешить другим пользователям доступ к рабочей области, предоставить общий доступ к вторичному ключу и использовать первичный ключ только для собственных служб. Вторичный ключ можно заменить, не вызывая простоя в собственных службах. Дополнительные сведения о совместном доступе к рабочей области см. в статье "Общий доступ к рабочей области".

Копирование строки подключения

  1. Войдите на портал Azure.
  2. Перейдите в рабочую область Azure Quantum.
  3. На панели рабочей области разверните раскрывающийся список "Операции" и выберите ключи доступа.
  4. Включите ключи доступа для рабочей области. Если ползунок "Ключи доступа " имеет значение "Отключено", установите для ползунка значение "Включено".
  5. Выберите значок Copy рядом со строкой подключения, которую вы хотите скопировать. Можно выбрать основную или вторичную строку подключения.

Предупреждение

Это угроза безопасности хранить ключи доступа к учетной записи или строки подключения в открытом виде. Сохраните ключи учетной записи в зашифрованном формате или переносите приложения, чтобы использовать авторизацию Microsoft Entra для доступа к рабочей области Azure Quantum.

Используйте строку подключения для доступа к рабочей области Azure Quantum

Используйте строку подключения, которую вы скопировали, чтобы подключиться к рабочей области Azure Quantum с помощью модуля qdk.azure или расширения QDK в Visual Studio Code.

Чтобы подключиться к рабочей области 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. Azure CLI
resource_group Имя группы ресурсов Azure. Azure CLI
name Имя рабочей области Azure Quantum. Azure CLI
resource_id Идентификатор ресурса Azure рабочей области Azure Quantum. Python

Чтобы найти параметры рабочей области, выполните следующие действия.

  1. Войдите на портал Azure.
  2. Перейдите в рабочую область Azure Quantum.
  3. На панели рабочей области выберите "Обзор".
  4. Разверните раскрывающееся меню Essentials.
  5. Скопируйте параметры в соответствующие поля.

Замечание

Прежде чем подключаться к рабочей области, убедитесь, что вы вошли в правильный арендатор. Дополнительные сведения о клиентах см. в статье "Управление подписками Azure с помощью Azure CLI".

Использование параметров рабочей области для подключения к рабочей области Azure Quantum

Чтобы оставаться в системе при запуске скриптов Python, откройте терминал и выполните следующую команду Azure CLI. Эта команда устанавливает подписку для вашего рабочего пространства. Замените <subscriptionId> идентификатором своей подписки.

az account set --subscription <subscriptionId>

Параметры рабочей области можно использовать для подключения к рабочей области Azure Quantum через qdk.azure модуль или через Azure CLI.

Чтобы подключиться к рабочей области Azure Quantum, выберите один из следующих вариантов.

  • Укажите идентификатор ресурса (рекомендуется):

    from qdk.azure import Workspace 
    
    workspace = Workspace(resource_id="") # Add the resource ID of your workspace
    
  • Укажите идентификатор подписки, группу ресурсов и имя рабочей области:

    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