互換性

バイナリ データ

Pythonのすべてのバージョンで、 PyMongo はバイト クラスのインスタンスをバイナリ データとして、サブタイプ のバイナリ0 データとしてエンコードします。これはバイナリ データのデフォルトのサブタイプです。 Python3 では、 PyMongo はこれらの値を:bytes クラスのインスタンスにデコードします。 Python2 では、ドライバーはそれらをサブタイプ を持つ Binaryクラスのインスタンスにデコードします。違いを示すコード例については、 0拡張JSONページ を参照してください。

サブタイプ を持つJSONバイナリ値をデコードする場合、ドライバーは同じように動作します。0 Python3 では、これらの値はbytes クラスのインスタンスにデコードされます。 Python2 では、ドライバーはこれらをサブタイプBinary を持つ0 クラスのインスタンスにデコードします。違いを示すコード例については、 拡張JSONページ を参照してください。

選択した ObjectId

Python 2 で ObjectId を選択し、 Python 3 で選択解除する場合は、pickle.loads() メソッドの引数として encoding='latin-1' を渡す必要があります。

次の例では、Python 3 を使用してPython 2 で選択された ObjectId の選択を解除する方法を示します。

import pickle
pickle.loads(b'<ObjectId byte stream>', encoding='latin-1')

Python 3アプリケーションが互換性のある直列化プロトコルを使用して ObjectId を選択する場合、 Python 2 を使用して選択解除できます。 Python 3 で互換性のあるプロトコルを指定するには、pickle.dumps() メソッドの protocol パラメーターに 0、1、または 2 の値を渡します。

次の例ではPython 3 で ObjectId を選択し、ObjectId と結果の bytesインスタンスを出力します。

import pickle
from bson.objectid import ObjectId
oid = ObjectId()
oid_bytes = pickle.dumps(oid, protocol=2)
print("ObjectId: {}".format(oid))
print("ObjectId bytes: {}".format(oid_bytes))

ObjectId: 67af9b1fae9260c0e97eb9eb
ObjectId bytes: b'\x80\x02cbson.objectid\nObjectId\nq\x00...

次の例では、 前の例から ObjectId のピリオドを解除し、bytes インスタンスと ObjectId インスタンスを出力します。

import pickle
from bson.objectid import ObjectId
oid_bytes = b'\x80\x02cbson.objectid\nObjectId\nq\x00...'
oid = pickle.loads(oid_bytes)
print("ObjectId bytes: {}".format(oid_bytes))
print("ObjectId: {}".format(oid))

ObjectId bytes: b'\x80\x02cbson.objectid\nObjectId\nq\x00)...
ObjectId: 67af9b1fae9260c0e97eb9eb