Resolver erros do Python no Excel

O Python no Excel está atualmente em pré-visualização e está sujeito a alterações com base no feedback. Para utilizar esta funcionalidade, adira ao Programa Insider do Microsoft 365 e selecione o nível Insider do Canal Beta.

O Python no Excel está a ser gradualmente lançado para clientes do Excel para Windows através do Canal Beta. Neste momento, a funcionalidade não está disponível noutras plataformas.

Se encontrar problemas com o Python no Excel, comunique-os ao selecionar Ajuda > Feedback no Excel.

É a primeira vez que utiliza o Python no Excel? Consulte Introdução ao Python no Excel e Introdução ao Python no Excel.

Requisitos de funcionalidades

Reveja a seguinte lista de requisitos antes de resolver erros.

Disponibilidade da plataforma

A funcionalidade não está disponível nas seguintes plataformas.

Excel para Mac
Excel na Web
Excel para iPad
Excel para iPhone
Excel para Android

Para obter informações de disponibilidade adicionais, veja Python in Excel availability (Disponibilidade do Python no Excel).

Acesso à Internet

O Python no Excel requer acesso à Internet porque os cálculos são executados em servidores remotos na Microsoft Cloud. Os cálculos não são executados pela sua aplicação Excel local.

Resolver erros do Excel

Os cálculos do Python no Excel podem devolver erros padrão do Excel em células Python, como #PYTHON!, #BUSY! e #CONNECT!.

Aceder à mensagem de erro

Para saber mais sobre como um erro do Excel se aplica à sua fórmula Python, abra a mensagem de erro. Para abrir a mensagem de erro, selecione o símbolo de erro junto à célula e, em seguida, selecione Mostrar Mensagem de Erro no menu. A captura de ecrã seguinte mostra o menu de erros que contém Mostrar Mensagem de Erro.

Um erro numa célula do Python no Excel com o menu de erros aberto.

Em seguida, o Excel apresenta uma Mensagem de Erro do Python com informações adicionais. Neste caso, o erro #PYTHON! é o resultado de uma sintaxe Python inválida na linha 1 na fórmula Python.

Nota: O painel de tarefas de diagnóstico é aberto automaticamente no Excel se o erro #PYTHON! for devolvido. Veja informações sobre o erro #PYTHON! na secção seguinte para saber mais sobre o painel de tarefas de diagnóstico.

Erros comuns

#BLOCKED!

O Python no Excel tem de estar ativado num livro para que as fórmulas Python sejam calculadas. Se vir o erro #BLOCKED!, certifique-se de que tem acesso aos serviços ligados do Microsoft 365.

#BUSY!

O erro #BUSY! indica que os cálculos do Python estão em execução na Microsoft Cloud. Se o erro #BUSY! for apresentado durante mais de 60 segundos, tente repor o runtime do Python. No separador Fórmulas, no grupo Python, selecione Repor runtime. Em alternativa, utilize o atalho de teclado Ctrl+Alt+Shift+F9.

#CALC!

O Python no Excel não suporta referências a células com valores voláteis, como células com a função RAND. As fórmulas python que referenciam células com valores voláteis devolvem o erro #CALC.

Os cálculos do Python no Excel podem processar até 100 MB de dados de cada vez. Tentar executar um cálculo com mais de 100 MB de dados devolve o erro #CALC! erro. Experimente utilizar um conjunto de dados mais pequeno.

#CONNECT!

Experimente atualizar a ligação com a Microsoft Cloud ao repor o runtime do Python. No separador Fórmulas, no grupo Python, selecione Repor runtime. Em alternativa, utilize o atalho de teclado Ctrl+Alt+Shift+F9.

#PYTHON!

O erro #PYTHON! provavelmente indica um erro de sintaxe Python. O painel de tarefas de diagnóstico é aberto automaticamente se o erro #PYTHON! for devolvido. Verifique o painel de tarefas de diagnóstico para ver detalhes sobre o erro.

Ver o painel de tarefas de diagnóstico

O painel de tarefas de diagnóstico é apresentado na IU do Excel, no lado direito da grelha. Utilize o painel de tarefas de diagnóstico para ver continuamente saídas padrão, erros padrão e erros de intérprete com os cálculos do Python no Excel. Para abrir manualmente o painel de tarefas de diagnóstico, aceda a uma célula Python na folha de cálculo, abra o menu de contexto (clique com o botão direito do rato ou Ctrl+clique na célula) e selecione Diagnósticos para esta célula.

A captura de ecrã seguinte mostra o painel de tarefas de diagnóstico a apresentar um erro: um erro de sintaxe para uma fórmula Python na célula C1.

O painel de tarefas de diagnóstico do Python no Excel a mostrar um erro de sintaxe.

#SPILL!

O erro #SPILL! provavelmente indica que uma célula no intervalo de saída do Python já contém dados. Isto pode ser o resultado da devolução de um objeto Python como valores do Excel. Os valores do Excel podem transpor várias células. Consulte Como corrigir um erro #SPILL! para obter estratégias de resolução.

#UNKNOWN!

O erro #UNKNOWN! numa célula Python indica provavelmente que a sua versão do Excel não suporta o Python no Excel. Para saber mais, consulte a secção Requisitos de funcionalidades anteriormente neste artigo.