Mongo Mailbag #2: Updating GridFS Files

Welcome to week two of Mongo Mailbag, where I take a question from the Mongo mailing list and answer it in more detail. If you have a question you’d like to see answered in excruciating detail, feel free to email it to me.

Is it possible (with the PHP driver) to storeBytes into GridFS (for example CSS data), and later change that data?!

I get some strange behavior when passing an existing _id value in the $extra array of MongoGridFS::storeBytes, sometimes Apache (under Windows) crashes when reloading the file, sometimes it doesn’t seem to be updated at all.

So I wonder, is it even possible to update files in GridFS?! 🙂

-Wouter

If you already understand GridFS, feel free to skip to the last section. For everyone else…

Intro to GridFS

GridFS is the standard way MongoDB drivers handle files; a protocol that allows you to save an arbitrarily large file to the database. It’s not the only way, it’s not the best way (necessarily), it’s just the built-in way that all of the drivers support. This means that you can use GridFS to save a file in Ruby and then retrieve it using Perl and visa versa.

Why would you want to store files in the database? Well, it can be handy for a number of reasons:

  • If you set up replication, you’ll have automatic backups of your files.
  • You can keep millions of files in one (logical) directory… something most filesystems either won’t allow or aren’t good at.
  • You can keep information associated with the file (who’s edited it, download count, description, etc.) right with the file itself.
  • You can easily access info from random sections of large files, another thing traditional file tools aren’t good at.

There are some limitations, too:

  • You can’t have an arbitrary number of files per document… it’s one file, one document.
  • You must use a specific naming scheme for the collections involved: prefix.files and prefix.chunks (by default prefix is “fs”: fs.files and fs.chunks).

If you have complex requirements for your files (e.g., YouTube), you’d probably want to come up with your own protocol for file storage. However, for most applications, GridFS is a good solution.

How it Works

GridFS breaks large files into manageable chunks. It saves the chunks to one collection (fs.chunks) and then metadata about the file to another collection (fs.files). When you query for the file, GridFS queries the chunks collection and returns the file one piece at a time.

Here are some common questions about GridFS:

Q: Why not just save the whole file in a single document?
A: MongoDB has a 4MB cap on document size.
Q: That’s inconvenient, why?
A: It’s an arbitrary limit, mostly to prevent bad schema design.
Q: But in this case it would be so handy!
A: Not really. Imagine you’re storing a 20GB file. Do you really want to return the whole thing at once? That means 20GB or memory will be used whenever you query for that document. Do you even have that much memory? Do you want it taken up by a single request?
Q: Well, no.
A: The nice thing about GridFS is that it streams the data back to the client, so you never need more than 4MB of memory.
Q: Now I know.
A: And knowing is half the battle.
Together: G.I. Joe!

Answer the Damn Question

Back to Wouter’s question: changing the metadata is easy: if we wanted to add, say, a “permissions” field, we could run the following PHP code:

$files = $db->fs->files;
$files->update(array("filename" => "installer.bin"), array('$set' => array("permissions" => "555")));

// or, equivalently, from the MongoGridFS object:

$grid->update(array("filename" => "installer.bin"), array('$set' => array("permissions" => "555")));

Updating the file itself, what Wouter is actually asking about, is significantly more complex. If we want to update the binary data, we’ll need to reach into the chunks collection and update every document associated with the file. Edit: Unless you’re using the C# driver! See Sam Corder’s comment below. It would look something like:

// get the target file's chunks
$chunks = $db->fs->chunks;
$cursor = $chunks->find(array("file_id" => $fileId))->sort(array("n" => 1));

$newLength = 0;

foreach ($cursor as $chunk) {
    // read in a string of bytes from the new version of the file
    $bindata = fread($file, MongoGridFS::$chunkSize);
    $newLength += strlen($bindata);

    // put the new version's contents in this chunk
    $chunk->data = new MongoBinData($bindata);

    // update the chunks collection with this new chunk
    $chunks->save($chunk);
}

// update the file length metadata (necessary for retrieving the file)
$db->fs->files->update(array("_id" => $fileId), array('$set' => array("length" => $newLength));

The code above doesn’t handle a bunch of cases (what if the new file is a different number of chunks than the old one?) and anything beyond this basic scenario gets irritatingly complex. If you’re updating individual chunks you should probably just remove the GridFS file and save it again. It’ll end up taking about the same amount of time and be less error-prone.

24 thoughts on “Mongo Mailbag #2: Updating GridFS Files

  1. Good write up on the internals. BTW didn’t they say “Yo Joe!”? That’s how I remember it. Of course I’ve just dated myself and admitted to a sordid past in one line. 🙂

    Begin Shameless Plug
    The C# driver exposes a read/write stream that can update a file in place. Simply get a stream of the file, seek to the spot you want to update, write your new bits and close the file. The only limitation is that you can’t add bits into the middle of the file. You can only change existing bits or append to the end of the stream.
    End Shameless Plug

    Like

  2. Good write up on the internals. BTW didn’t they say “Yo Joe!”? That’s how I remember it. Of course I’ve just dated myself and admitted to a sordid past in one line. 🙂

    Begin Shameless Plug
    The C# driver exposes a read/write stream that can update a file in place. Simply get a stream of the file, seek to the spot you want to update, write your new bits and close the file. The only limitation is that you can’t add bits into the middle of the file. You can only change existing bits or append to the end of the stream.
    End Shameless Plug

    Like

  3. I’m honored my question made it to your blog :-). I was trying to store CSS files into GridFS whose contents could be changed.

    Someone on the mailing list suggested to add the updated CSS file as a new file to GridFS, with the same filename, and then remove the outdated one. Much easier :-).

    Like

  4. I’m honored my question made it to your blog :-). I was trying to store CSS files into GridFS whose contents could be changed.

    Someone on the mailing list suggested to add the updated CSS file as a new file to GridFS, with the same filename, and then remove the outdated one. Much easier :-).

    Like

  5. “Imagine you’re storing a 20GB file. Do you really want to return the whole thing at once? That means 20GB or memory will be used whenever you query for that document.”
    FYI, there are ways for zero-copy data passing.

    Like

  6. “Imagine you’re storing a 20GB file. Do you really want to return the whole thing at once? That means 20GB or memory will be used whenever you query for that document.”
    FYI, there are ways for zero-copy data passing.

    Like

  7. That’s really cool, thanks for the link!

    I don’t think it wouldn’t really work with Mongo, though, because you have to parse the received data to figure out which bytes are even part of the file.

    Like

  8. That’s really cool, thanks for the link!

    I don’t think it wouldn’t really work with Mongo, though, because you have to parse the received data to figure out which bytes are even part of the file.

    Like

  9. Pingback: ehcache.net
  10. Hi, Why there is this limitation :
    You can’t have an arbitrary number of files per document… it’s one file, one document.

    Like

    1. It’s arbitrary, it’s just the way the API was designed.  I think it was supposed to be like, in a filesystem a filename points to one file (not many).  However, it would be easy enough to roll your own GridFS-like API that allowed multiple files per document.

      Like

Leave a comment