Ligue-se ao seu espaço de trabalho Azure Quantum com o QDK ou CLI do Azure

Se tiveres um espaço de trabalho no Azure Quantum, podes ligar-te ao teu espaço 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, precisa do seguinte:

  • Uma conta do Azure com uma subscrição ativa. Se não tiver uma conta do Azure, registe-se gratuitamente e inscreva-se numa subscrição pré-paga.

  • Um espaço de trabalho do Azure Quantum. Se não tiver um espaço de trabalho, veja Criar um espaço de trabalho no Azure Quantum.

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

    pip install --upgrade "qdk[azure]"

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

Conectar-se com uma string de conexão

Use uma cadeia de ligação para especificar os parâmetros de ligação a um espaço de trabalho do Azure Quantum. 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

  1. Inicie sessão no portal Azure.
  2. Vai ao teu espaço de trabalho Azure Quantum.
  3. No painel da área de trabalho, expanda a lista pendente Operações e selecione Chaves de acesso.
  4. Ativa as chaves de acesso para o teu espaço de trabalho. Se o controlo de deslize Teclas de Acesso estiver definido como Desativado, defina o controlo como Ativado.
  5. Seleciona 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. Armazene suas chaves de conta em um formato criptografado ou migre seus aplicativos para usar a autorização do Microsoft Entra para acesso ao seu espaço de trabalho do Azure Quantum.

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

Usa a cadeia de ligação que copiaste para te ligares ao teu espaço de trabalho do Azure Quantum com o qdk.azure módulo ou à extensão QDK no Visual Studio Code.

Para se ligar ao seu espaço de trabalho no Azure Quantum, escolha um dos seguintes métodos.

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

  • Armazena a tua cadeia de ligação numa 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 mais informações sobre como trabalhar com chaves, consulte Gerir as suas Chaves de Acesso.

Importante

Se desativares as teclas de acesso para o teu espaço de trabalho, não podes usar cadeias de ligação para te ligares ao teu espaço de trabalho. Usa os parâmetros do espaço de trabalho para te ligares em vez disso.

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.

Parâmetro Descrição Use quando se conecta com
subscription_id O ID da subscrição do Azure. CLI do Azure
resource_group O nome do grupo de recursos do Azure. CLI do Azure
name O nome do seu espaço de trabalho do Azure Quantum. CLI do Azure
resource_id O ID de recurso do Azure da área de trabalho do Azure Quantum. Python

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

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

Observação

Certifique-se de iniciar sessão com o inquilino correto antes de se ligar ao seu espaço de trabalho. Para mais informações sobre inquilinos, veja Como gerir subscrições Azure com a CLI Azure.

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

Para se manter ligado quando executa os seus scripts Python, abra um terminal e execute o seguinte comando CLI do Azure. Este comando define a subscrição do seu espaço de trabalho. Substitua <subscriptionId> pelo seu ID de subscrição.

az account set --subscription <subscriptionId>

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

Para se ligar ao seu espaço de trabalho Azure Quantum, escolha uma das seguintes opções.

  • Especifique o ID do recurso (recomendado):

    from qdk.azure import Workspace 

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

  • Especifique o ID da subscrição, o grupo de recursos e o nome do espaço de trabalho:

    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 espaço de trabalho. Esta opção pode falhar quando tens vários espaços de trabalho com o mesmo nome no mesmo inquilino.

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

Conteúdos relacionados

  • Last updated on