Visit complete MongoDB roadmap

← Back to Topics List

Binary data

Binary Data is a datatype in MongoDB that is used to store binary content like images, audio files, or any other data that can be represented in binary format. This datatype is particularly useful when you need to store large files, manipulate raw binary data, or work with data that cannot be encoded as UTF-8 strings.

In MongoDB, binary data is represented using the BSON Binary type, which uses a binary format for encoding and decoding data. The BSON Binary type has several subtypes to better categorize the kind of binary data being stored, such as B_GENERAL, B_FUNCTION, and B_BINARY.

Advantages of using Binary Data

  • Storage: Storing files directly in the MongoDB database removes the necessity for an additional file storage system and eases the retrieval and management of the files.
  • Efficiency: Binary data can be more efficiently stored and processed than textual representations of the same data.
  • Interoperability: Storing data in binary format allows for seamless communication between systems using different character encodings and serialization formats.

Working with Binary Data in MongoDB

To work with binary data in MongoDB, you will need to utilize the Binary class provided by your MongoDB driver. This class offers methods to create, encode, and decode binary data objects.

Here’s an example of creating a binary data object using the Binary class in Python:

from bson.binary import Binary
from bson import ObjectId

# Create a binary data object
image_data = open("image.jpg", "rb").read()
binary_image_data = Binary(image_data)

# Storing binary data in a MongoDB collection
data_collection = db.collection_name
document = {
    "name": "Sample Image",
    "image_data": binary_image_data,
stored_data = data_collection.insert_one(document)

When it comes to retrieving binary data from the database, you can use your MongoDB driver’s find method to query the required document and access the binary field.

For example, in Python:

# Retrieve binary data from the database
document = data_collection.find_one({"name": "Sample Image"})
retrieved_image_data = document["image_data"]

# Save the retrieved binary data to a new file
with open("retrieved_image.jpg", "wb") as f:

Keep in mind that storing large binary files in a MongoDB database might result in performance issues. In such cases, consider using a separate file storage system or MongoDB’s GridFS to store and manage binary data.

Community is the 6th most starred project on GitHub and is visited by hundreds of thousands of developers every month.

Roadmaps Best Practices Guides Videos Store YouTube by Kamran Ahmed

Community created roadmaps, articles, resources and journeys to help you choose your path and grow in your career.

© · FAQs · Terms · Privacy


The leading DevOps resource for Kubernetes, cloud-native computing, and the latest in at-scale development, deployment, and management.