// Copyright 2019-present PingCAP, Inc. // // Licensed 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, // See the License for the specific language governing permissions and // limitations under the License. package coprocessor import ( "container/heap" "github.com/juju/errors" "github.com/pingcap/tidb/sessionctx/stmtctx" "github.com/pingcap/tidb/types" tipb "github.com/pingcap/tipb/go-tipb" ) type sortRow struct { key []types.Datum data [][]byte } // topNSorter implements sort.Interface. When all rows have been processed, the topNSorter will sort the whole data in heap. type topNSorter struct { orderByItems []*tipb.ByItem rows []*sortRow err error sc *stmtctx.StatementContext } func (t *topNSorter) Len() int { return len(t.rows) } func (t *topNSorter) Swap(i, j int) { t.rows[i], t.rows[j] = t.rows[j], t.rows[i] } func (t *topNSorter) Less(i, j int) bool { for index, by := range t.orderByItems { v1 := t.rows[i].key[index] v2 := t.rows[j].key[index] ret, err := v1.CompareDatum(t.sc, &v2) if err != nil { t.err = errors.Trace(err) return true } if by.Desc { ret = -ret } if ret < 0 { return true } else if ret > 0 { return false } } return false } // topNHeap holds the top n elements using heap structure. It implements heap.Interface. // When we insert a row, topNHeap will check if the row can become one of the top n element or not. type topNHeap struct { topNSorter // totalCount is equal to the limit count, which means the max size of heap. totalCount int // heapSize means the current size of this heap. heapSize int } func (t *topNHeap) Len() int { return t.heapSize } func (t *topNHeap) Push(x interface{}) { t.rows = append(t.rows, x.(*sortRow)) t.heapSize++ } func (t *topNHeap) Pop() interface{} { return nil } func (t *topNHeap) Less(i, j int) bool { for index, by := range t.orderByItems { v1 := t.rows[i].key[index] v2 := t.rows[j].key[index] ret, err := v1.CompareDatum(t.sc, &v2) if err != nil { t.err = errors.Trace(err) return true } if by.Desc { ret = -ret } if ret > 0 { return true } else if ret < 0 { return false } } return false } // tryToAddRow tries to add a row to heap. // When this row is not less than any rows in heap, it will never become the top n element. // Then this function returns false. func (t *topNHeap) tryToAddRow(row *sortRow) bool { success := false if t.heapSize == t.totalCount { t.rows = append(t.rows, row) // When this row is less than the top element, it will replace it and adjust the heap structure. if t.Less(0, t.heapSize) { t.Swap(0, t.heapSize) heap.Fix(t, 0) success = true } t.rows = t.rows[:t.heapSize] } else { heap.Push(t, row) success = true } return success }