Solucionar problemas de erros do Python no Excel

O Python no Excel agora está disponível para usuários empresariais e empresariais que executam o Canal Atual no Windows, começando com a Versão 2407 (Build 17830.20128) e o Canal Empresarial Mensal no Windows, começando com a Versão 2408 (Build 17928.20216). Ele está disponível na versão prévia para usuários familiares e pessoais que executam o Canal Atual no Windows começando com a versão 2405 (Build 17628.20164). O Python no Excel está disponível em versão prévia para usuários do Education que executam o Canal Atual (Versão Prévia) por meio do Programa Insider do Microsoft 365. No momento, ele não está disponível para o Semi-Annual Enterprise Channel.

Ele está sendo lançado primeiro para o Excel para Windows e, em seguida, para outras plataformas em uma data posterior. Para obter mais informações de disponibilidade, consulte Python na disponibilidade do Excel.

Se você encontrar alguma preocupação com o Python no Excel, denuncie-as 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 para 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.

Licença de complemento do Python no Excel

Se você comprou o Python na licença de complemento do Excel e está trabalhando em vários computadores, o Excel pode levar de 24 a 72 horas para atualizar a licença. Tente atualizar sua licença manualmente indo para Arquivo > Conta > Licença de Atualização.

Para obter mais informações sobre a licença de complemento, consulte Perguntas frequentes sobre o licenciamento do suplemento do Python no Excel.

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.

Observação: O Python no Excel não tem suporte para assinaturas do Microsoft 365 baseadas em dispositivo (atribuídas a um dispositivo em vez de a um usuário) ou usam ativação de computador compartilhado (vários usuários compartilham o mesmo computador e cada usuário faz logon com sua própria conta). Para obter mais informações de disponibilidade, consulte Python na disponibilidade do Excel.

Para #BLOCKED adicionais! casos de erro relacionados ao Python no Excel, confira Como corrigir um erro de #BLOCKED!: Python no Excel.

#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 um Python na licença de complemento do Excel ou habilite a versão prévia do Python no Excel para acesso a cálculos mais rápidos com computação premium. Para saber mais, confira O que está incluído na assinatura do Microsoft 365.

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

#TIMEOUT!

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

Tente executar a fórmula novamente ou redefinir o runtime do Python. Na guia Fórmulas, no grupo Python selecione Redefinir runtime ou usar o atalho de teclado Ctrl+Alt+Shift+F9.

Você também pode ajustar o limite de tempo limite do Python. Acesse Opções de > de Arquivo > > Avançadoao calcular essa pasta de trabalho e defina o Tempo limite de fórmula do Python conforme desejado.

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