Compartilhar via

Conecte-se à área de trabalho do Azure Quantum com o módulo Python qdk.azure

Se você tiver um workspace do Azure Quantum, poderá conectar-se ao seu workspace e enviar seu código utilizando 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 seu workspace com o módulo qdk.azure, você deve ter o seguinte:

Se você usar a CLI do Azure, deverá ter a versão mais recente. Para obter as instruções de instalação, confira:

Conexão com uma cadeia de conexão

Você pode usar uma cadeia de conexão para especificar os parâmetros de conexão para um workspace 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. Faça logon no Portal do Azure.
  2. Vá para o workspace do Azure Quantum.
  3. No painel do workspace, expanda o menu suspenso Operações e escolha Chaves de Acesso.
  4. Você deve habilitar 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. Escolha o ícone Copiar para essa 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. É uma prática recomendada armazenar suas chaves de conta em um formato criptografado ou migrar seus aplicativos para usar a autorização do Microsoft Entra para acesso ao workspace do Azure Quantum.

Usar a cadeia de conexão para acessar seu workspace do Azure Quantum

Você pode usar a cadeia de conexão que acabou de copiar para se conectar ao workspace do Azure Quantum com o `qdk.azure` módulo ou com o Visual Studio Code (VS Code).

Crie um Workspace objeto para se conectar ao workspace do Azure Quantum. Há duas opções para identificar seu workspace do Azure Quantum ao criar um Workspace objeto.

  • Chame a from_connection_string função ao criar um Workspace objeto.

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

  • Se você não quiser copiar sua cadeia de conexão em seu código, armazene sua cadeia de conexão em uma variável de ambiente e use 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())

Para obter mais informações sobre como habilitar, desabilitar e regenerar suas chaves, consulte Gerenciar suas Chaves de Acesso.

Importante

Se você desabilitar as chaves de acesso para seu espaço de trabalho, não poderá usar strings de conexão para conexão com seu espaço de trabalho. Mas você ainda pode usar parâmetros de espaço de trabalho para se conectar ao seu espaço de trabalho.

Conecte-se ao seu espaço de trabalho com parâmetros de espaço de trabalho

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

Parâmetro Descrição
subscription_id A ID da assinatura do Azure.
resource_group O nome do grupo de recursos do Azure.
name O nome do workspace do Azure Quantum.
location A região do Azure na qual seu workspace está.
resource_id A ID de recurso do Azure do workspace do Azure Quantum.

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

  1. Faça logon 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 workspace.

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

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

Crie um Workspace objeto para se conectar ao workspace do Azure Quantum. Há duas opções para identificar seu workspace do Azure Quantum ao criar um Workspace objeto.

  • Especifique a ID do recurso (recomendado):

    from qdk.azure import Workspace 

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

  • Especifique a ID da assinatura, o grupo de recursos e o nome do workspace e o local:

    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
    workspace_name = "" # Add the name of your workspace
    location = "" # Add the location of your workspace
    )

Conteúdo relacionado

  • Last updated on