summaryrefslogtreecommitdiff
path: root/app/models/concerns/from_intersect.rb
blob: 428e63eb45e23e5c01025ff118a26ac130536952 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
# frozen_string_literal: true

module FromIntersect
  extend ActiveSupport::Concern

  class_methods do
    # Produces a query that uses a FROM to select data using an INTERSECT.
    #
    # Example:
    #     groups = Group.from_intersect([group1.self_and_hierarchy, group2.self_and_hierarchy])
    #
    # This would produce the following SQL query:
    #
    #     SELECT *
    #     FROM (
    #       SELECT "namespaces". *
    #       ...
    #
    #       INTERSECT
    #
    #       SELECT "namespaces". *
    #       ...
    #     ) groups;
    #
    # members - An Array of ActiveRecord::Relation objects to use in the intersect.
    #
    # remove_duplicates - A boolean indicating if duplicate entries should be
    #                     removed. Defaults to true.
    #
    # alias_as - The alias to use for the sub query. Defaults to the name of the
    #            table of the current model.
    # rubocop: disable Gitlab/Intersect
    extend FromSetOperator
    define_set_operator Gitlab::SQL::Intersect
    # rubocop: enable Gitlab/Intersect
  end
end