duckdb 0.9.0 → 0.9.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f7738df010c1fb1aab32b61077ff9409566cfaddecfef3b27aa6e7ee7a8651f2
-  data.tar.gz: 6357f43da56b7c4fbea72ec7b3c549f598f3a91b88c1c91ab5320a01606f3589
+  metadata.gz: aac4fbdeca8ed41cef872ace9dd3c8784ce43ee224a733f469fcd0907e852cd5
+  data.tar.gz: 56c8a5831830264fd4dfac41ba7a60bb9e6493a40536a5502c10dc0fc41b16d7
 SHA512:
-  metadata.gz: e417badc1b301fdea9f3f4b27648e7e1c7d8e125a0a1323bb69e93a992467eca0a57a320b0bb14f7fda45bf8d9d3706b59eb586a71e3c9f77bd2ec18c88b8b3a
-  data.tar.gz: b1486d0d525fa93a8485504eac95015a07ac064a4dfb15bb0689aa7be4cb41edcf03436324e822bda26a8c3c6e8a9e2a690efcd49f7180f675777f75284df5e8
+  metadata.gz: b94ffce97a54769bae379a3b13765b2132df1efe80fdb8f4855f77248855e95e9370651dbbe165a64c6ee45aff5bef20b3800a680f3da5287528974a243af338
+  data.tar.gz: 96accf18b7f4df7721efaec8e215e92dcbe97d22a99d89ffb64658f4696eb462b8ceaa27a3e558cba8ef5a7ce257fc4e3b35f83178fadf8047e19280563e7ae6

data/.github/workflows/test_on_macos.yml

@@ -15,7 +15,7 @@ jobs:
     runs-on: macos-latest
     strategy:
       matrix:
-        ruby: ['2.7.8', '3.0.6', '3.1.4', '3.2.2', '3.3.0-preview1', 'head']
+        ruby: ['2.7.8', '3.0.6', '3.1.4', '3.2.2', '3.3.0-preview2', 'head']
         duckdb: ['0.9.0', '0.8.1']
 
     steps:

data/.github/workflows/test_on_ubuntu.yml

@@ -15,7 +15,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        ruby: ['2.7.8', '3.0.6', '3.1.4', '3.2.2', '3.3.0-preview1', 'head']
+        ruby: ['2.7.8', '3.0.6', '3.1.4', '3.2.2', '3.3.0-preview2', 'head']
         duckdb: ['0.9.0', '0.8.1']
 
     steps:

data/CHANGELOG.md

@@ -1,5 +1,10 @@
 # ChangeLog
 
+# 0.9.0.1
+
+- add `DuckDB::PreparedStatement#bind_parameter_index`.
+- DuckDB::Connection#query accepts SQL with named bind parameters.
+
 # 0.9.0
 - bump duckdb to 0.9.0.
 

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    duckdb (0.9.0)
+    duckdb (0.9.0.1)
 
 GEM
   remote: https://rubygems.org/

data/README.md

@@ -94,6 +94,17 @@ DuckDB::Database.open do |db|
 end
 ```
 
+### using bind variables
+
+You can use bind variables.
+
+```ruby
+con.query('SELECT * FROM users WHERE name = ? AND email = ?', 'Alice', 'alice@example.com')
+# or
+con.query('SELECT * FROM users WHERE name = $name AND email = $email', name: 'Alice', email: 'alice@example.com')
+```
+
+
 ### using BLOB column
 
 BLOB is available with DuckDB v0.2.5 or later.

data/ext/duckdb/prepared_statement.c

@@ -9,6 +9,11 @@ static VALUE duckdb_prepared_statement_initialize(VALUE self, VALUE con, VALUE q
 static VALUE duckdb_prepared_statement_nparams(VALUE self);
 static VALUE duckdb_prepared_statement_execute(VALUE self);
 static idx_t check_index(VALUE vidx);
+
+#ifdef HAVE_DUCKDB_H_GE_V090
+static VALUE duckdb_prepared_statement_bind_parameter_index(VALUE self, VALUE name);
+#endif
+
 static VALUE duckdb_prepared_statement_bind_bool(VALUE self, VALUE vidx, VALUE val);
 static VALUE duckdb_prepared_statement_bind_int8(VALUE self, VALUE vidx, VALUE val);
 static VALUE duckdb_prepared_statement_bind_int16(VALUE self, VALUE vidx, VALUE val);
@@ -93,6 +98,20 @@ static idx_t check_index(VALUE vidx) {
     return idx;
 }
 
+#ifdef HAVE_DUCKDB_H_GE_V090
+static VALUE duckdb_prepared_statement_bind_parameter_index(VALUE self, VALUE name) {
+    rubyDuckDBPreparedStatement *ctx;
+    idx_t idx;
+
+    TypedData_Get_Struct(self, rubyDuckDBPreparedStatement, &prepared_statement_data_type, ctx);
+
+    if (duckdb_bind_parameter_index(ctx->prepared_statement, &idx, StringValuePtr(name)) == DuckDBError) {;
+        rb_raise(rb_eArgError, "parameter '%s' not found", StringValuePtr(name));
+    }
+    return ULL2NUM(idx);
+}
+#endif
+
 static VALUE duckdb_prepared_statement_bind_bool(VALUE self, VALUE vidx, VALUE val) {
     rubyDuckDBPreparedStatement *ctx;
     idx_t idx = check_index(vidx);
@@ -308,6 +327,11 @@ void init_duckdb_prepared_statement(void) {
     rb_define_method(cDuckDBPreparedStatement, "initialize", duckdb_prepared_statement_initialize, 2);
     rb_define_method(cDuckDBPreparedStatement, "execute", duckdb_prepared_statement_execute, 0);
     rb_define_method(cDuckDBPreparedStatement, "nparams", duckdb_prepared_statement_nparams, 0);
+
+#ifdef HAVE_DUCKDB_H_GE_V090
+    rb_define_method(cDuckDBPreparedStatement, "bind_parameter_index", duckdb_prepared_statement_bind_parameter_index, 1);
+#endif
+
     rb_define_method(cDuckDBPreparedStatement, "bind_bool", duckdb_prepared_statement_bind_bool, 2);
     rb_define_method(cDuckDBPreparedStatement, "bind_int8", duckdb_prepared_statement_bind_int8, 2);
     rb_define_method(cDuckDBPreparedStatement, "bind_int16", duckdb_prepared_statement_bind_int16, 2);

data/lib/duckdb/connection.rb

@@ -12,7 +12,6 @@ module DuckDB
     # executes sql with args.
     # The first argument sql must be SQL string.
     # The rest arguments are parameters of SQL string.
-    # The parameters must be '?' in SQL statement.
     #
     #   require 'duckdb'
     #   db = DuckDB::Database.open('duckdb_file')
@@ -21,12 +20,20 @@ module DuckDB
     #   sql = 'SELECT * FROM users WHERE name = ? AND email = ?'
     #   dave = con.query(sql, 'Dave', 'dave@example.com')
     #
-    def query(sql, *args)
-      return query_sql(sql) if args.empty?
+    #   # or You can use named parameter.
+    #
+    #   sql = 'SELECT * FROM users WHERE name = $name AND email = $email'
+    #   dave = con.query(sql, name: 'Dave', email: 'dave@example.com')
+    #
+    def query(sql, *args, **hash)
+      return query_sql(sql) if args.empty? && hash.empty?
 
       stmt = PreparedStatement.new(self, sql)
-      args.each_with_index do |arg, i|
-        stmt.bind(i + 1, arg)
+      args.each.with_index(1) do |arg, i|
+        stmt.bind(i, arg)
+      end
+      hash.each do |key, value|
+        stmt.bind(key, value)
       end
       stmt.execute
     end

data/lib/duckdb/prepared_statement.rb

@@ -1,6 +1,6 @@
 require 'date'
 require 'bigdecimal'
-require_relative './converter'
+require_relative 'converter'
 
 module DuckDB
   # The DuckDB::PreparedStatement encapsulates connection with DuckDB prepared
@@ -167,35 +167,55 @@ module DuckDB
     #   sql ='SELECT name, email FROM users WHERE email = ?'
     #   stmt = PreparedStatement.new(con, sql)
     #   stmt.bind(1, 'email@example.com')
-    def bind(i, value)
+    def bind(index, value)
+      case index
+      when Integer
+        bind_with_index(index, value)
+      when String
+        bind_with_name(index, value)
+      when Symbol
+        bind_with_name(index.to_s, value)
+      else
+        raise(ArgumentError, "1st argument `#{index}` must be Integer or String or Symbol.")
+      end
+    end
+
+    private
+
+    def bind_with_index(index, value)
       case value
       when NilClass
-        bind_null(i)
+        bind_null(index)
       when Float
-        bind_double(i, value)
+        bind_double(index, value)
       when Integer
         case value
         when RANGE_INT64
-          bind_int64(i, value)
+          bind_int64(index, value)
         else
-          bind_varchar(i, value.to_s)
+          bind_varchar(index, value.to_s)
         end
       when String
-        blob?(value) ? bind_blob(i, value) : bind_varchar(i, value)
+        blob?(value) ? bind_blob(index, value) : bind_varchar(index, value)
       when TrueClass, FalseClass
-        bind_bool(i, value)
+        bind_bool(index, value)
       when Time
-        bind_varchar(i, value.strftime('%Y-%m-%d %H:%M:%S.%N'))
+        bind_varchar(index, value.strftime('%Y-%m-%d %H:%M:%S.%N'))
       when Date
-        bind_varchar(i, value.strftime('%Y-%m-%d'))
+        bind_varchar(index, value.strftime('%Y-%m-%d'))
       when BigDecimal
-        bind_varchar(i, value.to_s('F'))
+        bind_varchar(index, value.to_s('F'))
       else
         raise(DuckDB::Error, "not supported type `#{value}` (#{value.class})")
       end
     end
 
-    private
+    def bind_with_name(name, value)
+      raise DuckDB::Error, 'not supported binding with name' unless respond_to?(:bind_parameter_index)
+
+      i = bind_parameter_index(name)
+      bind_with_index(i, value)
+    end
 
     def blob?(value)
       value.instance_of?(DuckDB::Blob) || value.encoding == Encoding::BINARY

data/lib/duckdb/version.rb

@@ -3,5 +3,5 @@
 module DuckDB
   # The version string of ruby-duckdb.
   # Currently, ruby-duckdb is NOT semantic versioning.
-  VERSION = '0.9.0'
+  VERSION = '0.9.0.1'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: duckdb
 version: !ruby/object:Gem::Version
-  version: 0.9.0
+  version: 0.9.0.1
 platform: ruby
 authors:
 - Masaki Suketa
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-09-29 00:00:00.000000000 Z
+date: 2023-10-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler