Matricule-se
Voltar para o blog
Python

Como salvar e reutilizar variáveis Python com a biblioteca Pickle

Pedro Surreaux

Neste post vamos te mostrar como usar a biblioteca Pickle para salvar qualquer objeto Python em um arquivo e reutilizá-lo em outro código, sem precisar recriar tudo do zero.

Se você já precisou salvar algo do seu código Python, como um dicionário ou até um modelo de inteligência artificial, em um arquivo para usar depois ou compartilhar com outra pessoa, a biblioteca Pickle do Python é o que você precisa!

Pickle é uma ferramenta poderosa, especialmente para quem trabalha com análise de dados ou IA.

Vamos aprender como funciona?

Caso prefira esse conteúdo no formato de vídeo-aula, assista ao vídeo abaixo ou acesse o nosso canal do YouTube!

Para receber por e-mail o(s) arquivo(s) utilizados na aula, preencha:

Não vamos te encaminhar nenhum tipo de SPAM! A Hashtag Treinamentos é uma empresa preocupada com a proteção de seus dados e realiza o tratamento de acordo com a Lei Geral de Proteção de Dados (Lei n. 13.709/18). Qualquer dúvida, nos contate.

O que é a biblioteca Pickle?

O Pickle é uma biblioteca nativa do Python que permite salvar qualquer objeto do seu código – como dicionários, listas, classes ou até modelos de inteligência artificial – em um arquivo com extensão .pkl. Depois, você pode carregar esse arquivo em outro código, em outro computador, ou até compartilhar com alguém, e o objeto volta exatamente como estava.

Por exemplo:

  • Salvou um dicionário com dados de um relatório? Pode abrir em outro código sem recriá-lo.
  • Treinou um modelo de IA que levou dias? Salve-o com Pickle e use-o sem treinar novamente.

Isso economiza tempo e facilita compartilhar resultados complexos, especialmente em projetos de dados ou machine learning.

Você já parou pra pensar quais as principais bibliotecas usadas em códigos em Python? Confira nosso post e descubra quais as bibliotecas mais utilizadas em Python.

Por que usar o Pickle?

Imagine que você criou um dicionário com informações de um relatório, como:

Codigo
relatorio = {
    "cliente": "João Silva",
    "valor": 3570.00,
    "status": "pago"
}

Ou talvez tenha treinado um modelo de inteligência artificial que demorou horas (ou dias!) para ficar pronto. Sem o Pickle, você teria que:

  • Salvar os dados em um arquivo de texto ou banco de dados e depois tratá-los para usar novamente.
  • Treinar o modelo de IA do zero toda vez que quisesse usá-lo.

Com o Pickle, você salva o objeto diretamente em um arquivo .pkl e o carrega quando precisar, sem perder tempo. É como salvar um jogo: você não começa do zero, apenas retoma de onde parou!

Ícone PythonPython Impressionador

Você vai aprender a linguagem de Programação que mais cresce no Mundo para fazer automações incríveis, desenvolver sites, fazer análises de dados, trabalhar com Ciência de Dados, Inteligência Artificial, mesmo que você nunca tenha tido nenhum contato com Programação na vida.

Começar agoraSeta para a direita
Fundo PythonTelas Python
Luz Python

Como usar o Pickle: Passo a Passo

Vamos mostrar como salvar o dicionário de relatório acima em um arquivo .pkl e depois carregar ele em outro código. O Pickle já vem instalado no Python, então é só importar e usar.

1. Salvando um Objeto com Pickle

Para salvar o dicionário relatorio em um arquivo, use a função pickle.dump().

Aqui está o código:

Python
import pickle

# Dicionário de exemplo
relatorio = {
    "cliente": "João Silva",
    "valor": 3570.00,
    "status": "pago"
}

# Salva o dicionário em um arquivo .pkl
with open("relatorio.pkl", "wb") as arquivo:
    pickle.dump(relatorio, arquivo)

Explicação:

  • with open("relatorio.pkl", "wb"): Abre um arquivo chamado relatorio.pkl no modo write bytes (wb). O modo wb é necessário porque o Pickle salva os dados em formato de bytes, não texto.
  • pickle.dump(relatorio, arquivo): Salva o dicionário relatorio no arquivo arquivo.
  • Estrutura with: Garante que o arquivo seja salvo e fechado automaticamente, evitando erros.

Quando você rodar esse código, um arquivo relatorio.pkl será criado na mesma pasta do seu código.

2. Carregando um objeto com Pickle

Agora, vamos carregar o dicionário salvo em outro código (ou no mesmo, se preferir). Use a função pickle.load():

Python
import pickle

# Carrega o dicionário do arquivo .pkl
with open("relatorio.pkl", "rb") as arquivo:
    relatorio_importado = pickle.load(arquivo)

# Exibe o dicionário carregado
print(relatorio_importado)
print(type(relatorio_importado))

Explicação:

  • with open("relatorio.pkl", "rb"): Abre o arquivo relatorio.pkl no modo read bytes (rb), pois vamos ler os bytes salvos.
  • pickle.load(arquivo): Carrega os dados do arquivo e os transforma em um objeto Python (neste caso, um dicionário).
  • print(relatorio_importado): Mostra o dicionário, que será idêntico ao original.
  • print(type(relatorio_importado)): Confirma que o objeto é um dicionário Python (<class 'dict'>).

A saída será:

Codigo
{'cliente': 'João Silva', 'valor': 3570.00, 'status': 'pago'}
<class 'dict'>

Você pode mandar o arquivo relatorio.pkl por e-mail, salvar no Google Drive ou usar em outro computador. Basta ter o arquivo na mesma pasta do código que vai carregá-lo.

Aplicações práticas do Pickle

O Pickle é incrivelmente útil em várias situações. Aqui estão alguns exemplos:

  • Relatórios e Dados: Salve dicionários ou listas com resultados de análises para compartilhar com sua equipe ou usar em outros projetos.
  • Modelos de Inteligência Artificial: Treinar um modelo de machine learning pode levar dias. Com o Pickle, você salva o modelo treinado em um arquivo .pkl e o carrega instantaneamente para fazer previsões, sem retrenar.
  • Classes e Objetos Complexos: Criou uma classe com métodos e atributos? Salve-a com Pickle e reutilize em outro sistema.
  • Sistemas Distribuídos: Disponibilize objetos Python em servidores ou sistemas da empresa, carregando-os conforme necessário.

Por exemplo, se você treina um modelo de IA que reconhece imagens, o Pickle permite salvar o modelo treinado. Assim, sua equipe pode usá-lo em um aplicativo sem repetir o treinamento.

Dicas para usar o Pickle

  • Extensão .pkl: Sempre use a extensão .pkl para arquivos Pickle, pois ela indica que o arquivo contém um objeto serializado.
  • Modos wb e rb: Use wb para salvar (escrever bytes) e rb para carregar (ler bytes). Modos como w ou r (texto) não funcionam com Pickle.
  • Segurança: Não carregue arquivos .pkl de fontes desconhecidas, pois eles podem conter código malicioso.
  • Portabilidade: O arquivo .pkl é independente do código original. Você só precisa do Python e do Pickle para carregá-lo, em qualquer máquina.

Conclusão

A biblioteca Pickle é uma ferramenta simples, mas poderosa, para salvar e reutilizar objetos Python, desde dicionários até modelos de inteligência artificial.

Com apenas algumas linhas de código, você pode salvar resultados complexos em um arquivo .pkl, compartilhá-los com sua equipe ou usá-los em outros projetos, economizando tempo e esforço.

Baixe os arquivos desta aula, pratique e veja como o Pickle pode agilizar seus processos!

E se quiser aprender mais sobre Python, confira nos outros conteúdos sobre esta linguagem e nosso blog!

Hashtag Treinamentos

Para acessar outras publicações de Python, clique aqui!

Quer aprender mais sobre Python com um minicurso básico gratuito?

Posts mais recentes de Python

Posts mais recentes da Hashtag Treinamentos

Pedro Surreaux

Autor do artigo

Pedro Surreaux

Redator de Publicações

Redator de conteúdo na Hashtag Treinamentos. Produzo textos didáticos sobre tecnologia, buscando informar e engajar o público de forma acessível e descomplicada.

Ver mais posts