Python em DataFrames do Excel

Aplica-se A
Excel para Microsoft 365 Excel para Microsoft 365 para Mac

Para obter informações sobre disponibilidade, consulte Disponibilidade do Python no Excel. Se encontrar quaisquer problemas com o Python no Excel, comunique-os ao selecionar Feedback da Ajuda> no Excel.

É a primeira vez que utiliza o Python no Excel? Comece por ler Introdução ao Python no Excel e comece a utilizar o Python no Excel.

O que é um DataFrame?

Um DataFrame é uma estrutura de dados bidimensional em linguagens de programação de computador, semelhante a uma tabela do Excel. Em Python, um DataFrame é um objeto na biblioteca de pandas . A biblioteca pandas é uma biblioteca central usada pelo Python no Excel, e os objetos DataFrame são uma estrutura chave para analisar dados com o Python no Excel.

Nota

O Python no Excel utiliza um DataFrame como objeto predefinido para intervalos bidimensionais.

O Python no Excel pode gerar um DataFrame de duas formas: como um objeto Python ou convertido em valores do Excel. Quando um DataFrame é devolvido como um objeto Python, a célula apresenta o texto "DataFrame", precedido por um ícone de cartão. A captura de ecrã seguinte mostra um DataFrame como um objeto Python numa célula do Excel.

Exemplo do objeto DataFrame numa célula do Excel.

Para exibir as informações em um DataFrame, selecione o ícone de cartão na célula ou use Ctrl+Shift+F5. A captura de ecrã seguinte mostra um objeto DataFrame com a vista de cartão aberta. Este exemplo de DataFrame repete os dados nas células A1:B3 da folha de cálculo.

Um cartão DataFrame aberto.

Também pode importar dados externos para o Excel e, em seguida, processar esses dados com o Python no Excel. Para importar dados externos, utilize Power Query. Para saber mais sobre isso, consulte Usar Power Query para importar dados para Python no Excel.

Alterar o tipo de saída Python

Os dados dentro de um DataFrame podem ser retornados como valores do Excel em vez de como um objeto Python. Exporte um DataFrame como valores do Excel para incorporar outras análises baseadas no Excel, como gráficos, fórmulas do Excel e formatação condicional.

Utilize o menu de saída do Python na barra de fórmulas para controlar a forma como os cálculos do Python são devolvidos. A captura de ecrã seguinte mostra o menu de saída do Python na barra de fórmulas.

O menu de saída aberto do Python no Excel.

A captura de ecrã seguinte mostra os dados do DataFrame anteriores, mas desta vez os dados são devolvidos como valores do Excel. Uma vez que este DataFrame repete os dados nas células A1:B3 na folha de cálculo, o resultado do Python nas células C1:D3 corresponde às células A1:B3.

O conteúdo de DataFrame devolvido como valores do Excel.

Nota

Se uma célula no intervalo de saída, que no cenário anterior é o intervalo C1:D3, já contiver um valor, então a célula Python devolve o #SPILL! em vez da saída Python. Para saber mais, consulte Resolver erros do Python no Excel e Como corrigir um erro #SPILL!.

Importante

Quando o tipo de saída de um DataFrame é definido como valores do Excel, o DataFrame só produz a coluna de índice se uma das seguintes condições for correspondida.

  • Se os valores da coluna de índice não forem numéricos (como o resultado de describe() ou group_by()).
  • Se o nome da coluna de índice tiver sido definido.

Também pode utilizar o menu de clique com o botão direito do rato ou Ctrl+clique em qualquer célula Python para alterar os tipos de saída. Abra o menu do botão direito do mouse e selecione Saída Como para alterar a saída.