mysqlknife 1.2.0 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: b2ee2b0915fae46573419b2abd8bb4af707ddf9e
-  data.tar.gz: 957ca26b80fd6f10c0a3460ccc554ae4d7064814
+  metadata.gz: 53677c0c444917af983ac901c03052cdb29ed3e6
+  data.tar.gz: b87aee8249871d370a69661c93dc8e02a120f5b3
 SHA512:
-  metadata.gz: f0da2a9dd580946da50082e44d16e3014cfb5b43aa730819fe3c2fb616bb15443e52ffdc3242568b517fc893c932cfde592badb99458cc32a4759d5f5840ec41
-  data.tar.gz: 3edb1981500349a11f9665cb819452071879065d1f51232937e7c3ee9e6129a3a65413b1800b4ecb09ad3f628c67bf38932fcaab40aa8f9f9d21ccf4334bc9d4
+  metadata.gz: 805c9aa77e5152d8971b3b6c9b214426917405463cd2fe77923e136ba46ae695b09e0eb0dc962e373294a5d980ee8be17e5bf196aacd51ab714e178e77d6bd4b
+  data.tar.gz: 126e56a02a2b9032016fdfd1ad8eaf0b009208a01d95a115a3e82ed707f8a3236740b60ca0787202824ab86da95591ab1b5116b3856512c555160defc6f306a2

data/README.md

@@ -1,17 +1,34 @@
 # Mysqlknife
 
-TODO: Write a gem description
+The missing utility for MySQL DBA:
+- Checksum tables.
+- Skip error is slave.
+- Swap Databases
+- Kill process for RDS or MySQL.
 
 ## Installation
 
 Install this tool executing the following command:
 
 ```Shell
-$ gem install mysqlkill
+$ gem install mysqlknife
 ```
 
 ## Usage
 
+### Checksum table
+
+Compare two tables with checksum:
+
+```Shell
+$ mysqlknife checksum --from h=127.0.0.1,P=3306,u=root,p=admin,d=demo_from --to h=127.0.0.1,P=3306,u=root,p=admin,d=demo_to --table foo
+```
+
+### Skip error in slave.
+
+```Shell
+$ mysqlknife skip --host 127.0.0.1 --user root --password admin --behind -120
+```
 
 ### Swap Databases
 
@@ -28,6 +45,9 @@ $ mysql -h 127.0.0.1 -u root -padmin < swap.sql
 
 ### Kill process
 
+This action permit kill MySQL process in Amazon RDS or normal service, and log
+output who kill.
+
 Please, follow next instructions to kill process:
 
 ```Shell

data/bin/mysqlknife

@@ -87,21 +87,45 @@ command :kill do |c|
     else
       kill = Mysqlknife::Kill.new(options.__hash__)
 
-      if options.list.nil?
-        kill.clear unless kill.list.first.nil?
-      else
-        unless kill.list.first.nil?
-          table = Terminal::Table.new do |t|
-            t.add_row(kill.list.first.keys)
-            t.add_separator
+      if kill.check_privileges
+        if options.list.nil?
+          kill.clear unless kill.list.first.nil?
+        else
+          unless kill.list.first.nil?
+            table = Terminal::Table.new do |t|
+              t.add_row(kill.list.first.keys)
+              t.add_separator
 
-            kill.list.each do |row|
-              t.add_row(row.values)
+              kill.list.each do |row|
+                t.add_row(row.values)
+              end
             end
+            puts table
           end
-          puts table
         end
+      else
+        puts 'User does not have process privileges.'
       end
     end
   end
 end
+
+command :skip do |c|
+  c.description = 'Skipping the current replication error in Amazon RDS.'
+  c.syntax      = %w(mysqlknife skip
+                     --host 127.0.0.1
+                     --user root
+                     --password admin
+                     --behind -120).join(' ')
+  c.option '--behind Integer', Integer, 'Set Seconds Behind Master, default is 120.'
+  c.action do |args, options|
+    if options.host.nil?   ||
+       options.user.nil?   ||
+       options.behind.nil?
+      puts c.syntax
+    else
+      rep = Mysqlknife::Replica.new(options.__hash__)
+      rep.skip
+    end
+  end
+end

data/lib/mysqlknife.rb

@@ -3,6 +3,7 @@
 require 'mysqlknife/config'
 require 'mysqlknife/connection'
 require 'mysqlknife/checksum'
+require 'mysqlknife/replica'
 require 'mysqlknife/kill'
 require 'mysqlknife/sql'
 require 'mysqlknife/swap'

data/lib/mysqlknife/kill.rb

@@ -14,7 +14,6 @@ module Mysqlknife
       if @conn.execute(sql_user).first['CURRENT_USER'] =~ /^root\@/
         return true
       else
-
         return true if @conn.execute(sql_grants).first.values.to_s =~ /PROCESS/
       end
     end

data/lib/mysqlknife/replica.rb

@@ -0,0 +1,48 @@
+# encoding: utf-8
+
+module Mysqlknife
+  class Replica
+    def initialize(options = {})
+      @conn   = Connection.new(options)
+      @sql    = Sql.new
+      @behind = options[:behind]
+    end
+
+    def check_status_negative(behind)
+      @behind < 0 && behind < 0 && behind <= @behind && behind != 0
+    end
+
+    def check_status_positive(behind)
+      @behind > 0 && behind > 0 && @behind <= behind && behind != 0
+    end
+
+    def skip
+      procedure_name  = @sql.show_procedure('rds_skip_repl_error')
+      exist_procedure = @conn.execute(procedure_name)
+      slave_status    = @conn.execute(@sql.slave_status).first
+
+      # Resolv Negative Lag:
+      if check_status_negative(slave_status['Seconds_Behind_Master'])
+        puts %W(#{Time.now.getutc} : MySQL Skip error replica -
+                #{slave_status.map { |k, v| "#{k}: #{v}" }.join(', ')}
+                ).join(' ')
+        if exist_procedure.first.nil?
+          @conn.execute(@sql.mysql_skip_repl_error)
+          while @conn.next_result
+            message = @conn.store_result
+            puts %W(#{Time.now.getutc} : MySQL Skip error replica -
+                    Message: #{message}).join(' ')
+          end
+        else
+          message = @conn.execute(@sql.rds_skip_repl_error).first['Message']
+          puts %W(#{Time.now.getutc} : MySQL Skip error replica -
+                  Message: #{message}).join(' ')
+        end
+      # Resolv Positive Lag:
+      elsif check_status_positive(slave_status['Seconds_Behind_Master'])
+        puts %W(#{Time.now.getutc} : MySQL Skip error replica -
+                Not implemented.).join(' ')
+      end
+    end
+  end
+end

data/lib/mysqlknife/sql.rb

@@ -59,7 +59,7 @@ module Mysqlknife
                'event_scheduler')
                AND id != CONNECTION_ID()
                AND command != 'Binlog Dump').join(' ')
-      sql << " AND #{where}" unless where.nil?
+      sql << " AND #{where};" unless where.nil?
     end
 
     def show_procedure(name)
@@ -96,5 +96,19 @@ module Mysqlknife
       end
       "SELECT SUM(CRC32(CONCAT(#{md5.join(', ')}))) AS sum FROM #{@table};"
     end
+
+    def slave_status
+      'SHOW SLAVE STATUS;'
+    end
+
+    def rds_skip_repl_error
+      'CALL mysql.rds_skip_repl_error;'
+    end
+
+    def mysql_skip_repl_error
+      %w(STOP SLAVE;
+         SET GLOBAL SQL_SLAVE_SKIP_COUNTER = 1;
+         START SLAVE;).join(' ')
+    end
   end
 end

data/lib/mysqlknife/version.rb

@@ -1,5 +1,5 @@
 # encoding: utf-8
 
 module Mysqlknife
-  VERSION = '1.2.0'
+  VERSION = '1.3.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: mysqlknife
 version: !ruby/object:Gem::Version
-  version: 1.2.0
+  version: 1.3.0
 platform: ruby
 authors:
 - Nicola Strappazzon C.
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-04-05 00:00:00.000000000 Z
+date: 2014-04-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: commander
@@ -52,7 +52,7 @@ dependencies:
     - - '>='
       - !ruby/object:Gem::Version
         version: 2.5.5
-description: MySQL knife tools
+description: MySQL Knife tools
 email: nicola51980@gmail.com
 executables:
 - mysqlknife
@@ -64,6 +64,7 @@ files:
 - lib/mysqlknife/config.rb
 - lib/mysqlknife/connection.rb
 - lib/mysqlknife/kill.rb
+- lib/mysqlknife/replica.rb
 - lib/mysqlknife/sql.rb
 - lib/mysqlknife/swap.rb
 - lib/mysqlknife/version.rb
@@ -93,5 +94,5 @@ rubyforge_project:
 rubygems_version: 2.1.11
 signing_key: 
 specification_version: 4
-summary: ''
+summary: The missing utility for MySQL.
 test_files: []