Pythonのpickleモジュール徹底解説：シリアライズとデシリアライズの基本から実践例まで

Pythonのpickleモジュールとは

Pythonのpickleモジュールは、Pythonオブジェクト構造の直列化（シリアライズ）と逆直列化（デシリアライズ）を行うための標準ライブラリです。リストや辞書などあらゆる種類のPythonオブジェクトをバイトストリーム（0と1のデータ列）へ変換する処理は、「ピクル化（pickling）」「シリアライズ」「フラット化」「マーシャリング」などと呼ばれます。逆に、ピクル化で生成されたバイトストリームを元のPythonオブジェクトへ戻す処理は「アンピクル（unpickling）」と呼ばれます。

なぜpickleを使うのか？

実際の開発現場では、pickle化とアンピクル化は非常に広く活用されています。サーバー間やシステム間でデータを手軽にやり取りしたり、ファイルやデータベースへ保存したりする際に便利だからです。また、Pythonオブジェクトをほぼそのままの形で保存・復元できるため、機械学習モデルの保存などにもよく利用されます。

セキュリティ上の注意点

信頼できないソースから受信したデータをアンピクルすることは避けるべきです。悪意のあるデータが含まれている場合、セキュリティ上の脅威となり得るためです。ただし、pickleモジュール自体には、悪意のあるデータを検知して警告を発する仕組みは備わっていません。取り扱いには十分注意しましょう。

pickleモジュールのインポート

pickle化・アンピクル化を行うには、まずpickleモジュールをインポートする必要があります。インポートは以下のコマンドで行います。

import pickle

pickleの使用例

リストをpickle化する

以下は、リストをpickle化するシンプルなプログラム例です（Pickle_list1.py）。

import pickle
mylist = ['a', 'b', 'c', 'd']
with open('datafile.txt', 'wb') as fh:
    pickle.dump(mylist, fh)

このコードでは、リスト「mylist」に4つの要素（'a'、'b'、'c'、'd'）が格納されています。すべての操作がバイト単位で行われるため、ファイルは「w」モードではなく「wb」（バイナリ書き込み）モードで開く点がポイントです。実行すると、カレントディレクトリに「datafile.txt」という新規ファイルが作成され、mylistのデータがバイトストリームへ変換されて保存されます。

リストをアンピクルする

続いて、保存したデータを読み込む例です（unpickle_list1.py）。

import pickle
pickle_off = open("datafile.txt", "rb")
emp = pickle.load(pickle_off)
print(emp)

上記スクリプトを実行すると、出力として元のmylistのデータが再び表示されます。

['a', 'b', 'c', 'd']

辞書をpickle化する

import pickle
EmpID = {1:"Zack",2:"53050",3:"IT",4:"38",5:"Flipkart"}
pickling_on = open("EmpID.pickle","wb")
pickle.dump(EmpID, pickling_on)
pickling_on.close()

辞書をアンピクルする

import pickle
pickle_off = open("EmpID.pickle", 'rb')
EmpID = pickle.load(pickle_off)
print(EmpID)

上記スクリプト（アンピクル）を実行すると、初期化時と同じ内容の辞書を取得できます。ここでもバイトデータを読み込むため、「r」ではなく「rb」（バイナリ読み込み）を使用している点に注意してください。

出力結果

{1: 'Zack', 2: '53050', 3: 'IT', 4: '38', 5: 'Flipkart'}

pickleで発生する主な例外

pickleモジュールを扱う際に発生しうる代表的な例外は以下の通りです。

• pickle.PicklingError：オブジェクトがpickle化に対応していない場合に発生します。
• pickle.UnpicklingError：ファイルに不正または破損したデータが含まれている場合に発生します。
• EOFError：ファイルの終端が検出された場合に発生します。

pickleのメリット

• 複雑なデータ構造を手軽に保存できる。
• 使いやすく軽量で、わずか数行のコードで実装できる。
• 生成されたpickleファイルはそのままでは読み取りにくいため、一定の保護効果が期待できる。

pickleのデメリット

• Python以外の言語では、pickle化されたPythonオブジェクトを復元できない場合がある。
• 悪意のあるソースからのデータをアンピクルすると、セキュリティリスクが生じる。

なお、言語間の互換性が必要な場合は、テキストベースで多くの言語から扱えるJSON形式（jsonモジュール）の利用も検討するとよいでしょう。