rails-paradedb 0.5.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 04a77503859e70b3362f1a5679a2d1b229c62c5c49a0383fbe1164b317d902f2
-  data.tar.gz: 1ec3bc0ae18c1232ddfc1b67aec6eb3a92dde0285297fa4a45afa7b789ae9d7c
+  metadata.gz: 1bcba07642cf33fe747ed6f810374adee776ee014533e64f5b38d490335dd672
+  data.tar.gz: a470ac63132444ae93ee893eee869d6dac4641774fe965f6519592a7e5c50d35
 SHA512:
-  metadata.gz: e81872356be536dd22423f39c7c8a899630dd5a601d5c54c6a8cbfc2c165ba3aa1c8edbe016a88ff9bc3492fcb0925c35cf31055dbca39de59f05f1b49ce2cec
-  data.tar.gz: 0c3781ba0d93f5aa4067545354f87e186da71c43fab1a257c9715ce821dfde474549c200d22f9814f75747a687a7e21626148de2b474759bc9317395f413902f
+  metadata.gz: aa7193be8a40ed3714b3d17cf1c1b53980b63245a70c878e6aaa164c272df072217eb9c71a808cc29c0dc2611056f7d323f3d6aa9e507b77648beea83a734b6e
+  data.tar.gz: 6870426a910699fd8b1b12f7a03402d8157138d2b2aa4c210339356a2ff60299b29301a1a5cc28f64656f4e80479719e0324270dd0f5a9f7668e09ee9654a262

data/CHANGELOG.md

@@ -4,6 +4,12 @@ All notable changes to this project will be documented in this file. The format
 
 ## [Unreleased]
 
+## [0.6.0] - 2026-04-14
+
+### Added
+
+- Support concurrent BM25 index creation via `concurrently:` in `create_paradedb_index` and `add_bm25_index`
+
 ## [0.5.0] - 2026-04-14
 
 ### Added
@@ -120,7 +126,8 @@ All notable changes to this project will be documented in this file. The format
 - Schema dump/load round-trip for tokenizer configuration and index options
   (including `target_segment_count`)
 
-[Unreleased]: https://github.com/paradedb/rails-paradedb/compare/v0.5.0...HEAD
+[Unreleased]: https://github.com/paradedb/rails-paradedb/compare/v0.6.0...HEAD
+[0.6.0]: https://github.com/paradedb/rails-paradedb/releases/tag/v0.6.0
 [0.5.0]: https://github.com/paradedb/rails-paradedb/releases/tag/v0.5.0
 [0.4.0]: https://github.com/paradedb/rails-paradedb/releases/tag/v0.4.0
 [0.3.0]: https://github.com/paradedb/rails-paradedb/releases/tag/v0.3.0

data/lib/generators/parade_db/index/templates/migration.rb.tt

@@ -6,7 +6,7 @@ class <%= migration_class_name %> < ActiveRecord::Migration[<%= ActiveRecord::Mi
 
 <% end -%>
   def up
-    create_paradedb_index(<%= class_name %>Index, if_not_exists: true)
+    create_paradedb_index(<%= class_name %>Index, if_not_exists: true<% if options[:concurrent] %>, concurrently: true<% end %>)
   end
 
   def down

data/lib/parade_db/migration_helpers.rb

@@ -4,11 +4,15 @@ require_relative "tokenizer_sql"
 
 module ParadeDB
   module MigrationHelpers
-    def create_paradedb_index(index_klass, if_not_exists: false)
+    def create_paradedb_index(index_klass, if_not_exists: false, concurrently: false)
       ensure_postgresql_adapter!
+      if concurrently && transaction_open_for_paradedb?
+        raise ArgumentError, "create_paradedb_index concurrently: true cannot run inside a transaction"
+      end
+
       resolved = resolve_index_klass(index_klass)
       compiled = resolved.compiled_definition
-      execute(build_create_sql(compiled, if_not_exists: if_not_exists))
+      execute(build_create_sql(compiled, if_not_exists: if_not_exists, concurrently: concurrently))
       remember_schema_index_reference(resolved)
     end
 
@@ -21,7 +25,7 @@ module ParadeDB
       remember_schema_index_reference(resolved)
     end
 
-    def add_bm25_index(table, fields:, key_field:, name: nil, index_options: nil, where: nil, if_not_exists: false)
+    def add_bm25_index(table, fields:, key_field:, name: nil, index_options: nil, where: nil, if_not_exists: false, concurrently: false)
       ensure_postgresql_adapter!
       anonymous = Class.new(ParadeDB::Index)
       anonymous.table_name = table
@@ -31,7 +35,7 @@ module ParadeDB
       anonymous.index_options = index_options unless index_options.nil?
       anonymous.where = where unless where.nil?
 
-      create_paradedb_index(anonymous, if_not_exists: if_not_exists)
+      create_paradedb_index(anonymous, if_not_exists: if_not_exists, concurrently: concurrently)
     end
 
     def remove_bm25_index(table, name: nil, if_exists: false)
@@ -77,14 +81,15 @@ module ParadeDB
       ParadeDB.ensure_postgresql_adapter!(self, context: "ParadeDB migration helper")
     end
 
-    def build_create_sql(compiled, if_not_exists:)
+    def build_create_sql(compiled, if_not_exists:, concurrently: false)
+      modifier = concurrently ? " CONCURRENTLY" : ""
       prefix = if_not_exists ? "IF NOT EXISTS " : ""
       fields_sql = compiled.entries.map { |entry| bm25_entry_sql(entry) }.join(", ")
       with_options_sql = bm25_with_options_sql(compiled)
       where_sql = compiled.where ? "\nWHERE #{compiled.where}" : ""
 
       <<~SQL.strip.gsub(/\s+/, " ")
-        CREATE INDEX #{prefix}#{quote_table_name(compiled.index_name)} ON #{quote_table_name(compiled.table_name)}
+        CREATE INDEX#{modifier} #{prefix}#{quote_table_name(compiled.index_name)} ON #{quote_table_name(compiled.table_name)}
         USING bm25 (#{fields_sql})
         WITH (#{with_options_sql})#{where_sql}
       SQL
@@ -846,15 +851,15 @@ end
 if defined?(ActiveRecord::Migration)
   module ParadeDB
     module MigrationDSL
-      def create_paradedb_index(index_klass, if_not_exists: false)
-        connection.create_paradedb_index(index_klass, if_not_exists: if_not_exists)
+      def create_paradedb_index(index_klass, if_not_exists: false, concurrently: false)
+        connection.create_paradedb_index(index_klass, if_not_exists: if_not_exists, concurrently: concurrently)
       end
 
       def replace_paradedb_index(index_klass)
         connection.replace_paradedb_index(index_klass)
       end
 
-      def add_bm25_index(table, fields:, key_field:, name: nil, index_options: nil, where: nil, if_not_exists: false)
+      def add_bm25_index(table, fields:, key_field:, name: nil, index_options: nil, where: nil, if_not_exists: false, concurrently: false)
         connection.add_bm25_index(
           table,
           fields: fields,
@@ -862,7 +867,8 @@ if defined?(ActiveRecord::Migration)
           name: name,
           index_options: index_options,
           where: where,
-          if_not_exists: if_not_exists
+          if_not_exists: if_not_exists,
+          concurrently: concurrently
         )
       end
 

data/lib/parade_db/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ParadeDB
-  VERSION = "0.5.0"
+  VERSION = "0.6.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rails-paradedb
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.6.0
 platform: ruby
 authors:
 - ParadeDB