activewarehouse 0.1.0

data/README

@@ -0,0 +1,41 @@
+ActiveWarehouse
+===============
+The ActiveWarehouse library provides classes and functions which help with building Data Warehouses using Rails. It can be installed either as a plugin or as a Gem. If you install it as a gem you must include the following in your config/environment.rb:
+
+  require_gem 'activewarehouse'
+  require 'active_warehouse'
+  
+Additionally, to use the Rake tasks you must include the following in your Rakefile:
+
+  load 'tasks/active_warehouse_tasks.rake'
+
+Generators
+===============
+ActiveWarehouse comes with several generators
+
+ script/generate fact Sales
+ script/generate fact sales
+ 
+   Creates a SalesFact class and a sales_facts table.
+ 
+ script/generate dimension Region
+ script/generate dimension region
+   
+   Creates a RegionDimension class and a region_dimension table.
+ 
+ script/generate cube RegionalSales
+ script/generate cube regional_sales
+ 
+   Creates a RegionalSalesCube class.
+   
+The rules for naming are as follows:
+
+Facts:
+  Fact classes and tables follow the typical Rails rules: classes are singular and tables are pluralized. 
+  Both the class and table name are suffixed by "_fact".
+Dimensions:
+  Dimension classes and tables are both singular. 
+  Both the class name and the table name are suffixed by "_dimension".
+Cube:
+  Cube class is singular. If a cube table is created it will also be singular.
+  

data/Rakefile

@@ -0,0 +1,121 @@
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+require 'rake/gempackagetask'
+require 'rake/contrib/rubyforgepublisher'
+
+require File.join(File.dirname(__FILE__), 'lib/active_warehouse', 'version')
+
+PKG_BUILD       = ENV['PKG_BUILD'] ? '.' + ENV['PKG_BUILD'] : ''
+PKG_NAME        = 'activewarehouse'
+PKG_VERSION     = ActiveWarehouse::VERSION::STRING + PKG_BUILD
+PKG_FILE_NAME   = "#{PKG_NAME}-#{PKG_VERSION}"
+PKG_DESTINATION = ENV["PKG_DESTINATION"] || "../#{PKG_NAME}"
+
+RELEASE_NAME  = "REL #{PKG_VERSION}"
+
+RUBY_FORGE_PROJECT = "activewarehouse"
+RUBY_FORGE_USER    = "aeden"
+
+desc 'Default: run unit tests.'
+task :default => :test
+
+desc 'Test the active_warehouse plugin.'
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'lib'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = true
+end
+
+desc 'Generate documentation for the active_warehouse plugin.'
+Rake::RDocTask.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'ActiveWarehouse'
+  rdoc.options << '--line-numbers' << '--inline-source'
+  rdoc.rdoc_files.include('README')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+# Gem Spec
+PKG_FILES = FileList[
+  '[a-zA-Z]*.rb',
+  'README',
+  'TODO',
+  'Rakefile',
+  'db/**/*',
+  'doc/**/*',
+  'generators/**/*', 
+  'lib/**/*',
+  'tasks/**/*'
+] - [ 'test' ]
+
+spec = Gem::Specification.new do |s|
+  s.name = 'activewarehouse'
+  s.version = PKG_VERSION
+  s.summary = "Build data warehouses with Rails."
+  s.description = <<-EOF
+    ActiveWarehouse extends Rails to provide functionality specific for building data warehouses.
+  EOF
+
+  s.add_dependency('rake', '>= 0.7.1')
+  s.add_dependency('activesupport',    '>= 1.3.1.5618')
+  s.add_dependency('activerecord',     '>= 1.14.4.5618')
+  s.add_dependency('actionpack',       '>= 1.12.5.5618')
+
+  s.rdoc_options << '--exclude' << '.'
+  s.has_rdoc = false
+
+  s.files = PKG_FILES.to_a.delete_if {|f| f.include?('.svn')}
+  s.require_path = 'lib'
+
+  #s.bindir = "bin" # Use these for applications.
+  #s.executables = []
+  #s.default_executable = ""
+
+  s.author = "Anthony Eden"
+  s.email = "anthonyeden@gmail.com"
+  s.homepage = "http://activewarehouse.rubyforge.org"
+  s.rubyforge_project = "activewarehouse"
+end
+
+Rake::GemPackageTask.new(spec) do |pkg|
+  pkg.gem_spec = spec
+  pkg.need_tar = true
+  pkg.need_zip = true
+end
+
+desc "Generate code statistics"
+task :lines do
+  lines, codelines, total_lines, total_codelines = 0, 0, 0, 0
+
+  for file_name in FileList["lib/**/*.rb"]
+    next if file_name =~ /vendor/
+    f = File.open(file_name)
+
+    while line = f.gets
+      lines += 1
+      next if line =~ /^\s*$/
+      next if line =~ /^\s*#/
+      codelines += 1
+    end
+    puts "L: #{sprintf("%4d", lines)}, LOC #{sprintf("%4d", codelines)} | #{file_name}"
+    
+    total_lines     += lines
+    total_codelines += codelines
+    
+    lines, codelines = 0, 0
+  end
+
+  puts "Total: Lines #{total_lines}, LOC #{total_codelines}"
+end
+
+desc "Publish the release files to RubyForge."
+task :release => [ :package ] do
+  `rubyforge login`
+
+  for ext in %w( gem tgz zip )
+    release_command = "rubyforge add_release activewarehouse #{PKG_NAME} 'REL #{PKG_VERSION}' pkg/#{PKG_NAME}-#{PKG_VERSION}.#{ext}"
+    puts release_command
+    system(release_command)
+  end
+end

data/TODO

@@ -0,0 +1,4 @@
+TODO list:
+
+* Modify the fact generator so that the migration has a map for foreign key and a map for fact attributes. The foreign keys can then automatically be indexed as that is pretty much standard behavior.
+* Make the belongs_to connection between facts and dimensions automatic.

data/db/migrations/001_create_table_reports.rb

@@ -0,0 +1,28 @@
+class CreateTableReports < ActiveRecord::Migration
+  def self.up
+    create_table :table_reports do |t|
+      t.column :title, :string
+      t.column :cube_name, :string, :null => false
+      
+      t.column :column_dimension_name, :string
+      t.column :column_hierarchy, :string
+      t.column :column_constraints, :text
+      t.column :column_stage, :integer
+      t.column :column_param_prefix, :string
+      
+      t.column :row_dimension_name, :string
+      t.column :row_hierarchy, :string
+      t.column :row_constraints, :text
+      t.column :row_stage, :integer
+      t.column :row_param_prefix, :string
+      
+      t.column :fact_attributes, :text
+      
+      t.column :created_at, :datetime
+      t.column :updated_at, :datetime
+    end
+  end
+  def self.down
+    drop_table :table_reports
+  end
+end

data/doc/agg_queries.txt

@@ -0,0 +1,26 @@
+Aggregate 1:
+
+select d1.calendar_year, d2.store_state,sum(f.sales_quantity) as sales_quantity,sum(f.sales_dollar_amount) as sales_dollar_amount from pos_retail_sales_transaction_facts f join date_dimension d1 on f.date_id = d1.id join store_dimension d2 on f.store_id = d2.id group by d1.calendar_year, d2.store_state;
+select d1.calendar_year, d2.store_state, d2.store_county,sum(f.sales_quantity) as sales_quantity,sum(f.sales_dollar_amount) as sales_dollar_amount from pos_retail_sales_transaction_facts f join date_dimension d1 on f.date_id = d1.id join store_dimension d2 on f.store_id = d2.id group by d1.calendar_year, d2.store_state, d2.store_county;
+select d1.calendar_year, d2.store_state, d2.store_county, d2.store_city,sum(f.sales_quantity) as sales_quantity,sum(f.sales_dollar_amount) as sales_dollar_amount from pos_retail_sales_transaction_facts f join date_dimension d1 on f.date_id = d1.id join store_dimension d2 on f.store_id = d2.id group by d1.calendar_year, d2.store_state, d2.store_county, d2.store_city;
+select d1.calendar_year, d1.calendar_month_name, d2.store_state,sum(f.sales_quantity) as sales_quantity,sum(f.sales_dollar_amount) as sales_dollar_amount from pos_retail_sales_transaction_facts f join date_dimension d1 on f.date_id = d1.id join store_dimension d2 on f.store_id = d2.id group by d1.calendar_year, d1.calendar_month_name, d2.store_state;
+select d1.calendar_year, d1.calendar_month_name, d2.store_state, d2.store_county,sum(f.sales_quantity) as sales_quantity,sum(f.sales_dollar_amount) as sales_dollar_amount from pos_retail_sales_transaction_facts f join date_dimension d1 on f.date_id = d1.id join store_dimension d2 on f.store_id = d2.id group by d1.calendar_year, d1.calendar_month_name, d2.store_state, d2.store_county;
+select d1.calendar_year, d1.calendar_month_name, d2.store_state, d2.store_county, d2.store_city,sum(f.sales_quantity) as sales_quantity,sum(f.sales_dollar_amount) as sales_dollar_amount from pos_retail_sales_transaction_facts f join date_dimension d1 on f.date_id = d1.id join store_dimension d2 on f.store_id = d2.id group by d1.calendar_year, d1.calendar_month_name, d2.store_state, d2.store_county, d2.store_city;
+select d1.calendar_year, d1.calendar_month_name, d1.calendar_week, d2.store_state,sum(f.sales_quantity) as sales_quantity,sum(f.sales_dollar_amount) as sales_dollar_amount from pos_retail_sales_transaction_facts f join date_dimension d1 on f.date_id = d1.id join store_dimension d2 on f.store_id = d2.id group by d1.calendar_year, d1.calendar_month_name, d1.calendar_week, d2.store_state;
+select d1.calendar_year, d1.calendar_month_name, d1.calendar_week, d2.store_state, d2.store_county,sum(f.sales_quantity) as sales_quantity,sum(f.sales_dollar_amount) as sales_dollar_amount from pos_retail_sales_transaction_facts f join date_dimension d1 on f.date_id = d1.id join store_dimension d2 on f.store_id = d2.id group by d1.calendar_year, d1.calendar_month_name, d1.calendar_week, d2.store_state, d2.store_county;
+select d1.calendar_year, d1.calendar_month_name, d1.calendar_week, d2.store_state, d2.store_county, d2.store_city,sum(f.sales_quantity) as sales_quantity,sum(f.sales_dollar_amount) as sales_dollar_amount from pos_retail_sales_transaction_facts f join date_dimension d1 on f.date_id = d1.id join store_dimension d2 on f.store_id = d2.id group by d1.calendar_year, d1.calendar_month_name, d1.calendar_week, d2.store_state, d2.store_county, d2.store_city;
+select d1.calendar_year, d1.calendar_month_name, d1.calendar_week, d1.day_number_in_calendar_month, d2.store_state,sum(f.sales_quantity) as sales_quantity,sum(f.sales_dollar_amount) as sales_dollar_amount from pos_retail_sales_transaction_facts f join date_dimension d1 on f.date_id = d1.id join store_dimension d2 on f.store_id = d2.id group by d1.calendar_year, d1.calendar_month_name, d1.calendar_week, d1.day_number_in_calendar_month, d2.store_state;
+select d1.calendar_year, d1.calendar_month_name, d1.calendar_week, d1.day_number_in_calendar_month, d2.store_state, d2.store_county,sum(f.sales_quantity) as sales_quantity,sum(f.sales_dollar_amount) as sales_dollar_amount from pos_retail_sales_transaction_facts f join date_dimension d1 on f.date_id = d1.id join store_dimension d2 on f.store_id = d2.id group by d1.calendar_year, d1.calendar_month_name, d1.calendar_week, d1.day_number_in_calendar_month, d2.store_state, d2.store_county;
+select d1.calendar_year, d1.calendar_month_name, d1.calendar_week, d1.day_number_in_calendar_month, d2.store_state, d2.store_county, d2.store_city,sum(f.sales_quantity) as sales_quantity,sum(f.sales_dollar_amount) as sales_dollar_amount from pos_retail_sales_transaction_facts f join date_dimension d1 on f.date_id = d1.id join store_dimension d2 on f.store_id = d2.id group by d1.calendar_year, d1.calendar_month_name, d1.calendar_week, d1.day_number_in_calendar_month, d2.store_state, d2.store_county, d2.store_city;
+
+
+Aggregate 2:
+
+select d1.calendar_year, d2.store_region,sum(f.sales_quantity) as sales_quantity,sum(f.sales_dollar_amount) as sales_dollar_amount from pos_retail_sales_transaction_facts f join date_dimension d1 on f.date_id = d1.id join store_dimension d2 on f.store_id = d2.id group by d1.calendar_year, d2.store_region;
+select d1.calendar_year, d2.store_region, d2.store_district,sum(f.sales_quantity) as sales_quantity,sum(f.sales_dollar_amount) as sales_dollar_amount from pos_retail_sales_transaction_facts f join date_dimension d1 on f.date_id = d1.id join store_dimension d2 on f.store_id = d2.id group by d1.calendar_year, d2.store_region, d2.store_district;
+select d1.calendar_year, d1.calendar_month_name, d2.store_region,sum(f.sales_quantity) as sales_quantity,sum(f.sales_dollar_amount) as sales_dollar_amount from pos_retail_sales_transaction_facts f join date_dimension d1 on f.date_id = d1.id join store_dimension d2 on f.store_id = d2.id group by d1.calendar_year, d1.calendar_month_name, d2.store_region;
+select d1.calendar_year, d1.calendar_month_name, d2.store_region, d2.store_district,sum(f.sales_quantity) as sales_quantity,sum(f.sales_dollar_amount) as sales_dollar_amount from pos_retail_sales_transaction_facts f join date_dimension d1 on f.date_id = d1.id join store_dimension d2 on f.store_id = d2.id group by d1.calendar_year, d1.calendar_month_name, d2.store_region, d2.store_district;
+select d1.calendar_year, d1.calendar_month_name, d1.calendar_week, d2.store_region,sum(f.sales_quantity) as sales_quantity,sum(f.sales_dollar_amount) as sales_dollar_amount from pos_retail_sales_transaction_facts f join date_dimension d1 on f.date_id = d1.id join store_dimension d2 on f.store_id = d2.id group by d1.calendar_year, d1.calendar_month_name, d1.calendar_week, d2.store_region;
+select d1.calendar_year, d1.calendar_month_name, d1.calendar_week, d2.store_region, d2.store_district,sum(f.sales_quantity) as sales_quantity,sum(f.sales_dollar_amount) as sales_dollar_amount from pos_retail_sales_transaction_facts f join date_dimension d1 on f.date_id = d1.id join store_dimension d2 on f.store_id = d2.id group by d1.calendar_year, d1.calendar_month_name, d1.calendar_week, d2.store_region, d2.store_district;
+select d1.calendar_year, d1.calendar_month_name, d1.calendar_week, d1.day_number_in_calendar_month, d2.store_region,sum(f.sales_quantity) as sales_quantity,sum(f.sales_dollar_amount) as sales_dollar_amount from pos_retail_sales_transaction_facts f join date_dimension d1 on f.date_id = d1.id join store_dimension d2 on f.store_id = d2.id group by d1.calendar_year, d1.calendar_month_name, d1.calendar_week, d1.day_number_in_calendar_month, d2.store_region;
+select d1.calendar_year, d1.calendar_month_name, d1.calendar_week, d1.day_number_in_calendar_month, d2.store_region, d2.store_district,sum(f.sales_quantity) as sales_quantity,sum(f.sales_dollar_amount) as sales_dollar_amount from pos_retail_sales_transaction_facts f join date_dimension d1 on f.date_id = d1.id join store_dimension d2 on f.store_id = d2.id group by d1.calendar_year, d1.calendar_month_name, d1.calendar_week, d1.day_number_in_calendar_month, d2.store_region, d2.store_district;

data/doc/agg_queries_results.txt

@@ -0,0 +1,150 @@
+mysql> select d1.calendar_year, d2.store_state,sum(f.sales_quantity) as sales_quantity,sum(f.sales_dollar_amount) as sales_dollar_amount from pos_retail_sales_transaction_facts f join date_dimension d1 on f.date_id = d1.id join store_dimension d2 on f.store_id = d2.id group by d1.calendar_year, d2.store_state;
++---------------+-------------+----------------+---------------------+
+| calendar_year | store_state | sales_quantity | sales_dollar_amount |
++---------------+-------------+----------------+---------------------+
+| 2001          | Florida     |              6 |    6.90000009536743 |
+| 2002          | Florida     |              2 |     2.6800000667572 |
+| 2003          | Florida     |              4 |     5.3600001335144 |
+| 2006          | Florida     |              5 |    6.30000013113022 |
++---------------+-------------+----------------+---------------------+
+4 rows in set (0.00 sec)
+
+mysql> select d1.calendar_year, d2.store_state, d2.store_county,sum(f.sales_quantity) as sales_quantity,sum(f.sales_dollar_amount) as sales_dollar_amount from pos_retail_sales_transaction_facts f join date_dimension d1 on f.date_id = d1.id join store_dimension d2 on f.store_id = d2.id group by d1.calendar_year, d2.store_state, d2.store_county;
++---------------+-------------+--------------+----------------+---------------------+
+| calendar_year | store_state | store_county | sales_quantity | sales_dollar_amount |
++---------------+-------------+--------------+----------------+---------------------+
+| 2001          | Florida     | Miami-Dade   |              6 |    6.90000009536743 |
+| 2002          | Florida     | Miami-Dade   |              2 |     2.6800000667572 |
+| 2003          | Florida     | Miami-Dade   |              4 |     5.3600001335144 |
+| 2006          | Florida     | Miami-Dade   |              5 |    6.30000013113022 |
++---------------+-------------+--------------+----------------+---------------------+
+4 rows in set (0.00 sec)
+
+mysql> select d1.calendar_year, d2.store_state, d2.store_county, d2.store_city,sum(f.sales_quantity) as sales_quantity,sum(f.sales_dollar_amount) as sales_dollar_amount from pos_retail_sales_transaction_facts f join date_dimension d1 on f.date_id = d1.id join store_dimension d2 on f.store_id = d2.id group by d1.calendar_year, d2.store_state, d2.store_county, d2.store_city;
++---------------+-------------+--------------+-------------+----------------+---------------------+
+| calendar_year | store_state | store_county | store_city  | sales_quantity | sales_dollar_amount |
++---------------+-------------+--------------+-------------+----------------+---------------------+
+| 2001          | Florida     | Miami-Dade   | Miami       |              3 |    3.45000004768372 |
+| 2001          | Florida     | Miami-Dade   | South Miami |              3 |    3.45000004768372 |
+| 2002          | Florida     | Miami-Dade   | Miami       |              1 |     1.3400000333786 |
+| 2002          | Florida     | Miami-Dade   | South Miami |              1 |     1.3400000333786 |
+| 2003          | Florida     | Miami-Dade   | Miami       |              2 |     2.6800000667572 |
+| 2003          | Florida     | Miami-Dade   | South Miami |              2 |     2.6800000667572 |
+| 2006          | Florida     | Miami-Dade   | Miami       |              4 |    4.96000009775162 |
+| 2006          | Florida     | Miami-Dade   | South Miami |              1 |     1.3400000333786 |
++---------------+-------------+--------------+-------------+----------------+---------------------+
+8 rows in set (0.00 sec)
+
+mysql> select d1.calendar_year, d1.calendar_month_name, d2.store_state,sum(f.sales_quantity) as sales_quantity,sum(f.sales_dollar_amount) as sales_dollar_amount from pos_retail_sales_transaction_facts f join date_dimension d1 on f.date_id = d1.id join store_dimension d2 on f.store_id = d2.id group by d1.calendar_year, d1.calendar_month_name, d2.store_state;
++---------------+---------------------+-------------+----------------+---------------------+
+| calendar_year | calendar_month_name | store_state | sales_quantity | sales_dollar_amount |
++---------------+---------------------+-------------+----------------+---------------------+
+| 2001          | November            | Florida     |              6 |    6.90000009536743 |
+| 2002          | September           | Florida     |              2 |     2.6800000667572 |
+| 2003          | June                | Florida     |              4 |     5.3600001335144 |
+| 2006          | October             | Florida     |              5 |    6.30000013113022 |
++---------------+---------------------+-------------+----------------+---------------------+
+4 rows in set (0.01 sec)
+
+mysql> select d1.calendar_year, d1.calendar_month_name, d2.store_state, d2.store_county,sum(f.sales_quantity) as sales_quantity,sum(f.sales_dollar_amount) as sales_dollar_amount from pos_retail_sales_transaction_facts f join date_dimension d1 on f.date_id = d1.id join store_dimension d2 on f.store_id = d2.id group by d1.calendar_year, d1.calendar_month_name, d2.store_state, d2.store_county;
++---------------+---------------------+-------------+--------------+----------------+---------------------+
+| calendar_year | calendar_month_name | store_state | store_county | sales_quantity | sales_dollar_amount |
++---------------+---------------------+-------------+--------------+----------------+---------------------+
+| 2001          | November            | Florida     | Miami-Dade   |              6 |    6.90000009536743 |
+| 2002          | September           | Florida     | Miami-Dade   |              2 |     2.6800000667572 |
+| 2003          | June                | Florida     | Miami-Dade   |              4 |     5.3600001335144 |
+| 2006          | October             | Florida     | Miami-Dade   |              5 |    6.30000013113022 |
++---------------+---------------------+-------------+--------------+----------------+---------------------+
+4 rows in set (0.04 sec)
+
+mysql> select d1.calendar_year, d1.calendar_month_name, d2.store_state, d2.store_county, d2.store_city,sum(f.sales_quantity) as sales_quantity,sum(f.sales_dollar_amount) as sales_dollar_amount from pos_retail_sales_transaction_facts f join date_dimension d1 on f.date_id = d1.id join store_dimension d2 on f.store_id = d2.id group by d1.calendar_year, d1.calendar_month_name, d2.store_state, d2.store_county, d2.store_city;
++---------------+---------------------+-------------+--------------+-------------+----------------+---------------------+
+| calendar_year | calendar_month_name | store_state | store_county | store_city  | sales_quantity | sales_dollar_amount |
++---------------+---------------------+-------------+--------------+-------------+----------------+---------------------+
+| 2001          | November            | Florida     | Miami-Dade   | Miami       |              3 |    3.45000004768372 |
+| 2001          | November            | Florida     | Miami-Dade   | South Miami |              3 |    3.45000004768372 |
+| 2002          | September           | Florida     | Miami-Dade   | Miami       |              1 |     1.3400000333786 |
+| 2002          | September           | Florida     | Miami-Dade   | South Miami |              1 |     1.3400000333786 |
+| 2003          | June                | Florida     | Miami-Dade   | Miami       |              2 |     2.6800000667572 |
+| 2003          | June                | Florida     | Miami-Dade   | South Miami |              2 |     2.6800000667572 |
+| 2006          | October             | Florida     | Miami-Dade   | Miami       |              4 |    4.96000009775162 |
+| 2006          | October             | Florida     | Miami-Dade   | South Miami |              1 |     1.3400000333786 |
++---------------+---------------------+-------------+--------------+-------------+----------------+---------------------+
+8 rows in set (0.00 sec)
+
+mysql> select d1.calendar_year, d1.calendar_month_name, d1.calendar_week, d2.store_state,sum(f.sales_quantity) as sales_quantity,sum(f.sales_dollar_amount) as sales_dollar_amount from pos_retail_sales_transaction_facts f join date_dimension d1 on f.date_id = d1.id join store_dimension d2 on f.store_id = d2.id group by d1.calendar_year, d1.calendar_month_name, d1.calendar_week, d2.store_state;
++---------------+---------------------+---------------+-------------+----------------+---------------------+
+| calendar_year | calendar_month_name | calendar_week | store_state | sales_quantity | sales_dollar_amount |
++---------------+---------------------+---------------+-------------+----------------+---------------------+
+| 2001          | November            | Week 45       | Florida     |              6 |    6.90000009536743 |
+| 2002          | September           | Week 36       | Florida     |              2 |     2.6800000667572 |
+| 2003          | June                | Week 26       | Florida     |              4 |     5.3600001335144 |
+| 2006          | October             | Week 41       | Florida     |              5 |    6.30000013113022 |
++---------------+---------------------+---------------+-------------+----------------+---------------------+
+4 rows in set (0.00 sec)
+
+mysql> select d1.calendar_year, d1.calendar_month_name, d1.calendar_week, d2.store_state, d2.store_county,sum(f.sales_quantity) as sales_quantity,sum(f.sales_dollar_amount) as sales_dollar_amount from pos_retail_sales_transaction_facts f join date_dimension d1 on f.date_id = d1.id join store_dimension d2 on f.store_id = d2.id group by d1.calendar_year, d1.calendar_month_name, d1.calendar_week, d2.store_state, d2.store_county;
++---------------+---------------------+---------------+-------------+--------------+----------------+---------------------+
+| calendar_year | calendar_month_name | calendar_week | store_state | store_county | sales_quantity | sales_dollar_amount |
++---------------+---------------------+---------------+-------------+--------------+----------------+---------------------+
+| 2001          | November            | Week 45       | Florida     | Miami-Dade   |              6 |    6.90000009536743 |
+| 2002          | September           | Week 36       | Florida     | Miami-Dade   |              2 |     2.6800000667572 |
+| 2003          | June                | Week 26       | Florida     | Miami-Dade   |              4 |     5.3600001335144 |
+| 2006          | October             | Week 41       | Florida     | Miami-Dade   |              5 |    6.30000013113022 |
++---------------+---------------------+---------------+-------------+--------------+----------------+---------------------+
+4 rows in set (0.01 sec)
+
+mysql> select d1.calendar_year, d1.calendar_month_name, d1.calendar_week, d2.store_state, d2.store_county, d2.store_city,sum(f.sales_quantity) as sales_quantity,sum(f.sales_dollar_amount) as sales_dollar_amount from pos_retail_sales_transaction_facts f join date_dimension d1 on f.date_id = d1.id join store_dimension d2 on f.store_id = d2.id group by d1.calendar_year, d1.calendar_month_name, d1.calendar_week, d2.store_state, d2.store_county, d2.store_city;
++---------------+---------------------+---------------+-------------+--------------+-------------+----------------+---------------------+
+| calendar_year | calendar_month_name | calendar_week | store_state | store_county | store_city  | sales_quantity | sales_dollar_amount |
++---------------+---------------------+---------------+-------------+--------------+-------------+----------------+---------------------+
+| 2001          | November            | Week 45       | Florida     | Miami-Dade   | Miami       |              3 |    3.45000004768372 |
+| 2001          | November            | Week 45       | Florida     | Miami-Dade   | South Miami |              3 |    3.45000004768372 |
+| 2002          | September           | Week 36       | Florida     | Miami-Dade   | Miami       |              1 |     1.3400000333786 |
+| 2002          | September           | Week 36       | Florida     | Miami-Dade   | South Miami |              1 |     1.3400000333786 |
+| 2003          | June                | Week 26       | Florida     | Miami-Dade   | Miami       |              2 |     2.6800000667572 |
+| 2003          | June                | Week 26       | Florida     | Miami-Dade   | South Miami |              2 |     2.6800000667572 |
+| 2006          | October             | Week 41       | Florida     | Miami-Dade   | Miami       |              4 |    4.96000009775162 |
+| 2006          | October             | Week 41       | Florida     | Miami-Dade   | South Miami |              1 |     1.3400000333786 |
++---------------+---------------------+---------------+-------------+--------------+-------------+----------------+---------------------+
+8 rows in set (0.04 sec)
+
+mysql> select d1.calendar_year, d1.calendar_month_name, d1.calendar_week, d1.day_number_in_calendar_month, d2.store_state,sum(f.sales_quantity) as sales_quantity,sum(f.sales_dollar_amount) as sales_dollar_amount from pos_retail_sales_transaction_facts f join date_dimension d1 on f.date_id = d1.id join store_dimension d2 on f.store_id = d2.id group by d1.calendar_year, d1.calendar_month_name, d1.calendar_week, d1.day_number_in_calendar_month, d2.store_state;
++---------------+---------------------+---------------+------------------------------+-------------+----------------+---------------------+
+| calendar_year | calendar_month_name | calendar_week | day_number_in_calendar_month | store_state | sales_quantity | sales_dollar_amount |
++---------------+---------------------+---------------+------------------------------+-------------+----------------+---------------------+
+| 2001          | November            | Week 45       |                            8 | Florida     |              6 |    6.90000009536743 |
+| 2002          | September           | Week 36       |                            3 | Florida     |              2 |     2.6800000667572 |
+| 2003          | June                | Week 26       |                           30 | Florida     |              4 |     5.3600001335144 |
+| 2006          | October             | Week 41       |                           12 | Florida     |              3 |    3.62000006437302 |
+| 2006          | October             | Week 41       |                           13 | Florida     |              2 |     2.6800000667572 |
++---------------+---------------------+---------------+------------------------------+-------------+----------------+---------------------+
+5 rows in set (0.01 sec)
+
+mysql> select d1.calendar_year, d1.calendar_month_name, d1.calendar_week, d1.day_number_in_calendar_month, d2.store_state, d2.store_county,sum(f.sales_quantity) as sales_quantity,sum(f.sales_dollar_amount) as sales_dollar_amount from pos_retail_sales_transaction_facts f join date_dimension d1 on f.date_id = d1.id join store_dimension d2 on f.store_id = d2.id group by d1.calendar_year, d1.calendar_month_name, d1.calendar_week, d1.day_number_in_calendar_month, d2.store_state, d2.store_county;
++---------------+---------------------+---------------+------------------------------+-------------+--------------+----------------+---------------------+
+| calendar_year | calendar_month_name | calendar_week | day_number_in_calendar_month | store_state | store_county | sales_quantity | sales_dollar_amount |
++---------------+---------------------+---------------+------------------------------+-------------+--------------+----------------+---------------------+
+| 2001          | November            | Week 45       |                            8 | Florida     | Miami-Dade   |              6 |    6.90000009536743 |
+| 2002          | September           | Week 36       |                            3 | Florida     | Miami-Dade   |              2 |     2.6800000667572 |
+| 2003          | June                | Week 26       |                           30 | Florida     | Miami-Dade   |              4 |     5.3600001335144 |
+| 2006          | October             | Week 41       |                           12 | Florida     | Miami-Dade   |              3 |    3.62000006437302 |
+| 2006          | October             | Week 41       |                           13 | Florida     | Miami-Dade   |              2 |     2.6800000667572 |
++---------------+---------------------+---------------+------------------------------+-------------+--------------+----------------+---------------------+
+5 rows in set (0.01 sec)
+
+mysql> select d1.calendar_year, d1.calendar_month_name, d1.calendar_week, d1.day_number_in_calendar_month, d2.store_state, d2.store_county, d2.store_city,sum(f.sales_quantity) as sales_quantity,sum(f.sales_dollar_amount) as sales_dollar_amount from pos_retail_sales_transaction_facts f join date_dimension d1 on f.date_id = d1.id join store_dimension d2 on f.store_id = d2.id group by d1.calendar_year, d1.calendar_month_name, d1.calendar_week, d1.day_number_in_calendar_month, d2.store_state, d2.store_county, d2.store_city;
++---------------+---------------------+---------------+------------------------------+-------------+--------------+-------------+----------------+---------------------+
+| calendar_year | calendar_month_name | calendar_week | day_number_in_calendar_month | store_state | store_county | store_city  | sales_quantity | sales_dollar_amount |
++---------------+---------------------+---------------+------------------------------+-------------+--------------+-------------+----------------+---------------------+
+| 2001          | November            | Week 45       |                            8 | Florida     | Miami-Dade   | Miami       |              3 |    3.45000004768372 |
+| 2001          | November            | Week 45       |                            8 | Florida     | Miami-Dade   | South Miami |              3 |    3.45000004768372 |
+| 2002          | September           | Week 36       |                            3 | Florida     | Miami-Dade   | Miami       |              1 |     1.3400000333786 |
+| 2002          | September           | Week 36       |                            3 | Florida     | Miami-Dade   | South Miami |              1 |     1.3400000333786 |
+| 2003          | June                | Week 26       |                           30 | Florida     | Miami-Dade   | Miami       |              2 |     2.6800000667572 |
+| 2003          | June                | Week 26       |                           30 | Florida     | Miami-Dade   | South Miami |              2 |     2.6800000667572 |
+| 2006          | October             | Week 41       |                           12 | Florida     | Miami-Dade   | Miami       |              2 |    2.28000003099442 |
+| 2006          | October             | Week 41       |                           12 | Florida     | Miami-Dade   | South Miami |              1 |     1.3400000333786 |
+| 2006          | October             | Week 41       |                           13 | Florida     | Miami-Dade   | Miami       |              2 |     2.6800000667572 |
++---------------+---------------------+---------------+------------------------------+-------------+--------------+-------------+----------------+---------------------+
+9 rows in set (0.00 sec)

data/doc/queries.txt

@@ -0,0 +1,35 @@
+# This will sum sales quantity and group by calendar year
+select d1.calendar_year, sum(f.sales_quantity) from pos_retail_sales_transaction_facts f join date_dimension d1 on f.date_id = d1.id group by d1.calendar_year;
+
+# This will sum sales quantity and group by store name
+select d2.store_name, sum(f.sales_quantity) from pos_retail_sales_transaction_facts f join store_dimension d2 on f.store_id = d2.id group by d2.store_name;
+
+# This will sum sales quantity and group by calendar year and store name
+select d1.calendar_year, d2.store_name, sum(f.sales_quantity) from pos_retail_sales_transaction_facts f join date_dimension d1 on f.date_id = d1.id join store_dimension d2 on f.store_id = d2.id group by d1.calendar_year, d2.store_name;
+
+# This will sum sales quantity and group by calendar year and store region
+select d1.calendar_year, d2.store_region, sum(f.sales_quantity) as sales_quantity from pos_retail_sales_transaction_facts f join date_dimension d1 on f.date_id = d1.id join store_dimension d2 on f.store_id = d2.id group by d1.calendar_year, d2.store_region;
+
+
+select d1.calendar_year, d1.calendar_quarter, d2.store_region, sum(f.sales_quantity) as sales_quantity from pos_retail_sales_transaction_facts f join date_dimension d1 on f.date_id = d1.id join store_dimension d2 on f.store_id = d2.id group by d1.calendar_year, d1.calendar_quarter, d2.store_region;
+
+select d1.calendar_year, d1.calendar_quarter, d1.calendar_month_name, d1.calendar_week, d1.day_number_in_calendar_month, d2.store_region, d2.store_district, sum(f.sales_quantity) as sales_quantity, sum(f.sales_dollar_amount) as sales_dollar_amount from pos_retail_sales_transaction_facts f join date_dimension d1 on f.date_id = d1.id join store_dimension d2 on f.store_id = d2.id group by d1.calendar_year, d1.calendar_quarter, d1.calendar_month_name, d1.calendar_week, d1.day_number_in_calendar_month, d2.store_region, d2.store_district;
+
+
+select * from pos_retail_sales_transaction_facts f join date_dimension d1 on f.date_id = d1.id join store_dimension d2 on f.store_id = d2.id;
+
+
+select f.pos_transaction_number, d1.calendar_year, d1.calendar_month_name, d1.calendar_week, d1.day_number_in_calendar_month as day, d2.store_region, d2.store_district, f.sales_quantity, f.sales_dollar_amount from pos_retail_sales_transaction_facts f join date_dimension d1 on f.date_id = d1.id join store_dimension d2 on f.store_id = d2.id;
+
+
+# This will calculate the number of days per year
+select calendar_year, count(id) from date_dimension group by calendar_year;
+
+# This will calculate the number of days per month for a particular calendar year
+select calendar_year, calendar_month_name, count(id) from date_dimension where calendar_year = 2002 group by calendar_month_name;
+
+# This will calculate the number of fiscal year months in each calendar year. * This is what to use for denomniators *
+select calendar_year, count(distinct(fiscal_year_month)) from date_dimension group by calendar_year;
+
+# The example below shows the number of days in each week for each fiscal month
+select calendar_year_month, count(distinct(day_of_week)) from date_dimension where calendar_year = 2002 group by calendar_year_month;

data/generators/cube/USAGE

@@ -0,0 +1 @@
+./script/generate cube NAME

data/generators/cube/cube_generator.rb

@@ -0,0 +1,28 @@
+class CubeGenerator < Rails::Generator::NamedBase
+  attr_accessor :file_name
+  
+  def initialize(runtime_args, runtime_options = {})
+    super
+    
+    @name = @name.underscore
+    @table_name = "#{@name}_cube"
+    @class_name = "#{@name.camelize}Cube"
+    @file_name = "#{@class_name.tableize.singularize}"
+  end
+  
+  def manifest
+    record do |m|
+      # Check for class naming collisions.
+      m.class_collisions class_path, "#{class_name}", "#{class_name}Test"
+      
+      # Create required directories if necessary
+      m.directory File.join('app/models', class_path)
+      m.directory File.join('test/unit', class_path)
+      
+      # Generate the files
+      m.template 'model.rb', File.join('app/models', class_path, "#{file_name}.rb")
+      m.template 'unit_test.rb', File.join('test/unit', class_path, "#{file_name}_test.rb")
+    end
+  end
+
+end