mysql-pause-adapter-ext 0.1.4

data/README

@@ -0,0 +1,100 @@
+= mysql-pause
+
+== Description
+
+mysql-pause is a proxy server to pause a query to MySQL.
+
+== Source Code
+
+https://bitbucket.org/winebarrel/mysql-pause
+
+== Dependency
+
+* EventMachine
+* RExec
+
+== Install
+
+gem install mysql-pause
+
+== Example
+=== Start server
+
+  shell> mysql-pause start
+  Starting daemon...
+  Waiting for daemon to start...
+  Daemon status: running pid=56921
+
+  shell> mysql -h 127.0.0.1 -P 13306 -u scott -ptiger
+  mysql> select 1;
+  +---+
+  | 1 |
+  +---+
+  | 1 |
+  +---+
+  1 row in set (0.00 sec)
+
+=== Pause
+
+  shell> mpctl pause
+
+  mysql> select 1;
+  (...no response...)
+
+=== Resume
+
+  shell> mpctl resume
+
+  (...resume response...)
+  +---+
+  | 1 |
+  +---+
+  | 1 |
+  +---+
+  1 row in set (18.01 sec)
+
+== Extend MySQL adapter
+=== Example code
+
+  require 'active_record'
+  require 'mysql-pause/adapter-ext'
+  
+  ActiveRecord::Base.establish_connection(
+    :adapter   => 'mysql2',
+    :host      => '127.0.0.1',
+    :port      => 13306,
+    :username  => 'scott',
+    :password  => 'tiger',
+    :database  => 'employees',
+    :reconnect => true,
+  )
+  
+  class Employee < ActiveRecord::Base; end
+  
+  loop do
+    employee = Employee.new
+    employee.first_name = 'Taro'
+    employee.last_name = 'Yamada'
+    employee.save!
+    sleep 3
+  end
+
+=== Behavior
+
+  log> DEBUG -- :    (0.6ms)  BEGIN
+  log> DEBUG -- :   SQL (0.7ms)  INSERT INTO `employees` (`first_name`, `last_name`) VALUES ('Taro', 'Yamada')
+  log> DEBUG -- :    (0.8ms)  COMMIT
+  log> DEBUG -- :    (0.6ms)  BEGIN
+  
+  shell> mpctl pause
+  shell> service mysql restart
+  shell> mpctl resume
+  
+  log> DEBUG -- :    (0.6ms)  BEGIN
+  (...handle error and reconnect...)
+  log> DEBUG -- : Mysql2::Error: %MYSQL_PAUSE%;;1000;;Aborted backend connection: BEGIN
+  log> WARN -- : ActiveRecord::StatementInvalid: Mysql2::Error: %MYSQL_PAUSE%;;1000;;Aborted backend connection: BEGIN
+  log> DEBUG -- :    (0.3ms)  BEGIN
+  log> DEBUG -- :   SQL (2.1ms)  INSERT INTO `employees` (`first_name`, `last_name`) VALUES ('Taro', 'Yamada')
+  log> DEBUG -- :    (0.8ms)  COMMIT
+

data/lib/mysql-pause/adapter-ext.rb

@@ -0,0 +1,26 @@
+require 'active_record'
+require 'active_record/connection_adapters/abstract_mysql_adapter'
+require 'mysql-pause/error'
+
+module ActiveRecord
+  module ConnectionAdapters
+    class AbstractMysqlAdapter
+
+      alias mysql_pause_execute_orig execute
+
+      def execute(sql, name = nil)
+        begin
+          mysql_pause_execute_orig(sql, name)
+        rescue => e
+          raise(e) unless MysqlPause::Error.mysql_pause_error?(e)
+
+          message = "#{e.class.name}: #{e.message}"
+          @logger.warn message if @logger
+          reconnect!
+          retry
+        end
+      end
+
+    end # AbstractMysqlAdapter
+  end # ConnectionAdapters
+end # ActiveRecord

data/lib/mysql-pause/error.rb

@@ -0,0 +1,45 @@
+module MysqlPause
+  class Error
+
+    ERROR_HEADER = '%MYSQL_PAUSE%'
+    ERROR_SEPARATOR = ';;'
+    ERROR_LIST = {}
+
+    class << self
+      def create_error_message(error_code, sequence_id)
+        # fetch error info
+        mysql_error_code, sql_state, message = ERROR_LIST[error_code]
+
+        # create mysql error message
+        message = [ERROR_HEADER, error_code, message].join(ERROR_SEPARATOR)
+
+        # create header
+        mysql_error_code = convert_to_chars(mysql_error_code, 2)
+        payload = ["\xFF", mysql_error_code, '#', sql_state, message].join
+        payload_length = convert_to_chars(payload.length, 3)
+        sequence_id = convert_to_chars(sequence_id, 1)
+
+        [payload_length, sequence_id, payload].join
+      end
+
+      def mysql_pause_error?(e)
+        /#{Regexp.escape(ERROR_HEADER)}/ =~ e.message
+      end
+
+      private
+
+      def convert_to_chars(number, length)
+        (0...length).map {|i| (number >> (8 * i)) & 0xFF }.pack("C*")
+      end
+
+      def define_error(name, code, values)
+        const_set(name, code)
+        ERROR_LIST[code] = values
+      end
+    end # self
+
+    # error list
+    define_error :ABORTED_BACKEND_CONNECTION, 1000, [2013, '08S01', 'Aborted backend connection']
+
+  end # Errot
+end # MysqlPause

metadata

@@ -0,0 +1,47 @@
+--- !ruby/object:Gem::Specification
+name: mysql-pause-adapter-ext
+version: !ruby/object:Gem::Version
+  version: 0.1.4
+  prerelease: 
+platform: ruby
+authors:
+- winebarrel
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-05-24 00:00:00.000000000 Z
+dependencies: []
+description: 
+email: sgwr_dts@yahoo.co.jp
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README
+- lib/mysql-pause/adapter-ext.rb
+- lib/mysql-pause/error.rb
+homepage: https://bitbucket.org/winebarrel/mysql-pause
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: mysql adapter extension for mysql-pause
+test_files: []