class Sequel::ADO::Database

  1. lib/sequel/adapters/ado.rb
Parent: ADO

Constants

CommandTimeout = opts[:command_timeout] if opts[:command_timeout]  
DISCONNECT_ERROR_RE = /Communication link failure/  
Provider = opts[:provider] if opts[:provider]  

Public Instance methods

connect (server)

In addition to the usual database options, the following options have an effect:

:command_timeout

Sets the time in seconds to wait while attempting to execute a command before cancelling the attempt and generating an error. Specifically, it sets the ADO CommandTimeout property. If this property is not set, the default of 30 seconds is used.

:driver

The driver to use in the ADO connection string. If not provided, a default of “SQL Server” is used.

:conn_string

The full ADO connection string. If this is provided, the usual options are ignored.

:provider

Sets the Provider of this ADO connection (for example, “SQLOLEDB”). If you don’t specify a provider, the default one used by WIN32OLE has major problems, such as creating a new native database connection for every query, which breaks things such as temporary tables.

Pay special attention to the :provider option, as without specifying a provider, many things will be broken. The SQLNCLI10 provider appears to work well if you are connecting to Microsoft SQL Server, but it is not the default as that would break backwards compatability.

[show source] 
# File lib/sequel/adapters/ado.rb, line 31
def connect(server)
  opts = server_opts(server)
  s = opts[:conn_string] || "driver=#{opts[:driver]};server=#{opts[:host]};database=#{opts[:database]}#{";uid=#{opts[:user]};pwd=#{opts[:password]}" if opts[:user]}"
  handle = WIN32OLE.new('ADODB.Connection')
  handle.CommandTimeout = opts[:command_timeout] if opts[:command_timeout]
  handle.Provider = opts[:provider] if opts[:provider]
  handle.Open(s)
  handle
end
disconnect_connection (conn)
[show source] 
# File lib/sequel/adapters/ado.rb, line 41
def disconnect_connection(conn)
  conn.Close
rescue WIN32OLERuntimeError
  nil
end
execute (sql, opts=OPTS)
[show source] 
# File lib/sequel/adapters/ado.rb, line 73
def execute(sql, opts=OPTS)
  synchronize(opts[:server]) do |conn|
    begin
      r = log_yield(sql){conn.Execute(sql)}
      yield(r) if block_given?
    rescue ::WIN32OLERuntimeError => e
      raise_error(e)
    end
  end
  nil
end
execute_ddl (sql, opts=OPTS)

Just execute so it doesn’t attempt to return the number of rows modified.

[show source] 
# File lib/sequel/adapters/ado.rb, line 48
def execute_ddl(sql, opts=OPTS)
  execute(sql, opts)
end
execute_dui (sql, opts=OPTS)

Use pass by reference in WIN32OLE to get the number of affected rows, unless is a provider is in use (since some providers don’t seem to return the number of affected rows, but the default provider appears to).

[show source] 
# File lib/sequel/adapters/ado.rb, line 61
def execute_dui(sql, opts=OPTS)
  return super if opts[:provider]
  synchronize(opts[:server]) do |conn|
    begin
      log_yield(sql){conn.Execute(sql, 1)}
      WIN32OLE::ARGV[1]
    rescue ::WIN32OLERuntimeError => e
      raise_error(e)
    end
  end
end
execute_insert (sql, opts=OPTS)

Just execute so it doesn’t attempt to return the number of rows modified.

[show source] 
# File lib/sequel/adapters/ado.rb, line 53
def execute_insert(sql, opts=OPTS)
  execute(sql, opts)
end