Liga-te ao teu espaço de trabalho Azure Quantum com o `qdk.azure` módulo Python

Se tiveres um espaço de trabalho Azure Quantum, podes ligar-te ao teu espaço de trabalho e submeter o teu código com o qdk.azure módulo Python. O qdk.azure módulo fornece uma Workspace classe que representa um espaço de trabalho Azure Quantum.

Pré-requisitos

Para se ligar ao seu espaço de trabalho com o qdk.azure módulo, deve ter o seguinte:

Uma conta do Azure com uma subscrição ativa. Se não tiver uma conta Azure, pode inscrever-se gratuitamente e subscrever uma subscrição pay-as-you-go.
Um espaço de trabalho do Azure Quantum. Se não tiver um espaço de trabalho, veja Criar um espaço de trabalho Azure Quantum.
A versão mais recente da biblioteca Python qdk com o azure extra.
```
pip install --upgrade "qdk[azure]"
```

Se usar o Azure CLI, então deve ter a versão mais recente. Para obter instruções de instalação, consulte:

Conectar-se com uma cadeia de conexão

Você pode usar uma cadeia de conexão para especificar os parâmetros de conexão para um Azure Quantum Workspace. As cadeias de ligação são úteis nos seguintes cenários:

Quer partilhar o acesso ao seu espaço de trabalho com outras pessoas que não têm conta Azure.
Quer partilhar o acesso ao seu espaço de trabalho com outras pessoas por um tempo limitado.
Não podes usar o Microsoft Entra ID por causa das políticas da empresa.

Gorjeta

Cada espaço de trabalho Azure Quantum tem uma chave primária e uma chave secundária, e cada chave tem a sua própria cadeia de ligação. Para permitir que outros acedam ao seu espaço de trabalho, partilhe a chave secundária e use a chave primária apenas para os seus próprios serviços. Pode substituir a chave secundária sem causar interrupção nos seus serviços. Para mais informações sobre como partilhar o acesso ao seu espaço de trabalho, consulte Partilhar o seu acesso ao seu espaço de trabalho.

Copiar a cadeia de ligação

Inicie sessão no portal do Azure.
Vai ao teu espaço de trabalho Azure Quantum.
No painel do espaço de trabalho, expanda a lista suspensa Operações e escolha Chaves de Acesso.
Deve ativar as chaves de acesso para o seu espaço de trabalho. Se o controlo de Chaves de Acesso estiver definido para Desativado, então defina o controlo para Ativado.
Escolhe o ícone Copiar para a cadeia de ligação que queres copiar. Pode escolher entre a cadeia de ligação primária ou secundária.

Aviso

É um risco de segurança guardar as chaves de acesso ou cadeias de ligação da sua conta em texto claro. É uma boa prática armazenar as suas chaves de conta num formato encriptado ou migrar as suas aplicações para usar a autorização Microsoft Entra para aceder ao seu espaço de trabalho Azure Quantum.

Utilize a cadeia de conexão para aceder ao seu espaço de trabalho do Azure Quantum

Pode usar a string de ligação que acabou de copiar para se ligar ao seu espaço de trabalho Azure Quantum com o qdk.azure módulo ou com o Visual Studio Code (VS Code).

Python
Código VS

Crie um Workspace objeto para se conectar ao seu espaço de trabalho do Azure Quantum. Existem duas opções para identificar o seu espaço de trabalho Azure Quantum quando cria um Workspace objeto.

Chama a from_connection_string função quando crias 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 não quiseres copiar a tua string de ligação no teu código, então guarda a tua string numa variável de ambiente e usa 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 mais informações sobre como ativar, desativar e regenerar as suas chaves, consulte Gerir as suas Chaves de Acesso.

Importante

Se desativares as chaves de acesso para o teu espaço de trabalho, então não podes usar strings de ligação para te ligares ao teu espaço de trabalho. Mas ainda podes usar parâmetros do espaço de trabalho para te ligares ao teu espaço de trabalho.

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

Cada espaço de trabalho Azure Quantum tem um conjunto único de parâmetros que pode usar para se ligar ao espaço de trabalho. Pode usar os seguintes parâmetros para se ligar ao seu espaço de trabalho Azure:

Parâmetro	Descrição
`subscription_id`	O ID da subscrição do Azure.
`resource_group`	O nome do grupo de recursos do Azure.
`name`	O nome do seu espaço de trabalho do Azure Quantum.
`location`	A região Azure onde fica o teu espaço de trabalho.
`resource_id`	O ID de recurso do Azure da área de trabalho do Azure Quantum.

Para encontrar os parâmetros do seu espaço de trabalho, siga estes passos:

Inicie sessão no portal do Azure.
Vai ao teu espaço de trabalho Azure Quantum.
No painel do seu espaço de trabalho, escolha Visão Geral.
Expande o menu suspenso de Essenciais .
Copie os parâmetros nos respetivos campos.

Observação

Certifique-se de que inicia sessão no tenant correto antes de conectar-se ao seu ambiente de trabalho.

Use parâmetros de espaço de trabalho para se ligar ao seu espaço de trabalho Azure Quantum

Pode usar os parâmetros do seu espaço de trabalho para se ligar ao seu espaço de trabalho Azure Quantum com o qdk.azure módulo ou com o Azure CLI.

Python
CLI do Azure

Especifique o 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 o ID da subscrição, o grupo de recursos e o nome do espaço de trabalho, e a localização:

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
    )

Podes usar o Azure CLI para te ligares ao teu espaço de trabalho. Para obter mais informações, consulte Gerenciar espaços de trabalho quânticos com a CLI do Azure.

Para iniciar sessão na sua conta Azure, execute o az login comando.
```
az login
```
Define a subscrição que queres usar. Substitua SubscriptionName pelo nome da sua subscrição. Também pode utilizar o ID da subscrição em vez do nome da subscrição.
```
az account set --subscription SubscriptionName
```
Define o espaço de trabalho que queres usar. Substitua ResourceGroupName, WorkspaceName, e Location pelo nome do grupo de recursos do seu espaço de trabalho, nome do espaço de trabalho e localização, respetivamente.
```
az quantum workspace set --resource-group ResourceGroupName --workspace-name WorkspaceName --location Location
```

Feedback

Esta página foi útil?

Last updated on 2025-12-24

Partilhar via

Liga-te ao teu espaço de trabalho Azure Quantum com o qdk.azure módulo Python