Manifest.txt PostInstall.txt README.rdoc Rakefile rails/init.rb script/console script/destroy script/generate spec/query_analyzer_spec.rb spec/spec.opts spec/spec_helper.rb tasks/rspec.rake @@ -1 +1,2 @@ .DS_Store +doc/* .gitignore @@ -1,3 +1,15 @@ +$:.unshift(File.dirname(__FILE__)) unless + $:.include?(File.dirname(__FILE__)) || $:.include?(File.expand_path(File.dirname(__FILE__))) + +# +# PostgreSQL/Oracle Adapter by: +# http://spazidigitali.com/2006/12/01/rails-query-analyzer-plugin-now-also-on-oracle-and-postgresql/ +# + +module QueryAnalyzer + VERSION = '0.0.1' +end + class Array protected def qa_columnized_row(fields, sized) @@ -27,28 +39,114 @@ class Array end - +# +# Connection Adapters +# module ActiveRecord module ConnectionAdapters + + # + # MySQL + # class MysqlAdapter < AbstractAdapter private alias_method :select_without_analyzer, :select - + + def select(sql, name = nil) + query_results = select_without_analyzer(sql, name) + + if @logger and @logger.level <= Logger::INFO + @logger.debug( + @logger.silence do + format_log_entry("Analyzing #{name}\n", + "#{select_without_analyzer("explain #{sql}", name).qa_columnized}\n" + ) + end + ) if sql =~ /^select/i + end + query_results + end + end + + # + # Oracle + # + class OracleAdapter < AbstractAdapter + #Name of plan table, default value 'PLAN_TABLE'. + cattr_accessor :plan_table_name + @@plan_table_name = 'PLAN_TABLE' + + #Plan details to use: + # BASIC ..... displays minimum information + # TYPICAL ... displays most relevant information + # SERIAL .... like TYPICAL but without parallel information + # ALL ....... displays all information + cattr_accessor :plan_details + @@plan_details ='TYPICAL' + + private + alias_method :select_without_analyzer, :select + + #Query to output the computed plan using the dbms_xplan package (available from Oracle 9i onwards) + def plan_query + "select plan_table_output from table(dbms_xplan.display('#{@@plan_table_name}',null,'#{@@plan_details}'))" + end + def select(sql, name = nil) query_results = select_without_analyzer(sql, name) - - if @logger and @logger.level == Logger::DEBUG + + if @logger and @logger.level <= Logger::INFO + execute("explain plan for #{sql}", name) @logger.debug( - ActiveRecord::Base.silence do - explain_results = select_without_analyzer("explain #{sql}", name) - format_log_entry("\033[1;34m############ FIXME - UNOPTIMIZED QUERY for #{name} ############ \033[0m\n", - "#{explain_results.qa_columnized}\n" - ) if explain_results[0]["rows"].to_i > 100 && sql =~ / where[\s(]/i + @logger.silence do + format_log_entry("Analyzing #{name}\n", + "#{select_without_analyzer(plan_query, name).qa_columnized}\n" + ) end ) if sql =~ /^select/i - end + end query_results end end + + # + # PostgreSQL + # + class PostgreSQLAdapter < AbstractAdapter + # if true then uses the ANALYZE option which (from postgresql manual): + #Carry out the command and show the actual run times. + cattr_accessor :explain_analyze + @@explain_analyze = nil + + #if true then uses the VERBOSE option which (from postgresql manual): + #Shows the full internal representation of the plan tree, + #rather than just a summary. Usually this option is only + #useful for specialized debugging purposes. + #The VERBOSE output is either pretty-printed or not, + #depending on the setting of the explain_pretty_print configuration parameter. + cattr_accessor :explain_verbose + @@explain_verbose = nil + + private + + alias_method :select_without_analyzer, :select + + def select(sql, name = nil) + query_results = select_without_analyzer(sql, name) + + if @logger and @logger.level <= Logger::INFO + @logger.debug(@logger.silence do + format_log_entry("Analyzing #{name}\n", + "#{select_without_analyzer("explain #{'analyze' if @@explain_analyze} #{'verbose' if @@explain_verbose} #{sql}", name).qa_columnized}\n") + end) if sql =~ /^select/i + end + + query_results + + end + + end + end + end lib/query_analyzer.rb README init.rb 772f350cf558749b4cc635efe230ac0ae758f7c8 Marcos Augusto x@nofxx.com http://github.com/nofxx/query-analyzer/commit/c99ca0b7281c18f1f075bab4a1bfb235cb655719 c99ca0b7281c18f1f075bab4a1bfb235cb655719 2009-01-17T21:30:57-08:00 2009-01-17T21:30:57-08:00 postgresl, orache and go gem 137f08074a918b5b0c9a8bb507241b3d3ce6e9f0 Marcos Augusto x@nofxx.com