Compartilhar via

Conectar-se ao workspace do Azure Quantum com o pacote Python azure-quantum

  • Artigo

Depois de criar um workspace do Azure Quantum, você pode se conectar a ele e enviar seu código usando o azure-quantum pacote Python. O azure-quantum pacote fornece uma Workspace classe que representa um workspace do Azure Quantum.

Pré-requisitos

Conectar usando 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. Você pode usar uma cadeia de conexão nos seguintes cenários:

  • Você deseja compartilhar o acesso ao workspace com outras pessoas que não têm uma conta do Azure.
  • Você deseja compartilhar o acesso ao espaço de trabalho 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 chaves primárias e secundárias e suas cadeias de conexão correspondentes. Se você quiser permitir o acesso ao seu espaço de trabalho para outras pessoas, poderá compartilhar sua chave secundária e usá-la primária para seus próprios serviços. Dessa forma, você pode substituir a chave secundária conforme necessário sem ter tempo de inatividade em seus próprios serviços. Para obter mais informações sobre como compartilhar o acesso ao workspace, consulte Compartilhar seu acesso ao workspace.

Copiar a cadeia de conexão

  1. Entre no portal do Azure e selecione seu workspace do Azure Quantum.

  2. No painel esquerdo, navegue até Teclas de acesso de operações>.

  3. As chaves de acesso devem estar habilitadas. Se as Teclas de Acesso estiverem desativadas, você precisará ativá-las primeiro. Veja como fazer isso em Gerenciar suas chaves de acesso.

  4. Clique no ícone Copiar para copiar a cadeia de conexão. Você pode selecionar a cadeia de conexão primária ou secundária.

    Captura de tela do portal do Azure mostrando como copiar as cadeias de conexão.

Aviso

Armazenar as chaves de acesso da conta ou a cadeia de conexão em texto não criptografado apresenta um risco de segurança e não é recomendado. 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.

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

Depois de copiar a cadeia de conexão, você pode usá-la para se conectar ao workspace do Azure Quantum.

Se você estiver trabalhando com um ambiente do Python, poderá criar um Workspace objeto para se conectar ao workspace do Azure Quantum. Ao criar um Workspace objeto, você tem duas opções para identificar seu workspace do Azure Quantum.

  • Você pode criar um Workspace objeto chamando from_connection_string.

    # Creating a new Workspace object from a connection string 
from azure.quantum 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 no código, também poderá armazenar sua cadeia de conexão em uma variável de ambiente e usar Workspace().

    # Using environment variable to connect with  connection string

connection_string = "[Copy connection string]" 

import os 

os.environ["AZURE_QUANTUM_CONNECTION_STRING"] = connection_string 

from azure.quantum 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

Quando as Chaves de Acesso estão desabilitadas, todas as solicitações usando cadeias de conexão ou chaves de acesso não são autorizadas. Você ainda pode usar os parâmetros do espaço de trabalho para se conectar ao seu espaço de trabalho.

Conectar-se usando os parâmetros do espaço de trabalho

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

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 em que o workspace do Azure Quantum é provisionado. Isso pode ser especificado como um nome de região, como "Leste dos EUA", ou um nome de local, como "eastus".
resource_id A ID de recurso do Azure do workspace do Azure Quantum.

Você pode encontrar os parâmetros do workspace na visão geral do workspace do Azure Quantum no portal do Azure.

  1. Faça login em sua conta do Azure, https://portal.azure.com,

  2. Selecione seu workspace do Azure Quantum e navegue até Visão geral.

  3. Copie os parâmetros nos campos.

    Captura de tela do Visual Studio Code mostrando como expandir o painel de visão geral do workspace do Quantum.

Usar os parâmetros do workspace para se conectar ao workspace do Azure Quantum

Crie um Workspace objeto para se conectar ao workspace do Azure Quantum. Ao criar um Workspace objeto, você tem duas opções para identificar seu workspace do Azure Quantum.

  • Você pode especificar o local e a ID do recurso (recomendado):

    from azure.quantum import Workspace 

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

  • Você pode especificar o local, a ID da assinatura, o grupo de recursos e o nome do workspace:

    from azure.quantum 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 (for example "westus")
    )

Conteúdo relacionado