cassandra-driver 3.0.0.beta.1-java → 3.0.0-java

data/lib/cassandra/cluster/schema/fqcn_type_parser.rb

@@ -1,7 +1,7 @@
 # encoding: utf-8
 
 #--
-# Copyright 2013-2015 DataStax, Inc.
+# Copyright 2013-2016 DataStax, Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -26,31 +26,31 @@ module Cassandra
         Result = Struct.new(:results, :collections)
 
         @@types = {
-          "org.apache.cassandra.db.marshal.AsciiType"         => :ascii,
-          "org.apache.cassandra.db.marshal.LongType"          => :bigint,
-          "org.apache.cassandra.db.marshal.BytesType"         => :blob,
-          "org.apache.cassandra.db.marshal.BooleanType"       => :boolean,
-          "org.apache.cassandra.db.marshal.CounterColumnType" => :counter,
-          "org.apache.cassandra.db.marshal.DecimalType"       => :decimal,
-          "org.apache.cassandra.db.marshal.DoubleType"        => :double,
-          "org.apache.cassandra.db.marshal.FloatType"         => :float,
-          "org.apache.cassandra.db.marshal.InetAddressType"   => :inet,
-          "org.apache.cassandra.db.marshal.Int32Type"         => :int,
-          "org.apache.cassandra.db.marshal.UTF8Type"          => :text,
-          "org.apache.cassandra.db.marshal.TimestampType"     => :timestamp,
-          "org.apache.cassandra.db.marshal.DateType"          => :timestamp,
-          "org.apache.cassandra.db.marshal.UUIDType"          => :uuid,
-          "org.apache.cassandra.db.marshal.IntegerType"       => :varint,
-          "org.apache.cassandra.db.marshal.TimeUUIDType"      => :timeuuid,
-          "org.apache.cassandra.db.marshal.MapType"           => :map,
-          "org.apache.cassandra.db.marshal.SetType"           => :set,
-          "org.apache.cassandra.db.marshal.ListType"          => :list,
-          "org.apache.cassandra.db.marshal.UserType"          => :udt,
-          "org.apache.cassandra.db.marshal.TupleType"         => :tuple,
-          "org.apache.cassandra.db.marshal.ShortType"         => :smallint,
-          "org.apache.cassandra.db.marshal.ByteType"          => :tinyint,
-          "org.apache.cassandra.db.marshal.TimeType"          => :time,
-          "org.apache.cassandra.db.marshal.SimpleDateType"    => :date,
+          'org.apache.cassandra.db.marshal.AsciiType'         => :ascii,
+          'org.apache.cassandra.db.marshal.LongType'          => :bigint,
+          'org.apache.cassandra.db.marshal.BytesType'         => :blob,
+          'org.apache.cassandra.db.marshal.BooleanType'       => :boolean,
+          'org.apache.cassandra.db.marshal.CounterColumnType' => :counter,
+          'org.apache.cassandra.db.marshal.DecimalType'       => :decimal,
+          'org.apache.cassandra.db.marshal.DoubleType'        => :double,
+          'org.apache.cassandra.db.marshal.FloatType'         => :float,
+          'org.apache.cassandra.db.marshal.InetAddressType'   => :inet,
+          'org.apache.cassandra.db.marshal.Int32Type'         => :int,
+          'org.apache.cassandra.db.marshal.UTF8Type'          => :text,
+          'org.apache.cassandra.db.marshal.TimestampType'     => :timestamp,
+          'org.apache.cassandra.db.marshal.DateType'          => :timestamp,
+          'org.apache.cassandra.db.marshal.UUIDType'          => :uuid,
+          'org.apache.cassandra.db.marshal.IntegerType'       => :varint,
+          'org.apache.cassandra.db.marshal.TimeUUIDType'      => :timeuuid,
+          'org.apache.cassandra.db.marshal.MapType'           => :map,
+          'org.apache.cassandra.db.marshal.SetType'           => :set,
+          'org.apache.cassandra.db.marshal.ListType'          => :list,
+          'org.apache.cassandra.db.marshal.UserType'          => :udt,
+          'org.apache.cassandra.db.marshal.TupleType'         => :tuple,
+          'org.apache.cassandra.db.marshal.ShortType'         => :smallint,
+          'org.apache.cassandra.db.marshal.ByteType'          => :tinyint,
+          'org.apache.cassandra.db.marshal.TimeType'          => :time,
+          'org.apache.cassandra.db.marshal.SimpleDateType'    => :date
         }.freeze
 
         def parse(string)
@@ -63,15 +63,16 @@ module Cassandra
           collections = nil
           results     = []
 
-          if node.name == "org.apache.cassandra.db.marshal.CompositeType"
+          if node.name == 'org.apache.cassandra.db.marshal.CompositeType'
             collections = {}
 
-            if node.children.last.name == "org.apache.cassandra.db.marshal.ColumnToCollectionType"
+            if node.children.last.name ==
+               'org.apache.cassandra.db.marshal.ColumnToCollectionType'
               node.children.pop.children.each do |child|
-                key, name  = child.name.split(":")
+                key, name  = child.name.split(':')
                 key        = [key].pack('H*').force_encoding(::Encoding::UTF_8)
 
-                if name == "org.apache.cassandra.db.marshal.ReversedType"
+                if name == 'org.apache.cassandra.db.marshal.ReversedType'
                   collections[key] = lookup_type(child.children.first)
                 else
                   child.name = name
@@ -94,12 +95,12 @@ module Cassandra
           order  = :asc
           frozen = false
 
-          if node.name == "org.apache.cassandra.db.marshal.ReversedType"
+          if node.name == 'org.apache.cassandra.db.marshal.ReversedType'
             order = :desc
             node  = node.children.first
           end
 
-          if node.name == "org.apache.cassandra.db.marshal.FrozenType"
+          if node.name == 'org.apache.cassandra.db.marshal.FrozenType'
             frozen = true
             node   = node.children.first
           end
@@ -108,11 +109,11 @@ module Cassandra
         end
 
         def lookup_type(node)
-          if node.name == "org.apache.cassandra.db.marshal.FrozenType"
-            return lookup_type(node.children.first)
-          end
+          return lookup_type(node.children.first) if node.name == 'org.apache.cassandra.db.marshal.FrozenType'
 
-          type = @@types.fetch(node.name) { return Cassandra::Types.custom(dump_node(node)) }
+          type = @@types.fetch(node.name) do
+            return Cassandra::Types.custom(dump_node(node))
+          end
 
           case type
           when :set, :list
@@ -123,7 +124,7 @@ module Cassandra
             keyspace = node.children.shift.name
             name     = [node.children.shift.name].pack('H*')
             fields   = node.children.map do |child|
-              field_name, child_name = child.name.split(":")
+              field_name, child_name = child.name.split(':')
 
               child.name = child_name
               field_name = [field_name].pack('H*').force_encoding(::Encoding::UTF_8)
@@ -166,7 +167,7 @@ module Cassandra
 
         def dump_node(node)
           str = node.name
-          str << '(' + node.children.map {|n| dump_node(n)}.join(',') + ')' unless node.children.empty?
+          str << '(' + node.children.map { |n| dump_node(n) }.join(',') + ')' unless node.children.empty?
           str
         end
       end

data/lib/cassandra/cluster/schema/partitioners.rb

@@ -1,7 +1,7 @@
 # encoding: utf-8
 
 #--
-# Copyright 2013-2015 DataStax, Inc.
+# Copyright 2013-2016 DataStax, Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/cassandra/cluster/schema/partitioners/murmur3.rb

@@ -1,7 +1,7 @@
 # encoding: utf-8
 
 #--
-# Copyright 2013-2015 DataStax, Inc.
+# Copyright 2013-2016 DataStax, Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -23,6 +23,11 @@ module Cassandra
       module Partitioners
         # @private
         class Murmur3
+          # @private
+          LONG_MIN = -2**63
+          # @private
+          LONG_MAX = 2**63 - 1
+
           def create_token(partition_key)
             token = Cassandra::Murmur3.hash(partition_key)
             token = LONG_MAX if token == LONG_MIN
@@ -33,13 +38,6 @@ module Cassandra
           def parse_token(token_string)
             token_string.to_i
           end
-
-          private
-
-          # @private
-          LONG_MIN = -2 ** 63
-          # @private
-          LONG_MAX = 2 ** 63 - 1
         end
       end
     end

data/lib/cassandra/cluster/schema/partitioners/ordered.rb

@@ -1,7 +1,7 @@
 # encoding: utf-8
 
 #--
-# Copyright 2013-2015 DataStax, Inc.
+# Copyright 2013-2016 DataStax, Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/cassandra/cluster/schema/partitioners/random.rb

@@ -1,7 +1,7 @@
 # encoding: utf-8
 
 #--
-# Copyright 2013-2015 DataStax, Inc.
+# Copyright 2013-2016 DataStax, Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/cassandra/cluster/schema/replication_strategies.rb

@@ -1,7 +1,7 @@
 # encoding: utf-8
 
 #--
-# Copyright 2013-2015 DataStax, Inc.
+# Copyright 2013-2016 DataStax, Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/cassandra/cluster/schema/replication_strategies/network_topology.rb

@@ -1,7 +1,7 @@
 # encoding: utf-8
 
 #--
-# Copyright 2013-2015 DataStax, Inc.
+# Copyright 2013-2016 DataStax, Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -34,7 +34,7 @@ module Cassandra
               racks[host.datacenter] ||= ::Set.new
               racks[host.datacenter].add(host.rack)
 
-              datacenter_token_rings[host.datacenter]  ||= Hash.new
+              datacenter_token_rings[host.datacenter]  ||= {}
               datacenter_token_rings[host.datacenter][i] = token
             end
 
@@ -48,8 +48,11 @@ module Cassandra
               replication_options.each do |datacenter, factor|
                 ring = datacenter_token_rings[datacenter]
                 next unless ring
-                factor = [Integer(factor), ring.size].min rescue next
-
+                factor = begin
+                           [Integer(factor), ring.size].min
+                         rescue
+                           next
+                         end
 
                 total_racks    = racks[datacenter].size
                 visited_racks  = visited[datacenter] ||= ::Set.new
@@ -68,21 +71,19 @@ module Cassandra
                   if rack.nil? || visited_racks.size == total_racks
                     replicas << host
                     added_replicas << host
+                  elsif visited_racks.include?(rack)
+                    skipped_hosts << host
                   else
-                    if visited_racks.include?(rack)
-                      skipped_hosts << host
-                    else
-                      replicas << host
-                      visited_racks << rack
-                      added_replicas << host
-
-                      if visited_racks.size == total_racks
-                        skipped_hosts.each do |skipped_host|
-                          break if added_replicas.size >= factor
-
-                          replicas << skipped_host
-                          added_replicas << host
-                        end
+                    replicas << host
+                    visited_racks << rack
+                    added_replicas << host
+
+                    if visited_racks.size == total_racks
+                      skipped_hosts.each do |skipped_host|
+                        break if added_replicas.size >= factor
+
+                        replicas << skipped_host
+                        added_replicas << host
                       end
                     end
                   end

data/lib/cassandra/cluster/schema/replication_strategies/none.rb

@@ -1,7 +1,7 @@
 # encoding: utf-8
 
 #--
-# Copyright 2013-2015 DataStax, Inc.
+# Copyright 2013-2016 DataStax, Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/cassandra/cluster/schema/replication_strategies/simple.rb

@@ -1,7 +1,7 @@
 # encoding: utf-8
 
 #--
-# Copyright 2013-2015 DataStax, Inc.
+# Copyright 2013-2016 DataStax, Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/cassandra/column.rb

@@ -1,7 +1,7 @@
 # encoding: utf-8
 
 #--
-# Copyright 2013-2015 DataStax, Inc.
+# Copyright 2013-2016 DataStax, Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -21,36 +21,18 @@ module Cassandra
   # @see Cassandra::Table#each_column
   # @see Cassandra::Table#column
   class Column
-    # @private
-    class Index
-      # @return [String] index name
-      attr_reader :name
-      # @return [String] custom index class name
-      attr_reader :custom_class_name
-
-      # @private
-      def initialize(name, custom_class_name = nil)
-        @name              = name
-        @custom_class_name = custom_class_name
-      end
-    end
-
     # @return [String] column name
     attr_reader :name
     # @return [Cassandra::Type] column type
     attr_reader :type
     # @return [Symbol] column order (`:asc` or `:desc`)
     attr_reader :order
-    # @private
-    # @return [Cassandra::Column::Index, nil] column index
-    attr_reader :index
 
     # @private
-    def initialize(name, type, order, index = nil, is_static = false, is_frozen = false)
+    def initialize(name, type, order, is_static = false, is_frozen = false)
       @name     = name
       @type     = type
       @order    = order
-      @index    = index
       @static   = is_static
       @frozen   = is_frozen
     end
@@ -67,7 +49,7 @@ module Cassandra
 
     # @private
     def inspect
-      "#<#{self.class.name}:0x#{self.object_id.to_s(16)} @name=#{@name} @type=#{@type}>"
+      "#<#{self.class.name}:0x#{object_id.to_s(16)} @name=#{@name} @type=#{@type}>"
     end
 
     # @private
@@ -76,10 +58,9 @@ module Cassandra
         @name == other.name &&
         @type == other.type &&
         @order == other.order &&
-        @index == other.index &&
         @static == other.static? &&
         @frozen == other.frozen?
     end
-    alias :== :eql?
+    alias == eql?
   end
 end

data/lib/cassandra/column_container.rb

@@ -0,0 +1,322 @@
+# encoding: utf-8
+
+#--
+# Copyright 2013-2016 DataStax, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#++
+
+module Cassandra
+  # This class contains all the logic needed for manipulating columns of an object.
+  class ColumnContainer
+    # Encapsulates all of the configuration options of a column-container.
+    class Options
+      # @return [String] the comment attribute of this column-container.
+      attr_reader :comment
+      # @return [Float] the chance with which a read repair is triggered for this column-container.
+      attr_reader :read_repair_chance
+      # @return [Float] the cluster local read repair chance for this column-container.
+      attr_reader :local_read_repair_chance
+      # @return [Integer] the tombstone garbage collection grace time in seconds for this column-container.
+      attr_reader :gc_grace_seconds
+      # @return [Hash] the caching options for this column-container.
+      attr_reader :caching
+      # @return [Float] the false positive chance for the Bloom filter of this column-container.
+      attr_reader :bloom_filter_fp_chance
+      # @return [Integer] how often (in milliseconds) to flush the memtable of this column-container.
+      attr_reader :memtable_flush_period_in_ms
+      # @return [Integer] the default TTL for this column-container.
+      attr_reader :default_time_to_live
+      # Return the speculative retry setting of this column-container, which determines how much
+      # response delay the coordinator node will tolerate from the chosen replica before
+      # retrying the request on other replicas. This setting can be expressed as a fixed
+      # delay in ms (e.g. 10ms) or as a percentile indicating "when the response time has
+      # exceeded the Nth percentile of read response times for this object" (e.g. 99percentile).
+      # @return [String] the speculative retry setting of this column-container.
+      attr_reader :speculative_retry
+      # Return the index interval of this column-container; Cassandra will hold `1/index_interval` of row keys in
+      # memory.
+      # @return [Integer] the index interval of this column-container. May be nil, indicating a default value of 128.
+      attr_reader :index_interval
+      # @return [Hash] compression settings
+      attr_reader :compression
+      # When compression is enabled, this option defines the probability
+      # with which checksums for compressed blocks are checked during reads.
+      # @return [Float] the probability of checking checksums on compressed blocks.
+      attr_reader :crc_check_chance
+      # @return [Hash] the extension options of this column-container.
+      attr_reader :extensions
+
+      # @return [ColumnContainer::Compaction] the compaction strategy of this column-container.
+      attr_reader :compaction_strategy
+
+      # @private
+      # rubocop:disable Metrics/ParameterLists
+      def initialize(comment,
+                     read_repair_chance,
+                     local_read_repair_chance,
+                     gc_grace_seconds,
+                     caching,
+                     bloom_filter_fp_chance,
+                     populate_io_cache_on_flush,
+                     memtable_flush_period_in_ms,
+                     default_time_to_live,
+                     speculative_retry,
+                     index_interval,
+                     replicate_on_write,
+                     min_index_interval,
+                     max_index_interval,
+                     compaction_strategy,
+                     compression,
+                     compact_storage,
+                     crc_check_chance,
+                     extensions)
+        @comment                     = comment
+        @read_repair_chance          = read_repair_chance
+        @local_read_repair_chance    = local_read_repair_chance
+        @gc_grace_seconds            = gc_grace_seconds
+        @caching                     = caching
+        @bloom_filter_fp_chance      = bloom_filter_fp_chance
+        @populate_io_cache_on_flush  = populate_io_cache_on_flush
+        @memtable_flush_period_in_ms = memtable_flush_period_in_ms
+        @default_time_to_live        = default_time_to_live
+        @speculative_retry           = speculative_retry
+        @index_interval              = index_interval
+        @replicate_on_write          = replicate_on_write
+        @min_index_interval          = min_index_interval
+        @max_index_interval          = max_index_interval
+        @compaction_strategy         = compaction_strategy
+        @compression                 = compression
+        @compact_storage             = compact_storage
+        @crc_check_chance            = crc_check_chance
+        @extensions                  = extensions
+      end
+
+      # Return whether to replicate counter updates to other replicas. It is *strongly* recommended
+      # that this setting be `true`. Otherwise, counter updates are only written to one replica
+      # and fault tolerance is sacrificed.
+      # @return [Boolean] whether to replicate counter updates to other replicas.
+      def replicate_on_write?
+        @replicate_on_write
+      end
+
+      # @return [Boolean] whether to populate the I/O cache on flush of this
+      #   column-container. May be nil, indicating a default value of `false`.
+      def populate_io_cache_on_flush?
+        @populate_io_cache_on_flush
+      end
+
+      # @return [Boolean] whether this column-container uses compact storage.
+      def compact_storage?
+        @compact_storage
+      end
+
+      # @private
+      def to_cql
+        options = []
+
+        options << 'COMPACT STORAGE' if @compact_storage
+        unless @bloom_filter_fp_chance.nil?
+          options << "bloom_filter_fp_chance = #{Util.encode_object(@bloom_filter_fp_chance)}"
+        end
+        options << "caching = #{Util.encode_object(@caching)}" unless @caching.nil?
+        options << "comment = #{Util.encode_object(@comment)}" unless @comment.nil?
+        options << "compaction = #{@compaction_strategy.to_cql}" unless @compaction_strategy.nil?
+        options << "compression = #{Util.encode_object(@compression)}" unless @compression.nil?
+        options << "crc_check_chance = #{Util.encode_object(@crc_check_chance)}" unless @crc_check_chance.nil?
+        unless @local_read_repair_chance.nil?
+          options << "dclocal_read_repair_chance = #{Util.encode_object(@local_read_repair_chance)}"
+        end
+        unless @default_time_to_live.nil?
+          options << "default_time_to_live = #{Util.encode_object(@default_time_to_live)}"
+        end
+        options << "gc_grace_seconds = #{Util.encode_object(@gc_grace_seconds)}" unless @gc_grace_seconds.nil?
+        options << "index_interval = #{Util.encode_object(@index_interval)}" unless @index_interval.nil?
+        options << "max_index_interval = #{Util.encode_object(@max_index_interval)}" unless @max_index_interval.nil?
+        unless @memtable_flush_period_in_ms.nil?
+          options << "memtable_flush_period_in_ms = #{Util.encode_object(@memtable_flush_period_in_ms)}"
+        end
+        options << "min_index_interval = #{Util.encode_object(@min_index_interval)}" unless @min_index_interval.nil?
+        unless @populate_io_cache_on_flush.nil?
+          options << "populate_io_cache_on_flush = '#{@populate_io_cache_on_flush}'"
+        end
+        options << "read_repair_chance = #{Util.encode_object(@read_repair_chance)}" unless @read_repair_chance.nil?
+        options << "replicate_on_write = '#{@replicate_on_write}'" unless @replicate_on_write.nil?
+        options << "speculative_retry = #{Util.encode_object(@speculative_retry)}" unless @speculative_retry.nil?
+
+        options.join("\nAND ")
+      end
+
+      # @private
+      def eql?(other)
+        other.is_a?(Options) &&
+          @comment == other.comment &&
+          @read_repair_chance == other.read_repair_chance &&
+          @local_read_repair_chance == other.local_read_repair_chance &&
+          @gc_grace_seconds == other.gc_grace_seconds &&
+          @caching == other.caching &&
+          @bloom_filter_fp_chance == other.bloom_filter_fp_chance &&
+          @populate_io_cache_on_flush == other.populate_io_cache_on_flush? &&
+          @memtable_flush_period_in_ms == other.memtable_flush_period_in_ms &&
+          @default_time_to_live == other.default_time_to_live &&
+          @speculative_retry == other.speculative_retry &&
+          @index_interval == other.index_interval &&
+          @replicate_on_write == other.replicate_on_write? &&
+          @compaction_strategy == other.compaction_strategy &&
+          @compression == other.compression &&
+          @compact_storage == other.compact_storage? &&
+          @crc_check_chance == other.crc_check_chance &&
+          @extensions == other.extensions
+      end
+      alias == eql?
+    end
+
+    # Encapsulates the compaction strategy of a column-container.
+    class Compaction
+      # @return [String] the name of the Cassandra class that performs compaction.
+      attr_reader :class_name
+      # @return [Hash] compaction strategy options
+      attr_reader :options
+
+      # @private
+      def initialize(class_name, options)
+        @class_name = class_name
+        @options = options
+      end
+
+      # @private
+      def to_cql
+        compaction = {'class' => @class_name}
+        compaction.merge!(@options)
+
+        Util.encode_hash(compaction)
+      end
+
+      # @private
+      def eql?(other)
+        other.is_a?(Compaction) &&
+          @class_name == other.class_name &&
+          @options == other.options
+      end
+      alias == eql?
+    end
+
+    # @return [String] name of this column-container
+    attr_reader :name
+    # @return [Cassandra::Uuid] the id of this object in Cassandra.
+    attr_reader :id
+    # @return [Cassandra::Keyspace] the keyspace that this column-container belongs to.
+    attr_reader :keyspace
+    # @return [ColumnContainer::Options] collection of configuration options of this column-container.
+    attr_reader :options
+    # @return [Array<Cassandra::Column>] ordered list of column-names that make up the partition-key.
+    attr_reader :partition_key
+    # @return [Array<Cassandra::Column>] ordered list of column-names that make up the clustering-columns.
+    attr_reader :clustering_columns
+    # @return [Array<Cassandra::Column>] primary key of this column-container. It's the combination of
+    #   `partition_key` and `clustering_columns`.
+    # @note This composition produces a flat list, so it will not be possible for the caller to distinguish
+    #   partition-key columns from clustering-columns.
+    attr_reader :primary_key
+
+    # @private
+    def initialize(keyspace,
+                   name,
+                   partition_key,
+                   clustering_columns,
+                   other_columns,
+                   options,
+                   id)
+      @keyspace           = keyspace
+      @name               = name.freeze
+      @partition_key      = partition_key.freeze
+      @clustering_columns = clustering_columns.freeze
+      @options            = options
+      @id                 = id
+
+      # Make one array of all the columns, ordered with partition key, clustering
+      # columns, then other columns. Make a hash as well, to support random access
+      # to column metadata for a given column name. Save off the primary key (which
+      # is partition-key + clustering-columns) while we're at it.
+
+      @primary_key = @partition_key.dup.concat(@clustering_columns).freeze
+      @columns = @primary_key.dup.concat(other_columns).freeze
+      @columns_hash = @columns.each_with_object({}) do |col, h|
+        h[col.name] = col
+      end
+    end
+
+    # @param name [String] column name
+    # @return [Boolean] whether this column-container has a given column
+    def has_column?(name)
+      @columns_hash.key?(name)
+    end
+
+    # @param name [String] column name
+    # @return [Cassandra::Column, nil] a column or nil
+    def column(name)
+      @columns_hash[name]
+    end
+
+    # Yield or enumerate each column defined in this column-container
+    # @overload each_column
+    #   @yieldparam column [Cassandra::Column] current column
+    #   @return [Cassandra::ColumnContainer] self
+    # @overload each_column
+    #   @return [Array<Cassandra::Column>] a list of columns
+    def each_column(&block)
+      if block_given?
+        @columns.each(&block)
+        self
+      else
+        @columns
+      end
+    end
+    alias columns each_column
+
+    # @private
+    # keyspace attribute may be nil because when this object was constructed, we didn't have
+    # its keyspace constructed yet. So allow updating @keyspace if it's nil, thus
+    # allowing fetchers to create keyspace, table/view, and hook them together without
+    # worrying about chickens and eggs.
+    # NOTE: Ignore the set request if the @keyspace is already set.
+    # rubocop:disable Style/AccessorMethodName
+    def set_keyspace(keyspace)
+      @keyspace = keyspace unless @keyspace
+    end
+
+    # @private
+    def inspect
+      "#<#{self.class.name}:0x#{object_id.to_s(16)} " \
+          "@keyspace=#{@keyspace.name} @name=#{@name}>"
+    end
+
+    # @private
+    def eql?(other)
+      other.is_a?(ColumnContainer) &&
+        @keyspace == other.keyspace &&
+        @name == other.name &&
+        @partition_key == other.partition_key &&
+        @clustering_columns == other.clustering_columns &&
+        @columns == other.raw_columns &&
+        @options == other.options
+    end
+    alias == eql?
+
+    # @private
+    def raw_columns
+      @columns
+    end
+    protected :raw_columns
+  end
+end