Conectar-se ao workspace do Azure Quantum com o QDK ou a CLI do Azure

Se você tiver um workspace do Azure Quantum, poderá se conectar ao seu workspace e enviar seu código com o módulo Python qdk.azure. O qdk.azure módulo fornece uma Workspace classe que representa um workspace do Azure Quantum.

Pré-requisitos

Para se conectar ao espaço de trabalho com o módulo qdk.azure, você precisará do seguinte:

  • Uma conta do Azure com uma assinatura ativa. Se você não tiver uma conta da Azure, registre-se gratuitamente e inscreva-se em uma assinatura pague conforme o uso.

  • Um workspace do Azure Quantum. Se você não tiver um espaço de trabalho, consulte Criar um espaço de trabalho do Azure Quantum.

  • A versão mais recente do pacote do Python qdk com o azure extra.

    pip install --upgrade "qdk[azure]"

Se você usar CLI do Azure, atualize para a versão mais recente. Para obter instruções de instalação, consulte:

Conexão com uma cadeia de conexão

Use uma cadeia de conexão para especificar os parâmetros de conexão de um espaço de trabalho do Azure Quantum. As cadeias de conexão são úteis nos seguintes cenários:

  • Você deseja compartilhar o acesso ao seu workspace com outras pessoas que não têm uma conta do Azure.
  • Você deseja compartilhar o acesso ao seu workspace com outras pessoas por um tempo limitado.
  • Você não pode usar a ID do Microsoft Entra devido às políticas da empresa.

Dica

Cada workspace do Azure Quantum tem uma chave primária e uma chave secundária, e cada chave tem sua própria cadeia de conexão. Para permitir que outras pessoas acessem seu workspace, compartilhe a chave secundária e use a chave primária somente para seus próprios serviços. Você pode substituir a chave secundária sem causar interrupção em seus próprios serviços. Para obter mais informações sobre como compartilhar o acesso ao seu workspace, consulte Compartilhar o acesso ao workspace.

Copiar a cadeia de conexão

  1. Entre no portal do Azure.
  2. Vá para o workspace do Azure Quantum.
  3. No painel do workspace, expanda o menu suspenso Operações e selecione Chaves de Acesso.
  4. Habilite as chaves de acesso para seu workspace. Se o controle deslizante de Chaves de Acesso estiver definido como Desabilitado, defina o controle deslizante como Habilitado.
  5. Selecione o ícone Copiar para o cadeia de conexão que você deseja copiar. Você pode escolher a cadeia de conexão primária ou secundária.

Aviso

É um risco de segurança armazenar as chaves de acesso da sua conta ou cadeias de conexão em texto claro. Armazene suas chaves de conta em um formato criptografado ou migre seus aplicativos para usar a autorização do Microsoft Entra para acessar seu workspace do Azure Quantum.

Use a string de conexão para acessar seu workspace do Azure Quantum

Use a cadeia de conexão que você copiou para se conectar ao seu espaço de trabalho do Azure Quantum com o módulo qdk.azure ou a extensão do QDK no Visual Studio Code.

Para se conectar ao workspace Azure Quantum, escolha um dos métodos a seguir.

  • Use a from_connection_string função para criar um Workspace objeto.

    from qdk.azure import Workspace 

connection_string = "" # Add your connection string
workspace = Workspace.from_connection_string(connection_string) 

print(workspace.get_targets())

  • Armazene o cadeia de conexão em uma variável de ambiente.

    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())

Para obter mais informações sobre como trabalhar com chaves, consulte Gerenciar suas Chaves de Acesso.

Importante

Se você desabilitar as chaves de acesso do seu espaço de trabalho, não poderá usar cadeias de caracteres de conexão para se conectar ao seu espaço de trabalho. Use os parâmetros do espaço de trabalho para se conectar em vez disso.

Conecte-se ao seu workspace com parâmetros de workspace

Cada workspace do Azure Quantum tem um conjunto exclusivo de parâmetros que você pode usar para se conectar ao workspace.

Parâmetro Descrição Use ao se conectar com
subscription_id A ID da assinatura do Azure. CLI do Azure
resource_group O nome do grupo de recursos do Azure. CLI do Azure
name O nome do espaço de trabalho do Azure Quantum. CLI do Azure
resource_id O ID de recurso do Azure do workspace do Azure Quantum. Python

Para localizar os parâmetros do workspace, siga estas etapas:

  1. Entre no portal do Azure.
  2. Vá para o workspace do Azure Quantum.
  3. No painel do workspace, escolha Visão geral.
  4. Expanda a lista suspensa Essentials.
  5. Copie os parâmetros em seus campos correspondentes.

Observação

Certifique-se de fazer login no tenant correto antes de se conectar ao seu espaço de trabalho. Para obter mais informações sobre locatários, consulte Como gerenciar assinaturas do Azure com a CLI do Azure.

Usar parâmetros de ambiente de trabalho para se conectar ao ambiente de trabalho do Azure Quantum

Para permanecer conectado ao executar seus scripts de Python, abra um terminal e execute o comando CLI do Azure a seguir. Este comando configura a assinatura do seu espaço de trabalho. Substitua <subscriptionId> por sua ID da assinatura.

az account set --subscription <subscriptionId>

Você pode usar os parâmetros do seu workspace para se conectar ao workspace do Azure Quantum por meio do módulo qdk.azure ou da CLI do Azure.

Para se conectar ao seu workspace Azure Quantum, escolha uma das opções a seguir.

  • Especifique a ID do recurso (recomendado):

    from qdk.azure import Workspace 

workspace = Workspace(resource_id="") # Add the resource ID of your workspace

  • Especifique a ID da assinatura, o grupo de recursos e o nome do 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
    )

  • Especifique apenas o nome do workspace. Essa opção pode falhar quando você tiver vários workspaces com o mesmo nome no mesmo locatário.

    from qdk.azure import Workspace 
workspace = Workspace(name="") # Add the name of your workspace

Conteúdo relacionado

  • Last updated on