Skip to content
EventMachine HandlerSocket MySQL plugin for direct read/write of InnoDB tables
Find file
Latest commit 2108e37 @igrigorik bump version
Failed to load latest commit information.
lib bump version
spec update support
.gitignore hello world
.rspec connect to server
Gemfile hello world
Gemfile.lock read from composite index update support
Rakefile hello world
em-handlersocket.gemspec update README example


EventMachine client for HandlerSocket MySQL plugin for direct read/write of InnoDB tables. This plugin bypasses any/all SQL parsing, query planner, and other MySQL locks, while giving you the advantage of InnoDB persistence, speed, and the network daemon! Best of all, HandlerSocket plugin runs alongside your regular MySQL engine, which means you still have the full advantage of a SQL console at your disposal.

HandlerSocket: The NoSQL MySQL & Ruby


  • Plays nicely with the (EventMachine) reactor
  • Find, Multi-find, Insert, Update, Delete support
  • No native extensions
  • Pipelined processing

Example: Open & Read from an InnoDB index

Open the PRIMARY key index on the widgets.user InnoDB table, and query for id == 1. {
  c =
  idx = {:id => 0, :db => 'widgets', :table => 'user', :index_name => 'PRIMARY', :columns => 'user_name'}

  d = c.open_index(idx)
  d.callback do

    d = c.query(:id => 0, :op => '=', :key => '1')
    d.errback { p 'uh oh!' }
    d.callback do |data|
      p ["received data", data]



(The MIT License) Copyright © 2011 Ilya Grigorik

Something went wrong with that request. Please try again.