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

taosdata / TDengine / #3796

31 Mar 2025 10:39AM UTC coverage: 30.372% (-7.1%) from 37.443%
#3796

push

travis-ci

happyguoxy
test:add test cases

69287 of 309062 branches covered (22.42%)

Branch coverage included in aggregate %.

118044 of 307720 relevant lines covered (38.36%)

278592.15 hits per line

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

0.0
/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) {
×
58
  QRY_PARAM_CHECK(pOptrInfo);
×
59

60
  int32_t code = 0;
×
61
  int32_t lino = 0;
×
62

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

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

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

77
  pOperator->exprSupp.numOfExprs = numOfCols;
×
78
  int32_t numOfOutputCols = 0;
×
79
  code =
80
      extractColMatchInfo(pSortNode->pTargets, pDescNode, &numOfOutputCols, COL_MATCH_FROM_SLOT_ID, &pInfo->matchInfo);
×
81
  if (code != TSDB_CODE_SUCCESS) {
×
82
    goto _error;
×
83
  }
84
  
85
  calcSortOperMaxTupleLength(pInfo, pSortNode->pSortKeys);
×
86
  pInfo->maxRows = -1;
×
87
  if (pSortNode->node.pLimit && ((SLimitNode*)pSortNode->node.pLimit)->limit) {
×
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 =
×
95
      createSqlFunctionCtx(pOperator->exprSupp.pExprInfo, numOfCols, &pOperator->exprSupp.rowEntryInfoOffset, &pTaskInfo->storageAPI.functionStore);
×
96
  QUERY_CHECK_NULL(pOperator->exprSupp.pCtx, code, lino, _error, terrno);
×
97
  initResultSizeInfo(&pOperator->resultInfo, 1024);
×
98
  code = filterInitFromNode((SNode*)pSortNode->node.pConditions, &pOperator->exprSupp.pFilterInfo, 0);
×
99
  if (code != TSDB_CODE_SUCCESS) {
×
100
    goto _error;
×
101
  }
102

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

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

109
  if (pSortNode->calcGroupId) {
×
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;
×
138

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

143
  setOperatorInfo(pOperator, "SortOperator", QUERY_NODE_PHYSICAL_PLAN_SORT, true, OP_NOT_OPENED, pInfo, pTaskInfo);
×
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);
×
153

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

159
  *pOptrInfo = pOperator;
×
160
  return TSDB_CODE_SUCCESS;
×
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) {
×
172
  int32_t code = 0;
×
173
  for (int32_t i = 0; i < taosArrayGetSize(pBlock->pDataBlock); ++i) {
×
174
    SColumnInfoData* pColInfo = taosArrayGet(pBlock->pDataBlock, i);
×
175
    if (pColInfo == NULL) {
×
176
      return terrno;
×
177
    }
178

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

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

195
  pBlock->info.dataLoad = 1;
×
196

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

200
  pBlock->info.scanFlag = info.scanFlag;
×
201
  pBlock->info.rows += 1;
×
202
  return code;
×
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,
×
261
                                SSortOperatorInfo* pInfo, SSDataBlock** pResBlock) {
262
  QRY_PARAM_CHECK(pResBlock);
×
263
  blockDataCleanup(pDataBlock);
×
264

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

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

275
  code = blockDataEnsureCapacity(p, capacity);
×
276
  QUERY_CHECK_CODE(code, lino, _error);
×
277

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

285
    TSDB_CHECK_CODE(code, lino, _error);
×
286
    if (pTupleHandle == NULL) {
×
287
      break;
×
288
    }
289

290
    code = appendOneRowToDataBlock(p, pTupleHandle);
×
291
    QUERY_CHECK_CODE(code, lino, _error);
×
292

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

298
  QUERY_CHECK_CODE(code, lino, _error);
×
299

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

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

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

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

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

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

326
  blockDataDestroy(p);
×
327
  *pResBlock = (pDataBlock->info.rows > 0) ? pDataBlock : NULL;
×
328
  return code;
×
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) {
×
338
  SOperatorInfo* pOperator = (SOperatorInfo*)param;
×
339
  int32_t        code = pOperator->fpSet.getNextFn(pOperator, ppBlock);
×
340
  if (code) {
×
341
    qError("failed to get next data block from upstream, %s code:%s", __func__, tstrerror(code));
×
342
  } else {
343
    code = blockDataCheck(*ppBlock);
×
344
    if (code) {
×
345
      qError("failed to check block data, %s code:%s", __func__, tstrerror(code));
×
346
    }
347
  }
348
  return code;
×
349
}
350

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

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

371
  if (OPTR_IS_OPENED(pOperator)) {
×
372
    return code;
×
373
  }
374

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

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

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

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

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

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

401
_end:
×
402
  if (pSource) {
×
403
    taosMemoryFree(pSource);
×
404
  }
405
  if (code != TSDB_CODE_SUCCESS) {
×
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;
×
411
}
412

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

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

424
  code = pOperator->fpSet._openFn(pOperator);
×
425
  QUERY_CHECK_CODE(code, lino, _end);
×
426

427
  // multi-group case not handle here
428
  SSDataBlock* pBlock = NULL;
×
429
  while (1) {
×
430
    if (tsortIsClosed(pInfo->pSortHandle)) {
×
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,
×
436
                                pInfo->matchInfo.pList, pInfo, &pBlock);
437
    QUERY_CHECK_CODE(code, lino, _end);
×
438
    if (pBlock == NULL) {
×
439
      setOperatorCompleted(pOperator);
×
440
      return code;
×
441
    }
442

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

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

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

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

462
  *pResBlock = blockDataGetNumOfRows(pBlock) > 0 ? pBlock : NULL;
×
463
_end:
×
464
  if (code != TSDB_CODE_SUCCESS) {
×
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;
×
470
}
471

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

477
  tsortDestroySortHandle(pInfo->pSortHandle);
×
478
  taosArrayDestroy(pInfo->pSortInfo);
×
479
  taosArrayDestroy(pInfo->matchInfo.pList);
×
480
  destroySortOpGroupIdCalc(pInfo->pGroupIdCalc);
×
481
  taosMemoryFreeClear(param);
×
482
}
×
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) {
×
499
  SColMatchInfo* pColItem = &pSortOperInfo->matchInfo;
×
500
  size_t         size = taosArrayGetSize(pColItem->pList);
×
501
  for (size_t i = 0; i < size; ++i) {
×
502
    SColMatchItem* pInfo = taosArrayGet(pColItem->pList, i);
×
503
    if (pInfo == NULL) {
×
504
      continue;
×
505
    }
506

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

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

517
static void destroySortOpGroupIdCalc(SSortOpGroupIdCalc* pCalc) {
×
518
  if (pCalc) {
×
519
    taosArrayDestroy(pCalc->pSortColsArr);
×
520
    taosMemoryFree(pCalc->keyBuf);
×
521
    taosMemoryFree(pCalc);
×
522
  }
523
}
×
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