active_tree 0.2.9 → 0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7bf00b350061ffb40ff9a7db9cb0f10d06bea1a20eb82062ac66029d5fd1ad52
-  data.tar.gz: 6babe94e0d5f928b9bb3c14306850211c6ba4cd5660ee5cfebd6ace953e8be6a
+  metadata.gz: 5fb9ce62863408c33ab2b8db4bdfa7b21a67b15f14927f43d9b168dfe121604a
+  data.tar.gz: 8dc8ad54ec03529d82bab17e219389057a7040fb1340bc691a0c9de06566ef66
 SHA512:
-  metadata.gz: 40dce12132b74bc1b53bb52bc1281e76c953fe8a486613ff362f742b4a51e6847b05938bfd84ea9be56230edec6112543263ef3d52caab25837c3a9ed0d2c837
-  data.tar.gz: 9679c3a799b5472be0786085c060fa1bbfa6fa8ca160412797e1a5a79fe69b2db6137573ecf4095341d98948301077e285ef27c3f0e861f462a1c55b64356f05
+  metadata.gz: cda0e7157dfa1abd83dd92df6430bce8842500cc93aa58b07a0fa0216ea8c826f9ff61dec764bfa3bfbd915a67f32e8006987a960f7beede67d1a9357e68280d
+  data.tar.gz: 0e62ce8e6fb8d9ffe4d1caecfa32f6129842607452ed217116b0d7802c2c2d190ba48dc58f432c886a95dc902074308fad7071dd4b94a025d2856a73bd18783e

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    active_tree (0.2.9)
+    active_tree (0.3)
       activerecord (~> 6.0)
       jwt (~> 2.2.3)
       pg_ltree (~> 1.1.8)
@@ -60,4 +60,4 @@ DEPENDENCIES
   rspec (~> 3.0)
 
 BUNDLED WITH
-   2.2.27
+   2.2.29

data/README.md

@@ -2,9 +2,7 @@
 
 # ActiveTree
 
-Storing, processing and working with hierarchical data has always been challenging. A multitude of data models and implementations exist already but every one of them makes huge compromises or lacks functionality. 
-
-This gem implements a denormalized database model for tree data as well as several vectors for convenient querying. 
+This gem implements a denormalized database model for tree data backed up by the Postgres LTREE extension.
 
 ## Installation
 
@@ -91,6 +89,14 @@ The `ActiveTree::Metadata` model can store key-value pairs queryable through Act
 ActiveTree::Model.match_path("*.Battery.*").metadata.where(key: "Shipping weight").sum(:value)
 ```
 
+## Partitioning
+
+All data is partitioned for each owner using the owner_id as partition index. Through the yml configuration you can choose how the gem behaves when deleting an owner record - either delete the partition and all the data, or detach the partition and keep the data for later use.
+
+Through subsequent ActiveRecord migrations the data can be federated from a separate Postgres server. 
+
+The main table as well as its partitions can be queried through PostgREST using the role attached to the owner model.
+
 ## Caveats
 
 `pg_ltree` .child / .parent queries do not work across different models due to an ActiveRecord limitation that requires results to be related via inheritance. 

data/lib/active_tree/models/concerns/active_tree_able.rb

@@ -35,18 +35,25 @@ module ActiveTree
 
         	    # create data partition
         	    active_tree_sql "create table if not exists #{active_tree_table_name}_#{id} partition of #{active_tree_table_name} for values in (#{id})"
-        	    # TODO create partition indexes
-
-            	    if ACTIVE_TREE_OPTIONS[:create_postgrest_roles]
+        	    # create partition indexes
+                active_tree_sql "create index index_#{id}_by_id on #{active_tree_table_name}_#{id} (id)"
+                active_tree_sql "create index index_#{id}_by_owner_id on #{active_tree_table_name}_#{id} (owner_id)"
+                active_tree_sql "create index index_#{id}_by_type on #{active_tree_table_name}_#{id} (type)"
+                active_tree_sql "create index index_#{id}_by_parent_entity_id on #{active_tree_table_name}_#{id} (parent_entity_id)"
+                active_tree_sql "create index index_#{id}_by_path on #{active_tree_table_name}_#{id} using gist (path)"
+                active_tree_sql "create index index_#{id}_by_data_provider_and_data_external_id on #{active_tree_table_name}_#{id} (data_provider, data_external_id)"
+                
+
+            	if ACTIVE_TREE_OPTIONS[:create_postgrest_roles]
             		# drop role if it exists
                 	active_tree_sql "drop role if exists #{ active_tree_role }"
 
                 	# create role
             		active_tree_sql "create role #{ active_tree_role }"
 
-        		# grant privs
-        		active_tree_sql "grant all privileges on #{active_tree_table_name}_#{id} to #{ active_tree_role }"
-            	    end
+        		    # grant privs
+        		    active_tree_sql "grant all privileges on #{active_tree_table_name}_#{id} to #{ active_tree_role }"
+            	end
 
         	end # create_storage
 

data/lib/active_tree/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ActiveTree
-  VERSION = "0.2.9"
+  VERSION = "0.3"
 end

data/lib/generators/active_tree/templates/migration.rb.tt

@@ -40,9 +40,6 @@ class <%= migration_class_name %> < ActiveRecord::Migration<%= migration_version
     ) partition by list(owner_id)
 SQL
 
-    # create an "others" partition for when the owner is undefined/unknown? just in case / may help in some edge cases
-    execute "CREATE TABLE #{ACTIVE_TREE_OPTIONS[:table_name]}_others PARTITION OF #{ACTIVE_TREE_OPTIONS[:table_name]} DEFAULT"
-
 
     # add indexes
     add_index ACTIVE_TREE_OPTIONS[:table_name], :id
@@ -55,6 +52,16 @@ SQL
     add_index ACTIVE_TREE_OPTIONS[:table_name], [:data_provider, :data_external_id]
 
 
+    # create an "others" partition for when the owner is undefined/unknown? just in case / may help in some edge cases
+    execute "CREATE TABLE #{ACTIVE_TREE_OPTIONS[:table_name]}_others PARTITION OF #{ACTIVE_TREE_OPTIONS[:table_name]} DEFAULT"
+
+	execute "create index index_others_by_id on #{ACTIVE_TREE_OPTIONS[:table_name]}_others (id)"
+	execute "create index index_others_by_owner_id on #{ACTIVE_TREE_OPTIONS[:table_name]}_others (owner_id)"
+	execute "create index index_others_by_type on #{ACTIVE_TREE_OPTIONS[:table_name]}_others (type)"
+	execute "create index index_others_by_parent_entity_id on #{ACTIVE_TREE_OPTIONS[:table_name]}_others (parent_entity_id)"
+	execute "create index index_others_by_path on #{ACTIVE_TREE_OPTIONS[:table_name]}_others using gist (path)"
+	execute "create index index_others_by_data_provider_and_data_external_id on #{ACTIVE_TREE_OPTIONS[:table_name]}_others (data_provider, data_external_id)"
+
     # when postgrest is enabled...
     if ACTIVE_TREE_OPTIONS[:create_postgrest_roles]
     	# create postgrest anon user with no privs

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: active_tree
 version: !ruby/object:Gem::Version
-  version: 0.2.9
+  version: '0.3'
 platform: ruby
 authors:
 - Nick @ Earthster
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2021-10-08 00:00:00.000000000 Z
+date: 2021-10-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activerecord