Trabalhar com notebooks Jupyter em um workspace do Azure Quantum

Saiba como executar código Q# ou Python em um notebook Jupyter no workspace do Azure Quantum. Um notebook Jupyter é um documento que contém rich text e código e pode ser executado em seu navegador.

Pré-requisitos

Você precisa dos seguintes pré-requisitos para usar notebooks Jupyter em um workspace do Azure Quantum.

• Uma conta do Azure com uma assinatura ativa. Se você não tiver uma conta do Azure, registre-se gratuitamente e inscreva-se em uma assinatura paga conforme o uso.
• Um espaço de trabalho do Azure Quantum. Consulte Criar um espaço de trabalho do Azure Quantum.

Obter um notebook de amostra

Para começar, você pode usar um notebook de exemplo da galeria de exemplo.

1. Selecione seu espaço de trabalho do Azure Quantum no Portal do Microsoft Azure.

2. Selecione Notebooks.

3. Selecione Galeria de exemplos.

4. Selecione o exemplo que você deseja usar e selecione Copiar para meus Notebooks.

   

O notebook de amostra pode ser encontrado em Meus notebooks, e agora você pode executá-lo.

Executar um notebook

Para executar Q# ou Python em um notebook Jupyter, siga estas etapas.

1. Selecione seu espaço de trabalho do Azure Quantum no Portal do Microsoft Azure.

2. Selecione Notebooks.

3. Selecione seu notebook em Meus notebooks.

4. Selecione a célula que você deseja executar e selecione o ícone executar para executar o código na célula ou selecione Executar Tudo para executar todas as células no notebook.

   

Criar um novo notebook

Siga estas etapas para criar um notebook Jupyter usando Q# ou Python.

1. Selecione seu espaço de trabalho do Azure Quantum no Portal do Microsoft Azure.

2. Selecione Notebooks.

3. Selecione Meus notebooks e selecione Adicionar novo

   

4. Digite um Nome de Arquivo e selecione Criar arquivo.

A primeira célula do notebook é preenchida automaticamente com a cadeia de conexão para o espaço de trabalho do Azure Quantum.

Selecione + Código ou + Markdown para adicionar um código ou uma célula de texto de markdown.

Dica

Um notebook é salvo automaticamente a cada 30 segundos. Você também pode salvar manualmente pressionando Ctrl + S.

Carregar notebooks

Você pode carregar um ou mais notebooks Jupyter existentes em um workspace do Azure Quantum.

Cuidado

Você só deve carregar e executar notebooks Jupyter de fontes confiáveis e instalar apenas pacotes de fontes confiáveis. Enquanto os notebooks no Azure Quantum protegem você por meio de saídas de área restrita, os Notebooks Jupyter são criados para a execução de código arbitrário. Portanto, há riscos inerentes ao carregar ou executar notebooks de uma fonte não confiável.

1. Selecione seu espaço de trabalho do Azure Quantum no Portal do Microsoft Azure.

2. Selecione Notebooks.

3. Selecione Meus notebooks.

4. Selecione Carregar novo.

5. Arraste e solte os arquivos do notebook ou selecione Procurar Arquivos e selecione os arquivos de notebook que você deseja carregar.

6. Se você quiser substituir arquivos já existentes, selecione Substituir se já existir.

7. Selecione Carregar arquivos.

   

Depois que os notebooks tiverem sido carregados, você poderá encontrá-los em Meus notebooks.

Observação

Se você estiver carregando um notebook que foi salvo de outro workspace do Azure Quantum, talvez seja necessário atualizar as informações de conexão, como Assinatura, Grupo de recursos, nome do workspace, Localização ou ID do Recurso, antes de executar o notebook.

Gerenciar notebooks

Você pode renomear, excluir, duplicar e baixar notebooks existentes.

1. Selecione seu espaço de trabalho do Azure Quantum no Portal do Microsoft Azure.

2. Selecione Notebooks.

3. Selecione seu bloco de anotações em Meus blocos de anotações

4. Clique no painel de contexto, que é ... à direita do nome do bloco de anotações.

5. Selecione Renomear Notebook, Excluir Notebook, Duplicar Notebook ou Baixar Notebook.

   

Isolamento

Os notebooks Jupyter em um espaço de trabalho do Azure Quantum são isolados dos notebooks de outros usuários.

• Sua instância do Jupyter Notebook é hospedada pelo Azure Quantum com isolamento em nível de hipervisor de instâncias de outros usuários.
• Os notebooks são armazenados em sua conta de armazenamento vinculada em sua assinatura.
• Uma instância do Jupyter Notebook tem escopo para uma combinação sua e de um workspace específico. Se você visitar outro workspace, obterá uma instância do Jupyter Notebook diferente. Se outro usuário visitar o mesmo workspace, ele obterá uma instância do Jupyter Notebook diferente da sua.
• Os notebooks têm o escopo para você e um espaço de trabalho específico. Se você visitar outro espaço de trabalho, os mesmos notebooks não serão exibidos em Meus notebooks. Se outro usuário visitar esse workspace, ele não verá seus notebooks.

Armazenamento de notebooks

Os notebooks Jupyter são armazenados em uma conta do Armazenamento do Microsoft Azure vinculada ao seu workspace do Azure Quantum.

Observação

Quando um workspace do Azure Quantum é criado, o Compartilhamento de Recursos entre Origens (CORS) é habilitado na conta do Armazenamento do Microsoft Azure vinculada. Isso é necessário para usar Jupyter Notebooks no portal. Se você não planeja usar o Jupyter Notebooks no portal e não deseja habilitar o CORS para sua conta de armazenamento do Azure, poderá editar diretamente sua conta de armazenamento para remover a regra CORS. Nas propriedades da conta de armazenamento, em Configurações, selecione CORS (Compartilhamento de Recursos) e remova a regra no Serviço de Arquivo. Não deixe de abrir a folha Notebooks novamente em seu workspace, assim a regra será recriada automaticamente.

Limitações

Veja a seguir as limitações de notebooks Jupyter em um workspace do Azure Quantum.

• Como é gratuita, a instância do Jupyter Notebook existirá até um máximo de 12 horas (após esse período, sua instância será excluída ou recriada, e você precisará reinstalar todos os pacotes personalizados).
• O Azure Quantum pode precisar excluir sua instância do Jupyter Notebook para aplicar patches de segurança ou implementar alterações de emergência. Quando possível, ele não interromperá o fluxo de trabalho.
• As instâncias do notebook têm 2 vCPUs e 4 GB de memória alocados previamente.
• Os kernels ociosos são encerrados após 30 minutos. Após esse período, você precisará executar novamente as células.
• A localização da sua conta de armazenamento e do workspace afetará o desempenho dos notebooks Jupyter em um workspace do Azure Quantum. Quando possível, tente criar a conta de armazenamento e o espaço de trabalho em uma região próxima de onde você usará seus notebooks.
• Não pode haver mais de 10 notebooks abertos simultaneamente em uma região por assinatura. Para abrir mais de 10 notebooks simultaneamente, você deve implantar workspaces em várias regiões.
• Um único usuário pode abrir no máximo cinco notebooks simultaneamente em uma região por assinatura.

Próximas etapas

• Introdução ao Q# e a um notebook do Azure Quantum
• Início Rápido: Enviar um circuito com o Qiskit