Class/Module Index [+]

Quicksearch

Sequel::SQLite::Database

Database class for SQLite databases used with Sequel and the ruby-sqlite3 driver.

Attributes

conversion_procs[R]

The conversion procs to use for this database

Public Instance Methods

connect(server) click to toggle source

Connect to the database. Since SQLite is a file based database, available options are limited:

:database

database name (filename or ':memory:' or file: URI)

:readonly

open database in read-only mode; useful for reading static data that you do not want to modify

:timeout

how long to wait for the database to be available if it is locked, given in milliseconds (default is 5000)

# File lib/sequel/adapters/sqlite.rb, line 102
def connect(server)
  opts = server_opts(server)
  opts[:database] = ':memory:' if blank_object?(opts[:database])
  sqlite3_opts = {}
  sqlite3_opts[:readonly] = typecast_value_boolean(opts[:readonly]) if opts.has_key?(:readonly)
  db = ::SQLite3::Database.new(opts[:database].to_s, sqlite3_opts)
  db.busy_timeout(opts.fetch(:timeout, 5000))
  
  connection_pragmas.each{|s| log_yield(s){db.execute_batch(s)}}
  
  class << db
    attr_reader :prepared_statements
  end
  db.instance_variable_set(:@prepared_statements, {})
  
  db
end
disconnect_connection(c) click to toggle source

Disconnect given connections from the database.

# File lib/sequel/adapters/sqlite.rb, line 121
def disconnect_connection(c)
  c.prepared_statements.each_value{|v| v.first.close}
  c.close
end
execute(sql, opts=OPTS, &block) click to toggle source

Run the given SQL with the given arguments and yield each row.

# File lib/sequel/adapters/sqlite.rb, line 127
def execute(sql, opts=OPTS, &block)
  _execute(:select, sql, opts, &block)
end
execute_ddl(sql, opts=OPTS) click to toggle source

Drop any prepared statements on the connection when executing DDL. This is because prepared statements lock the table in such a way that you can't drop or alter the table while a prepared statement that references it still exists.

# File lib/sequel/adapters/sqlite.rb, line 139
def execute_ddl(sql, opts=OPTS)
  synchronize(opts[:server]) do |conn|
    conn.prepared_statements.values.each{|cps, s| cps.close}
    conn.prepared_statements.clear
    super
  end
end
execute_dui(sql, opts=OPTS) click to toggle source

Run the given SQL with the given arguments and return the number of changed rows.

# File lib/sequel/adapters/sqlite.rb, line 132
def execute_dui(sql, opts=OPTS)
  _execute(:update, sql, opts)
end
execute_insert(sql, opts=OPTS) click to toggle source

Run the given SQL with the given arguments and return the last inserted row id.

# File lib/sequel/adapters/sqlite.rb, line 148
def execute_insert(sql, opts=OPTS)
  _execute(:insert, sql, opts)
end
to_application_timestamp(s) click to toggle source

Handle Integer and Float arguments, since SQLite can store timestamps as integers and floats.

# File lib/sequel/adapters/sqlite.rb, line 153
def to_application_timestamp(s)
  case s
  when String
    super
  when Integer
    super(Time.at(s).to_s)
  when Float
    super(DateTime.jd(s).to_s)
  else
    raise Sequel::Error, "unhandled type when converting to : #{s.inspect} (#{s.class.inspect})"
  end
end

[Validate]

Generated with the Darkfish Rdoc Generator 2.