Module: Cequel

Extended by:

Uuids

Defined in:

lib/cequel.rb,
lib/cequel/type.rb,
lib/cequel/util.rb,
lib/cequel/metal.rb,
lib/cequel/uuids.rb,
lib/cequel/errors.rb,
lib/cequel/record.rb,
lib/cequel/schema.rb,
lib/cequel/version.rb,
lib/cequel/metal/row.rb,
lib/cequel/metal/batch.rb,
lib/cequel/metal/writer.rb,
lib/cequel/record/bound.rb,
lib/cequel/record/dirty.rb,
lib/cequel/schema/table.rb,
lib/cequel/spec_support.rb,
lib/cequel/metal/deleter.rb,
lib/cequel/metal/logging.rb,
lib/cequel/metal/updater.rb,
lib/cequel/record/errors.rb,
lib/cequel/record/schema.rb,
lib/cequel/record/scoped.rb,
lib/cequel/schema/column.rb,
lib/cequel/metal/data_set.rb,
lib/cequel/metal/inserter.rb,
lib/cequel/metal/keyspace.rb,
lib/cequel/record/finders.rb,
lib/cequel/record/railtie.rb,
lib/cequel/instrumentation.rb,
lib/cequel/metal/statement.rb,
lib/cequel/schema/keyspace.rb,
lib/cequel/record/callbacks.rb,
lib/cequel/metal/incrementer.rb,
lib/cequel/record/collection.rb,
lib/cequel/record/conversion.rb,
lib/cequel/record/properties.rb,
lib/cequel/record/record_set.rb,
lib/cequel/record/timestamps.rb,
lib/cequel/record/bulk_writes.rb,
lib/cequel/record/persistence.rb,
lib/cequel/record/validations.rb,
lib/cequel/metal/batch_manager.rb,
lib/cequel/record/associations.rb,
lib/cequel/schema/table_reader.rb,
lib/cequel/schema/table_writer.rb,
lib/cequel/metal/request_logger.rb,
lib/cequel/schema/table_updater.rb,
lib/cequel/schema/table_property.rb,
lib/cequel/record/mass_assignment.rb,
lib/cequel/metal/row_specification.rb,
lib/cequel/record/data_set_builder.rb,
lib/cequel/record/record_generator.rb,
lib/cequel/schema/create_table_dsl.rb,
lib/cequel/schema/update_table_dsl.rb,
lib/cequel/spec_support/preparation.rb,
lib/cequel/schema/table_synchronizer.rb,
lib/cequel/schema/migration_validator.rb,
lib/cequel/metal/cql_row_specification.rb,
lib/cequel/record/has_many_association.rb,
lib/cequel/record/association_collection.rb,
lib/cequel/record/belongs_to_association.rb,
lib/cequel/record/lazy_record_collection.rb,
lib/cequel/record/configuration_generator.rb,
lib/cequel/metal/new_relic_instrumentation.rb

Overview

Cequel is a library providing robust data modeling and query building capabilities for Cassandra using CQL3.

See Also:

• Cequel::Record, an object-row mapper for CQL3
• Cequel::Metal, a query builder for CQL3 statements
• Cequel::Schema::Keyspace, which provides full read-write access to the database schema defined in Cassandra

Defined Under Namespace

Modules: Instrumentation, Metal, Record, Schema, SpecSupport, Type, Util, Uuids

Constant Summary

InvalidSchemaMigration =

Raised when the schema defined in Cassandra cannot be modified to match the schema defined in the application (e.g., changing the type of a primary key)

Since:

• 1.0.0

Class.new(StandardError)

VERSION =

The current version of the library

'1.5.0'

Class Method Summary

• .connect(configuration = nil) ⇒ Metal::Keyspace

  Get a handle to a keyspace.

Methods included from Uuids

uuid, uuid?

Class Method Details

.connect(configuration = nil) ⇒ Metal::Keyspace

Get a handle to a keyspace

Parameters:

• configuration (Options) (defaults to: nil)

Options Hash (configuration):

• :host (String) — default: '127.0.0.1' —

  hostname of single Cassandra instance to connect to

• :port (Integer) — default: 9042 —

  port on which to connect to all specified hosts

• :max_retries (Integer) —

  maximum number of retries on connection failure

• :hosts (Array<String>) —

  list of Cassandra instances to connect to (hostnames only)

• :username (String) —

  user to auth with (leave blank for no auth)

• :password (String) —

  password to auth with (leave blank for no auth)

• :keyspace (String) —

  name of keyspace to connect to

Returns:

• (Metal::Keyspace) —

  a handle to a keyspace

# File 'lib/cequel.rb', line 36

def self.connect(configuration = nil)
  Metal::Keyspace.new(configuration || {})
end