Solucionar problemas de erros do Python no Excel

O Python no Excel está atualmente em versão prévia e sujeito a alterações com base nos comentários. Para usar esse recurso, ingresse no Programa Insider do Microsoft 365 e escolha o nível Insider Canal Beta.

O Python no Excel está sendo implementado gradualmente para clientes do Excel para Windows que usam o Canal Beta. No momento, o recurso não está disponível em outras plataformas.

Se você encontrar algum problema com Python no Excel, relate-o selecionando Ajuda > Comentários 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 for Android

Para obter informações adicionais de disponibilidade, consulte Python na disponibilidade do 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.

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.

#CALC!

O Python no Excel não dá suporte a referências a células com valores voláteis, como células que usam a função RAND. Fórmulas python que fazem referência a células com valores voláteis retornam 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.

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