A parser for InnoDB file formats, in Ruby
Switch branches/tags
Nothing to show
Clone or download
jeremycole Add new modes for parallelization of space-index-pages-summary
Add new mode space-inodes-fseg-id to get fseg id for each inode.

Add new mode space-index-fseg-pages-summary to do the same thing
as space-index-pages-summary but for only a single inode by fseg id.

Using the combination of these two new modes allows the user to
easily iterate multiple inodes in parallel to scan large tables
Latest commit cd8d35b Aug 31, 2018


A parser for InnoDB file formats, in Ruby

The purpose for this library and tools is to expose some otherwise hidden internals of InnoDB. This code is not intended for critical production usage. It is definitely buggy, and it may be dangerous. Neither its internal APIs or its output are considered stable and are subject to change at any time.

It is intended as for a few purposes:

  • As a learning tool. What better way to improve your understanding of a structure than to implement it in another language?
  • As a teaching tool. Using irb to interactively investigate the actual structures on disk is invaluable for demonstrating (to yourself or others) what is actually happening.
  • As an investigative tool. InnoDB unfortunately doesn't provide enough information about what it is doing or has done with its on-disk storage. How full are pages? Exactly how many records per page? How is the B+tree structured for a particular table? All of these questions can be answered easily with innodb_ruby.
  • As a debugging tool. While making changes to the structures or behaviors of InnoDB, it is necessary to have tools to expose the results both of the original behavior and the new one, in order to validate that the changes have the desired effect.

Various parts of this library and the tools included may have wildly differing maturity levels, as it is worked on primarily based on immediate needs of the authors.


Build Status