tiny_tds 0.4.3 → 0.4.4

data/test/benchmark/query_tinytds.rb

@@ -0,0 +1,111 @@
+require 'rubygems'
+require 'bench_press'
+$:.unshift File.expand_path('../../../lib',__FILE__)
+require 'tiny_tds'
+
+extend BenchPress
+
+author 'Ken Collins'
+summary 'Benchmark TinyTds Querys'
+
+reps 1_000
+
+@client = TinyTds::Client.new({ 
+  :dataserver    => ENV['TINYTDS_UNIT_DATASERVER'],
+  :username      => 'tinytds',
+  :password      => '',
+  :database      => 'tinytdstest',
+  :appname       => 'TinyTds Dev',
+  :login_timeout => 5,
+  :timeout       => 5
+})
+
+@query_nothing  = "SELECT NULL AS [null]"
+@query_ints     = "SELECT [int], [bigint], [smallint], [tinyint] FROM [datatypes]"
+@query_binaries = "SELECT [binary_50], [image], [varbinary_50] FROM [datatypes]"
+@query_bits     = "SELECT [bit] FROM [datatypes]"
+@query_chars    = "SELECT [char_10], [nchar_10], [ntext], [nvarchar_50], [text], [varchar_50] FROM [datatypes]"
+@query_dates    = "SELECT [datetime], [smalldatetime] FROM [datatypes]"
+@query_decimals = "SELECT [decimal_9_2], [decimal_16_4], [numeric_18_0], [numeric_36_2] FROM [datatypes]"
+@query_floats   = "SELECT [float], [real] FROM [datatypes]"
+@query_moneys   = "SELECT [money], [smallmoney] FROM [datatypes]"
+@query_guids    = "SELECT [uniqueidentifier] FROM [datatypes]"
+@query_all      = "SELECT * FROM [datatypes]"
+
+def select_all(query)
+  @client.execute(query).each
+end
+
+
+measure "Nothing" do
+  select_all @query_nothing
+end
+
+measure "Integers" do
+  select_all @query_ints
+end
+
+measure "Binaries" do
+  select_all @query_binaries
+end
+
+measure "Bits" do
+  select_all @query_bits
+end
+
+measure "Chars" do
+  select_all @query_chars
+end
+
+measure "Dates" do
+  select_all @query_dates
+end
+
+measure "Decimals" do
+  select_all @query_decimals
+end
+
+measure "Floats" do
+  select_all @query_floats
+end
+
+measure "Moneys" do
+  select_all @query_moneys
+end
+
+measure "Guids" do
+  select_all @query_guids
+end
+
+measure "All" do
+  select_all @query_all
+end
+
+
+=begin
+
+System Information
+------------------
+    Operating System:    Mac OS X 10.6.4 (10F569)
+    CPU:                 Intel Core 2 Duo 2.4 GHz
+    Processor Count:     2
+    Memory:              4 GB
+    ruby 1.8.7 (2010-08-16 patchlevel 302) [i686-darwin10.4.0]
+
+"Nothing" is up to 89% faster over 1,000 repetitions
+----------------------------------------------------
+
+    Nothing     0.357741832733154 secs    Fastest
+    Guids       0.460683107376099 secs    22% Slower
+    Bits        0.483309984207153 secs    25% Slower
+    Floats      0.505340099334717 secs    29% Slower
+    Moneys      0.523844003677368 secs    31% Slower
+    Integers    0.616975069046021 secs    42% Slower
+    Binaries    0.639773845672607 secs    44% Slower
+    Decimals    0.670897960662842 secs    46% Slower
+    Chars       0.800287008285522 secs    55% Slower
+    Dates       0.950634956359863 secs    62% Slower
+    All         2.91044211387634  secs    87% Slower
+
+=end
+

data/test/client_test.rb

@@ -0,0 +1,163 @@
+require 'test_helper'
+
+class ClientTest < TinyTds::TestCase
+  
+  context 'With valid credentials' do
+    
+    setup do
+      @client = new_connection
+    end
+    
+    should 'not be closed' do
+      assert !@client.closed?
+      assert @client.active?
+    end
+    
+    should 'allow client connection to be closed' do
+      assert @client.close
+      assert @client.closed?
+      assert !@client.active?
+      action = lambda { @client.execute('SELECT 1 as [one]').each }
+      assert_raise_tinytds_error(action) do |e|
+        assert_match %r{closed connection}i, e.message, 'ignore if non-english test run'
+      end
+    end
+    
+    should 'have a getters for the tds version information (brittle since conf takes precedence)' do
+      assert_equal 9, @client.tds_version
+      assert_equal 'DBTDS_8_0 - Microsoft SQL Server 2000', @client.tds_version_info
+    end
+    
+    should 'use UTF-8 client charset/encoding by default' do
+      assert_equal 'UTF-8', @client.charset
+      assert_equal Encoding.find('UTF-8'), @client.encoding if ruby19?
+    end
+    
+    should 'have a #escape method used for quote strings' do
+      assert_equal "''hello''", @client.escape("'hello'")
+    end
+    
+    should 'allow valid iconv character set' do
+      ['CP850', 'CP1252', 'ISO-8859-1'].each do |encoding|
+        client = new_connection(:encoding => encoding)
+        assert_equal encoding, client.charset
+        assert_equal Encoding.find(encoding), client.encoding if ruby19?
+      end
+    end
+    
+    should 'be able to use :host/:port connection' do
+      client = new_connection :dataserver => nil, :host => ENV['TINYTDS_UNIT_HOST'], :port => 1433
+    end
+  
+  end
+  
+  context 'With in-valid options' do
+    
+    should 'raise an argument error when no :host given and :dataserver is blank' do
+      assert_raises(ArgumentError) { new_connection :dataserver => nil, :host => nil }
+    end
+    
+    should 'raise an argument error when no :username is supplied' do
+      assert_raises(ArgumentError) { TinyTds::Client.new :username => nil }
+    end
+    
+    should 'raise TinyTds exception with undefined :dataserver' do
+      options = connection_options :login_timeout => 1, :dataserver => '127.0.0.2'
+      action = lambda { new_connection(options) }
+      assert_raise_tinytds_error(action) do |e|
+        assert [20008,20009].include?(e.db_error_number)
+        assert_equal 9, e.severity
+        assert_match %r{unable to (open|connect)}i, e.message, 'ignore if non-english test run'
+      end
+      assert_new_connections_work
+    end
+    
+    should 'raise TinyTds exception with long query past :timeout option' do
+      client = new_connection :timeout => 1
+      action = lambda { client.execute("WaitFor Delay '00:00:02'").do }
+      assert_raise_tinytds_error(action) do |e|
+        assert_equal 20003, e.db_error_number
+        assert_equal 6, e.severity
+        assert_match %r{timed out}i, e.message, 'ignore if non-english test run'
+      end
+      assert_client_works(client)
+      assert_new_connections_work
+    end
+    
+    should 'not timeout per sql batch when not under transaction' do
+      client = new_connection :timeout => 2
+      client.execute("WaitFor Delay '00:00:01'").do
+      client.execute("WaitFor Delay '00:00:01'").do
+      client.execute("WaitFor Delay '00:00:01'").do
+    end
+    
+    should 'not timeout per sql batch when under transaction' do
+      client = new_connection :timeout => 2
+      begin
+        client.execute("BEGIN TRANSACTION").do
+        client.execute("WaitFor Delay '00:00:01'").do
+        client.execute("WaitFor Delay '00:00:01'").do
+        client.execute("WaitFor Delay '00:00:01'").do
+      ensure
+        client.execute("COMMIT TRANSACTION").do
+      end
+    end
+    
+    should_eventually 'run this test to prove we account for dropped connections' do
+      begin
+        client = new_connection :login_timeout => 2, :timeout => 2
+        assert_client_works(client)
+        STDOUT.puts "Disconnect network!"
+        sleep 10
+        STDOUT.puts "This should not get stuck past 6 seconds!"
+        action = lambda { client.execute('SELECT 1 as [one]').each }
+        assert_raise_tinytds_error(action) do |e|
+          assert_equal 20003, e.db_error_number
+          assert_equal 6, e.severity
+          assert_match %r{timed out}i, e.message, 'ignore if non-english test run'
+        end
+      ensure
+        STDOUT.puts "Reconnect network!"
+        sleep 10
+        action = lambda { client.execute('SELECT 1 as [one]').each }
+        assert_raise_tinytds_error(action) do |e|
+          assert_equal 20047, e.db_error_number
+          assert_equal 1, e.severity
+          assert_match %r{dead or not enabled}i, e.message, 'ignore if non-english test run'
+        end
+        assert_new_connections_work
+      end
+    end
+    
+    should 'raise TinyTds exception with wrong :username' do
+      options = connection_options :username => 'willnotwork'
+      action = lambda { new_connection(options) }
+      assert_raise_tinytds_error(action) do |e|
+        if sqlserver_azure?
+          assert_match %r{server name cannot be determined}i, e.message, 'ignore if non-english test run'
+        else
+          assert_equal 18456, e.db_error_number
+          assert_equal 14, e.severity
+          assert_match %r{login failed}i, e.message, 'ignore if non-english test run'
+        end
+      end
+      assert_new_connections_work
+    end
+    
+    should 'fail miserably with unknown encoding option' do
+      options = connection_options :encoding => 'ISO-WTF'
+      action = lambda { new_connection(options) }
+      assert_raise_tinytds_error(action) do |e|
+        assert_equal 20002, e.db_error_number
+        assert_equal 9, e.severity
+        assert_match %r{connection failed}i, e.message, 'ignore if non-english test run'
+      end
+      assert_new_connections_work
+    end
+  
+  end
+  
+  
+  
+end
+

data/test/result_test.rb

@@ -0,0 +1,437 @@
+# encoding: utf-8
+require 'test_helper'
+
+class ResultTest < TinyTds::TestCase
+  
+  context 'Basic query and result' do
+
+    setup do
+      @@current_schema_loaded ||= load_current_schema
+      @client = new_connection
+      @query1 = 'SELECT 1 AS [one]'
+    end
+    
+    should 'have included Enumerable' do
+      assert TinyTds::Result.ancestors.include?(Enumerable)
+    end
+    
+    should 'respond to #each' do
+      result = @client.execute(@query1)
+      assert result.respond_to?(:each)
+    end
+    
+    should 'return all results for #each with no block' do
+      result = @client.execute(@query1)
+      data = result.each
+      row = data.first
+      assert_instance_of Array, data
+      assert_equal 1, data.size
+      assert_instance_of Hash, row, 'hash is the default query option'
+    end
+    
+    should 'return all results for #each with a block yielding a row at a time' do
+      result = @client.execute(@query1)
+      data = result.each do |row|
+        assert_instance_of Hash, row, 'hash is the default query option'
+      end
+      assert_instance_of Array, data
+    end
+    
+    should 'allow successive calls to each returning the same data' do
+      result = @client.execute(@query1)
+      data = result.each
+      result.each
+      assert_equal data.object_id, result.each.object_id
+      assert_equal data.first.object_id, result.each.first.object_id
+    end
+    
+    should 'return hashes with string keys' do
+      result = @client.execute(@query1)
+      row = result.each(:as => :hash, :symbolize_keys => false).first
+      assert_instance_of Hash, row
+      assert_equal ['one'], row.keys
+      assert_equal ['one'], result.fields
+    end
+    
+    should 'return hashes with symbol keys' do
+      result = @client.execute(@query1)
+      row = result.each(:as => :hash, :symbolize_keys => true).first
+      assert_instance_of Hash, row
+      assert_equal [:one], row.keys
+      assert_equal [:one], result.fields
+    end
+    
+    should 'return arrays with string fields' do
+      result = @client.execute(@query1)
+      row = result.each(:as => :array, :symbolize_keys => false).first
+      assert_instance_of Array, row
+      assert_equal ['one'], result.fields
+    end
+    
+    should 'return arrays with symbol fields' do
+      result = @client.execute(@query1)
+      row = result.each(:as => :array, :symbolize_keys => true).first
+      assert_instance_of Array, row
+      assert_equal [:one], result.fields
+    end
+    
+    should 'be able to turn :cache_rows option off' do
+      result = @client.execute(@query1)
+      local = []
+      result.each(:cache_rows => false) do |row|
+        local << row
+      end
+      assert local.first, 'should have iterated over each row'
+      assert_equal [], result.each, 'should not have been cached'
+      assert_equal ['one'], result.fields, 'should still cache field names'
+    end
+    
+    should 'be able to get the first result row only' do
+      load_current_schema
+      big_query = "SELECT [id] FROM [datatypes]"
+      one = @client.execute(big_query).each(:first => true)
+      many = @client.execute(big_query).each
+      assert many.size > 1
+      assert one.size == 1
+    end
+    
+    should 'cope with no results when using first option' do
+      data = @client.execute("SELECT [id] FROM [datatypes] WHERE [id] = -1").each(:first => true)
+      assert_equal [], data
+    end
+    
+    should 'delete, insert and find data' do
+      rollback_transaction(@client) do
+        text = 'test insert and delete'
+        @client.execute("DELETE FROM [datatypes] WHERE [varchar_50] IS NOT NULL").do
+        @client.execute("INSERT INTO [datatypes] ([varchar_50]) VALUES ('#{text}')").do
+        row = @client.execute("SELECT [varchar_50] FROM [datatypes] WHERE [varchar_50] IS NOT NULL").each.first
+        assert row
+        assert_equal text, row['varchar_50']
+      end
+    end
+    
+    should 'insert and find unicode data' do
+      rollback_transaction(@client) do
+        text = '✓'
+        @client.execute("DELETE FROM [datatypes] WHERE [nvarchar_50] IS NOT NULL").do
+        @client.execute("INSERT INTO [datatypes] ([nvarchar_50]) VALUES (N'#{text}')").do
+        row = @client.execute("SELECT [nvarchar_50] FROM [datatypes] WHERE [nvarchar_50] IS NOT NULL").each.first
+        assert_equal text, row['nvarchar_50']
+      end
+    end
+    
+    should 'delete and update with affected rows support and insert with identity support in native sql' do
+      rollback_transaction(@client) do
+        text = 'test affected rows sql'
+        @client.execute("DELETE FROM [datatypes]").do
+        afrows = @client.execute("SELECT @@ROWCOUNT AS AffectedRows").each.first['AffectedRows']
+        assert_instance_of Fixnum, afrows
+        @client.execute("INSERT INTO [datatypes] ([varchar_50]) VALUES ('#{text}')").do
+        pk1 = @client.execute("SELECT SCOPE_IDENTITY() AS Ident").each.first['Ident']
+        assert_instance_of BigDecimal, pk1, 'native is numeric(38,0) for SCOPE_IDENTITY() function'
+        pk2 = @client.execute("SELECT CAST(SCOPE_IDENTITY() AS bigint) AS Ident").each.first['Ident']
+        assert_instance_of Fixnum, pk2, 'we should be able to CAST to bigint'
+        assert_equal pk2, pk1.to_i, 'just making sure the 2 line up'
+        @client.execute("UPDATE [datatypes] SET [varchar_50] = NULL WHERE [varchar_50] = '#{text}'").do
+        afrows = @client.execute("SELECT @@ROWCOUNT AS AffectedRows").each.first['AffectedRows']
+        assert_equal 1, afrows
+      end
+    end
+    
+    should 'have a #do method that cancels result rows and returns affected rows natively' do
+      rollback_transaction(@client) do
+        text = 'test affected rows native'
+        count = @client.execute("SELECT COUNT(*) AS [count] FROM [datatypes]").each.first['count']
+        deleted_rows = @client.execute("DELETE FROM [datatypes]").do
+        assert_equal count, deleted_rows, 'should have deleted rows equal to count'
+        inserted_rows = @client.execute("INSERT INTO [datatypes] ([varchar_50]) VALUES ('#{text}')").do
+        assert_equal 1, inserted_rows, 'should have inserted row for one above'
+        updated_rows = @client.execute("UPDATE [datatypes] SET [varchar_50] = NULL WHERE [varchar_50] = '#{text}'").do
+        assert_equal 1, updated_rows, 'should have updated row for one above' unless sqlserver_2000? # Will report -1
+      end
+    end
+    
+    should 'allow native affected rows using #do to work under transaction' do
+      rollback_transaction(@client) do
+        text = 'test affected rows native in transaction'
+        @client.execute("BEGIN TRANSACTION").do
+        @client.execute("DELETE FROM [datatypes]").do
+        inserted_rows = @client.execute("INSERT INTO [datatypes] ([varchar_50]) VALUES ('#{text}')").do
+        assert_equal 1, inserted_rows, 'should have inserted row for one above'
+        updated_rows = @client.execute("UPDATE [datatypes] SET [varchar_50] = NULL WHERE [varchar_50] = '#{text}'").do
+        assert_equal 1, updated_rows, 'should have updated row for one above' unless sqlserver_2000? # Will report -1
+      end
+    end
+    
+    should 'have an #insert method that cancels result rows and returns the SCOPE_IDENTITY() natively' do
+      rollback_transaction(@client) do
+        text = 'test scope identity rows native'
+        @client.execute("DELETE FROM [datatypes] WHERE [varchar_50] = '#{text}'").do
+        @client.execute("INSERT INTO [datatypes] ([varchar_50]) VALUES ('#{text}')").do
+        sql_identity = @client.execute("SELECT CAST(SCOPE_IDENTITY() AS bigint) AS Ident").each.first['Ident']
+        native_identity = @client.execute("INSERT INTO [datatypes] ([varchar_50]) VALUES ('#{text}')").insert
+        assert_equal sql_identity+1, native_identity
+      end
+    end
+    
+    should 'be able to begin/commit transactions with raw sql' do
+      rollback_transaction(@client) do
+        @client.execute("BEGIN TRANSACTION").do
+        @client.execute("DELETE FROM [datatypes]").do
+        @client.execute("COMMIT TRANSACTION").do
+        count = @client.execute("SELECT COUNT(*) AS [count] FROM [datatypes]").each.first['count']
+        assert_equal 0, count
+      end
+    end
+    
+    should 'be able to begin/rollback transactions with raw sql' do
+      load_current_schema
+      @client.execute("BEGIN TRANSACTION").do
+      @client.execute("DELETE FROM [datatypes]").do
+      @client.execute("ROLLBACK TRANSACTION").do
+      count = @client.execute("SELECT COUNT(*) AS [count] FROM [datatypes]").each.first['count']
+      0.wont_equal count
+    end
+    
+    should 'have a #fields accessor with logic default and valid outcome' do
+      result = @client.execute(@query1)
+      result.fields.must_equal ['one']
+      result.each
+      result.fields.must_equal ['one']
+    end
+    
+    should 'always return an array for fields for all sql' do
+      result = @client.execute("USE [tinytdstest]")
+      result.fields.must_equal []
+      result.do
+      result.fields.must_equal []
+    end
+    
+    should 'return fields even when no results are found' do
+      no_results_query = "SELECT [id], [varchar_50] FROM [datatypes] WHERE [varchar_50] = 'NOTFOUND'"
+      # Fields before each.
+      result = @client.execute(no_results_query)
+      result.fields.must_equal ['id','varchar_50']
+      result.each
+      result.fields.must_equal ['id','varchar_50']
+      # Each then fields
+      result = @client.execute(no_results_query)
+      result.each
+      result.fields.must_equal ['id','varchar_50']
+    end
+    
+    should 'allow the result to be canceled before reading' do
+      result = @client.execute(@query1)
+      result.cancel
+      @client.execute(@query1).each
+    end
+    
+    should 'work in tandem with the client when needing to find out if client has sql sent and result is canceled or not' do
+      # Default state.
+      @client = TinyTds::Client.new(connection_options)
+      @client.sqlsent?.must_equal false
+      @client.canceled?.must_equal false
+      # With active result before and after cancel. 
+      result = @client.execute(@query1)
+      @client.sqlsent?.must_equal true
+      @client.canceled?.must_equal false
+      result.cancel
+      @client.sqlsent?.must_equal false
+      @client.canceled?.must_equal true
+      assert result.cancel, 'must be safe to call again'
+      # With each and no block.
+      @client.execute(@query1).each
+      @client.sqlsent?.must_equal false
+      @client.canceled?.must_equal false
+      # With each and block.
+      @client.execute(@query1).each do |row|
+        @client.sqlsent?.must_equal true, 'when iterating over each row in a block'
+        @client.canceled?.must_equal false
+      end
+      @client.sqlsent?.must_equal false
+      @client.canceled?.must_equal false
+      # With each and block canceled half way thru.
+      count = @client.execute("SELECT COUNT([id]) AS [count] FROM [datatypes]").each[0]['count']
+      assert count > 10, 'since we want to cancel early for test'
+      result = @client.execute("SELECT [id] FROM [datatypes]")
+      index = 0
+      result.each do |row| 
+        break if index > 10
+        index += 1
+      end
+      @client.sqlsent?.must_equal true
+      @client.canceled?.must_equal false
+      result.cancel
+      @client.sqlsent?.must_equal false
+      @client.canceled?.must_equal true
+      # With do method.
+      @client.execute(@query1).do
+      @client.sqlsent?.must_equal false
+      @client.canceled?.must_equal true
+      # With insert method.
+      rollback_transaction(@client) do
+        @client.execute("INSERT INTO [datatypes] ([varchar_50]) VALUES ('test')").insert
+        @client.sqlsent?.must_equal false
+        @client.canceled?.must_equal true
+      end
+      # With first
+      @client.execute("SELECT [id] FROM [datatypes]").each(:first => true)
+      @client.sqlsent?.must_equal false
+      @client.canceled?.must_equal true
+    end
+    
+    should 'use same string object for hash keys' do
+      data = @client.execute("SELECT [id], [bigint] FROM [datatypes]").each
+      assert_equal data.first.keys.map{ |r| r.object_id }, data.last.keys.map{ |r| r.object_id }
+    end
+    
+    should 'have properly encoded column names' do
+      col_name = "öäüß"
+      @client.execute("DROP TABLE [test_encoding]").do rescue nil
+      @client.execute("CREATE TABLE [dbo].[test_encoding] ( [#{col_name}] [nvarchar](10) NOT NULL )").do
+      @client.execute("INSERT INTO [test_encoding] ([#{col_name}]) VALUES (N'#{col_name}')").do
+      result = @client.execute("SELECT [#{col_name}] FROM [test_encoding]")
+      row = result.each.first
+      assert_equal col_name, result.fields.first
+      assert_equal col_name, row.keys.first
+      assert_utf8_encoding result.fields.first
+      assert_utf8_encoding row.keys.first
+    end unless sqlserver_azure?
+    
+    should 'allow #return_code to work with stored procedures and reset per sql batch' do
+      assert_nil @client.return_code
+      result = @client.execute("EXEC tinytds_TestReturnCodes")
+      assert_equal [{"one"=>1}], result.each
+      assert_equal 420, @client.return_code
+      assert_equal 420, result.return_code
+      result = @client.execute('SELECT 1 as [one]')
+      result.each
+      assert_nil @client.return_code
+      assert_nil result.return_code
+    end
+    
+    context 'with multiple result sets' do
+      
+      setup do
+        @double_select = "SELECT 1 AS [rs1]\nSELECT 2 AS [rs2]" 
+      end
+      
+      should 'handle a command buffer with double selects' do
+        result = @client.execute(@double_select)
+        result_sets = result.each
+        assert_equal 2, result_sets.size
+        assert_equal [{'rs1' => 1}], result_sets.first
+        assert_equal [{'rs2' => 2}], result_sets.last
+        assert_equal [['rs1'],['rs2']], result.fields
+        assert_equal result.each.object_id, result.each.object_id, 'same cached rows'
+        # As array
+        result = @client.execute(@double_select)
+        result_sets = result.each(:as => :array)
+        assert_equal 2, result_sets.size
+        assert_equal [[1]], result_sets.first
+        assert_equal [[2]], result_sets.last
+        assert_equal [['rs1'],['rs2']], result.fields
+        assert_equal result.each.object_id, result.each.object_id, 'same cached rows'
+      end
+      
+      should 'yield each row for each result set' do
+        data = []
+        result_sets = @client.execute(@double_select).each { |row| data << row }
+        assert_equal data.first, result_sets.first[0]
+        assert_equal data.last, result_sets.last[0]
+      end
+      
+      should 'from a stored procedure' do
+        results1, results2 = @client.execute("EXEC sp_helpconstraint '[datatypes]'").each
+        assert_equal [{"Object Name"=>"[datatypes]"}], results1
+        constraint_info = results2.first
+        assert constraint_info.key?("constraint_keys")
+        assert constraint_info.key?("constraint_type")
+        assert constraint_info.key?("constraint_name")
+      end
+      
+      should 'ignore empty result sets' do
+        rollback_transaction(@client) do
+          @client.execute("DELETE FROM [datatypes]").do
+          id = @client.execute("INSERT INTO [datatypes] ([varchar_50]) VALUES ('test empty result sets')").insert
+          sql = %|
+            SET NOCOUNT ON
+            DECLARE @row_number TABLE (row int identity(1,1), id int) 
+            INSERT INTO @row_number (id) 
+              SELECT [datatypes].[id] FROM [datatypes]
+            SET NOCOUNT OFF 
+            SELECT id FROM @row_number|
+          result = @client.execute(sql)
+          result.each.must_equal [{"id"=>id}]
+          result.fields.must_equal ['id']
+        end
+      end
+    
+    end
+    
+    context 'when casting to native ruby values' do
+    
+      should 'return fixnum for 1' do
+        value = @client.execute('SELECT 1 AS [fixnum]').each.first['fixnum']
+        assert_equal 1, value
+      end
+      
+      should 'return nil for NULL' do
+        value = @client.execute('SELECT NULL AS [null]').each.first['null']
+        assert_equal nil, value
+      end
+    
+    end
+    
+    context 'when shit happens' do
+      
+      should 'cope with nil or empty buffer' do
+        assert_raises(TypeError) { @client.execute(nil) } 
+        assert_equal [], @client.execute('').each
+      end
+      
+      should 'throw an error when you execute another query with other results pending' do
+        result1 = @client.execute(@query1)
+        action = lambda { @client.execute(@query1) }
+        assert_raise_tinytds_error(action) do |e|
+          assert_match %r|with results pending|i, e.message
+          assert_equal 7, e.severity
+          assert_equal 20019, e.db_error_number
+        end
+      end
+    
+      should 'error gracefully with bad table name' do
+        action = lambda { @client.execute('SELECT * FROM [foobar]').each }
+        assert_raise_tinytds_error(action) do |e|
+          assert_match %r|invalid object name.*foobar|i, e.message
+          assert_equal 16, e.severity
+          assert_equal 208, e.db_error_number
+        end
+        assert_followup_query
+      end
+      
+      should 'error gracefully with invalid syntax' do
+        action = lambda { @client.execute('this will not work').each }
+        assert_raise_tinytds_error(action) do |e|
+          assert_match %r|incorrect syntax|i, e.message
+          assert_equal 15, e.severity
+          assert_equal 156, e.db_error_number
+        end
+        assert_followup_query
+      end
+    
+    end
+
+  end
+  
+  
+  protected
+  
+  def assert_followup_query
+    result = @client.execute(@query1)
+    assert_equal 1, result.each.first['one']
+  end
+  
+end
+