Solucionar problemas de erros do Python no Excel

O Python no Excel está atualmente a ser lançado para utilizadores empresariais e empresariais que executam o Canal Atual no Windows, a partir da Versão 2407 (Compilação 17830.20128). Está disponível em pré-visualização para utilizadores Familiares e Pessoais que executem o Canal Atual no Windows a partir da Versão 2405 (Compilação 17628.20164). O Python no Excel está disponível em pré-visualização para utilizadores do Education que executem o Canal Atual (Pré-visualização) através do Programa Insider do Microsoft 365. Atualmente, não está disponível para o Canal Empresarial Mensal ou para o canal Semi-Annual Enterprise.

Está a ser implementada primeiro no Excel para Windows e, em seguida, noutras plataformas posteriormente. Para obter mais informações de disponibilidade, veja Python in Excel availability (Disponibilidade do Python no Excel).

Se encontrar alguma preocupação com o Python no Excel, comunique-os ao selecionar Ajuda > Feedback no Excel.

Novo no Python no Excel? Comece com Introdução ao Python no Excel e Introdução ao Python no Excel.

Requisitos de recursos

Examine a lista de requisitos a seguir antes de solucionar erros.

Disponibilidade da plataforma

O recurso 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 no Microsoft Cloud. Os cálculos não são executados pelo aplicativo do Excel local.

Licença de suplemento Python no Excel

Se comprou a licença do suplemento Python no Excel e está a trabalhar em vários computadores, o Excel poderá demorar entre 24 a 72 horas a atualizar a licença. Experimente atualizar a licença manualmente ao aceder a Conta de > de Ficheiros > Atualizar Licença.

Solucionar erros do Excel

Cálculos do Python no Excel podem retornar erros padrão do Excel para células do Python, como #PYTHON!, #OCUPADO! e #CONECTAR!.

Acessar a 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 próximo à célula e selecione Mostrar Mensagem de Erro no menu. A captura de tela a seguir mostra o menu de erro contendo Mostrar Mensagem de Erro. Um erro em uma célula Python no Excel, com o menu de erro aberto.

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

Observação: O painel de tarefas de diagnóstico abre automaticamente no Excel se o erro #PYTHON! é retornado. Consulte as informações do erro #PYTHON! na seção a seguir para saber mais sobre o painel de tarefas de diagnóstico.

Erros comuns

#BLOQUEADO!

O Python no Excel deve estar habilitado em uma pasta de trabalho para que as fórmulas Python sejam calculadas. Se você vir o erro #BLOQUEADO! verifique se você tem acesso aos serviços conectados do Microsoft 365.

#OCUPADO!

O erro #OCUPADO! indica que os cálculos do Python estão em execução no Microsoft Cloud. Se o erro #OCUPADO! for exibido por mais de 60 segundos, tente redefinir o runtime do Python. Na guia Fórmulas, no grupo Python, selecione Redefinir runtime. Ou use o atalho de teclado Ctrl+Alt+Shift+F9.

Compre uma licença de suplemento Python no Excel ou ative a pré-visualização do Python no Excel para aceder a cálculos mais rápidos com computação premium. Para saber mais, consulte O que está incluído na sua subscrição do Microsoft 365.

#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.

Cálculos do Python no Excel podem processar até 100 MB de dados por vez. A tentativa de executar um cálculo com mais de 100 MB de dados retorna o #CALC! Erro. Tente usar um conjunto de dados menor.

#CONECTAR!

Tente atualizar a conexão com o Microsoft Cloud redefinindo o runtime do Python. Na guia Fórmulas, no grupo Python, selecione Redefinir runtime. Ou use o atalho de teclado Ctrl+Alt+Shift+F9.

#PYTHON!

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

Exibir o painel de tarefas de diagnóstico

O painel de tarefas de diagnóstico é exibido na interface do usuário do Excel, no lado direito da grade. Use o painel de tarefas de diagnóstico para exibir continuamente resultados padrão, erros padrão e erros de interpretador com seus cálculos do Python no Excel. Para abrir manualmente o painel de tarefas de diagnóstico, vá até uma célula do Python na planilha, abra o menu de contexto (clique com o botão direito ou Ctrl+clique na célula) e selecione Diagnóstico para essa célula.

A captura de tela a seguir mostra o painel de tarefas de diagnóstico exibindo um erro: um erro de sintaxe para uma fórmula Python na célula C1.

O Painel de tarefas do Python no Excel diagnóstico mostrando um erro de sintaxe.

#DESPEJAR!

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

#TIMEOUT!

O #TIMEOUT! o erro indica que a fórmula python excedeu o tempo máximo de execução atribuído.

Tente executar a fórmula novamente ou repor o runtime do Python. No separador Fórmulas, no grupo Python, selecione Repor runtime ou utilize o atalho de teclado Ctrl+Alt+Shift+F9.

Também pode ajustar o limite de tempo limite do Python. Aceda a Opções de > de Ficheiros > > AvançadasAo calcular este livro e definir o Tempo Limite da Fórmula python conforme pretendido.

#DESCONHECIDO!

O erro #DESCONHECIDO! em uma célula do Python provavelmente indica que sua versão do Excel não dá suporte ao Python no Excel. Para saber mais, consulte a seção Requisitos de recursos anteriormente nesse artigo.