Method: Cequel::Record::RecordSet#where

Defined in:

lib/cequel/record/record_set.rb

#where(column_name, value) ⇒ RecordSet #where(column_values) ⇒ RecordSet

Note:

Filtering on a primary key requires also filtering on all prior primary keys

Note:

Only one secondary index filter can be used in a given query

Note:

Secondary index filters cannot be mixed with primary key filters

Filter the record set to records containing a given value in an indexed column

Overloads:

• #where(column_name, value) ⇒ RecordSet
  Deprecated.

  Returns record set with filter applied.

  Parameters:

  • column_name (Symbol) —

    column for filter

  • value —

    value to match in given column

  Returns:

  • (RecordSet) —

    record set with filter applied

• #where(column_values) ⇒ RecordSet

  Returns record set with filter applied.

  Parameters:

  • column_values (Hash) —

    map of key column names to values

  Returns:

  • (RecordSet) —

    record set with filter applied

Raises:

• (IllegalQuery) —

  if applying filter would generate an impossible query

• (ArgumentError) —

  if the specified column is not a column that can be filtered on

Since:

• 1.0.0

# File 'lib/cequel/record/record_set.rb', line 204

def where(*args)
  if args.length == 1
    column_filters = args.first.symbolize_keys
  elsif args.length == 2
    warn "where(column_name, value) is deprecated. Use " \
         "where(column_name => value) instead"
    column_filters = {args.first.to_sym => args.second}
  else
    fail ArgumentError,
         "wrong number of arguments (#{args.length} for 1..2)"
  end
  filter_columns(column_filters)
end