elasticsearch_record 1.2.3 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cdb71bb8689c67cd7a2ef1add3b7ad0ab6710cbb5833313cb3f474267c39e43e
-  data.tar.gz: 06ec37ac16f5adb110da8ffa08c9c44fc20993be3db12bf8033315cfa9611fc3
+  metadata.gz: 0e7302cf1310d0d583125bf9a9e526203feb42d000569b6daca266d88ae7bb50
+  data.tar.gz: e67b0946f566b44232827244c323aa2e221796f4d0ac91adf4696179f4ba56e1
 SHA512:
-  metadata.gz: 929f5df6456203e7bce466d62836805bb9a75ff5a89856c75cd1ba187a95e05f51aa3ad676c3058d7ad95d1295db1422571964240182000bef59a8cdb95181bc
-  data.tar.gz: 7f785864f92bc6f3243ea081236327ff7c600833cdf74a11d59239f31551d928dc7b8bb1b4952ec38aadaa8d0174ac2a7ceeebae100a247c3534ef4c1609e484
+  metadata.gz: 3fbf9f25937e5c77520af89de811c72bc9e2a51a49cbb1c6f7a77d0b2af8d2e533b3cc2fc11acf3f8b9a78ed5616c97c068cc88a1171e85bcc5611252960b345
+  data.tar.gz: f8d77b26a20ddd8db5495638fdd98da72bcd1bd6978f17d6a1a794ab436fc184e3dafa153c67b364f6c89e59c5bca1eb0a59e09b240c4ea8e6055c017eb4738c

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    elasticsearch_record (1.2.3)
+    elasticsearch_record (1.2.4)
       activerecord (~> 7.0.0)
       elasticsearch (~> 8.4)
 
@@ -28,7 +28,7 @@ GEM
       elasticsearch-api (= 8.5.2)
     elasticsearch-api (8.5.2)
       multi_json
-    faraday (2.7.1)
+    faraday (2.7.2)
       faraday-net_http (>= 2.0, < 3.1)
       ruby2_keywords (>= 0.0.4)
     faraday-net_http (3.0.2)

data/README.md

@@ -198,6 +198,7 @@ total = scope.total
 - kind 
 - configure
 - aggregate
+- refresh
 - query
 - filter
 - must_not
@@ -274,6 +275,8 @@ Access these methods through the model's connection.
 - meta_exists?
 - max_result_window
 - cluster_info
+- cluster_settings
+- cluster_health
 
 ## Active Record Schema migration methods
 Access these methods through the model's connection or within any `Migration`.
@@ -285,26 +288,30 @@ Access these methods through the model's connection or within any `Migration`.
 - close_tables
 - truncate_table
 - truncate_tables
+- refresh_table
+- refresh_tables
 - drop_table
 - block_table
 - unblock_table
 - clone_table
 - create_table
 - change_table
+- rename_table
 
 **table actions:**
 - change_meta
-- delete_meta
+- remove_meta
 - add_mapping
 - change_mapping
 - change_mapping_meta
 - change_mapping_attributes
+- remove_mapping
 - add_setting
 - change_setting
-- delete_setting
+- remove_setting
 - add_alias
 - change_alias
-- delete_alias
+- remove_alias
 
 ```ruby
 # Example migration
@@ -322,6 +329,11 @@ class AddTests < ActiveRecord::Migration[7.0]
     # changes the auto-increment value
     change_meta "assignments", :auto_increment, 3625
     
+    # removes the mapping 'updated_at' from the 'assignments' index.
+    # the flag 'recreate' is required, since 'remove' is not supported for elasticsearch.
+    # this will recreate the whole index (data will be LOST!!!)
+    remove_mapping :assignments, :updated_at, recreate: true 
+    
     create_table "settings", force: true do |t|
       t.mapping :created_at, :date
       t.mapping :key, :integer do |m|
@@ -347,8 +359,8 @@ class AddTests < ActiveRecord::Migration[7.0]
       t.add_alias('supersettings')
     end
 
-    delete_alias('settings', :supersettings)
-    delete_setting('settings', 'index.search.idle.after')
+    remove_alias('settings', :supersettings)
+    remove_setting('settings', 'index.search.idle.after')
 
     change_table 'settings', force: true do |t|
       t.integer :amount_of_newbies
@@ -357,10 +369,14 @@ class AddTests < ActiveRecord::Migration[7.0]
     create_table "vintage", force: true do |t|
       t.primary_key :number
       t.string :name
+      t.string :comments
       t.timestamps
     end
 
-    change_mapping_attributes "vintage", :number, fields: {raw: {type: :keyword}}
+    change_table 'vintage', if_exists: true, recreate: true do |t|
+      t.change_mapping :number, fields: {raw: {type: :keyword}}
+      t.remove_mapping :number
+    end
   end
 
   def down

data/docs/CHANGELOG.md

@@ -1,5 +1,30 @@
 # ElasticsearchRecord - CHANGELOG
 
+## [1.3.0] - 2023-01-17
+* [add] 'metas: {}' param for `CreateTableDefinition` to provide individual meta information without providing them through 'mappings'
+* [add] 'change_'- & 'remove_'-methods for _mapping, setting & alias_  for `CreateTableDefinition`
+* [add] `ActiveRecord::ConnectionAdapters::Elasticsearch::TableMappingDefinition#meta` for easier access
+* [add] `UpdateTableDefinition#remove_mapping` to always raise an ArgumentError (now created @ `CreateTableDefinition` through change_table(x, recreate: true) )
+* [add] `_env_table_name`-syntax to `ActiveRecord::ConnectionAdapters::Elasticsearch::SchemaDumper#table` for prefixed & suffixed tables in connections
+* [add] `#cluster_health`, `#refresh_table`, `#refresh_tables` & `#rename_table` methods to 'connection'
+* [add] `#change_table` 'recreate: false' parameter to switch between a 'change' or 'recreate' of an index
+* [add] `#refresh` method to relations to explicit set the refresh value of the generated query
+* [ref] `CloneTableDefinition` to adapt settings (number_of_shards & number_of_replicas) from source table by default
+* [ref] `CreateTableDefinition#transform_mappings!` also support simple 'key->attributes' assignment of custom provided mappings
+* [ref] 'delete_'-methods into more common 'remove_'  for `UpdateTableDefinition`
+* [ref] `UpdateTableDefinition#change_mapping` to always raise an ArgumentError (now moved to `CreateTableDefinition` through change_table(x, recreate: true) )
+* [ref] `#change_table` missing '&block'
+* [ref] 'delete_'-methods into more common 'remove_' to 'connection'
+* [ref] ':\_\_claim\_\_'-operator to ':\_\_query\_\_' within `Arel::Collectors::ElasticsearchQuery`
+* [ref] update & delete queries to preset a 'refresh: true' as default _(can be overwritten through 'relation.refresh(false)' )_
+* [rem] `#clone_table` unusable '&block'
+* [rem] `#compute_table_name`-method - must be explicit provided with `#_env_table_name(name)`
+* [fix] `#where!` & `#build_where_clause` methods to also build a valid 'where_clause' in nested 'where' & 'or'
+
+## [1.2.4] - 2022-12-15
+* [fix] missing `#visit_Arel_Nodes_In` method in `Arel::Visitors::ElasticsearchQuery` to build array conditions
+* [fix] resolving buckets from relation `ElasticsearchRecord::Result#buckets` not recognizing sub-buckets
+
 ## [1.2.3] - 2022-12-12
 * [fix] `change_table` 'if_exists: true' returns at the wrong state
 

data/lib/active_record/connection_adapters/elasticsearch/schema_definitions/clone_table_definition.rb

@@ -16,6 +16,9 @@ module ActiveRecord
           @settings = HashWithIndifferentAccess.new
           @aliases  = HashWithIndifferentAccess.new
 
+          # before assigning new settings, we need to resolve some defaults
+          assign_default_clone_settings!
+
           transform_settings!(settings) if settings.present?
           transform_aliases!(aliases) if aliases.present?
         end
@@ -64,6 +67,12 @@ module ActiveRecord
 
         private
 
+        def assign_default_clone_settings!
+          settings = table_settings(name)
+          setting('index.number_of_shards', (settings.dig('index.number_of_shards') || 1))
+          setting('index.number_of_replicas', (settings.dig('index.number_of_replicas') || 0))
+        end
+
         def _before_exec
           block_table(self.name, :write)
         end

data/lib/active_record/connection_adapters/elasticsearch/schema_definitions/create_table_definition.rb

@@ -6,7 +6,7 @@ module ActiveRecord
   module ConnectionAdapters
     module Elasticsearch
       class CreateTableDefinition < TableDefinition
-        def initialize(conn, name, settings: nil, mappings: nil, aliases: nil, **opts)
+        def initialize(conn, name, settings: nil, mappings: nil, aliases: nil, metas: nil, **opts)
           super(conn, name, **opts)
 
           @settings = HashWithIndifferentAccess.new
@@ -17,6 +17,9 @@ module ActiveRecord
           transform_settings!(settings) if settings.present?
           transform_mappings!(mappings) if mappings.present?
           transform_aliases!(aliases) if aliases.present?
+          # PLEASE NOTE: metas are already provided through the mappings (['_meta']),
+          # but this will support individually provided key<->values...
+          transform_metas!(metas) if metas.present?
         end
 
         # returns an array with all +TableSettingDefinition+.
@@ -64,18 +67,23 @@ module ActiveRecord
           self
         end
 
+        def change_meta(name, value, **options)
+          # simply force full overwrite
+          meta(name, value, force: true, **options)
+        end
+
         def remove_meta(name)
           @metas.delete(name)
         end
 
         # adds a new mapping
-        def mapping(name, type, force: false, **options, &block)
+        def mapping(name, type, if_not_exists: false, force: false, **options, &block)
+          return if if_not_exists && @mappings.key?(name)
           raise ArgumentError, "you cannot define an already defined mapping '#{name}'!" if @mappings.key?(name) && !force?(force)
 
           mapping = new_mapping_definition(name, type, **options, &block)
           @mappings[name] = mapping
 
-
           # check if the mapping is assigned as primary_key
           if mapping.primary_key?
             meta :primary_key, mapping.name
@@ -86,16 +94,51 @@ module ActiveRecord
         end
 
         # provide backwards compatibility to columns
-        alias column mapping
+        alias :column :mapping
+        alias :add_mapping :mapping
+        alias :add_column :mapping
+
+        def change_mapping(name, type, if_exists: false, **options, &block)
+          return if if_exists && !@mappings.key?(name)
+
+          raise ArgumentError, "you cannot change an unknown mapping '#{name}'" unless @mappings.key?(name)
+
+          mapping(name, type, force: true, **options, &block)
+        end
+
+        alias :change_column :change_mapping
+        alias :change :change_mapping
+
+        def change_mapping_meta(name, **options)
+          raise ArgumentError, "you cannot change the 'meta' parameter for an unknown mapping '#{name}'" unless @mappings.key?(name)
+
+          # merge mapping options
+          opts = @mappings[name].attributes
+          opts['meta'] = @mappings[name].meta.merge(options)
+
+          mapping(name, @mappings[name].type, force: true, **opts)
+        end
+
+        def change_mapping_attributes(name, if_exists: false, **options, &block)
+          return if if_exists && !@mappings.key?(name)
+
+          raise ArgumentError, "you cannot change an unknown mapping '#{name}'" unless @mappings.key?(name)
+
+          # merge mapping attributes
+          opts = @mappings[name].attributes.merge(options)
+
+          mapping(name, @mappings[name].type, force: true, **opts, &block)
+        end
 
         def remove_mapping(name)
           @mappings.delete(name)
         end
 
         # provide backwards compatibility to columns
-        alias remove_column remove_mapping
+        alias :remove_column :remove_mapping
 
-        def setting(name, value, force: false, **options, &block)
+        def setting(name, value, if_not_exists: false, force: false, **options, &block)
+          return if if_not_exists && @settings.key?(name)
           raise ArgumentError, "you cannot define an already defined setting '#{name}'!" if @settings.key?(name) && !force?(force)
 
           @settings[name] = new_setting_definition(name, value, **options, &block)
@@ -103,13 +146,19 @@ module ActiveRecord
           self
         end
 
+        def change_setting(name, value, if_exists: false, **options, &block)
+          return if if_exists && !@settings.key?(name)
+
+          # simply force full overwrite
+          setting(name, value, force: true, **options, &block)
+        end
+
         def remove_setting(name)
           @settings.delete name
         end
 
-        # we can use +alias+ here, since the instance method is not a reserved keyword!
-
-        def alias(name, force: false, **options, &block)
+        def add_alias(name, if_not_exists: false, force: false, **options, &block)
+          return if if_not_exists && @aliases.key?(name)
           raise ArgumentError, "you cannot define an already defined alias '#{name}'." if @aliases.key?(name) && !force?(force)
 
           @aliases[name] = new_alias_definition(name, **options, &block)
@@ -117,6 +166,13 @@ module ActiveRecord
           self
         end
 
+        def change_alias(name, if_exists: false, **options, &block)
+          return if if_exists && !@aliases.key?(name)
+
+          # simply force full overwrite
+          add_alias(name, force: true, **options, &block)
+        end
+
         def remove_alias(name)
           @aliases.delete name
         end
@@ -154,6 +210,51 @@ module ActiveRecord
         def state
           nil
         end
+
+        def transform_mappings!(mappings)
+          # transform +_meta+ mappings
+          if mappings['_meta'].present?
+            mappings['_meta'].each do |name, value|
+              self.meta(name, value, force: true)
+            end
+          end
+
+          # transform properties (=columns)
+          if mappings['properties'].present?
+            mappings['properties'].each do |name, attributes|
+              self.mapping(name, attributes.delete('type'), force: true, **attributes)
+            end
+          elsif mappings.present? && mappings.values[0].is_a?(Hash)
+            # raw settings where provided with just (key => attributes)
+            mappings.each do |name, attributes|
+              self.mapping(name, attributes.delete('type'), force: true, **attributes)
+            end
+          end
+        end
+
+        def transform_settings!(settings)
+          # exclude settings, that are provided through the API but are not part of the index-settings
+          settings
+            .with_indifferent_access
+            .each { |name, value|
+              # don't transform ignored names
+              next if ActiveRecord::ConnectionAdapters::Elasticsearch::TableSettingDefinition.match_ignore_names?(name)
+
+              self.setting(name, value, force: true)
+            }
+        end
+
+        def transform_aliases!(aliases)
+          aliases.each do |name, attributes|
+            self.alias(name, force: true, **attributes)
+          end
+        end
+
+        def transform_metas!(metas)
+          metas.each do |name, value|
+            self.meta(name, value, force: true)
+          end
+        end
       end
     end
   end

data/lib/active_record/connection_adapters/elasticsearch/schema_definitions/table_definition.rb

@@ -147,40 +147,6 @@ module ActiveRecord
         def strict?(strict = nil)
           opts.fetch(:strict, false) || strict
         end
-
-        def transform_mappings!(mappings)
-          # transform +_meta+ mappings
-          if mappings['_meta'].present?
-            mappings['_meta'].each do |name, value|
-              self.meta(name, value)
-            end
-          end
-
-          # transform properties (=columns)
-          if mappings['properties'].present?
-            mappings['properties'].each do |name, attributes|
-              self.mapping(name, attributes.delete('type'), **attributes)
-            end
-          end
-        end
-
-        def transform_settings!(settings)
-          # exclude settings, that are provided through the API but are not part of the index-settings
-          settings
-            .with_indifferent_access
-            .each { |name, value|
-              # don't transform ignored names
-              next if ActiveRecord::ConnectionAdapters::Elasticsearch::TableSettingDefinition.match_ignore_names?(name)
-
-              self.setting(name, value)
-            }
-        end
-
-        def transform_aliases!(aliases)
-          aliases.each do |name, attributes|
-            self.alias(name, **attributes)
-          end
-        end
       end
     end
   end

data/lib/active_record/connection_adapters/elasticsearch/schema_definitions/table_mapping_definition.rb

@@ -99,6 +99,12 @@ module ActiveRecord
           _lazy_attributes[:auto_increment] = value
         end
 
+        # returns the meta hash
+        # @param [Hash]
+        def meta
+          __get_attribute(:meta) || {}
+        end
+
         def meta=(value)
           if value.nil?
             __remove_attribute(:meta)

data/lib/active_record/connection_adapters/elasticsearch/schema_definitions/update_table_definition.rb

@@ -8,15 +8,13 @@ module ActiveRecord
     module Elasticsearch
       class UpdateTableDefinition < TableDefinition
 
-        attr_reader :definitions
-
         # defines which definitions can be executed composite
         COMPOSITE_DEFINITIONS = [
           AddMappingDefinition,
           ChangeMappingDefinition,
           ChangeMetaDefinition,
           AddSettingDefinition,
-          DeleteAliasDefinition
+          RemoveAliasDefinition
         ].freeze
 
         def add_mapping(name, type, if_not_exists: false, **options, &block)
@@ -35,23 +33,14 @@ module ActiveRecord
           define! ChangeMetaDefinition, new_meta_definition(name, value, **options)
         end
 
-        def delete_meta(name, **options)
+        def remove_meta(name, **options)
           load_meta_definition!
 
           define! ChangeMetaDefinition, new_meta_definition(name, nil, **options)
         end
 
-        def change_mapping(name, type, if_exists: false, **options, &block)
-          return if if_exists && !mapping_exists?(self.name, name, type)
-
-          mapping = new_mapping_definition(name, type, **options, &block)
-          define! ChangeMappingDefinition, mapping
-
-          # check if the mapping is assigned as primary_key
-          if mapping.primary_key?
-            change_meta :primary_key, mapping.name
-            change_meta(:auto_increment, mapping.auto_increment) if mapping.auto_increment?
-          end
+        def change_mapping(name, type, **options, &block)
+          raise ArgumentError, "you cannot change the mapping '#{name}' without the 'recreate: true' flag in the '#change_table' call"
         end
 
         alias :change_column :change_mapping
@@ -67,16 +56,28 @@ module ActiveRecord
           define! ChangeMappingDefinition, new_mapping_definition(name, mapping['type'], meta: meta)
         end
 
-        def change_mapping_attributes(name, **options, &block)
-          mapping = table_mappings(self.name).dig('properties', name.to_s)
-          raise ArgumentError, "you cannot change parameters for an unknown mapping '#{name}'" if mapping.blank?
+        def change_mapping_attributes(name, if_exists: false, **options, &block)
+          return if if_exists && !mapping_exists?(self.name, name)
+
+          # receive current mapping
+          current_mapping = table_mappings(self.name).dig('properties', name.to_s)
+          raise ArgumentError, "you cannot change an unknown mapping '#{name}'" if current_mapping.blank?
 
-          options = mapping.with_indifferent_access.except(:type).merge(options) if options.present?
+          # build new mapping
+          mapping = new_mapping_definition(name, current_mapping[:type], **options, &block)
+          define! ChangeMappingDefinition, mapping
 
-          define! ChangeMappingDefinition, new_mapping_definition(name, mapping['type'], **options, &block)
+          # check if the mapping is assigned as new primary_key
+          if mapping.primary_key?
+            change_meta :primary_key, mapping.name
+            change_meta(:auto_increment, mapping.auto_increment) if mapping.auto_increment?
+          end
         end
 
-        alias :change_mapping_attribute :change_mapping_attributes
+        def remove_mapping(name)
+          raise ArgumentError, "you cannot remove the mapping '#{name}' without the 'recreate: true' flag in the '#change_table' call"
+        end
+        alias :remove_column :remove_mapping
 
         def add_setting(name, value, if_not_exists: false, **options, &block)
           return if if_not_exists && setting_exists?(self.name, name)
@@ -90,10 +91,10 @@ module ActiveRecord
           define! ChangeSettingDefinition, new_setting_definition(name, value, **options, &block)
         end
 
-        def delete_setting(name, if_exists: false, **options, &block)
+        def remove_setting(name, if_exists: false, **options, &block)
           return if if_exists && !setting_exists?(self.name, name)
 
-          define! DeleteSettingDefinition, new_setting_definition(name, nil, **options, &block)
+          define! RemoveSettingDefinition, new_setting_definition(name, nil, **options, &block)
         end
 
         def add_alias(name, if_not_exists: false, **options, &block)
@@ -108,10 +109,10 @@ module ActiveRecord
           define! ChangeAliasDefinition, new_alias_definition(name, **options, &block)
         end
 
-        def delete_alias(name, if_exists: false, **, &block)
+        def remove_alias(name, if_exists: false, **, &block)
           return if if_exists && !alias_exists?(self.name, name)
 
-          define! DeleteAliasDefinition, new_alias_definition(name, &block)
+          define! RemoveAliasDefinition, new_alias_definition(name, &block)
         end
 
         # Appends <tt>:datetime</tt> columns <tt>:created_at</tt> and
@@ -123,6 +124,11 @@ module ActiveRecord
           add_mapping(:updated_at, :datetime, if_not_exists: true, **options)
         end
 
+        # returns the definitions hash
+        def definitions
+          @definitions ||= {}
+        end
+
         private
 
         # loads existing meta definitions from table_mappings
@@ -130,16 +136,14 @@ module ActiveRecord
           return if @load_meta_definition
           @load_meta_definition = true
 
-
           table_metas(self.name).each do |name, value|
             define! ChangeMetaDefinition, new_meta_definition(name, value)
           end
         end
 
         def define!(klass, item)
-          @definitions        ||= {}
-          @definitions[klass] ||= []
-          @definitions[klass] << item
+          self.definitions[klass] ||= []
+          self.definitions[klass] << item
         end
 
         def _before_assign
@@ -157,6 +161,7 @@ module ActiveRecord
           # reset table state
           clear_state!
         end
+
         alias :_rescue_assign :_after_exec
         alias :_rescue_exec :_after_exec
 

data/lib/active_record/connection_adapters/elasticsearch/schema_definitions.rb

@@ -14,12 +14,12 @@ module ActiveRecord
       # setting definitions
       AddSettingDefinition    = Struct.new(:items) # composite
       ChangeSettingDefinition = Struct.new(:items) # composite
-      DeleteSettingDefinition = Struct.new(:items) # composite
+      RemoveSettingDefinition = Struct.new(:items) # composite
 
       # alias definitions
       AddAliasDefinition    = Struct.new(:item) # single
       ChangeAliasDefinition = Struct.new(:item) # single
-      DeleteAliasDefinition = Struct.new(:items) # composite
+      RemoveAliasDefinition = Struct.new(:items) # composite
     end
   end
 end

data/lib/active_record/connection_adapters/elasticsearch/schema_dumper.rb

@@ -20,6 +20,11 @@ module ActiveRecord
           @options[:table_name_suffix] = @connection.table_name_suffix if @options[:table_name_suffix].blank?
         end
 
+        # returns true if the connection has table-names, that are environment related
+        def _has_env_table_names?
+          @options[:table_name_prefix].present? || @options[:table_name_suffix].present?
+        end
+
         # overwrite the method to 'fix' a possible ActiveRecord bug:
         # If a +table_name_prefix+ or +table_name_suffix+ was provided we also only want to dump those tables,
         # which matches the prefix/suffix. So possible, environment-related tables will be ignored
@@ -35,7 +40,7 @@ module ActiveRecord
           return true if @options[:table_name_prefix].present? && !table_name.start_with?(@options[:table_name_prefix].to_s)
 
           # if the table ends NOT with +suffix+ it must be ignored
-          return true if  @options[:table_name_suffix].present? && !table_name.end_with?(@options[:table_name_suffix].to_s)
+          return true if @options[:table_name_suffix].present? && !table_name.end_with?(@options[:table_name_suffix].to_s)
 
           false
         end
@@ -50,7 +55,14 @@ module ActiveRecord
             # resolve string printer
             tbl = StringIO.new
 
-            tbl.print "  create_table #{remove_prefix_and_suffix(table).inspect}"
+            tbl.print "  create_table"
+
+            if _has_env_table_names?
+              tbl.print " _env_table_name(#{remove_prefix_and_suffix(table).inspect})"
+            else
+              tbl.print " #{remove_prefix_and_suffix(table).inspect}"
+            end
+
             tbl.print ", force: true do |t|"
 
             # META

data/lib/active_record/connection_adapters/elasticsearch/schema_statements.rb

@@ -399,6 +399,12 @@ module ActiveRecord
             settings['persistent'].merge(settings['transient'])
           end
 
+          # returns the cluster health
+          # @return [Hash]
+          def cluster_health(**options)
+            api(:cluster, :health, options, 'CLUSTER HEALTH').to_h
+          end
+
           # transforms provided schema-type to a sql-type
           # overwrite original methods to provide a elasticsearch version
           # @param [String, Symbol] type
@@ -467,7 +473,7 @@ module ActiveRecord
 
           # overwrite original methods to provide a elasticsearch version
           def extract_table_options!(options)
-            options.extract!(:settings, :mappings, :aliases, :force, :strict)
+            options.extract!(:settings, :mappings, :aliases, :metas, :force, :strict)
           end
         end
       end