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
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
|
/*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership.
* The ASF licenses this file to You under the Apache License, Version 2.0
* (the "License"); you may not use this file except in compliance with
* the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package org.apache.spark.sql.execution.aggregate
import org.apache.spark.rdd.RDD
import org.apache.spark.sql.catalyst.errors._
import org.apache.spark.sql.catalyst.InternalRow
import org.apache.spark.sql.catalyst.expressions._
import org.apache.spark.sql.catalyst.expressions.aggregate._
import org.apache.spark.sql.catalyst.plans.physical.{UnspecifiedDistribution, ClusteredDistribution, AllTuples, Distribution}
import org.apache.spark.sql.execution.{UnsafeFixedWidthAggregationMap, SparkPlan, UnaryNode}
import org.apache.spark.sql.types.StructType
/**
* An Aggregate Operator used to evaluate [[AggregateFunction2]]. Based on the data types
* of the grouping expressions and aggregate functions, it determines if it uses
* sort-based aggregation and hybrid (hash-based with sort-based as the fallback) to
* process input rows.
*/
case class Aggregate(
requiredChildDistributionExpressions: Option[Seq[Expression]],
groupingExpressions: Seq[NamedExpression],
nonCompleteAggregateExpressions: Seq[AggregateExpression2],
nonCompleteAggregateAttributes: Seq[Attribute],
completeAggregateExpressions: Seq[AggregateExpression2],
completeAggregateAttributes: Seq[Attribute],
initialInputBufferOffset: Int,
resultExpressions: Seq[NamedExpression],
child: SparkPlan)
extends UnaryNode {
private[this] val allAggregateExpressions =
nonCompleteAggregateExpressions ++ completeAggregateExpressions
private[this] val hasNonAlgebricAggregateFunctions =
!allAggregateExpressions.forall(_.aggregateFunction.isInstanceOf[AlgebraicAggregate])
// Use the hybrid iterator if (1) unsafe is enabled, (2) the schemata of
// grouping key and aggregation buffer is supported; and (3) all
// aggregate functions are algebraic.
private[this] val supportsHybridIterator: Boolean = {
val aggregationBufferSchema: StructType =
StructType.fromAttributes(
allAggregateExpressions.flatMap(_.aggregateFunction.bufferAttributes))
val groupKeySchema: StructType =
StructType.fromAttributes(groupingExpressions.map(_.toAttribute))
val schemaSupportsUnsafe: Boolean =
UnsafeFixedWidthAggregationMap.supportsAggregationBufferSchema(aggregationBufferSchema) &&
UnsafeProjection.canSupport(groupKeySchema)
// TODO: Use the hybrid iterator for non-algebric aggregate functions.
sqlContext.conf.unsafeEnabled && schemaSupportsUnsafe && !hasNonAlgebricAggregateFunctions
}
// We need to use sorted input if we have grouping expressions, and
// we cannot use the hybrid iterator or the hybrid is disabled.
private[this] val requiresSortedInput: Boolean = {
groupingExpressions.nonEmpty && !supportsHybridIterator
}
override def canProcessUnsafeRows: Boolean = !hasNonAlgebricAggregateFunctions
// If result expressions' data types are all fixed length, we generate unsafe rows
// (We have this requirement instead of check the result of UnsafeProjection.canSupport
// is because we use a mutable projection to generate the result).
override def outputsUnsafeRows: Boolean = {
// resultExpressions.map(_.dataType).forall(UnsafeRow.isFixedLength)
// TODO: Supports generating UnsafeRows. We can just re-enable the line above and fix
// any issue we get.
false
}
override def output: Seq[Attribute] = resultExpressions.map(_.toAttribute)
override def requiredChildDistribution: List[Distribution] = {
requiredChildDistributionExpressions match {
case Some(exprs) if exprs.length == 0 => AllTuples :: Nil
case Some(exprs) if exprs.length > 0 => ClusteredDistribution(exprs) :: Nil
case None => UnspecifiedDistribution :: Nil
}
}
override def requiredChildOrdering: Seq[Seq[SortOrder]] = {
if (requiresSortedInput) {
// TODO: We should not sort the input rows if they are just in reversed order.
groupingExpressions.map(SortOrder(_, Ascending)) :: Nil
} else {
Seq.fill(children.size)(Nil)
}
}
override def outputOrdering: Seq[SortOrder] = {
if (requiresSortedInput) {
// It is possible that the child.outputOrdering starts with the required
// ordering expressions (e.g. we require [a] as the sort expression and the
// child's outputOrdering is [a, b]). We can only guarantee the output rows
// are sorted by values of groupingExpressions.
groupingExpressions.map(SortOrder(_, Ascending))
} else {
Nil
}
}
protected override def doExecute(): RDD[InternalRow] = attachTree(this, "execute") {
child.execute().mapPartitions { iter =>
// Because the constructor of an aggregation iterator will read at least the first row,
// we need to get the value of iter.hasNext first.
val hasInput = iter.hasNext
val useHybridIterator =
hasInput &&
supportsHybridIterator &&
groupingExpressions.nonEmpty
if (useHybridIterator) {
UnsafeHybridAggregationIterator.createFromInputIterator(
groupingExpressions,
nonCompleteAggregateExpressions,
nonCompleteAggregateAttributes,
completeAggregateExpressions,
completeAggregateAttributes,
initialInputBufferOffset,
resultExpressions,
newMutableProjection _,
child.output,
iter,
outputsUnsafeRows)
} else {
if (!hasInput && groupingExpressions.nonEmpty) {
// This is a grouped aggregate and the input iterator is empty,
// so return an empty iterator.
Iterator[InternalRow]()
} else {
val outputIter = SortBasedAggregationIterator.createFromInputIterator(
groupingExpressions,
nonCompleteAggregateExpressions,
nonCompleteAggregateAttributes,
completeAggregateExpressions,
completeAggregateAttributes,
initialInputBufferOffset,
resultExpressions,
newMutableProjection _ ,
newProjection _,
child.output,
iter,
outputsUnsafeRows)
if (!hasInput && groupingExpressions.isEmpty) {
// There is no input and there is no grouping expressions.
// We need to output a single row as the output.
Iterator[InternalRow](outputIter.outputForEmptyGroupingKeyWithoutInput())
} else {
outputIter
}
}
}
}
}
override def simpleString: String = {
val iterator = if (supportsHybridIterator && groupingExpressions.nonEmpty) {
classOf[UnsafeHybridAggregationIterator].getSimpleName
} else {
classOf[SortBasedAggregationIterator].getSimpleName
}
s"""NewAggregate with $iterator ${groupingExpressions} ${allAggregateExpressions}"""
}
}
|