• Home
  • Features
  • Pricing
  • Docs
  • Announcements
  • Sign In

taosdata / TDengine / #3825

01 Apr 2025 11:58AM UTC coverage: 34.067% (+0.003%) from 34.064%
#3825

push

travis-ci

happyguoxy
test:alter gcda dir

148492 of 599532 branches covered (24.77%)

Branch coverage included in aggregate %.

222504 of 489471 relevant lines covered (45.46%)

762290.2 hits per line

Source File
Press 'n' to go to next uncovered line, 'b' for previous

31.03
/source/libs/executor/src/sortoperator.c
1
/*
2
 * Copyright (c) 2019 TAOS Data, Inc. <jhtao@taosdata.com>
3
 *
4
 * This program is free software: you can use, redistribute, and/or modify
5
 * it under the terms of the GNU Affero General Public License, version 3
6
 * or later ("AGPL"), as published by the Free Software Foundation.
7
 *
8
 * This program is distributed in the hope that it will be useful, but WITHOUT
9
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
10
 * FITNESS FOR A PARTICULAR PURPOSE.
11
 *
12
 * You should have received a copy of the GNU Affero General Public License
13
 * along with this program. If not, see <http://www.gnu.org/licenses/>.
14
 */
15

16
#include "executorInt.h"
17
#include "filter.h"
18
#include "operator.h"
19
#include "querytask.h"
20
#include "tdatablock.h"
21

22
typedef struct SSortOpGroupIdCalc {
23
  STupleHandle* pSavedTuple;
24
  SArray*       pSortColsArr;
25
  char*         keyBuf;
26
  int32_t       lastKeysLen; // default to be 0
27
  uint64_t      lastGroupId;
28
  bool          excludePKCol;
29
} SSortOpGroupIdCalc;
30

31
typedef struct SSortOperatorInfo {
32
  SOptrBasicInfo      binfo;
33
  uint32_t            sortBufSize;  // max buffer size for in-memory sort
34
  SArray*             pSortInfo;
35
  SSortHandle*        pSortHandle;
36
  SColMatchInfo       matchInfo;
37
  int32_t             bufPageSize;
38
  int64_t             startTs;      // sort start time
39
  uint64_t            sortElapsed;  // sort elapsed time, time to flush to disk not included.
40
  SLimitInfo          limitInfo;
41
  uint64_t            maxTupleLength;
42
  int64_t             maxRows;
43
  SSortOpGroupIdCalc* pGroupIdCalc;
44
} SSortOperatorInfo;
45

46
static int32_t doSort(SOperatorInfo* pOperator, SSDataBlock** pResBlock);
47
static int32_t doOpenSortOperator(SOperatorInfo* pOperator);
48
static int32_t getExplainExecInfo(SOperatorInfo* pOptr, void** pOptrExplain, uint32_t* len);
49
static int32_t doGroupSort(SOperatorInfo* pOperator, SSDataBlock** pResBlock);
50

51
static void destroySortOperatorInfo(void* param);
52
static void calcSortOperMaxTupleLength(SSortOperatorInfo* pSortOperInfo, SNodeList* pSortKeys);
53

54
static void destroySortOpGroupIdCalc(SSortOpGroupIdCalc* pCalc);
55

56
// todo add limit/offset impl
57
int32_t createSortOperatorInfo(SOperatorInfo* downstream, SSortPhysiNode* pSortNode, SExecTaskInfo* pTaskInfo, SOperatorInfo** pOptrInfo) {
50✔
58
  QRY_PARAM_CHECK(pOptrInfo);
50!
59

60
  int32_t code = 0;
50✔
61
  int32_t lino = 0;
50✔
62

63
  SSortOperatorInfo* pInfo = taosMemoryCalloc(1, sizeof(SSortOperatorInfo));
50!
64
  SOperatorInfo*     pOperator = taosMemoryCalloc(1, sizeof(SOperatorInfo));
50!
65
  if (pInfo == NULL || pOperator == NULL) {
50!
66
    code = terrno;
×
67
    goto _error;
×
68
  }
69

70
  pOperator->pTaskInfo = pTaskInfo;
50✔
71
  SDataBlockDescNode* pDescNode = pSortNode->node.pOutputDataBlockDesc;
50✔
72

73
  int32_t numOfCols = 0;
50✔
74
  code = createExprInfo(pSortNode->pExprs, NULL, &pOperator->exprSupp.pExprInfo, &numOfCols);
50✔
75
  QUERY_CHECK_CODE(code, lino, _error);
50!
76

77
  pOperator->exprSupp.numOfExprs = numOfCols;
50✔
78
  int32_t numOfOutputCols = 0;
50✔
79
  code =
80
      extractColMatchInfo(pSortNode->pTargets, pDescNode, &numOfOutputCols, COL_MATCH_FROM_SLOT_ID, &pInfo->matchInfo);
50✔
81
  if (code != TSDB_CODE_SUCCESS) {
50!
82
    goto _error;
×
83
  }
84
  
85
  calcSortOperMaxTupleLength(pInfo, pSortNode->pSortKeys);
50✔
86
  pInfo->maxRows = -1;
50✔
87
  if (pSortNode->node.pLimit && ((SLimitNode*)pSortNode->node.pLimit)->limit) {
50!
88
    SLimitNode* pLimit = (SLimitNode*)pSortNode->node.pLimit;
×
89
    if (pLimit->limit->datum.i > 0) {
×
90
      pInfo->maxRows = pLimit->limit->datum.i + (pLimit->offset ? pLimit->offset->datum.i : 0);
×
91
    }
92
  }
93

94
  pOperator->exprSupp.pCtx =
50✔
95
      createSqlFunctionCtx(pOperator->exprSupp.pExprInfo, numOfCols, &pOperator->exprSupp.rowEntryInfoOffset, &pTaskInfo->storageAPI.functionStore);
50✔
96
  QUERY_CHECK_NULL(pOperator->exprSupp.pCtx, code, lino, _error, terrno);
50!
97
  initResultSizeInfo(&pOperator->resultInfo, 1024);
50✔
98
  code = filterInitFromNode((SNode*)pSortNode->node.pConditions, &pOperator->exprSupp.pFilterInfo, 0);
50✔
99
  if (code != TSDB_CODE_SUCCESS) {
50!
100
    goto _error;
×
101
  }
102

103
  pInfo->binfo.pRes = createDataBlockFromDescNode(pDescNode);
50✔
104
  QUERY_CHECK_NULL(pInfo->binfo.pRes, code, lino, _error, terrno);
50!
105

106
  pInfo->pSortInfo = createSortInfo(pSortNode->pSortKeys);
50✔
107
  TSDB_CHECK_NULL(pInfo->pSortInfo, code, lino, _error, terrno);
50!
108

109
  if (pSortNode->calcGroupId) {
50!
110
    int32_t keyLen;
111
    SSortOpGroupIdCalc* pGroupIdCalc = pInfo->pGroupIdCalc = taosMemoryCalloc(1, sizeof(SSortOpGroupIdCalc));
×
112
    if (!pGroupIdCalc) {
×
113
      code = terrno;
×
114
      goto _error;
×
115
    }
116
    SNodeList* pSortColsNodeArr = makeColsNodeArrFromSortKeys(pSortNode->pSortKeys);
×
117
    if (!pSortColsNodeArr) code = terrno;
×
118
    if (TSDB_CODE_SUCCESS == code) {
×
119
      pGroupIdCalc->pSortColsArr = makeColumnArrayFromList(pSortColsNodeArr);
×
120
      if (!pGroupIdCalc->pSortColsArr) code = terrno;
×
121
      nodesClearList(pSortColsNodeArr);
×
122
    }
123
    if (TSDB_CODE_SUCCESS == code) {
×
124
      // PK ts col should always at last, see partColOptCreateSort
125
      if (pSortNode->excludePkCol) taosArrayPop(pGroupIdCalc->pSortColsArr);
×
126
      code = extractKeysLen(pGroupIdCalc->pSortColsArr, &keyLen);
×
127
      QUERY_CHECK_CODE(code, lino, _error);
×
128
    }
129
    if (TSDB_CODE_SUCCESS == code) {
×
130
      pGroupIdCalc->lastKeysLen = 0;
×
131
      pGroupIdCalc->keyBuf = taosMemoryCalloc(1, keyLen);
×
132
      if (!pGroupIdCalc->keyBuf) {
×
133
        code = terrno;
×
134
      }
135
    }
136
  }
137
  if (code != TSDB_CODE_SUCCESS) goto _error;
50!
138

139
  pInfo->binfo.inputTsOrder = pSortNode->node.inputTsOrder;
50✔
140
  pInfo->binfo.outputTsOrder = pSortNode->node.outputTsOrder;
50✔
141
  initLimitInfo(pSortNode->node.pLimit, pSortNode->node.pSlimit, &pInfo->limitInfo);
50✔
142

143
  setOperatorInfo(pOperator, "SortOperator", QUERY_NODE_PHYSICAL_PLAN_SORT, true, OP_NOT_OPENED, pInfo, pTaskInfo);
50✔
144

145

146
  // lazy evaluation for the following parameter since the input datablock is not known till now.
147
  //  pInfo->bufPageSize  = rowSize < 1024 ? 1024 * 2 : rowSize * 2;
148
  //  there are headers, so pageSize = rowSize + header pInfo->sortBufSize  = pInfo->bufPageSize * 16;
149
  // TODO dynamic set the available sort buffer
150

151
  pOperator->fpSet =
152
      createOperatorFpSet(doOpenSortOperator, doSort, NULL, destroySortOperatorInfo, optrDefaultBufFn, getExplainExecInfo, optrDefaultGetNextExtFn, NULL);
50✔
153

154
  code = appendDownstream(pOperator, &downstream, 1);
50✔
155
  if (code != TSDB_CODE_SUCCESS) {
50!
156
    goto _error;
×
157
  }
158

159
  *pOptrInfo = pOperator;
50✔
160
  return TSDB_CODE_SUCCESS;
50✔
161

162
_error:
×
163
  if (pInfo != NULL) {
×
164
    destroySortOperatorInfo(pInfo);
×
165
  }
166
  destroyOperatorAndDownstreams(pOperator, &downstream, 1);
×
167
  pTaskInfo->code = code;
×
168
  return code;
×
169
}
170

171
int32_t appendOneRowToDataBlock(SSDataBlock* pBlock, STupleHandle* pTupleHandle) {
4,448✔
172
  int32_t code = 0;
4,448✔
173
  for (int32_t i = 0; i < taosArrayGetSize(pBlock->pDataBlock); ++i) {
16,157✔
174
    SColumnInfoData* pColInfo = taosArrayGet(pBlock->pDataBlock, i);
11,702✔
175
    if (pColInfo == NULL) {
11,703!
176
      return terrno;
×
177
    }
178

179
    bool isNull = tsortIsNullVal(pTupleHandle, i);
11,703✔
180
    if (isNull) {
11,704✔
181
      colDataSetNULL(pColInfo, pBlock->info.rows);
114✔
182
    } else {
183
      char* pData = NULL;
11,590✔
184
      tsortGetValue(pTupleHandle, i, (void**) &pData);
11,590✔
185

186
      if (pData != NULL) {
11,592!
187
        code = colDataSetVal(pColInfo, pBlock->info.rows, pData, false);
11,592✔
188
        if (code) {
11,595!
189
          return code;
×
190
        }
191
      }
192
    }
193
  }
194

195
  pBlock->info.dataLoad = 1;
4,447✔
196

197
  SDataBlockInfo info = {0};
4,447✔
198
  tsortGetBlockInfo(pTupleHandle, &info);
4,447✔
199

200
  pBlock->info.scanFlag = info.scanFlag;
4,448✔
201
  pBlock->info.rows += 1;
4,448✔
202
  return code;
4,448✔
203
}
204

205
/**
206
 * @brief get next tuple with group id attached, here assume that all tuples are sorted by group keys
207
 * @param [in, out] pBlock the output block, the group id will be saved in it
208
 * @retval NULL if next group tuple arrived and this new group tuple will be saved in pInfo.pSavedTuple
209
 */
210
static int32_t nextTupleWithGroupId(SSortHandle* pHandle, SSortOperatorInfo* pInfo, SSDataBlock* pBlock,
×
211
                                    STupleHandle** pTupleHandle) {
212
  QRY_PARAM_CHECK(pTupleHandle);
×
213

214
  int32_t       code = 0;
×
215
  STupleHandle* retTuple = pInfo->pGroupIdCalc->pSavedTuple;
×
216
  if (!retTuple) {
×
217
    code = tsortNextTuple(pHandle, &retTuple);
×
218
    if (code) {
×
219
      qError("failed to get next tuple, code:%s", tstrerror(code));
×
220
      return code;
×
221
    }
222
  }
223

224
  if (retTuple) {
×
225
    int32_t newGroup;
226
    if (pInfo->pGroupIdCalc->pSavedTuple) {
×
227
      newGroup = true;
×
228
      pInfo->pGroupIdCalc->pSavedTuple = NULL;
×
229
    } else {
230
      newGroup = tsortCompAndBuildKeys(pInfo->pGroupIdCalc->pSortColsArr, pInfo->pGroupIdCalc->keyBuf,
×
231
                                       &pInfo->pGroupIdCalc->lastKeysLen, retTuple);
×
232
    }
233

234
    bool emptyBlock = (pBlock->info.rows == 0);
×
235
    if (newGroup) {
×
236
      if (!emptyBlock) {
×
237
        // new group arrived, and we have already copied some tuples for cur group, save the new group tuple, return
238
        // NULL. Note that the keyBuf and lastKeysLen has been updated to new value
239
        pInfo->pGroupIdCalc->pSavedTuple = retTuple;
×
240
        retTuple = NULL;
×
241
      } else {
242
        // new group with empty block
243
        pInfo->pGroupIdCalc->lastGroupId = pBlock->info.id.groupId =
×
244
            calcGroupId(pInfo->pGroupIdCalc->keyBuf, pInfo->pGroupIdCalc->lastKeysLen);
×
245
      }
246
    } else {
247
      if (emptyBlock) {
×
248
        // new block but not new group, assign last group id to it
249
        pBlock->info.id.groupId = pInfo->pGroupIdCalc->lastGroupId;
×
250
      } else {
251
        // not new group and not empty block and ret NOT NULL, just return the tuple
252
      }
253
    }
254
  }
255

256
  *pTupleHandle = retTuple;
×
257
  return code;
×
258
}
259

260
static int32_t getSortedBlockData(SSortHandle* pHandle, SSDataBlock* pDataBlock, int32_t capacity, SArray* pColMatchInfo,
96✔
261
                                SSortOperatorInfo* pInfo, SSDataBlock** pResBlock) {
262
  QRY_PARAM_CHECK(pResBlock);
96!
263
  blockDataCleanup(pDataBlock);
96✔
264

265
  int32_t       lino = 0;
96✔
266
  int32_t       code = 0;
96✔
267
  STupleHandle* pTupleHandle = NULL;
96✔
268
  SSDataBlock*  p = NULL;
96✔
269

270
  code = tsortGetSortedDataBlock(pHandle, &p);
96✔
271
  if (p == NULL || (code != 0)) {
96!
272
    return code;
×
273
  }
274

275
  code = blockDataEnsureCapacity(p, capacity);
96✔
276
  QUERY_CHECK_CODE(code, lino, _error);
96!
277

278
  while (1) {
279
    if (pInfo->pGroupIdCalc) {
3,103!
280
      code = nextTupleWithGroupId(pHandle, pInfo, p, &pTupleHandle);
×
281
    } else {
282
      code = tsortNextTuple(pHandle, &pTupleHandle);
3,103✔
283
    }
284

285
    TSDB_CHECK_CODE(code, lino, _error);
3,103!
286
    if (pTupleHandle == NULL) {
3,103✔
287
      break;
96✔
288
    }
289

290
    code = appendOneRowToDataBlock(p, pTupleHandle);
3,007✔
291
    QUERY_CHECK_CODE(code, lino, _error);
3,007!
292

293
    if (p->info.rows >= capacity) {
3,007!
294
      break;
×
295
    }
296
  }
297

298
  QUERY_CHECK_CODE(code, lino, _error);
96!
299

300
  if (p->info.rows > 0) {
96✔
301
    code = blockDataEnsureCapacity(pDataBlock, capacity);
48✔
302
    QUERY_CHECK_CODE(code, lino, _error);
48!
303

304
    // todo extract function to handle this
305
    int32_t numOfCols = taosArrayGetSize(pColMatchInfo);
48✔
306
    for (int32_t i = 0; i < numOfCols; ++i) {
171✔
307
      SColMatchItem* pmInfo = taosArrayGet(pColMatchInfo, i);
123✔
308
      QUERY_CHECK_NULL(pmInfo, code, lino, _error, terrno);
123!
309

310
      SColumnInfoData* pSrc = taosArrayGet(p->pDataBlock, pmInfo->srcSlotId);
123✔
311
      QUERY_CHECK_NULL(pSrc, code, lino, _error, terrno);
123!
312

313
      SColumnInfoData* pDst = taosArrayGet(pDataBlock->pDataBlock, pmInfo->dstSlotId);
123✔
314
      QUERY_CHECK_NULL(pDst, code, lino, _error, terrno);
123!
315

316
      code = colDataAssign(pDst, pSrc, p->info.rows, &pDataBlock->info);
123✔
317
      QUERY_CHECK_CODE(code, lino, _error);
123!
318
    }
319

320
    pDataBlock->info.dataLoad = 1;
48✔
321
    pDataBlock->info.rows = p->info.rows;
48✔
322
    pDataBlock->info.scanFlag = p->info.scanFlag;
48✔
323
    pDataBlock->info.id.groupId = p->info.id.groupId;
48✔
324
  }
325

326
  blockDataDestroy(p);
96✔
327
  *pResBlock = (pDataBlock->info.rows > 0) ? pDataBlock : NULL;
96✔
328
  return code;
96✔
329

330
  _error:
×
331
  qError("%s failed at line %d since %s", __func__, lino, tstrerror(code));
×
332

333
  blockDataDestroy(p);
×
334
  return code;
×
335
}
336

337
int32_t loadNextDataBlock(void* param, SSDataBlock** ppBlock) {
106✔
338
  SOperatorInfo* pOperator = (SOperatorInfo*)param;
106✔
339
  int32_t        code = pOperator->fpSet.getNextFn(pOperator, ppBlock);
106✔
340
  if (code) {
105!
341
    qError("failed to get next data block from upstream, %s code:%s", __func__, tstrerror(code));
×
342
  } else {
343
    code = blockDataCheck(*ppBlock);
105✔
344
    if (code) {
105!
345
      qError("failed to check block data, %s code:%s", __func__, tstrerror(code));
×
346
    }
347
  }
348
  return code;
105✔
349
}
350

351
// todo refactor: merged with fetch fp
352
void applyScalarFunction(SSDataBlock* pBlock, void* param) {
56✔
353
  SOperatorInfo*     pOperator = param;
56✔
354
  SSortOperatorInfo* pSort = pOperator->info;
56✔
355
  if (pOperator->exprSupp.pExprInfo != NULL && pOperator->exprSupp.numOfExprs > 0) {
56!
356
    int32_t code = projectApplyFunctions(pOperator->exprSupp.pExprInfo, pBlock, pBlock, pOperator->exprSupp.pCtx,
1✔
357
                                         pOperator->exprSupp.numOfExprs, NULL);
358
    if (code != TSDB_CODE_SUCCESS) {
1!
359
      T_LONG_JMP(pOperator->pTaskInfo->env, code);
×
360
    }
361
  }
362
}
56✔
363

364
int32_t doOpenSortOperator(SOperatorInfo* pOperator) {
98✔
365
  SSortOperatorInfo* pInfo = pOperator->info;
98✔
366
  SExecTaskInfo*     pTaskInfo = pOperator->pTaskInfo;
98✔
367
  int32_t            code = TSDB_CODE_SUCCESS;
98✔
368
  int32_t            lino = 0;
98✔
369
  SSortSource* pSource =NULL;
98✔
370

371
  if (OPTR_IS_OPENED(pOperator)) {
98✔
372
    return code;
48✔
373
  }
374

375
  pInfo->startTs = taosGetTimestampUs();
50✔
376
  //  pInfo->binfo.pRes is not equalled to the input datablock.
377
  pInfo->pSortHandle = NULL;
50✔
378
  code =
379
      tsortCreateSortHandle(pInfo->pSortInfo, SORT_SINGLESOURCE_SORT, -1, -1, NULL, pTaskInfo->id.str, pInfo->maxRows,
50✔
380
                            pInfo->maxTupleLength, tsPQSortMemThreshold * 1024 * 1024, &pInfo->pSortHandle);
50✔
381
  QUERY_CHECK_CODE(code, lino, _end);
50!
382

383
  tsortSetFetchRawDataFp(pInfo->pSortHandle, loadNextDataBlock, applyScalarFunction, pOperator);
50✔
384

385
  pSource = taosMemoryCalloc(1, sizeof(SSortSource));
50!
386
  QUERY_CHECK_NULL(pSource, code, lino, _end, terrno);
50!
387

388
  pSource->param = pOperator->pDownstream[0];
50✔
389
  pSource->onlyRef = true;
50✔
390

391
  code = tsortAddSource(pInfo->pSortHandle, pSource);
50✔
392
  QUERY_CHECK_CODE(code, lino, _end);
50!
393
  pSource = NULL;
50✔
394

395
  code = tsortOpen(pInfo->pSortHandle);
50✔
396
  QUERY_CHECK_CODE(code, lino, _end);
48!
397
  pOperator->cost.openCost = (taosGetTimestampUs() - pInfo->startTs) / 1000.0;
48✔
398
  pOperator->status = OP_RES_TO_RETURN;
48✔
399
  OPTR_SET_OPENED(pOperator);
48✔
400

401
_end:
48✔
402
  if (pSource) {
48!
403
    taosMemoryFree(pSource);
×
404
  }
405
  if (code != TSDB_CODE_SUCCESS) {
48!
406
    qError("%s failed at line %d since %s", __func__, lino, tstrerror(code));
×
407
    pTaskInfo->code = code;
×
408
    T_LONG_JMP(pTaskInfo->env, code);
×
409
  }
410
  return code;
48✔
411
}
412

413
int32_t doSort(SOperatorInfo* pOperator, SSDataBlock** pResBlock) {
98✔
414
  QRY_PARAM_CHECK(pResBlock);
98!
415
  int32_t code = TSDB_CODE_SUCCESS;
98✔
416
  int32_t lino = 0;
98✔
417
  if (pOperator->status == OP_EXEC_DONE) {
98!
418
    return code;
×
419
  }
420

421
  SExecTaskInfo*     pTaskInfo = pOperator->pTaskInfo;
98✔
422
  SSortOperatorInfo* pInfo = pOperator->info;
98✔
423

424
  code = pOperator->fpSet._openFn(pOperator);
98✔
425
  QUERY_CHECK_CODE(code, lino, _end);
96!
426

427
  // multi-group case not handle here
428
  SSDataBlock* pBlock = NULL;
96✔
429
  while (1) {
×
430
    if (tsortIsClosed(pInfo->pSortHandle)) {
96!
431
      code = TSDB_CODE_TSC_QUERY_CANCELLED;
×
432
      QUERY_CHECK_CODE(code, lino, _end);
×
433
    }
434

435
    code = getSortedBlockData(pInfo->pSortHandle, pInfo->binfo.pRes, pOperator->resultInfo.capacity,
96✔
436
                                pInfo->matchInfo.pList, pInfo, &pBlock);
437
    QUERY_CHECK_CODE(code, lino, _end);
96!
438
    if (pBlock == NULL) {
96✔
439
      setOperatorCompleted(pOperator);
48✔
440
      return code;
48✔
441
    }
442

443
    code = doFilter(pBlock, pOperator->exprSupp.pFilterInfo, &pInfo->matchInfo);
48✔
444
    QUERY_CHECK_CODE(code, lino, _end);
48!
445

446
    if (blockDataGetNumOfRows(pBlock) == 0) {
48!
447
      continue;
×
448
    }
449

450
    // there are bugs?
451
    bool limitReached = applyLimitOffset(&pInfo->limitInfo, pBlock, pTaskInfo);
48✔
452
    if (limitReached) {
48!
453
      resetLimitInfoForNextGroup(&pInfo->limitInfo);
×
454
    }
455

456
    pOperator->resultInfo.totalRows += pBlock->info.rows;
48✔
457
    if (pBlock->info.rows > 0) {
48!
458
      break;
48✔
459
    }
460
  }
461

462
  *pResBlock = blockDataGetNumOfRows(pBlock) > 0 ? pBlock : NULL;
48!
463
_end:
48✔
464
  if (code != TSDB_CODE_SUCCESS) {
48!
465
    qError("%s failed at line %d since %s", __func__, lino, tstrerror(code));
×
466
    pTaskInfo->code = code;
×
467
    T_LONG_JMP(pTaskInfo->env, code);
×
468
  }
469
  return code;
48✔
470
}
471

472
void destroySortOperatorInfo(void* param) {
50✔
473
  SSortOperatorInfo* pInfo = (SSortOperatorInfo*)param;
50✔
474
  blockDataDestroy(pInfo->binfo.pRes);
50✔
475
  pInfo->binfo.pRes = NULL;
50✔
476

477
  tsortDestroySortHandle(pInfo->pSortHandle);
50✔
478
  taosArrayDestroy(pInfo->pSortInfo);
50✔
479
  taosArrayDestroy(pInfo->matchInfo.pList);
50✔
480
  destroySortOpGroupIdCalc(pInfo->pGroupIdCalc);
50✔
481
  taosMemoryFreeClear(param);
50!
482
}
50✔
483

484
int32_t getExplainExecInfo(SOperatorInfo* pOptr, void** pOptrExplain, uint32_t* len) {
×
485
  SSortExecInfo* pInfo = taosMemoryCalloc(1, sizeof(SSortExecInfo));
×
486
  if (pInfo == NULL) {
×
487
    return terrno;
×
488
  }
489

490
  SSortOperatorInfo* pOperatorInfo = (SSortOperatorInfo*)pOptr->info;
×
491

492
  *pInfo = tsortGetSortExecInfo(pOperatorInfo->pSortHandle);
×
493
  *pOptrExplain = pInfo;
×
494
  *len = sizeof(SSortExecInfo);
×
495
  return TSDB_CODE_SUCCESS;
×
496
}
497

498
static void calcSortOperMaxTupleLength(SSortOperatorInfo* pSortOperInfo, SNodeList* pSortKeys) {
50✔
499
  SColMatchInfo* pColItem = &pSortOperInfo->matchInfo;
50✔
500
  size_t         size = taosArrayGetSize(pColItem->pList);
50✔
501
  for (size_t i = 0; i < size; ++i) {
175✔
502
    SColMatchItem* pInfo = taosArrayGet(pColItem->pList, i);
125✔
503
    if (pInfo == NULL) {
125!
504
      continue;
×
505
    }
506

507
    pSortOperInfo->maxTupleLength += pInfo->dataType.bytes;
125✔
508
  }
509

510
  size = LIST_LENGTH(pSortKeys);
50!
511
  for (size_t i = 0; i < size; ++i) {
129✔
512
    SOrderByExprNode* pOrderExprNode = (SOrderByExprNode*)nodesListGetNode(pSortKeys, i);
79✔
513
    pSortOperInfo->maxTupleLength += ((SColumnNode*)pOrderExprNode->pExpr)->node.resType.bytes;
79✔
514
  }
515
}
50✔
516

517
static void destroySortOpGroupIdCalc(SSortOpGroupIdCalc* pCalc) {
50✔
518
  if (pCalc) {
50!
519
    taosArrayDestroy(pCalc->pSortColsArr);
×
520
    taosMemoryFree(pCalc->keyBuf);
×
521
    taosMemoryFree(pCalc);
×
522
  }
523
}
50✔
524

525
//=====================================================================================
526
// Group Sort Operator
527
typedef enum EChildOperatorStatus { CHILD_OP_NEW_GROUP, CHILD_OP_SAME_GROUP, CHILD_OP_FINISHED } EChildOperatorStatus;
528

529
typedef struct SGroupSortOperatorInfo {
530
  SOptrBasicInfo       binfo;
531
  SArray*              pSortInfo;
532
  SColMatchInfo        matchInfo;
533
  int64_t              startTs;
534
  uint64_t             sortElapsed;
535
  bool                 hasGroupId;
536
  uint64_t             currGroupId;
537
  SSDataBlock*         prefetchedSortInput;
538
  SSortHandle*         pCurrSortHandle;
539
  EChildOperatorStatus childOpStatus;
540
  SSortExecInfo        sortExecInfo;
541
} SGroupSortOperatorInfo;
542

543
int32_t getGroupSortedBlockData(SSortHandle* pHandle, SSDataBlock* pDataBlock, int32_t capacity, SArray* pColMatchInfo,
×
544
                                SGroupSortOperatorInfo* pInfo, SSDataBlock** pResBlock) {
545
  QRY_PARAM_CHECK(pResBlock);
×
546

547
  blockDataCleanup(pDataBlock);
×
548
  int32_t code = blockDataEnsureCapacity(pDataBlock, capacity);
×
549
  if (code) {
×
550
    return code;
×
551
  }
552

553
  SSDataBlock* p = NULL;
×
554
  code = tsortGetSortedDataBlock(pHandle, &p);
×
555
  if (p == NULL || (code != 0)) {
×
556
    return code;
×
557
  }
558

559
  code = blockDataEnsureCapacity(p, capacity);
×
560
  if (code) {
×
561
    return code;
×
562
  }
563

564
  while (1) {
×
565
    STupleHandle* pTupleHandle = NULL;
×
566
    code = tsortNextTuple(pHandle, &pTupleHandle);
×
567
    if (pTupleHandle == NULL || code != 0) {
×
568
      break;
569
    }
570

571
    code = appendOneRowToDataBlock(p, pTupleHandle);
×
572
    if (code) {
×
573
      break;
×
574
    }
575

576
    if (p->info.rows >= capacity) {
×
577
      break;
×
578
    }
579
  }
580

581
  if (p->info.rows > 0) {
×
582
    int32_t numOfCols = taosArrayGetSize(pColMatchInfo);
×
583
    for (int32_t i = 0; i < numOfCols; ++i) {
×
584
      SColMatchItem* pmInfo = taosArrayGet(pColMatchInfo, i);
×
585
      if (pmInfo == NULL) {
×
586
        return terrno;
×
587
      }
588

589
      SColumnInfoData* pSrc = taosArrayGet(p->pDataBlock, pmInfo->srcSlotId);
×
590
      if (pSrc == NULL) {
×
591
        return terrno;
×
592
      }
593

594
      SColumnInfoData* pDst = taosArrayGet(pDataBlock->pDataBlock, pmInfo->dstSlotId);
×
595
      if (pDst == NULL) {
×
596
        return terrno;
×
597
      }
598

599
      code = colDataAssign(pDst, pSrc, p->info.rows, &pDataBlock->info);
×
600
      if (code) {
×
601
        return code;
×
602
      }
603
    }
604

605
    pDataBlock->info.rows = p->info.rows;
×
606
    pDataBlock->info.capacity = p->info.rows;
×
607
    pDataBlock->info.scanFlag = p->info.scanFlag;
×
608
  }
609

610
  blockDataDestroy(p);
×
611
  *pResBlock = (pDataBlock->info.rows > 0) ? pDataBlock : NULL;
×
612
  return code;
×
613
}
614

615
typedef struct SGroupSortSourceParam {
616
  SOperatorInfo*          childOpInfo;
617
  SGroupSortOperatorInfo* grpSortOpInfo;
618
} SGroupSortSourceParam;
619

620
int32_t fetchNextGroupSortDataBlock(void* param, SSDataBlock** ppBlock) {
×
621
  int32_t                 code = 0;
×
622
  int32_t                 lino = 0;
×
623
  SGroupSortSourceParam*  source = param;
×
624
  SGroupSortOperatorInfo* grpSortOpInfo = source->grpSortOpInfo;
×
625
  SSDataBlock*            block = NULL;
×
626

627
  QRY_PARAM_CHECK(ppBlock);
×
628

629
  if (grpSortOpInfo->prefetchedSortInput) {
×
630
    block = grpSortOpInfo->prefetchedSortInput;
×
631
    grpSortOpInfo->prefetchedSortInput = NULL;
×
632
    *ppBlock = block;
×
633
  } else {
634
    SOperatorInfo* childOp = source->childOpInfo;
×
635
    code = childOp->fpSet.getNextFn(childOp, &block);
×
636
    QUERY_CHECK_CODE(code, lino, _end);
×
637

638
    if (block != NULL) {
×
639
      code = blockDataCheck(block);
×
640
      QUERY_CHECK_CODE(code, lino, _end);
×
641
      if (block->info.id.groupId == grpSortOpInfo->currGroupId) {
×
642
        grpSortOpInfo->childOpStatus = CHILD_OP_SAME_GROUP;
×
643
        *ppBlock = block;
×
644
      } else {
645
        grpSortOpInfo->childOpStatus = CHILD_OP_NEW_GROUP;
×
646
        grpSortOpInfo->prefetchedSortInput = block;
×
647
      }
648
    } else {
649
      grpSortOpInfo->childOpStatus = CHILD_OP_FINISHED;
×
650
    }
651
  }
652

653
  return code;
×
654
_end:
×
655
  if (code != 0) {
×
656
    qError("%s failed at line %d since %s", __func__, lino, tstrerror(code));
×
657
  }
658
  return code;
×
659
}
660

661
int32_t beginSortGroup(SOperatorInfo* pOperator) {
×
662
  SGroupSortOperatorInfo* pInfo = pOperator->info;
×
663
  SExecTaskInfo*          pTaskInfo = pOperator->pTaskInfo;
×
664

665
  //  pInfo->binfo.pRes is not equalled to the input datablock.
666
  pInfo->pCurrSortHandle = NULL;
×
667

668
  int32_t code = tsortCreateSortHandle(pInfo->pSortInfo, SORT_SINGLESOURCE_SORT, -1, -1, NULL, pTaskInfo->id.str, 0, 0,
×
669
                                       0, &pInfo->pCurrSortHandle);
670
  if (code) {
×
671
    return code;
×
672
  }
673

674
  tsortSetFetchRawDataFp(pInfo->pCurrSortHandle, fetchNextGroupSortDataBlock, applyScalarFunction, pOperator);
×
675

676
  SSortSource*           ps = taosMemoryCalloc(1, sizeof(SSortSource));
×
677
  SGroupSortSourceParam* param = taosMemoryCalloc(1, sizeof(SGroupSortSourceParam));
×
678
  if (ps == NULL || param == NULL) {
×
679
    taosMemoryFree(ps);
×
680
    taosMemoryFree(param);
×
681
    return terrno;
×
682
  }
683

684
  param->childOpInfo = pOperator->pDownstream[0];
×
685
  param->grpSortOpInfo = pInfo;
×
686

687
  ps->param = param;
×
688
  ps->onlyRef = false;
×
689
  code = tsortAddSource(pInfo->pCurrSortHandle, ps);
×
690
  if (code != 0) {
×
691
    return code;
×
692
  }
693

694
  code = tsortOpen(pInfo->pCurrSortHandle);
×
695
  return code;
×
696
}
697

698
int32_t finishSortGroup(SOperatorInfo* pOperator) {
×
699
  SGroupSortOperatorInfo* pInfo = pOperator->info;
×
700

701
  SSortExecInfo sortExecInfo = tsortGetSortExecInfo(pInfo->pCurrSortHandle);
×
702

703
  pInfo->sortExecInfo.sortMethod = sortExecInfo.sortMethod;
×
704
  pInfo->sortExecInfo.sortBuffer = sortExecInfo.sortBuffer;
×
705
  pInfo->sortExecInfo.loops += sortExecInfo.loops;
×
706
  pInfo->sortExecInfo.readBytes += sortExecInfo.readBytes;
×
707
  pInfo->sortExecInfo.writeBytes += sortExecInfo.writeBytes;
×
708

709
  tsortDestroySortHandle(pInfo->pCurrSortHandle);
×
710
  pInfo->pCurrSortHandle = NULL;
×
711

712
  return TSDB_CODE_SUCCESS;
×
713
}
714

715
int32_t doGroupSort(SOperatorInfo* pOperator, SSDataBlock** pResBlock) {
×
716
  QRY_PARAM_CHECK(pResBlock);
×
717
  SExecTaskInfo*          pTaskInfo = pOperator->pTaskInfo;
×
718
  SGroupSortOperatorInfo* pInfo = pOperator->info;
×
719
  int32_t                 code = TSDB_CODE_SUCCESS;
×
720
  int32_t                 lino = 0;
×
721

722
  if (pOperator->status == OP_EXEC_DONE) {
×
723
    return code;
×
724
  }
725

726
  code = pOperator->fpSet._openFn(pOperator);
×
727
  QUERY_CHECK_CODE(code, lino, _end);
×
728

729
  if (!pInfo->hasGroupId) {
×
730
    pInfo->hasGroupId = true;
×
731

732
    pInfo->prefetchedSortInput = getNextBlockFromDownstream(pOperator, 0);
×
733
    if (pInfo->prefetchedSortInput == NULL) {
×
734
      setOperatorCompleted(pOperator);
×
735
      return code;
×
736
    }
737

738
    pInfo->currGroupId = pInfo->prefetchedSortInput->info.id.groupId;
×
739
    pInfo->childOpStatus = CHILD_OP_NEW_GROUP;
×
740
    code = beginSortGroup(pOperator);
×
741
    QUERY_CHECK_CODE(code, lino, _end);
×
742
  }
743

744
  SSDataBlock* pBlock = NULL;
×
745
  while (pInfo->pCurrSortHandle != NULL) {
×
746
    if (tsortIsClosed(pInfo->pCurrSortHandle)) {
×
747
      code = TSDB_CODE_TSC_QUERY_CANCELLED;
×
748
      QUERY_CHECK_CODE(code, lino, _end);
×
749
    }
750

751
    // beginSortGroup would fetch all child blocks of pInfo->currGroupId;
752
    if (pInfo->childOpStatus == CHILD_OP_SAME_GROUP) {
×
753
      code = TSDB_CODE_QRY_EXECUTOR_INTERNAL_ERROR;
×
754
      QUERY_CHECK_CODE(code, lino, _end);
×
755
    }
756

757
    code = getGroupSortedBlockData(pInfo->pCurrSortHandle, pInfo->binfo.pRes, pOperator->resultInfo.capacity,
×
758
                                     pInfo->matchInfo.pList, pInfo, &pBlock);
759
    QUERY_CHECK_CODE(code, lino, _end);
×
760
    if (pBlock != NULL) {
×
761
      pBlock->info.id.groupId = pInfo->currGroupId;
×
762
      pOperator->resultInfo.totalRows += pBlock->info.rows;
×
763
      *pResBlock = pBlock;
×
764
      return code;
×
765
    } else {
766
      if (pInfo->childOpStatus == CHILD_OP_NEW_GROUP) {
×
767
        (void) finishSortGroup(pOperator);
×
768
        pInfo->currGroupId = pInfo->prefetchedSortInput->info.id.groupId;
×
769
        code = beginSortGroup(pOperator);
×
770
        QUERY_CHECK_CODE(code, lino, _end);
×
771
      } else if (pInfo->childOpStatus == CHILD_OP_FINISHED) {
×
772
        (void) finishSortGroup(pOperator);
×
773
        setOperatorCompleted(pOperator);
×
774
        return code;
×
775
      }
776
    }
777
  }
778

779
_end:
×
780
  if (code != TSDB_CODE_SUCCESS) {
×
781
    qError("%s failed at line %d since %s", __func__, lino, tstrerror(code));
×
782
    pTaskInfo->code = code;
×
783
    T_LONG_JMP(pTaskInfo->env, code);
×
784
  }
785
  return code;
×
786
}
787

788
int32_t getGroupSortExplainExecInfo(SOperatorInfo* pOptr, void** pOptrExplain, uint32_t* len) {
×
789
  SGroupSortOperatorInfo* pInfo = (SGroupSortOperatorInfo*)pOptr->info;
×
790
  *pOptrExplain = &pInfo->sortExecInfo;
×
791
  *len = sizeof(SSortExecInfo);
×
792
  return TSDB_CODE_SUCCESS;
×
793
}
794

795
void destroyGroupSortOperatorInfo(void* param) {
×
796
  SGroupSortOperatorInfo* pInfo = (SGroupSortOperatorInfo*)param;
×
797
  blockDataDestroy(pInfo->binfo.pRes);
×
798
  pInfo->binfo.pRes = NULL;
×
799

800
  taosArrayDestroy(pInfo->pSortInfo);
×
801
  taosArrayDestroy(pInfo->matchInfo.pList);
×
802

803
  tsortDestroySortHandle(pInfo->pCurrSortHandle);
×
804
  pInfo->pCurrSortHandle = NULL;
×
805

806
  taosMemoryFreeClear(param);
×
807
}
×
808

809
int32_t createGroupSortOperatorInfo(SOperatorInfo* downstream, SGroupSortPhysiNode* pSortPhyNode,
×
810
                                    SExecTaskInfo* pTaskInfo, SOperatorInfo** pOptrInfo) {
811
  QRY_PARAM_CHECK(pOptrInfo);
×
812
  int32_t code = 0;
×
813
  int32_t lino = 0;
×
814

815
  SGroupSortOperatorInfo* pInfo = taosMemoryCalloc(1, sizeof(SGroupSortOperatorInfo));
×
816
  SOperatorInfo*          pOperator = taosMemoryCalloc(1, sizeof(SOperatorInfo));
×
817
  if (pInfo == NULL || pOperator == NULL) {
×
818
    code = terrno;
×
819
    goto _error;
×
820
  }
821

822
  SExprSupp*          pSup = &pOperator->exprSupp;
×
823
  SDataBlockDescNode* pDescNode = pSortPhyNode->node.pOutputDataBlockDesc;
×
824

825
  int32_t    numOfCols = 0;
×
826
  SExprInfo* pExprInfo = NULL;
×
827
  code = createExprInfo(pSortPhyNode->pExprs, NULL, &pExprInfo, &numOfCols);
×
828
  QUERY_CHECK_CODE(code, lino, _error);
×
829

830
  pSup->pExprInfo = pExprInfo;
×
831
  pSup->numOfExprs = numOfCols;
×
832

833
  initResultSizeInfo(&pOperator->resultInfo, 1024);
×
834
  pOperator->exprSupp.pCtx = createSqlFunctionCtx(pExprInfo, numOfCols, &pOperator->exprSupp.rowEntryInfoOffset,
×
835
                                                  &pTaskInfo->storageAPI.functionStore);
836
  QUERY_CHECK_NULL(pOperator->exprSupp.pCtx, code, lino, _error, terrno);
×
837

838
  pInfo->binfo.pRes = createDataBlockFromDescNode(pDescNode);
×
839
  QUERY_CHECK_NULL(pInfo->binfo.pRes, code, lino, _error, terrno);
×
840

841
  code = blockDataEnsureCapacity(pInfo->binfo.pRes, pOperator->resultInfo.capacity);
×
842
  TSDB_CHECK_CODE(code, lino, _error);
×
843

844
  pInfo->binfo.inputTsOrder = pSortPhyNode->node.inputTsOrder;
×
845
  pInfo->binfo.outputTsOrder = pSortPhyNode->node.outputTsOrder;
×
846

847
  int32_t numOfOutputCols = 0;
×
848
  code = extractColMatchInfo(pSortPhyNode->pTargets, pDescNode, &numOfOutputCols, COL_MATCH_FROM_SLOT_ID,
×
849
                             &pInfo->matchInfo);
850
  TSDB_CHECK_CODE(code, lino, _error);
×
851

852
  pInfo->pSortInfo = createSortInfo(pSortPhyNode->pSortKeys);
×
853
  setOperatorInfo(pOperator, "GroupSortOperator", QUERY_NODE_PHYSICAL_PLAN_GROUP_SORT, false, OP_NOT_OPENED, pInfo,
×
854
                  pTaskInfo);
855
  pOperator->fpSet = createOperatorFpSet(optrDummyOpenFn, doGroupSort, NULL, destroyGroupSortOperatorInfo,
×
856
                                         optrDefaultBufFn, getGroupSortExplainExecInfo, optrDefaultGetNextExtFn, NULL);
857

858
  code = appendDownstream(pOperator, &downstream, 1);
×
859
  if (code != TSDB_CODE_SUCCESS) {
×
860
    goto _error;
×
861
  }
862

863
  *pOptrInfo = pOperator;
×
864
  return TSDB_CODE_SUCCESS;
×
865

866
_error:
×
867
  pTaskInfo->code = code;
×
868
  if (pInfo != NULL) {
×
869
    destroyGroupSortOperatorInfo(pInfo);
×
870
  }
871
  destroyOperatorAndDownstreams(pOperator, &downstream, 1);
×
872
  return code;
×
873
}
STATUS · Troubleshooting · Open an Issue · Sales · Support · CAREERS · ENTERPRISE · START FREE · SCHEDULE DEMO
ANNOUNCEMENTS · TWITTER · TOS & SLA · Supported CI Services · What's a CI service? · Automated Testing

© 2026 Coveralls, Inc