activerecord 7.2.3 → 8.0.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/CHANGELOG.md +391 -958
- data/README.rdoc +1 -1
- data/lib/active_record/association_relation.rb +1 -0
- data/lib/active_record/associations/association.rb +34 -10
- data/lib/active_record/associations/builder/association.rb +7 -6
- data/lib/active_record/associations/collection_association.rb +1 -1
- data/lib/active_record/associations/disable_joins_association_scope.rb +1 -1
- data/lib/active_record/associations/has_many_through_association.rb +3 -2
- data/lib/active_record/associations/preloader/association.rb +2 -2
- data/lib/active_record/associations/singular_association.rb +8 -3
- data/lib/active_record/associations.rb +34 -4
- data/lib/active_record/asynchronous_queries_tracker.rb +28 -24
- data/lib/active_record/attribute_methods/primary_key.rb +4 -8
- data/lib/active_record/attribute_methods/query.rb +34 -0
- data/lib/active_record/attribute_methods/time_zone_conversion.rb +2 -12
- data/lib/active_record/autosave_association.rb +69 -27
- data/lib/active_record/connection_adapters/abstract/connection_handler.rb +34 -25
- data/lib/active_record/connection_adapters/abstract/connection_pool/queue.rb +0 -1
- data/lib/active_record/connection_adapters/abstract/connection_pool/reaper.rb +0 -1
- data/lib/active_record/connection_adapters/abstract/connection_pool.rb +6 -15
- data/lib/active_record/connection_adapters/abstract/database_statements.rb +90 -43
- data/lib/active_record/connection_adapters/abstract/query_cache.rb +8 -2
- data/lib/active_record/connection_adapters/abstract/quoting.rb +1 -1
- data/lib/active_record/connection_adapters/abstract/schema_creation.rb +4 -5
- data/lib/active_record/connection_adapters/abstract/schema_definitions.rb +7 -2
- data/lib/active_record/connection_adapters/abstract/schema_statements.rb +34 -7
- data/lib/active_record/connection_adapters/abstract/transaction.rb +15 -5
- data/lib/active_record/connection_adapters/abstract_adapter.rb +31 -43
- data/lib/active_record/connection_adapters/abstract_mysql_adapter.rb +21 -40
- data/lib/active_record/connection_adapters/mysql/quoting.rb +0 -8
- data/lib/active_record/connection_adapters/mysql/schema_definitions.rb +2 -8
- data/lib/active_record/connection_adapters/mysql/schema_statements.rb +50 -45
- data/lib/active_record/connection_adapters/mysql2/database_statements.rb +84 -94
- data/lib/active_record/connection_adapters/mysql2_adapter.rb +1 -8
- data/lib/active_record/connection_adapters/pool_config.rb +7 -7
- data/lib/active_record/connection_adapters/postgresql/database_statements.rb +72 -43
- data/lib/active_record/connection_adapters/postgresql/oid/array.rb +1 -1
- data/lib/active_record/connection_adapters/postgresql/oid/point.rb +10 -0
- data/lib/active_record/connection_adapters/postgresql/referential_integrity.rb +2 -4
- data/lib/active_record/connection_adapters/postgresql/schema_creation.rb +1 -11
- data/lib/active_record/connection_adapters/postgresql/schema_definitions.rb +6 -12
- data/lib/active_record/connection_adapters/postgresql/schema_dumper.rb +2 -1
- data/lib/active_record/connection_adapters/postgresql/schema_statements.rb +59 -16
- data/lib/active_record/connection_adapters/postgresql_adapter.rb +46 -96
- data/lib/active_record/connection_adapters/schema_cache.rb +1 -3
- data/lib/active_record/connection_adapters/sqlite3/database_statements.rb +80 -100
- data/lib/active_record/connection_adapters/sqlite3/schema_creation.rb +0 -6
- data/lib/active_record/connection_adapters/sqlite3/schema_dumper.rb +13 -0
- data/lib/active_record/connection_adapters/sqlite3/schema_statements.rb +9 -1
- data/lib/active_record/connection_adapters/sqlite3_adapter.rb +53 -12
- data/lib/active_record/connection_adapters/statement_pool.rb +4 -2
- data/lib/active_record/connection_adapters/trilogy/database_statements.rb +37 -67
- data/lib/active_record/connection_adapters/trilogy_adapter.rb +0 -17
- data/lib/active_record/connection_adapters.rb +0 -56
- data/lib/active_record/connection_handling.rb +23 -1
- data/lib/active_record/core.rb +29 -14
- data/lib/active_record/database_configurations/database_config.rb +4 -0
- data/lib/active_record/database_configurations/hash_config.rb +16 -2
- data/lib/active_record/encryption/config.rb +3 -1
- data/lib/active_record/encryption/encryptable_record.rb +4 -4
- data/lib/active_record/encryption/encrypted_attribute_type.rb +10 -1
- data/lib/active_record/encryption/encryptor.rb +16 -8
- data/lib/active_record/encryption/extended_deterministic_queries.rb +4 -2
- data/lib/active_record/encryption/scheme.rb +8 -1
- data/lib/active_record/enum.rb +9 -22
- data/lib/active_record/errors.rb +13 -5
- data/lib/active_record/fixtures.rb +0 -2
- data/lib/active_record/future_result.rb +13 -9
- data/lib/active_record/gem_version.rb +3 -3
- data/lib/active_record/insert_all.rb +1 -1
- data/lib/active_record/locking/optimistic.rb +1 -1
- data/lib/active_record/log_subscriber.rb +5 -11
- data/lib/active_record/migration/command_recorder.rb +31 -11
- data/lib/active_record/migration/compatibility.rb +5 -2
- data/lib/active_record/migration.rb +38 -42
- data/lib/active_record/model_schema.rb +3 -4
- data/lib/active_record/nested_attributes.rb +4 -6
- data/lib/active_record/persistence.rb +128 -130
- data/lib/active_record/query_logs.rb +102 -50
- data/lib/active_record/query_logs_formatter.rb +17 -28
- data/lib/active_record/querying.rb +8 -8
- data/lib/active_record/railtie.rb +2 -26
- data/lib/active_record/railties/databases.rake +11 -35
- data/lib/active_record/reflection.rb +18 -21
- data/lib/active_record/relation/batches/batch_enumerator.rb +4 -3
- data/lib/active_record/relation/batches.rb +132 -72
- data/lib/active_record/relation/calculations.rb +40 -39
- data/lib/active_record/relation/delegation.rb +25 -14
- data/lib/active_record/relation/finder_methods.rb +18 -18
- data/lib/active_record/relation/merger.rb +8 -8
- data/lib/active_record/relation/predicate_builder/polymorphic_array_value.rb +1 -1
- data/lib/active_record/relation/predicate_builder/relation_handler.rb +4 -3
- data/lib/active_record/relation/predicate_builder.rb +13 -0
- data/lib/active_record/relation/query_methods.rb +105 -61
- data/lib/active_record/relation/spawn_methods.rb +7 -7
- data/lib/active_record/relation.rb +79 -61
- data/lib/active_record/result.rb +66 -4
- data/lib/active_record/sanitization.rb +7 -6
- data/lib/active_record/schema_dumper.rb +5 -0
- data/lib/active_record/schema_migration.rb +2 -1
- data/lib/active_record/scoping/named.rb +5 -2
- data/lib/active_record/statement_cache.rb +14 -14
- data/lib/active_record/store.rb +7 -3
- data/lib/active_record/table_metadata.rb +1 -3
- data/lib/active_record/tasks/database_tasks.rb +69 -60
- data/lib/active_record/tasks/mysql_database_tasks.rb +0 -2
- data/lib/active_record/tasks/postgresql_database_tasks.rb +2 -1
- data/lib/active_record/tasks/sqlite_database_tasks.rb +2 -2
- data/lib/active_record/test_databases.rb +1 -1
- data/lib/active_record/test_fixtures.rb +12 -0
- data/lib/active_record/token_for.rb +1 -1
- data/lib/active_record/transactions.rb +5 -6
- data/lib/active_record/validations/uniqueness.rb +8 -8
- data/lib/active_record.rb +21 -48
- data/lib/arel/collectors/bind.rb +2 -2
- data/lib/arel/collectors/sql_string.rb +1 -1
- data/lib/arel/collectors/substitute_binds.rb +2 -2
- data/lib/arel/nodes/binary.rb +1 -1
- data/lib/arel/nodes/node.rb +1 -1
- data/lib/arel/nodes/sql_literal.rb +1 -1
- data/lib/arel/table.rb +3 -7
- metadata +9 -10
- data/lib/active_record/relation/record_fetch_warning.rb +0 -52
|
@@ -5,7 +5,7 @@ require "active_record/relation/batches/batch_enumerator"
|
|
|
5
5
|
module ActiveRecord
|
|
6
6
|
# = Active Record \Batches
|
|
7
7
|
module Batches
|
|
8
|
-
ORDER_IGNORE_MESSAGE = "Scoped order is ignored,
|
|
8
|
+
ORDER_IGNORE_MESSAGE = "Scoped order is ignored, use :cursor with :order to configure custom order."
|
|
9
9
|
DEFAULT_ORDER = :asc
|
|
10
10
|
|
|
11
11
|
# Looping through a collection of records from the database
|
|
@@ -35,11 +35,13 @@ module ActiveRecord
|
|
|
35
35
|
#
|
|
36
36
|
# ==== Options
|
|
37
37
|
# * <tt>:batch_size</tt> - Specifies the size of the batch. Defaults to 1000.
|
|
38
|
-
# * <tt>:start</tt> - Specifies the
|
|
39
|
-
# * <tt>:finish</tt> - Specifies the
|
|
38
|
+
# * <tt>:start</tt> - Specifies the cursor column value to start from, inclusive of the value.
|
|
39
|
+
# * <tt>:finish</tt> - Specifies the cursor column value to end at, inclusive of the value.
|
|
40
40
|
# * <tt>:error_on_ignore</tt> - Overrides the application config to specify if an error should be raised when
|
|
41
41
|
# an order is present in the relation.
|
|
42
|
-
# * <tt>:
|
|
42
|
+
# * <tt>:cursor</tt> - Specifies the column to use for batching (can be a column name or an array
|
|
43
|
+
# of column names). Defaults to primary key.
|
|
44
|
+
# * <tt>:order</tt> - Specifies the cursor column order (can be +:asc+ or +:desc+ or an array consisting
|
|
43
45
|
# of :asc or :desc). Defaults to +:asc+.
|
|
44
46
|
#
|
|
45
47
|
# class Order < ActiveRecord::Base
|
|
@@ -71,20 +73,25 @@ module ActiveRecord
|
|
|
71
73
|
#
|
|
72
74
|
# NOTE: Order can be ascending (:asc) or descending (:desc). It is automatically set to
|
|
73
75
|
# ascending on the primary key ("id ASC").
|
|
74
|
-
# This also means that this method only works when the
|
|
76
|
+
# This also means that this method only works when the cursor column is
|
|
75
77
|
# orderable (e.g. an integer or string).
|
|
76
78
|
#
|
|
79
|
+
# NOTE: When using custom columns for batching, they should include at least one unique column
|
|
80
|
+
# (e.g. primary key) as a tiebreaker. Also, to reduce the likelihood of race conditions,
|
|
81
|
+
# all columns should be static (unchangeable after it was set).
|
|
82
|
+
#
|
|
77
83
|
# NOTE: By its nature, batch processing is subject to race conditions if
|
|
78
84
|
# other processes are modifying the database.
|
|
79
|
-
def find_each(start: nil, finish: nil, batch_size: 1000, error_on_ignore: nil, order: DEFAULT_ORDER, &block)
|
|
85
|
+
def find_each(start: nil, finish: nil, batch_size: 1000, error_on_ignore: nil, cursor: primary_key, order: DEFAULT_ORDER, &block)
|
|
80
86
|
if block_given?
|
|
81
|
-
find_in_batches(start: start, finish: finish, batch_size: batch_size, error_on_ignore: error_on_ignore, order: order) do |records|
|
|
87
|
+
find_in_batches(start: start, finish: finish, batch_size: batch_size, error_on_ignore: error_on_ignore, cursor: cursor, order: order) do |records|
|
|
82
88
|
records.each(&block)
|
|
83
89
|
end
|
|
84
90
|
else
|
|
85
|
-
enum_for(:find_each, start: start, finish: finish, batch_size: batch_size, error_on_ignore: error_on_ignore, order: order) do
|
|
91
|
+
enum_for(:find_each, start: start, finish: finish, batch_size: batch_size, error_on_ignore: error_on_ignore, cursor: cursor, order: order) do
|
|
86
92
|
relation = self
|
|
87
|
-
|
|
93
|
+
cursor = Array(cursor)
|
|
94
|
+
apply_limits(relation, cursor, start, finish, build_batch_orders(cursor, order)).size
|
|
88
95
|
end
|
|
89
96
|
end
|
|
90
97
|
end
|
|
@@ -109,11 +116,13 @@ module ActiveRecord
|
|
|
109
116
|
#
|
|
110
117
|
# ==== Options
|
|
111
118
|
# * <tt>:batch_size</tt> - Specifies the size of the batch. Defaults to 1000.
|
|
112
|
-
# * <tt>:start</tt> - Specifies the
|
|
113
|
-
# * <tt>:finish</tt> - Specifies the
|
|
119
|
+
# * <tt>:start</tt> - Specifies the cursor column value to start from, inclusive of the value.
|
|
120
|
+
# * <tt>:finish</tt> - Specifies the cursor column value to end at, inclusive of the value.
|
|
114
121
|
# * <tt>:error_on_ignore</tt> - Overrides the application config to specify if an error should be raised when
|
|
115
122
|
# an order is present in the relation.
|
|
116
|
-
# * <tt>:
|
|
123
|
+
# * <tt>:cursor</tt> - Specifies the column to use for batching (can be a column name or an array
|
|
124
|
+
# of column names). Defaults to primary key.
|
|
125
|
+
# * <tt>:order</tt> - Specifies the cursor column order (can be +:asc+ or +:desc+ or an array consisting
|
|
117
126
|
# of :asc or :desc). Defaults to +:asc+.
|
|
118
127
|
#
|
|
119
128
|
# class Order < ActiveRecord::Base
|
|
@@ -140,21 +149,26 @@ module ActiveRecord
|
|
|
140
149
|
#
|
|
141
150
|
# NOTE: Order can be ascending (:asc) or descending (:desc). It is automatically set to
|
|
142
151
|
# ascending on the primary key ("id ASC").
|
|
143
|
-
# This also means that this method only works when the
|
|
152
|
+
# This also means that this method only works when the cursor column is
|
|
144
153
|
# orderable (e.g. an integer or string).
|
|
145
154
|
#
|
|
155
|
+
# NOTE: When using custom columns for batching, they should include at least one unique column
|
|
156
|
+
# (e.g. primary key) as a tiebreaker. Also, to reduce the likelihood of race conditions,
|
|
157
|
+
# all columns should be static (unchangeable after it was set).
|
|
158
|
+
#
|
|
146
159
|
# NOTE: By its nature, batch processing is subject to race conditions if
|
|
147
160
|
# other processes are modifying the database.
|
|
148
|
-
def find_in_batches(start: nil, finish: nil, batch_size: 1000, error_on_ignore: nil, order: DEFAULT_ORDER)
|
|
161
|
+
def find_in_batches(start: nil, finish: nil, batch_size: 1000, error_on_ignore: nil, cursor: primary_key, order: DEFAULT_ORDER)
|
|
149
162
|
relation = self
|
|
150
163
|
unless block_given?
|
|
151
|
-
return to_enum(:find_in_batches, start: start, finish: finish, batch_size: batch_size, error_on_ignore: error_on_ignore, order: order) do
|
|
152
|
-
|
|
164
|
+
return to_enum(:find_in_batches, start: start, finish: finish, batch_size: batch_size, error_on_ignore: error_on_ignore, cursor: cursor, order: order) do
|
|
165
|
+
cursor = Array(cursor)
|
|
166
|
+
total = apply_limits(relation, cursor, start, finish, build_batch_orders(cursor, order)).size
|
|
153
167
|
(total - 1).div(batch_size) + 1
|
|
154
168
|
end
|
|
155
169
|
end
|
|
156
170
|
|
|
157
|
-
in_batches(of: batch_size, start: start, finish: finish, load: true, error_on_ignore: error_on_ignore, order: order) do |batch|
|
|
171
|
+
in_batches(of: batch_size, start: start, finish: finish, load: true, error_on_ignore: error_on_ignore, cursor: cursor, order: order) do |batch|
|
|
158
172
|
yield batch.to_a
|
|
159
173
|
end
|
|
160
174
|
end
|
|
@@ -183,11 +197,13 @@ module ActiveRecord
|
|
|
183
197
|
# ==== Options
|
|
184
198
|
# * <tt>:of</tt> - Specifies the size of the batch. Defaults to 1000.
|
|
185
199
|
# * <tt>:load</tt> - Specifies if the relation should be loaded. Defaults to false.
|
|
186
|
-
# * <tt>:start</tt> - Specifies the
|
|
187
|
-
# * <tt>:finish</tt> - Specifies the
|
|
200
|
+
# * <tt>:start</tt> - Specifies the cursor column value to start from, inclusive of the value.
|
|
201
|
+
# * <tt>:finish</tt> - Specifies the cursor column value to end at, inclusive of the value.
|
|
188
202
|
# * <tt>:error_on_ignore</tt> - Overrides the application config to specify if an error should be raised when
|
|
189
203
|
# an order is present in the relation.
|
|
190
|
-
# * <tt>:
|
|
204
|
+
# * <tt>:cursor</tt> - Specifies the column to use for batching (can be a column name or an array
|
|
205
|
+
# of column names). Defaults to primary key.
|
|
206
|
+
# * <tt>:order</tt> - Specifies the cursor column order (can be +:asc+ or +:desc+ or an array consisting
|
|
191
207
|
# of :asc or :desc). Defaults to +:asc+.
|
|
192
208
|
#
|
|
193
209
|
# class Order < ActiveRecord::Base
|
|
@@ -231,22 +247,25 @@ module ActiveRecord
|
|
|
231
247
|
#
|
|
232
248
|
# NOTE: Order can be ascending (:asc) or descending (:desc). It is automatically set to
|
|
233
249
|
# ascending on the primary key ("id ASC").
|
|
234
|
-
# This also means that this method only works when the
|
|
250
|
+
# This also means that this method only works when the cursor column is
|
|
235
251
|
# orderable (e.g. an integer or string).
|
|
236
252
|
#
|
|
253
|
+
# NOTE: When using custom columns for batching, they should include at least one unique column
|
|
254
|
+
# (e.g. primary key) as a tiebreaker. Also, to reduce the likelihood of race conditions,
|
|
255
|
+
# all columns should be static (unchangeable after it was set).
|
|
256
|
+
#
|
|
237
257
|
# NOTE: By its nature, batch processing is subject to race conditions if
|
|
238
258
|
# other processes are modifying the database.
|
|
239
|
-
def in_batches(of: 1000, start: nil, finish: nil, load: false, error_on_ignore: nil, order: DEFAULT_ORDER, use_ranges: nil, &block)
|
|
240
|
-
|
|
241
|
-
|
|
242
|
-
end
|
|
259
|
+
def in_batches(of: 1000, start: nil, finish: nil, load: false, error_on_ignore: nil, cursor: primary_key, order: DEFAULT_ORDER, use_ranges: nil, &block)
|
|
260
|
+
cursor = Array(cursor).map(&:to_s)
|
|
261
|
+
ensure_valid_options_for_batching!(cursor, start, finish, order)
|
|
243
262
|
|
|
244
263
|
if arel.orders.present?
|
|
245
264
|
act_on_ignored_order(error_on_ignore)
|
|
246
265
|
end
|
|
247
266
|
|
|
248
267
|
unless block
|
|
249
|
-
return BatchEnumerator.new(of: of, start: start, finish: finish, relation: self, order: order, use_ranges: use_ranges)
|
|
268
|
+
return BatchEnumerator.new(of: of, start: start, finish: finish, relation: self, cursor: cursor, order: order, use_ranges: use_ranges)
|
|
250
269
|
end
|
|
251
270
|
|
|
252
271
|
batch_limit = of
|
|
@@ -261,6 +280,7 @@ module ActiveRecord
|
|
|
261
280
|
relation: self,
|
|
262
281
|
start: start,
|
|
263
282
|
finish: finish,
|
|
283
|
+
cursor: cursor,
|
|
264
284
|
order: order,
|
|
265
285
|
batch_limit: batch_limit,
|
|
266
286
|
&block
|
|
@@ -271,6 +291,7 @@ module ActiveRecord
|
|
|
271
291
|
start: start,
|
|
272
292
|
finish: finish,
|
|
273
293
|
load: load,
|
|
294
|
+
cursor: cursor,
|
|
274
295
|
order: order,
|
|
275
296
|
use_ranges: use_ranges,
|
|
276
297
|
remaining: remaining,
|
|
@@ -281,28 +302,51 @@ module ActiveRecord
|
|
|
281
302
|
end
|
|
282
303
|
|
|
283
304
|
private
|
|
284
|
-
def
|
|
285
|
-
|
|
286
|
-
|
|
305
|
+
def ensure_valid_options_for_batching!(cursor, start, finish, order)
|
|
306
|
+
if start && Array(start).size != cursor.size
|
|
307
|
+
raise ArgumentError, ":start must contain one value per cursor column"
|
|
308
|
+
end
|
|
309
|
+
|
|
310
|
+
if finish && Array(finish).size != cursor.size
|
|
311
|
+
raise ArgumentError, ":finish must contain one value per cursor column"
|
|
312
|
+
end
|
|
313
|
+
|
|
314
|
+
if (Array(primary_key) - cursor).any?
|
|
315
|
+
indexes = model.schema_cache.indexes(table_name)
|
|
316
|
+
unique_index = indexes.find { |index| index.unique && index.where.nil? && (Array(index.columns) - cursor).empty? }
|
|
317
|
+
|
|
318
|
+
unless unique_index
|
|
319
|
+
raise ArgumentError, ":cursor must include a primary key or other unique column(s)"
|
|
320
|
+
end
|
|
321
|
+
end
|
|
322
|
+
|
|
323
|
+
if (Array(order) - [:asc, :desc]).any?
|
|
324
|
+
raise ArgumentError, ":order must be :asc or :desc or an array consisting of :asc or :desc, got #{order.inspect}"
|
|
325
|
+
end
|
|
326
|
+
end
|
|
327
|
+
|
|
328
|
+
def apply_limits(relation, cursor, start, finish, batch_orders)
|
|
329
|
+
relation = apply_start_limit(relation, cursor, start, batch_orders) if start
|
|
330
|
+
relation = apply_finish_limit(relation, cursor, finish, batch_orders) if finish
|
|
287
331
|
relation
|
|
288
332
|
end
|
|
289
333
|
|
|
290
|
-
def apply_start_limit(relation, start, batch_orders)
|
|
334
|
+
def apply_start_limit(relation, cursor, start, batch_orders)
|
|
291
335
|
operators = batch_orders.map do |_column, order|
|
|
292
336
|
order == :desc ? :lteq : :gteq
|
|
293
337
|
end
|
|
294
|
-
batch_condition(relation,
|
|
338
|
+
batch_condition(relation, cursor, start, operators)
|
|
295
339
|
end
|
|
296
340
|
|
|
297
|
-
def apply_finish_limit(relation, finish, batch_orders)
|
|
341
|
+
def apply_finish_limit(relation, cursor, finish, batch_orders)
|
|
298
342
|
operators = batch_orders.map do |_column, order|
|
|
299
343
|
order == :desc ? :gteq : :lteq
|
|
300
344
|
end
|
|
301
|
-
batch_condition(relation,
|
|
345
|
+
batch_condition(relation, cursor, finish, operators)
|
|
302
346
|
end
|
|
303
347
|
|
|
304
|
-
def batch_condition(relation,
|
|
305
|
-
cursor_positions =
|
|
348
|
+
def batch_condition(relation, cursor, values, operators)
|
|
349
|
+
cursor_positions = cursor.zip(Array(values), operators)
|
|
306
350
|
|
|
307
351
|
first_clause_column, first_clause_value, operator = cursor_positions.pop
|
|
308
352
|
where_clause = predicate_builder[first_clause_column, first_clause_value, operator]
|
|
@@ -316,9 +360,9 @@ module ActiveRecord
|
|
|
316
360
|
relation.where(where_clause)
|
|
317
361
|
end
|
|
318
362
|
|
|
319
|
-
def build_batch_orders(order)
|
|
320
|
-
|
|
321
|
-
[column,
|
|
363
|
+
def build_batch_orders(cursor, order)
|
|
364
|
+
cursor.zip(Array(order)).map do |column, order_|
|
|
365
|
+
[column, order_ || DEFAULT_ORDER]
|
|
322
366
|
end
|
|
323
367
|
end
|
|
324
368
|
|
|
@@ -327,34 +371,28 @@ module ActiveRecord
|
|
|
327
371
|
|
|
328
372
|
if raise_error
|
|
329
373
|
raise ArgumentError.new(ORDER_IGNORE_MESSAGE)
|
|
330
|
-
elsif logger
|
|
331
|
-
logger.warn(ORDER_IGNORE_MESSAGE)
|
|
374
|
+
elsif model.logger
|
|
375
|
+
model.logger.warn(ORDER_IGNORE_MESSAGE)
|
|
332
376
|
end
|
|
333
377
|
end
|
|
334
378
|
|
|
335
|
-
def
|
|
336
|
-
Array(primary_key).zip(Array(order))
|
|
337
|
-
end
|
|
338
|
-
|
|
339
|
-
def batch_on_loaded_relation(relation:, start:, finish:, order:, batch_limit:)
|
|
379
|
+
def batch_on_loaded_relation(relation:, start:, finish:, cursor:, order:, batch_limit:)
|
|
340
380
|
records = relation.to_a
|
|
381
|
+
order = build_batch_orders(cursor, order).map(&:second)
|
|
341
382
|
|
|
342
383
|
if start || finish
|
|
343
384
|
records = records.filter do |record|
|
|
344
|
-
|
|
385
|
+
values = record_cursor_values(record, cursor)
|
|
345
386
|
|
|
346
|
-
|
|
347
|
-
(
|
|
348
|
-
else
|
|
349
|
-
(start.nil? || id <= start) && (finish.nil? || id >= finish)
|
|
350
|
-
end
|
|
387
|
+
(start.nil? || compare_values_for_order(values, Array(start), order) >= 0) &&
|
|
388
|
+
(finish.nil? || compare_values_for_order(values, Array(finish), order) <= 0)
|
|
351
389
|
end
|
|
352
390
|
end
|
|
353
391
|
|
|
354
|
-
records.
|
|
355
|
-
|
|
356
|
-
|
|
357
|
-
|
|
392
|
+
records.sort! do |record1, record2|
|
|
393
|
+
values1 = record_cursor_values(record1, cursor)
|
|
394
|
+
values2 = record_cursor_values(record2, cursor)
|
|
395
|
+
compare_values_for_order(values1, values2, order)
|
|
358
396
|
end
|
|
359
397
|
|
|
360
398
|
records.each_slice(batch_limit) do |subrecords|
|
|
@@ -367,44 +405,65 @@ module ActiveRecord
|
|
|
367
405
|
nil
|
|
368
406
|
end
|
|
369
407
|
|
|
370
|
-
def
|
|
371
|
-
|
|
408
|
+
def record_cursor_values(record, cursor)
|
|
409
|
+
record.attributes.slice(*cursor).values
|
|
410
|
+
end
|
|
411
|
+
|
|
412
|
+
# This is a custom implementation of `<=>` operator,
|
|
413
|
+
# which also takes into account how the collection will be ordered.
|
|
414
|
+
def compare_values_for_order(values1, values2, order)
|
|
415
|
+
values1.each_with_index do |element1, index|
|
|
416
|
+
element2 = values2[index]
|
|
417
|
+
direction = order[index]
|
|
418
|
+
comparison = element1 <=> element2
|
|
419
|
+
comparison = -comparison if direction == :desc
|
|
420
|
+
return comparison if comparison != 0
|
|
421
|
+
end
|
|
422
|
+
|
|
423
|
+
0
|
|
424
|
+
end
|
|
425
|
+
|
|
426
|
+
def batch_on_unloaded_relation(relation:, start:, finish:, load:, cursor:, order:, use_ranges:, remaining:, batch_limit:)
|
|
427
|
+
batch_orders = build_batch_orders(cursor, order)
|
|
372
428
|
relation = relation.reorder(batch_orders.to_h).limit(batch_limit)
|
|
373
|
-
relation = apply_limits(relation, start, finish, batch_orders)
|
|
429
|
+
relation = apply_limits(relation, cursor, start, finish, batch_orders)
|
|
374
430
|
relation.skip_query_cache! # Retaining the results in the query cache would undermine the point of batching
|
|
375
431
|
batch_relation = relation
|
|
376
|
-
empty_scope = to_sql ==
|
|
432
|
+
empty_scope = to_sql == model.unscoped.all.to_sql
|
|
377
433
|
|
|
378
434
|
loop do
|
|
379
435
|
if load
|
|
380
436
|
records = batch_relation.records
|
|
381
|
-
|
|
382
|
-
yielded_relation = where(
|
|
437
|
+
values = records.pluck(*cursor)
|
|
438
|
+
yielded_relation = where(cursor => values)
|
|
383
439
|
yielded_relation.load_records(records)
|
|
384
440
|
elsif (empty_scope && use_ranges != false) || use_ranges
|
|
385
|
-
|
|
386
|
-
|
|
441
|
+
values = batch_relation.pluck(*cursor)
|
|
442
|
+
|
|
443
|
+
finish = values.last
|
|
387
444
|
if finish
|
|
388
|
-
yielded_relation = apply_finish_limit(batch_relation, finish, batch_orders)
|
|
445
|
+
yielded_relation = apply_finish_limit(batch_relation, cursor, finish, batch_orders)
|
|
389
446
|
yielded_relation = yielded_relation.except(:limit, :order)
|
|
390
447
|
yielded_relation.skip_query_cache!(false)
|
|
391
448
|
end
|
|
392
449
|
else
|
|
393
|
-
|
|
394
|
-
yielded_relation = where(
|
|
450
|
+
values = batch_relation.pluck(*cursor)
|
|
451
|
+
yielded_relation = where(cursor => values)
|
|
395
452
|
end
|
|
396
453
|
|
|
397
|
-
break if
|
|
454
|
+
break if values.empty?
|
|
398
455
|
|
|
399
|
-
|
|
400
|
-
|
|
456
|
+
if values.flatten.any?(nil)
|
|
457
|
+
raise ArgumentError, "Not all of the batch cursor columns were included in the custom select clause "\
|
|
458
|
+
"or some columns contain nil."
|
|
459
|
+
end
|
|
401
460
|
|
|
402
461
|
yield yielded_relation
|
|
403
462
|
|
|
404
|
-
break if
|
|
463
|
+
break if values.length < batch_limit
|
|
405
464
|
|
|
406
465
|
if limit_value
|
|
407
|
-
remaining -=
|
|
466
|
+
remaining -= values.length
|
|
408
467
|
|
|
409
468
|
if remaining == 0
|
|
410
469
|
# Saves a useless iteration when the limit is a multiple of the
|
|
@@ -422,7 +481,8 @@ module ActiveRecord
|
|
|
422
481
|
end
|
|
423
482
|
operators << (last_order == :desc ? :lt : :gt)
|
|
424
483
|
|
|
425
|
-
|
|
484
|
+
cursor_value = values.last
|
|
485
|
+
batch_relation = batch_condition(relation, cursor, cursor_value, operators)
|
|
426
486
|
end
|
|
427
487
|
|
|
428
488
|
nil
|
|
@@ -233,7 +233,7 @@ module ActiveRecord
|
|
|
233
233
|
if operation == "count"
|
|
234
234
|
unless distinct_value || distinct_select?(column_name || select_for_count)
|
|
235
235
|
relation.distinct!
|
|
236
|
-
relation.select_values = Array(
|
|
236
|
+
relation.select_values = Array(model.primary_key || table[Arel.star])
|
|
237
237
|
end
|
|
238
238
|
# PostgreSQL: ORDER BY expressions must appear in SELECT list when using DISTINCT
|
|
239
239
|
relation.order_values = [] if group_values.empty?
|
|
@@ -274,10 +274,14 @@ module ActiveRecord
|
|
|
274
274
|
# # SELECT people.id FROM people WHERE people.age = 21 LIMIT 5
|
|
275
275
|
# # => [2, 3]
|
|
276
276
|
#
|
|
277
|
-
# Comment.joins(:person).pluck(:id, person:
|
|
278
|
-
# # SELECT comments.id,
|
|
277
|
+
# Comment.joins(:person).pluck(:id, person: :id)
|
|
278
|
+
# # SELECT comments.id, person.id FROM comments INNER JOIN people person ON person.id = comments.person_id
|
|
279
279
|
# # => [[1, 2], [2, 2]]
|
|
280
280
|
#
|
|
281
|
+
# Comment.joins(:person).pluck(:id, person: [:id, :name])
|
|
282
|
+
# # SELECT comments.id, person.id, person.name FROM comments INNER JOIN people person ON person.id = comments.person_id
|
|
283
|
+
# # => [[1, 2, 'David'], [2, 2, 'David']]
|
|
284
|
+
#
|
|
281
285
|
# Person.pluck(Arel.sql('DATEDIFF(updated_at, created_at)'))
|
|
282
286
|
# # SELECT DATEDIFF(updated_at, created_at) FROM people
|
|
283
287
|
# # => ['0', '27761', '173']
|
|
@@ -305,7 +309,7 @@ module ActiveRecord
|
|
|
305
309
|
relation = apply_join_dependency
|
|
306
310
|
relation.pluck(*column_names)
|
|
307
311
|
else
|
|
308
|
-
|
|
312
|
+
model.disallow_raw_sql!(flattened_args(column_names))
|
|
309
313
|
relation = spawn
|
|
310
314
|
columns = relation.arel_columns(column_names)
|
|
311
315
|
relation.select_values = columns
|
|
@@ -313,8 +317,8 @@ module ActiveRecord
|
|
|
313
317
|
if where_clause.contradiction?
|
|
314
318
|
ActiveRecord::Result.empty(async: @async)
|
|
315
319
|
else
|
|
316
|
-
|
|
317
|
-
c.select_all(relation.arel, "#{
|
|
320
|
+
model.with_connection do |c|
|
|
321
|
+
c.select_all(relation.arel, "#{model.name} Pluck", async: @async)
|
|
318
322
|
end
|
|
319
323
|
end
|
|
320
324
|
end
|
|
@@ -390,8 +394,8 @@ module ActiveRecord
|
|
|
390
394
|
ActiveRecord::Result.empty
|
|
391
395
|
else
|
|
392
396
|
skip_query_cache_if_necessary do
|
|
393
|
-
|
|
394
|
-
c.select_all(relation, "#{
|
|
397
|
+
model.with_connection do |c|
|
|
398
|
+
c.select_all(relation, "#{model.name} Ids", async: @async)
|
|
395
399
|
end
|
|
396
400
|
end
|
|
397
401
|
end
|
|
@@ -407,16 +411,19 @@ module ActiveRecord
|
|
|
407
411
|
|
|
408
412
|
protected
|
|
409
413
|
def aggregate_column(column_name)
|
|
410
|
-
|
|
411
|
-
|
|
412
|
-
|
|
413
|
-
|
|
414
|
+
case column_name
|
|
415
|
+
when Arel::Expressions
|
|
416
|
+
column_name
|
|
417
|
+
when :all
|
|
418
|
+
Arel.star
|
|
419
|
+
else
|
|
420
|
+
arel_column(column_name)
|
|
414
421
|
end
|
|
415
422
|
end
|
|
416
423
|
|
|
417
424
|
private
|
|
418
425
|
def all_attributes?(column_names)
|
|
419
|
-
(column_names.map(&:to_s) -
|
|
426
|
+
(column_names.map(&:to_s) - model.attribute_names - model.attribute_aliases.keys).empty?
|
|
420
427
|
end
|
|
421
428
|
|
|
422
429
|
def has_include?(column_name)
|
|
@@ -486,8 +493,8 @@ module ActiveRecord
|
|
|
486
493
|
end
|
|
487
494
|
else
|
|
488
495
|
skip_query_cache_if_necessary do
|
|
489
|
-
|
|
490
|
-
c.select_all(query_builder, "#{
|
|
496
|
+
model.with_connection do |c|
|
|
497
|
+
c.select_all(query_builder, "#{model.name} #{operation.capitalize}", async: @async)
|
|
491
498
|
end
|
|
492
499
|
end
|
|
493
500
|
end
|
|
@@ -508,7 +515,7 @@ module ActiveRecord
|
|
|
508
515
|
group_fields = group_fields.uniq if group_fields.size > 1
|
|
509
516
|
|
|
510
517
|
if group_fields.size == 1 && group_fields.first.respond_to?(:to_sym)
|
|
511
|
-
association =
|
|
518
|
+
association = model._reflect_on_association(group_fields.first)
|
|
512
519
|
associated = association && association.belongs_to? # only count belongs_to associations
|
|
513
520
|
group_fields = Array(association.foreign_key) if associated
|
|
514
521
|
end
|
|
@@ -516,7 +523,7 @@ module ActiveRecord
|
|
|
516
523
|
relation = except(:group).distinct!(false)
|
|
517
524
|
group_fields = relation.arel_columns(group_fields)
|
|
518
525
|
|
|
519
|
-
|
|
526
|
+
model.with_connection do |connection|
|
|
520
527
|
column_alias_tracker = ColumnAliasTracker.new(connection)
|
|
521
528
|
|
|
522
529
|
group_aliases = group_fields.map { |field|
|
|
@@ -528,13 +535,13 @@ module ActiveRecord
|
|
|
528
535
|
column = relation.aggregate_column(column_name)
|
|
529
536
|
column_alias = column_alias_tracker.alias_for("#{operation} #{column_name.to_s.downcase}")
|
|
530
537
|
select_value = operation_over_aggregate_column(column, operation, distinct)
|
|
531
|
-
select_value.as(adapter_class.quote_column_name(column_alias))
|
|
538
|
+
select_value.as(model.adapter_class.quote_column_name(column_alias))
|
|
532
539
|
|
|
533
540
|
select_values = [select_value]
|
|
534
541
|
select_values += self.select_values unless having_clause.empty?
|
|
535
542
|
|
|
536
543
|
select_values.concat group_columns.map { |aliaz, field|
|
|
537
|
-
aliaz = adapter_class.quote_column_name(aliaz)
|
|
544
|
+
aliaz = model.adapter_class.quote_column_name(aliaz)
|
|
538
545
|
if field.respond_to?(:as)
|
|
539
546
|
field.as(aliaz)
|
|
540
547
|
else
|
|
@@ -546,7 +553,7 @@ module ActiveRecord
|
|
|
546
553
|
relation.select_values = select_values
|
|
547
554
|
|
|
548
555
|
result = skip_query_cache_if_necessary do
|
|
549
|
-
connection.select_all(relation.arel, "#{
|
|
556
|
+
connection.select_all(relation.arel, "#{model.name} #{operation.capitalize}", async: @async)
|
|
550
557
|
end
|
|
551
558
|
|
|
552
559
|
result.then do |calculated_data|
|
|
@@ -588,7 +595,7 @@ module ActiveRecord
|
|
|
588
595
|
|
|
589
596
|
def type_for(field, &block)
|
|
590
597
|
field_name = field.respond_to?(:name) ? field.name.to_s : field.to_s.split(".").last
|
|
591
|
-
|
|
598
|
+
model.type_for_attribute(field_name, &block)
|
|
592
599
|
end
|
|
593
600
|
|
|
594
601
|
def lookup_cast_type_from_join_dependencies(name, join_dependencies = build_join_dependencies)
|
|
@@ -601,12 +608,12 @@ module ActiveRecord
|
|
|
601
608
|
|
|
602
609
|
def type_cast_pluck_values(result, columns)
|
|
603
610
|
cast_types = if result.columns.size != columns.size
|
|
604
|
-
|
|
611
|
+
model.attribute_types
|
|
605
612
|
else
|
|
606
613
|
join_dependencies = nil
|
|
607
614
|
columns.map.with_index do |column, i|
|
|
608
615
|
column.try(:type_caster) ||
|
|
609
|
-
|
|
616
|
+
model.attribute_types.fetch(name = result.columns[i]) do
|
|
610
617
|
join_dependencies ||= build_join_dependencies
|
|
611
618
|
lookup_cast_type_from_join_dependencies(name, join_dependencies) ||
|
|
612
619
|
result.column_types[i] || Type.default_value
|
|
@@ -635,22 +642,12 @@ module ActiveRecord
|
|
|
635
642
|
end
|
|
636
643
|
|
|
637
644
|
def select_for_count
|
|
638
|
-
if select_values.
|
|
639
|
-
return select_values.first if select_values.one?
|
|
640
|
-
|
|
641
|
-
select_values.map do |field|
|
|
642
|
-
column = arel_column(field.to_s) do |attr_name|
|
|
643
|
-
Arel.sql(attr_name)
|
|
644
|
-
end
|
|
645
|
-
|
|
646
|
-
if column.is_a?(Arel::Nodes::SqlLiteral)
|
|
647
|
-
column
|
|
648
|
-
else
|
|
649
|
-
"#{adapter_class.quote_table_name(column.relation.name)}.#{adapter_class.quote_column_name(column.name)}"
|
|
650
|
-
end
|
|
651
|
-
end.join(", ")
|
|
652
|
-
else
|
|
645
|
+
if select_values.empty?
|
|
653
646
|
:all
|
|
647
|
+
else
|
|
648
|
+
with_connection do |conn|
|
|
649
|
+
arel_columns(select_values).map { |column| conn.visitor.compile(column) }.join(", ")
|
|
650
|
+
end
|
|
654
651
|
end
|
|
655
652
|
end
|
|
656
653
|
|
|
@@ -673,7 +670,11 @@ module ActiveRecord
|
|
|
673
670
|
subquery_alias = Arel.sql("subquery_for_count", retryable: true)
|
|
674
671
|
select_value = operation_over_aggregate_column(column_alias, "count", false)
|
|
675
672
|
|
|
676
|
-
|
|
673
|
+
if column_name == :all
|
|
674
|
+
relation.unscope(:order).build_subquery(subquery_alias, select_value)
|
|
675
|
+
else
|
|
676
|
+
relation.build_subquery(subquery_alias, select_value)
|
|
677
|
+
end
|
|
677
678
|
end
|
|
678
679
|
end
|
|
679
680
|
end
|