click_house-client 0.7.0 → 0.7.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c9934204626e5719062113ca9663b762a387b91112a39bfe78aa6ac92f5741d6
-  data.tar.gz: 574ea9046e7cd316802871c6dc86152022092b4d0bea14c1d10943dec3cf6748
+  metadata.gz: 321e868b4cca95b643f90153b5ae1912f1960b13f5dafda79aea4056e130edc8
+  data.tar.gz: c89e9e47c42a8550d6a7e899a7c30a6807ca7c8119f66cbb573a9cfc082ab175
 SHA512:
-  metadata.gz: 8ace70ea9c9575040206ac917acb386b95bb206d79a4e270f558b2b189ed5a11add58fd79e8b821538d6042ebd9d189a7552472b1036bd4191705a5d8504788e
-  data.tar.gz: 2b962b32106e75a1ed3384703907558de78d97356a88d9903cc3b427a43c4158415a28810fd10d7d28ad0fa9c2999421c7a7b7d925e7b3cb5cc1a50e3ad418b9
+  metadata.gz: 54aecdd0475745b881b40074122a06cee33f4d6d7dcb2c38c2622dfc484ffaa364bc57260ce8858277d524c62b62ce83dd3ea19711ff1f94c5df5852ef57b1c0
+  data.tar.gz: 3416500a2e4b09074e421c99f363323d79af92fbc6a14e015f52c5ae0eb5a4dd86142bc3a913eef3879a5f12255f9e0435a556b3f5a9375bf6b2b1eca9a8d392

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    click_house-client (0.7.0)
+    click_house-client (0.7.1)
       activerecord (>= 7.0, < 9.0)
       activesupport (>= 7.0, < 9.0)
       addressable (~> 2.8)
@@ -136,7 +136,7 @@ CHECKSUMS
   benchmark (0.4.1) sha256=d4ef40037bba27f03b28013e219b950b82bace296549ec15a78016552f8d2cce
   bigdecimal (3.2.2) sha256=39085f76b495eb39a79ce07af716f3a6829bc35eb44f2195e2753749f2fa5adc
   byebug (12.0.0) sha256=d4a150d291cca40b66ec9ca31f754e93fed8aa266a17335f71bb0afa7fca1a1e
-  click_house-client (0.7.0)
+  click_house-client (0.7.1)
   concurrent-ruby (1.3.5) sha256=813b3e37aca6df2a21a3b9f1d497f8cbab24a2b94cab325bffe65ee0f6cbebc6
   connection_pool (2.5.3) sha256=cfd74a82b9b094d1ce30c4f1a346da23ee19dc8a062a16a85f58eab1ced4305b
   diff-lcs (1.5.0) sha256=49b934001c8c6aedb37ba19daec5c634da27b318a7a3c654ae979d6ba1929b67

data/README.md

@@ -61,6 +61,184 @@ puts ClickHouse::Client.execute('CREATE TABLE IF NOT EXISTS t1 (id Int64) ENGINE
 puts ClickHouse::Client.execute('DROP TABLE IF EXISTS t1', :main)
 ```
 
+## ClickHouse::Client::QueryBuilder
+
+The QueryBuilder provides an ActiveRecord-like interface for constructing ClickHouse queries programmatically. While similar to ActiveRecord's query interface, it has been tailored specifically for ClickHouse's SQL dialect and features.
+
+### Basic Usage
+
+```ruby
+# Initialize a query builder for a table
+query = ClickHouse::Client::QueryBuilder.new('users')
+
+# Build and execute queries
+query.select(:id, :name).where(active: true).to_sql
+# => "SELECT `users`.`id`, `users`.`name` FROM `users` WHERE `users`.`active` = 'true'"
+```
+
+### WHERE Clause
+
+The `where` method supports various types of conditions:
+
+#### Simple Equality Conditions
+
+```ruby
+query.where(status: 'active').to_sql
+# => "SELECT * FROM `users` WHERE `users`.`status` = 'active'"
+
+# Multiple conditions (joined with AND)
+query.where(status: 'active', role: 'admin').to_sql
+# => "SELECT * FROM `users` WHERE `users`.`status` = 'active' AND `users`.`role` = 'admin'"
+```
+
+#### Array Conditions (IN clause)
+
+```ruby
+query.where(id: [1, 2, 3]).to_sql
+# => "SELECT * FROM `users` WHERE `users`.`id` IN (1, 2, 3)"
+```
+
+#### Using Arel Nodes for Complex Conditions
+
+```ruby
+# Greater than
+query.where(query.table[:age].gt(18)).to_sql
+# => "SELECT * FROM `users` WHERE `users`.`age` > 18"
+
+# Less than
+query.where(query.table[:price].lt(100)).to_sql
+# => "SELECT * FROM `users` WHERE `users`.`price` < 100"
+
+# Between
+query.where(query.table[:created_at].between(Date.yesterday..Date.today)).to_sql
+# => "SELECT * FROM `users` WHERE `users`.`created_at` BETWEEN '2025-09-10' AND '2025-09-11'"
+
+# Combining conditions with AND
+condition = query.table[:age].gt(18).and(query.table[:status].eq('active'))
+query.where(condition).to_sql
+# => "SELECT * FROM `users` WHERE `users`.`age` > 18 AND `users`.`status` = 'active'"
+
+# Combining conditions with OR
+condition = query.table[:role].eq('admin').or(query.table[:role].eq('moderator'))
+query.where(condition).to_sql
+# => "SELECT * FROM `users` WHERE (`users`.`role` = 'admin' OR `users`.`role` = 'moderator')"
+
+# List of supported node types in where clause
+puts ClickHouse::Client::QueryBuilder::VALID_NODES
+```
+
+#### Pattern Matching with LIKE/ILIKE
+
+```ruby
+# Case-insensitive pattern matching (ILIKE - default)
+query.where(query.table[:email].matches('%@example.com')).to_sql
+# => "SELECT * FROM `users` WHERE `users`.`email` ILIKE '%@example.com'"
+
+# Case-sensitive pattern matching (LIKE)
+query.where(query.table[:name].matches('John%', nil, true)).to_sql
+# => "SELECT * FROM `users` WHERE `users`.`name` LIKE 'John%'"
+
+# Negative pattern matching (NOT ILIKE)
+query.where(query.table[:email].does_not_match('%@spam.com')).to_sql
+# => "SELECT * FROM `users` WHERE `users`.`email` NOT ILIKE '%@spam.com'"
+```
+
+#### Subqueries
+
+```ruby
+# Using a subquery in WHERE clause
+subquery = ClickHouse::Client::QueryBuilder.new('orders')
+  .select(:user_id)
+  .where(status: 'completed')
+
+query.where(id: subquery).to_sql
+# => "SELECT * FROM `users` WHERE `users`.`id` IN (SELECT `orders`.`user_id` FROM `orders` WHERE `orders`.`status` = 'completed')"
+```
+
+### HAVING Clause
+
+The `having` method works similarly to `where` but is used for filtering aggregated results:
+
+```ruby
+# Using COUNT(*) in HAVING clause
+count_func = Arel::Nodes::NamedFunction.new('COUNT', [Arel.star])
+query.group(:department).having(count_func.gt(10)).to_sql
+# => "SELECT * FROM `users` GROUP BY `users`.`department` HAVING COUNT(*) > 10"
+
+# Using other aggregation functions
+sum_func = Arel::Nodes::NamedFunction.new('SUM', [query.table[:salary]])
+query.group(:department).having(sum_func.gt(100000)).to_sql
+# => "SELECT * FROM `users` GROUP BY `users`.`department` HAVING SUM(`users`.`salary`) > 100000"
+```
+
+#### Combining WHERE and HAVING
+
+```ruby
+query
+  .where(active: true)
+  .group(:department)
+  .having(query.table[:avg_salary].gt(50000))
+  .to_sql
+# => "SELECT * FROM `users` WHERE `users`.`active` = 'true' GROUP BY `users`.`department` HAVING `users`.`avg_salary` > 50000"
+```
+
+### Working with JOINs
+
+When using JOINs, you can apply conditions to joined tables: _(Supports only `INNER JOIN`)_
+
+```ruby
+# Join with conditions on joined table
+query
+  .joins('orders', { 'id' => 'user_id' })
+  .where(orders: { status: 'pending' })
+  .to_sql
+# => "SELECT * FROM `users` INNER JOIN `orders` ON `users`.`id` = `orders`.`user_id` WHERE `orders`.`status` = 'pending'"
+
+# HAVING clause with joined tables
+query
+  .joins('orders', { 'id' => 'user_id' })
+  .group(:department)
+  .having(orders: { total: [100, 200, 300] })
+  .to_sql
+# => "SELECT * FROM `users` INNER JOIN `orders` ON `users`.`id` = `orders`.`user_id` GROUP BY `users`.`department` HAVING `orders`.`total` IN (100, 200, 300)"
+```
+
+### Complete Example
+
+Here's a comprehensive example combining multiple QueryBuilder features:
+
+```ruby
+# Find active users in specific departments who have completed orders
+# Group by department and filter groups with more than 5 users
+
+completed_orders = ClickHouse::Client::QueryBuilder.new('orders')
+  .select(:user_id)
+  .where(status: 'completed')
+  .where(query.table[:created_at].gt(Date.today - 30))
+
+count_func = Arel::Nodes::NamedFunction.new('COUNT', [Arel.star])
+
+result = ClickHouse::Client::QueryBuilder.new('users')
+  .select(:department, count_func.as('user_count'))
+  .where(active: true)
+  .where(department: ['Sales', 'Marketing', 'Engineering'])
+  .where(id: completed_orders)
+  .where(query.table[:email].matches('%@company.com'))
+  .group(:department)
+  .having(count_func.gt(5))
+  .order(Arel.sql('user_count'), :desc)
+  .limit(10)
+
+puts result.to_sql
+"SELECT `users`.`department`, COUNT(*) AS user_count FROM `users` WHERE `users`.`active` = 'true' 
+AND `users`.`department` IN ('Sales', 'Marketing', 'Engineering') 
+AND `users`.`id` IN (SELECT `orders`.`user_id` FROM `orders` WHERE `orders`.`status` = 'completed' 
+AND `users`.`created_at` > '2025-08-12') 
+AND `users`.`email` ILIKE '%@company.com' 
+GROUP BY department HAVING COUNT(*) AS user_count > 5 
+ORDER BY user_count DESC LIMIT 10"
+```
+
 ## License
 
 The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/lib/click_house/client/version.rb

@@ -2,6 +2,6 @@
 
 module ClickHouse
   module Client
-    VERSION = "0.7.0"
+    VERSION = "0.7.1"
   end
 end

data/lib/click_house/client.rb

@@ -77,7 +77,6 @@ module ClickHouse
 
       headers = db.headers.merge(
         'Transfer-Encoding' => 'chunked',
-        'Content-Length' => File.size(io).to_s,
         'Content-Encoding' => 'gzip'
       )
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: click_house-client
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.7.1
 platform: ruby
 authors:
 - group::optimize
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-09-09 00:00:00.000000000 Z
+date: 2025-09-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activerecord