igrigorik / em-handlersocket

EventMachine HandlerSocket MySQL plugin for direct read/write of InnoDB tables

EM-HandlerSocket

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

Features

• 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.

EM.run {
  c = EM::HandlerSocket.new
  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]
    end
  end
}

Resources

• HandlerSocket Protocol
• HandlerSocket @ DeNA

License

(The MIT License) Copyright © 2011 Ilya Grigorik