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

taosdata / TDengine / #4822

27 Oct 2025 05:42AM UTC coverage: 59.732% (+1.0%) from 58.728%
#4822

push

travis-ci

web-flow
Merge pull request #33377 from taosdata/fix/main/rename-udf-path

fix: update UDF example links to correct file paths

121214 of 258518 branches covered (46.89%)

Branch coverage included in aggregate %.

193636 of 268583 relevant lines covered (72.1%)

4002399.5 hits per line

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

72.53
/source/libs/executor/src/mergeoperator.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 SSortMergeInfo {
23
  SArray*        pSortInfo;
24
  SSortHandle*   pSortHandle;
25
  STupleHandle*  prefetchedTuple;
26
  int32_t        bufPageSize;
27
  uint32_t       sortBufSize;  // max buffer size for in-memory sort
28
  SSDataBlock*   pIntermediateBlock;   // to hold the intermediate result
29
  SSDataBlock*   pInputBlock;
30
  SColMatchInfo  matchInfo;
31
} SSortMergeInfo;
32

33
typedef struct SNonSortMergeInfo {
34
  int32_t  lastSourceIdx;
35
  int32_t  sourceWorkIdx;
36
  int32_t  sourceNum;
37
  int32_t* pSourceStatus;
38
} SNonSortMergeInfo;
39

40
typedef struct SColsMergeInfo {
41
  SNodeList* pTargets;
42
  size_t     sourceNum;
43
  uint64_t*  srcBlkIds;
44
} SColsMergeInfo;
45

46
typedef struct SMultiwayMergeOperatorInfo {
47
  SOptrBasicInfo binfo;
48
  EMergeType     type;
49
  union {
50
    SSortMergeInfo    sortMergeInfo;
51
    SNonSortMergeInfo nsortMergeInfo;
52
    SColsMergeInfo    colsMergeInfo;
53
  };
54
  SLimitInfo     limitInfo;
55
  bool           groupMerge;
56
  bool           ignoreGroupId;
57
  uint64_t       groupId;
58
  bool           inputWithGroupId;
59
} SMultiwayMergeOperatorInfo;
60

61
static int32_t doSortMerge(SOperatorInfo* pOperator, SSDataBlock** pResBlock);
62
static int32_t doMultiwayMerge(SOperatorInfo* pOperator, SSDataBlock** pResBlock);
63
static int32_t doNonSortMerge(SOperatorInfo* pOperator, SSDataBlock** pResBlock);
64
static int32_t doColsMerge(SOperatorInfo* pOperator, SSDataBlock** pResBlock);
65
static int32_t sortMergeloadNextDataBlock(void* param, SSDataBlock** ppBlock);
66

67
int32_t sortMergeloadNextDataBlock(void* param, SSDataBlock** ppBlock) {
163,166✔
68
  SOperatorInfo* pOperator = (SOperatorInfo*)param;
163,166✔
69
  int32_t        code = pOperator->fpSet.getNextFn(pOperator, ppBlock);
163,166✔
70
  if (code) {
163,166!
71
    qError("failed to get next data block from upstream, %s code:%s", __func__, tstrerror(code));
×
72
  }
73
  code = blockDataCheck(*ppBlock);
163,166✔
74
  if (code) {
163,163!
75
    qError("failed to check data block got from upstream, %s code:%s", __func__, tstrerror(code));
×
76
  }
77
  return code;
163,164✔
78
}
79

80
int32_t openSortMergeOperator(SOperatorInfo* pOperator) {
25,266✔
81
  SMultiwayMergeOperatorInfo* pInfo = pOperator->info;
25,266✔
82
  SExecTaskInfo*              pTaskInfo = pOperator->pTaskInfo;
25,266✔
83
  SSortMergeInfo*             pSortMergeInfo = &pInfo->sortMergeInfo;
25,266✔
84

85
  int32_t numOfBufPage = pSortMergeInfo->sortBufSize / pSortMergeInfo->bufPageSize;
25,266✔
86

87
  pSortMergeInfo->pSortHandle = NULL;
25,266✔
88
  int32_t code = tsortCreateSortHandle(pSortMergeInfo->pSortInfo, SORT_MULTISOURCE_MERGE, pSortMergeInfo->bufPageSize,
25,266✔
89
                                       numOfBufPage, pSortMergeInfo->pInputBlock, pTaskInfo->id.str, 0, 0, 0, &pSortMergeInfo->pSortHandle);
25,266✔
90
  if (code) {
25,267!
91
    return code;
×
92
  }
93

94
  tsortSetFetchRawDataFp(pSortMergeInfo->pSortHandle, sortMergeloadNextDataBlock, NULL, NULL);
25,267✔
95
  tsortSetCompareGroupId(pSortMergeInfo->pSortHandle, pInfo->groupMerge);
25,266✔
96

97
  for (int32_t i = 0; i < pOperator->numOfDownstream; ++i) {
83,892✔
98
    SOperatorInfo* pDownstream = pOperator->pDownstream[i];
58,625✔
99
    if (pDownstream->operatorType == QUERY_NODE_PHYSICAL_PLAN_EXCHANGE) {
58,625!
100
      code = pDownstream->fpSet._openFn(pDownstream);
58,626✔
101
      if (code) {
58,626!
102
        return code;
×
103
      }
104
    }
105

106
    SSortSource* ps = taosMemoryCalloc(1, sizeof(SSortSource));
58,625!
107
    if (ps == NULL) {
58,627!
108
      return terrno;
×
109
    }
110

111
    ps->param = pDownstream;
58,627✔
112
    ps->onlyRef = true;
58,627✔
113

114
    code = tsortAddSource(pSortMergeInfo->pSortHandle, ps);
58,627✔
115
    if (code) {
58,627!
116
      return code;
×
117
    }
118
  }
119

120
  return tsortOpen(pSortMergeInfo->pSortHandle);
25,267✔
121
}
122

123
static int32_t doGetSortedBlockData(SMultiwayMergeOperatorInfo* pInfo, SSortHandle* pHandle, int32_t capacity,
73,044✔
124
                                 SSDataBlock* p, bool* newgroup) {
125
  SSortMergeInfo* pSortMergeInfo = &pInfo->sortMergeInfo;
73,044✔
126
  *newgroup = false;
73,044✔
127
  int32_t code = 0;
73,044✔
128

129
  while (1) {
26,934,164✔
130
    STupleHandle* pTupleHandle = NULL;
27,007,208✔
131
    if (pInfo->groupMerge || pInfo->inputWithGroupId) {
27,007,208✔
132
      if (pSortMergeInfo->prefetchedTuple == NULL) {
22,706,655✔
133
        pTupleHandle = NULL;
22,697,091✔
134
        code = tsortNextTuple(pHandle, &pTupleHandle);
22,697,091✔
135
        if (code) {
136
          // todo handle error
137
        }
138
      } else {
139
        pTupleHandle = pSortMergeInfo->prefetchedTuple;
9,564✔
140
        pSortMergeInfo->prefetchedTuple = NULL;
9,564✔
141
        uint64_t gid = tsortGetGroupId(pTupleHandle);
9,564✔
142
        if (gid != pInfo->groupId) {
9,564!
143
          *newgroup = true;
9,564✔
144
          pInfo->groupId = gid;
9,564✔
145
        }
146
      }
147
    } else {
148
      code = tsortNextTuple(pHandle, &pTupleHandle);
4,300,553✔
149
      pInfo->groupId = 0;
4,259,827✔
150
    }
151

152
    if (pTupleHandle == NULL || (code != 0)) {
26,965,713!
153
      break;
154
    }
155

156
    if (pInfo->groupMerge || pInfo->inputWithGroupId) {
49,600,472✔
157
      uint64_t tupleGroupId = tsortGetGroupId(pTupleHandle);
22,684,229✔
158
      if (pInfo->groupId == 0 || pInfo->groupId == tupleGroupId) {
22,683,675✔
159
        code = appendOneRowToDataBlock(p, pTupleHandle);
22,674,074✔
160
        if (code) {
22,675,788!
161
          return code;
×
162
        }
163

164
        p->info.id.groupId = tupleGroupId;
22,675,788✔
165
        pInfo->groupId = tupleGroupId;
22,675,788✔
166
      } else {
167
        if (p->info.rows == 0) {
9,601!
168
          code = appendOneRowToDataBlock(p, pTupleHandle);
×
169
          if (code) {
×
170
            return code;
×
171
          }
172

173
          p->info.id.groupId = pInfo->groupId = tupleGroupId;
×
174
        } else {
175
          pSortMergeInfo->prefetchedTuple = pTupleHandle;
9,601✔
176
          break;
9,601✔
177
        }
178
      }
179
    } else {
180
      code = appendOneRowToDataBlock(p, pTupleHandle);
4,240,455✔
181
      if (code) {
4,282,352!
182
        return code;
×
183
      }
184
    }
185

186
    if (p->info.rows >= capacity) {
26,958,140✔
187
      break;
23,976✔
188
    }
189
  }
190

191
  return code;
74,606✔
192
}
193

194
int32_t doSortMerge(SOperatorInfo* pOperator, SSDataBlock** pResBlock) {
73,011✔
195
  SExecTaskInfo*              pTaskInfo = pOperator->pTaskInfo;
73,011✔
196
  SMultiwayMergeOperatorInfo* pInfo = pOperator->info;
73,011✔
197
  SSortMergeInfo*             pSortMergeInfo = &pInfo->sortMergeInfo;
73,011✔
198
  SSortHandle*                pHandle = pSortMergeInfo->pSortHandle;
73,011✔
199
  SSDataBlock*                pDataBlock = pInfo->binfo.pRes;
73,011✔
200
  SArray*                     pColMatchInfo = pSortMergeInfo->matchInfo.pList;
73,011✔
201
  int32_t                     capacity = pOperator->resultInfo.capacity;
73,011✔
202
  int32_t                     code = 0;
73,011✔
203
  bool                        newgroup = false;
73,011✔
204

205
  qDebug("start to merge final sorted rows, %s", GET_TASKID(pTaskInfo));
73,011✔
206
  blockDataCleanup(pDataBlock);
73,011✔
207

208
  if (pSortMergeInfo->pIntermediateBlock == NULL) {
73,012✔
209
    pSortMergeInfo->pIntermediateBlock = NULL;
25,267✔
210
    code = tsortGetSortedDataBlock(pHandle, &pSortMergeInfo->pIntermediateBlock);
25,267✔
211
    if (pSortMergeInfo->pIntermediateBlock == NULL || code != 0) {
25,267!
212
      return code;
×
213
    }
214

215
    code = blockDataEnsureCapacity(pSortMergeInfo->pIntermediateBlock, capacity);
25,267✔
216
    if (code) {
25,267!
217
      return code;
×
218
    }
219

220
  } else {
221
    blockDataCleanup(pSortMergeInfo->pIntermediateBlock);
47,745✔
222
  }
223

224
  SSDataBlock* p = pSortMergeInfo->pIntermediateBlock;
73,013✔
225
  while (1) {
31✔
226
    code = doGetSortedBlockData(pInfo, pHandle, capacity, p, &newgroup);
73,044✔
227
    if (code) {
73,044!
228
      return code;
×
229
    }
230

231
    if (p->info.rows == 0) {
73,044✔
232
      break;
20,247✔
233
    }
234

235
    if (newgroup) {
52,797✔
236
      resetLimitInfoForNextGroup(&pInfo->limitInfo);
9,564✔
237
    }
238

239
    bool limitReached = applyLimitOffset(&pInfo->limitInfo, p, pTaskInfo);
52,797✔
240

241
    if (p->info.rows > 0) {
52,796✔
242
      break;
52,765✔
243
    }
244
  }
245

246
  if (p->info.rows > 0) {
73,012✔
247
    int32_t numOfCols = taosArrayGetSize(pColMatchInfo);
52,766✔
248
    for (int32_t i = 0; i < numOfCols; ++i) {
214,889✔
249
      SColMatchItem* pmInfo = taosArrayGet(pColMatchInfo, i);
162,123✔
250
      if (pmInfo == NULL) {
162,123!
251
        code = terrno;
×
252
        return code;
×
253
      }
254

255
      SColumnInfoData* pSrc = taosArrayGet(p->pDataBlock, pmInfo->srcSlotId);
162,123✔
256
      if (pSrc == NULL) {
162,123!
257
        code = terrno;
×
258
        return code;
×
259
      }
260

261
      SColumnInfoData* pDst = taosArrayGet(pDataBlock->pDataBlock, pmInfo->dstSlotId);
162,123✔
262
      if (pDst == NULL) {
162,122!
263
        code = terrno;
×
264
        return code;
×
265
      }
266

267
      code = colDataAssign(pDst, pSrc, p->info.rows, &pDataBlock->info);
162,122✔
268
      if (code) {
162,124!
269
        return code;
×
270
      }
271
    }
272

273
    pDataBlock->info.rows = p->info.rows;
52,766✔
274
    pDataBlock->info.scanFlag = p->info.scanFlag;
52,766✔
275
    if (pInfo->ignoreGroupId) {
52,766✔
276
      pDataBlock->info.id.groupId = 0;
8✔
277
    } else {
278
      pDataBlock->info.id.groupId = pInfo->groupId;
52,758✔
279
    }
280
    pDataBlock->info.dataLoad = 1;
52,766✔
281
  }
282

283
  qDebug("%s get sorted block, groupId:0x%" PRIx64 " rows:%" PRId64 , GET_TASKID(pTaskInfo), pDataBlock->info.id.groupId,
73,012✔
284
         pDataBlock->info.rows);
285

286
  *pResBlock = (pDataBlock->info.rows > 0) ? pDataBlock : NULL;
73,013✔
287
  return code;
73,013✔
288
}
289

290
int32_t getSortMergeExplainExecInfo(SOperatorInfo* pOptr, void** pOptrExplain, uint32_t* len) {
1,091✔
291
  SSortExecInfo* pSortExecInfo = taosMemoryCalloc(1, sizeof(SSortExecInfo));
1,091!
292
  if (pSortExecInfo == NULL) {
1,091!
293
    pOptr->pTaskInfo->code = terrno;
×
294
    return terrno;
×
295
  }
296

297
  SMultiwayMergeOperatorInfo* pInfo = (SMultiwayMergeOperatorInfo*)pOptr->info;
1,091✔
298
  SSortMergeInfo* pSortMergeInfo = &pInfo->sortMergeInfo;
1,091✔
299

300
  *pSortExecInfo = tsortGetSortExecInfo(pSortMergeInfo->pSortHandle);
1,091✔
301
  *pOptrExplain = pSortExecInfo;
1,091✔
302

303
  *len = sizeof(SSortExecInfo);
1,091✔
304
  return TSDB_CODE_SUCCESS;
1,091✔
305
}
306

307

308
void destroySortMergeOperatorInfo(void* param) {
25,483✔
309
  SSortMergeInfo* pSortMergeInfo = param;
25,483✔
310
  blockDataDestroy(pSortMergeInfo->pInputBlock);
25,483✔
311
  pSortMergeInfo->pInputBlock = NULL;
25,483✔
312

313
  blockDataDestroy(pSortMergeInfo->pIntermediateBlock);
25,483✔
314
  pSortMergeInfo->pIntermediateBlock = NULL;
25,482✔
315

316
  taosArrayDestroy(pSortMergeInfo->matchInfo.pList);
25,482✔
317

318
  tsortDestroySortHandle(pSortMergeInfo->pSortHandle);
25,483✔
319
  taosArrayDestroy(pSortMergeInfo->pSortInfo);
25,482✔
320
}
25,483✔
321

322
#define NON_SORT_NEXT_SRC(_info, _idx) ((++(_idx) >= (_info)->sourceNum) ? ((_info)->sourceWorkIdx) : (_idx))
323

324
int32_t openNonSortMergeOperator(SOperatorInfo* pOperator) {
2✔
325
  SMultiwayMergeOperatorInfo* pInfo = pOperator->info;
2✔
326
  SExecTaskInfo*              pTaskInfo = pOperator->pTaskInfo;
2✔
327
  SNonSortMergeInfo*          pNonSortMergeInfo = &pInfo->nsortMergeInfo;
2✔
328

329
  pNonSortMergeInfo->sourceWorkIdx = 0;
2✔
330
  pNonSortMergeInfo->sourceNum = pOperator->numOfDownstream;
2✔
331
  pNonSortMergeInfo->lastSourceIdx = -1;
2✔
332
  pNonSortMergeInfo->pSourceStatus =
4✔
333
      taosMemoryCalloc(pOperator->numOfDownstream, sizeof(*pNonSortMergeInfo->pSourceStatus));
2!
334
  if (NULL == pNonSortMergeInfo->pSourceStatus) {
2!
335
    pTaskInfo->code = terrno;
×
336
    return pTaskInfo->code;
×
337
  }
338

339
  for (int32_t i = 0; i < pOperator->numOfDownstream; ++i) {
6✔
340
    pNonSortMergeInfo->pSourceStatus[i] = i;
4✔
341
  }
342

343
  return 0;
2✔
344
}
345

346
int32_t doNonSortMerge(SOperatorInfo* pOperator, SSDataBlock** pResBlock) {
106✔
347
  QRY_PARAM_CHECK(pResBlock);
106!
348

349
  SExecTaskInfo*              pTaskInfo = pOperator->pTaskInfo;
106✔
350
  SMultiwayMergeOperatorInfo* pInfo = pOperator->info;
106✔
351
  SNonSortMergeInfo*          pNonSortMerge = &pInfo->nsortMergeInfo;
106✔
352
  SSDataBlock*                pBlock = NULL;
106✔
353
  SSDataBlock*                pRes = pInfo->binfo.pRes;
106✔
354
  int32_t                     code = 0;
106✔
355

356
  qDebug("start to merge no sorted rows, %s", GET_TASKID(pTaskInfo));
106!
357

358
  int32_t idx = NON_SORT_NEXT_SRC(pNonSortMerge, pNonSortMerge->lastSourceIdx);
106!
359
  while (idx < pNonSortMerge->sourceNum) {
110✔
360
    pBlock = getNextBlockFromDownstream(pOperator, pNonSortMerge->pSourceStatus[idx]);
108✔
361
    if (NULL == pBlock) {
108✔
362
      TSWAP(pNonSortMerge->pSourceStatus[pNonSortMerge->sourceWorkIdx], pNonSortMerge->pSourceStatus[idx]);
4✔
363
      pNonSortMerge->sourceWorkIdx++;
4✔
364
      idx = NON_SORT_NEXT_SRC(pNonSortMerge, pNonSortMerge->lastSourceIdx);
4✔
365
      continue;
4✔
366
    }
367

368
    pNonSortMerge->lastSourceIdx = idx - 1;
104✔
369
    break;
104✔
370
  }
371

372
  if (!pBlock) {  // null data
106✔
373
    return code;
2✔
374
  }
375

376
  code = copyDataBlock(pRes, pBlock);
104✔
377
  *pResBlock = pRes;
104✔
378
  return code;
104✔
379
}
380

381
void destroyNonSortMergeOperatorInfo(void* param) {
2✔
382
  SNonSortMergeInfo* pNonSortMerge = param;
2✔
383
  taosMemoryFree(pNonSortMerge->pSourceStatus);
2!
384
}
2✔
385

386
int32_t getNonSortMergeExplainExecInfo(SOperatorInfo* pOptr, void** pOptrExplain, uint32_t* len) {
×
387
  return TSDB_CODE_SUCCESS;
×
388
}
389

390

391
int32_t openColsMergeOperator(SOperatorInfo* pOperator) {
35✔
392
  return TSDB_CODE_SUCCESS;
35✔
393
}
394

395
int32_t copyColumnsValue(SNodeList* pNodeList, uint64_t targetBlkId, SSDataBlock* pDst, SSDataBlock* pSrc) {
70✔
396
  bool    isNull = (NULL == pSrc || pSrc->info.rows <= 0);
70!
397
  size_t  numOfCols = LIST_LENGTH(pNodeList);
70!
398
  int32_t code = 0;
70✔
399

400
  for (int32_t i = 0; i < numOfCols; ++i) {
358✔
401
    STargetNode* pNode = (STargetNode*)nodesListGetNode(pNodeList, i);
288✔
402
    if (nodeType(pNode->pExpr) == QUERY_NODE_COLUMN && ((SColumnNode*)pNode->pExpr)->dataBlockId == targetBlkId) {
288!
403
      SColumnInfoData* pDstCol = taosArrayGet(pDst->pDataBlock, pNode->slotId);
144✔
404
      if (pDstCol == NULL) {
144!
405
        return terrno;
×
406
      }
407

408
      if (isNull) {
144!
409
        code = colDataSetVal(pDstCol, 0, NULL, true);
×
410
      } else {
411
        SColumnInfoData* pSrcCol = taosArrayGet(pSrc->pDataBlock, ((SColumnNode*)pNode->pExpr)->slotId);
144✔
412
        if (pSrcCol == NULL) {
144!
413
          code = terrno;
×
414
          return code;
×
415
        }
416

417
        code = colDataAssign(pDstCol, pSrcCol, 1, &pDst->info);
144✔
418
      }
419

420
      if (code) {
144!
421
        break;
×
422
      }
423
    }
424
  }
425

426
  return code;
70✔
427
}
428

429
int32_t doColsMerge(SOperatorInfo* pOperator, SSDataBlock** pResBlock) {
35✔
430
  QRY_PARAM_CHECK(pResBlock);
35!
431

432
  SExecTaskInfo*              pTaskInfo = pOperator->pTaskInfo;
35✔
433
  SMultiwayMergeOperatorInfo* pInfo = pOperator->info;
35✔
434
  SSDataBlock*                pBlock = NULL;
35✔
435
  SColsMergeInfo*             pColsMerge = &pInfo->colsMergeInfo;
35✔
436
  int32_t                     nullBlkNum = 0;
35✔
437
  int32_t                     code = 0;
35✔
438

439
  qDebug("start to merge columns, %s", GET_TASKID(pTaskInfo));
35!
440

441
  for (int32_t i = 0; i < pColsMerge->sourceNum; ++i) {
105✔
442
    pBlock = getNextBlockFromDownstream(pOperator, i);
70✔
443
    if (pBlock && pBlock->info.rows > 1) {
70!
444
      qError("more than 1 row returned from downstream, rows:%" PRId64, pBlock->info.rows);
×
445
      T_LONG_JMP(pTaskInfo->env, TSDB_CODE_QRY_EXECUTOR_INTERNAL_ERROR);
×
446
    } else if (NULL == pBlock) {
70!
447
      nullBlkNum++;
×
448
    }
449
    
450
    code = copyColumnsValue(pColsMerge->pTargets, pColsMerge->srcBlkIds[i], pInfo->binfo.pRes, pBlock);
70✔
451
    if (code) {
70!
452
      return code;
×
453
    }
454
  }
455

456
  setOperatorCompleted(pOperator);
35✔
457
  if (pColsMerge->sourceNum == nullBlkNum) {
35!
458
    return code;
×
459
  }
460

461
  pInfo->binfo.pRes->info.rows = 1;
35✔
462
  *pResBlock = pInfo->binfo.pRes;
35✔
463

464
  return code;
35✔
465
}
466

467
void destroyColsMergeOperatorInfo(void* param) {
35✔
468
  SColsMergeInfo* pColsMergeInfo = param;
35✔
469
  taosMemoryFreeClear(pColsMergeInfo->srcBlkIds);
35!
470
}
35✔
471

472
int32_t getColsMergeExplainExecInfo(SOperatorInfo* pOptr, void** pOptrExplain, uint32_t* len) {
×
473
  return TSDB_CODE_SUCCESS;
×
474
}
475

476

477
SOperatorFpSet gMultiwayMergeFps[MERGE_TYPE_MAX_VALUE] = {
478
  {0},
479
  {._openFn = openSortMergeOperator, .getNextFn = doSortMerge, .closeFn = destroySortMergeOperatorInfo, .getExplainFn = getSortMergeExplainExecInfo},
480
  {._openFn = openNonSortMergeOperator, .getNextFn = doNonSortMerge, .closeFn = destroyNonSortMergeOperatorInfo, .getExplainFn = getNonSortMergeExplainExecInfo},
481
  {._openFn = openColsMergeOperator, .getNextFn = doColsMerge, .closeFn = destroyColsMergeOperatorInfo, .getExplainFn = getColsMergeExplainExecInfo},
482
};
483

484

485
int32_t openMultiwayMergeOperator(SOperatorInfo* pOperator) {
73,152✔
486
  int32_t code = 0;
73,152✔
487
  SMultiwayMergeOperatorInfo* pInfo = pOperator->info;
73,152✔
488
  SExecTaskInfo*              pTaskInfo = pOperator->pTaskInfo;
73,152✔
489

490
  if (OPTR_IS_OPENED(pOperator)) {
73,152✔
491
    return TSDB_CODE_SUCCESS;
47,850✔
492
  }
493

494
  int64_t startTs = taosGetTimestampUs();
25,303✔
495
  
496
  if (NULL != gMultiwayMergeFps[pInfo->type]._openFn) {
25,303!
497
    code = (*gMultiwayMergeFps[pInfo->type]._openFn)(pOperator);
25,304✔
498
  }
499

500
  pOperator->cost.openCost = (taosGetTimestampUs() - startTs) / 1000.0;
25,304✔
501
  pOperator->status = OP_RES_TO_RETURN;
25,304✔
502

503
  if (code != TSDB_CODE_SUCCESS) {
25,304!
504
    qError("%s failed at line %d since %s", __func__, __LINE__, tstrerror(code));
×
505
    pOperator->pTaskInfo->code = code;
×
506
    T_LONG_JMP(pTaskInfo->env, terrno);
×
507
  }
508

509
  OPTR_SET_OPENED(pOperator);
25,304✔
510
  return code;
25,304✔
511
}
512

513
int32_t doMultiwayMerge(SOperatorInfo* pOperator, SSDataBlock** pResBlock) {
73,201✔
514
  QRY_PARAM_CHECK(pResBlock);
73,201!
515
  int32_t code = TSDB_CODE_SUCCESS;
73,201✔
516
  int32_t lino = 0;
73,201✔
517

518
  if (pOperator->status == OP_EXEC_DONE) {
73,201✔
519
    return 0;
49✔
520
  }
521

522
  SExecTaskInfo* pTaskInfo = pOperator->pTaskInfo;
73,152✔
523
  SMultiwayMergeOperatorInfo* pInfo = pOperator->info;
73,152✔
524

525
  code = pOperator->fpSet._openFn(pOperator);
73,152✔
526
  QUERY_CHECK_CODE(code, lino, _end);
73,154!
527

528
  if (NULL != gMultiwayMergeFps[pInfo->type].getNextFn) {
73,154✔
529
    code = (*gMultiwayMergeFps[pInfo->type].getNextFn)(pOperator, pResBlock);
73,153✔
530
    QUERY_CHECK_CODE(code, lino, _end);
73,154!
531
  }
532

533
  if ((*pResBlock) != NULL) {
73,155✔
534
    pOperator->resultInfo.totalRows += (*pResBlock)->info.rows;
52,905✔
535
    code = blockDataCheck(*pResBlock);
52,905✔
536
    QUERY_CHECK_CODE(code, lino, _end);
52,905!
537
  } else {
538
    setOperatorCompleted(pOperator);
20,250✔
539
  }
540

541
_end:
73,154✔
542
  if (code != TSDB_CODE_SUCCESS) {
73,154!
543
    qError("%s failed at line %d since %s", __func__, lino, tstrerror(code));
×
544
    pTaskInfo->code = code;
×
545
    T_LONG_JMP(pTaskInfo->env, code);
×
546
  }
547
  return code;
73,154✔
548
}
549

550
void destroyMultiwayMergeOperatorInfo(void* param) {
25,520✔
551
  SMultiwayMergeOperatorInfo* pInfo = (SMultiwayMergeOperatorInfo*)param;
25,520✔
552
  blockDataDestroy(pInfo->binfo.pRes);
25,520✔
553
  pInfo->binfo.pRes = NULL;
25,520✔
554

555
  if (NULL != gMultiwayMergeFps[pInfo->type].closeFn) {
25,520!
556
    (*gMultiwayMergeFps[pInfo->type].closeFn)(&pInfo->sortMergeInfo);
25,520✔
557
  }
558

559
  taosMemoryFreeClear(param);
25,520!
560
}
25,520✔
561

562
int32_t getMultiwayMergeExplainExecInfo(SOperatorInfo* pOptr, void** pOptrExplain, uint32_t* len) {
1,091✔
563
  int32_t code = 0;
1,091✔
564
  SMultiwayMergeOperatorInfo* pInfo = (SMultiwayMergeOperatorInfo*)pOptr->info;
1,091✔
565

566
  if (NULL != gMultiwayMergeFps[pInfo->type].getExplainFn) {
1,091!
567
    code = (*gMultiwayMergeFps[pInfo->type].getExplainFn)(pOptr, pOptrExplain, len);
1,091✔
568
  }
569

570
  return code;
1,091✔
571
}
572

573
static int32_t resetMultiwayMergeOperState(SOperatorInfo* pOper) {
4✔
574
  SMultiwayMergeOperatorInfo* pInfo = pOper->info;
4✔
575
  SExecTaskInfo*           pTaskInfo = pOper->pTaskInfo;
4✔
576
  SMergePhysiNode* pPhynode = (SMergePhysiNode*)pOper->pPhyNode;
4✔
577
  pOper->status = OP_NOT_OPENED;
4✔
578

579
  resetBasicOperatorState(&pInfo->binfo);
4✔
580
  pInfo->groupId = 0;
4✔
581

582
  OPTR_CLR_OPENED(pOper);
4✔
583

584
  switch (pInfo->type) {
4!
585
    case MERGE_TYPE_SORT: {
4✔
586

587
      SSortMergeInfo* pSortMergeInfo = &pInfo->sortMergeInfo;
4✔
588

589
      blockDataCleanup(pSortMergeInfo->pInputBlock);
4✔
590

591
      blockDataDestroy(pSortMergeInfo->pIntermediateBlock);
4✔
592
      pSortMergeInfo->pIntermediateBlock = NULL;
4✔
593

594
      tsortDestroySortHandle(pSortMergeInfo->pSortHandle);
4✔
595
      pSortMergeInfo->pSortHandle = NULL;
4✔
596
      pSortMergeInfo->prefetchedTuple = NULL;
4✔
597

598
      pInfo->limitInfo = (SLimitInfo){0};
4✔
599
      initLimitInfo(pPhynode->node.pLimit, pPhynode->node.pSlimit, &pInfo->limitInfo);
4✔
600
      break;
4✔
601
    }
602
    case MERGE_TYPE_NON_SORT: {
×
603
      pInfo->nsortMergeInfo = (SNonSortMergeInfo){0};
×
604
      break;
×
605
    }
606
    case MERGE_TYPE_COLUMNS: {
×
607
      break;
×
608
    }
609
    default:
×
610
      qError("Invalid merge type: %d", pInfo->type);
×
611
  }
612

613
  return 0;
4✔
614
}
615

616
int32_t createMultiwayMergeOperatorInfo(SOperatorInfo** downStreams, size_t numStreams, SMergePhysiNode* pMergePhyNode,
25,519✔
617
                                        SExecTaskInfo* pTaskInfo, SOperatorInfo** pOptrInfo) {
618
  QRY_PARAM_CHECK(pOptrInfo);
25,519!
619

620
  SPhysiNode*                 pPhyNode = (SPhysiNode*)pMergePhyNode;
25,519✔
621
  int32_t                     lino = 0;
25,519✔
622
  int32_t                     code = TSDB_CODE_SUCCESS;
25,519✔
623
  SMultiwayMergeOperatorInfo* pInfo = taosMemoryCalloc(1, sizeof(SMultiwayMergeOperatorInfo));
25,519!
624
  SOperatorInfo*              pOperator = taosMemoryCalloc(1, sizeof(SOperatorInfo));
25,519!
625
  SDataBlockDescNode*         pDescNode = pPhyNode->pOutputDataBlockDesc;
25,520✔
626
  if (pInfo == NULL || pOperator == NULL) {
25,520!
627
    code = terrno;
×
628
    goto _error;
×
629
  }
630

631
  pOperator->pPhyNode = pPhyNode;
25,520✔
632
  pInfo->groupMerge = pMergePhyNode->groupSort;
25,520✔
633
  pInfo->ignoreGroupId = pMergePhyNode->ignoreGroupId;
25,520✔
634
  pInfo->binfo.inputTsOrder = pMergePhyNode->node.inputTsOrder;
25,520✔
635
  pInfo->binfo.outputTsOrder = pMergePhyNode->node.outputTsOrder;
25,520✔
636
  pInfo->inputWithGroupId = pMergePhyNode->inputWithGroupId;
25,520✔
637

638
  pInfo->type = pMergePhyNode->type;
25,520✔
639
  switch (pInfo->type) {
25,520!
640
    case MERGE_TYPE_SORT: {
25,483✔
641
      SSortMergeInfo* pSortMergeInfo = &pInfo->sortMergeInfo;
25,483✔
642
      initLimitInfo(pMergePhyNode->node.pLimit, pMergePhyNode->node.pSlimit, &pInfo->limitInfo);
25,483✔
643
      pInfo->binfo.pRes = createDataBlockFromDescNode(pDescNode);
25,483✔
644
      TSDB_CHECK_NULL(pInfo->binfo.pRes, code, lino, _error, terrno);
25,483!
645

646
      SPhysiNode*  pChildNode = (SPhysiNode*)nodesListGetNode(pPhyNode->pChildren, 0);
25,483✔
647
      SSDataBlock* pInputBlock = createDataBlockFromDescNode(pChildNode->pOutputDataBlockDesc);
25,483✔
648
      TSDB_CHECK_NULL(pInputBlock, code, lino, _error, terrno);
25,483!
649
      pSortMergeInfo->pInputBlock = pInputBlock;
25,483✔
650

651
      initResultSizeInfo(&pOperator->resultInfo, 1024);
25,483✔
652
      code = blockDataEnsureCapacity(pInfo->binfo.pRes, pOperator->resultInfo.capacity);
25,482✔
653
      TSDB_CHECK_CODE(code, lino, _error);
25,482!
654

655
      size_t  numOfCols = taosArrayGetSize(pInfo->binfo.pRes->pDataBlock);
25,482✔
656
      int32_t rowSize = pInfo->binfo.pRes->info.rowSize;
25,482✔
657
      int32_t numOfOutputCols = 0;
25,482✔
658
      pSortMergeInfo->pSortInfo = createSortInfo(pMergePhyNode->pMergeKeys);
25,482✔
659
      pSortMergeInfo->bufPageSize = getProperSortPageSize(rowSize, numOfCols);
25,482✔
660
      pSortMergeInfo->sortBufSize =
25,483✔
661
          pSortMergeInfo->bufPageSize * (numStreams + 1);  // one additional is reserved for merged result.
25,483✔
662
      code = extractColMatchInfo(pMergePhyNode->pTargets, pDescNode, &numOfOutputCols, COL_MATCH_FROM_SLOT_ID,
25,483✔
663
                                 &pSortMergeInfo->matchInfo);
664
      if (code != TSDB_CODE_SUCCESS) {
25,483!
665
        goto _error;
×
666
      }
667
      break;
25,483✔
668
    }
669
    case MERGE_TYPE_NON_SORT: {
2✔
670
      SNonSortMergeInfo* pNonSortMerge = &pInfo->nsortMergeInfo;
2✔
671
      pInfo->binfo.pRes = createDataBlockFromDescNode(pDescNode);
2✔
672
      TSDB_CHECK_NULL(pInfo->binfo.pRes, code, lino, _error, terrno);
2!
673

674
      initResultSizeInfo(&pOperator->resultInfo, 1024);
2✔
675
      code = blockDataEnsureCapacity(pInfo->binfo.pRes, pOperator->resultInfo.capacity);
2✔
676
      TSDB_CHECK_CODE(code, lino, _error);
2!
677

678
      break;
2✔
679
    }
680
    case MERGE_TYPE_COLUMNS: {
35✔
681
      SColsMergeInfo* pColsMerge = &pInfo->colsMergeInfo;
35✔
682
      pInfo->binfo.pRes = createDataBlockFromDescNode(pDescNode);
35✔
683
      TSDB_CHECK_NULL(pInfo->binfo.pRes, code, lino, _error, terrno);
35!
684

685
      initResultSizeInfo(&pOperator->resultInfo, 1);
35✔
686
      code = blockDataEnsureCapacity(pInfo->binfo.pRes, pOperator->resultInfo.capacity);
35✔
687
      TSDB_CHECK_CODE(code, lino, _error);
35!
688

689
      pColsMerge->pTargets = pMergePhyNode->pTargets;
35✔
690
      pColsMerge->sourceNum = numStreams;
35✔
691
      pColsMerge->srcBlkIds = taosMemoryCalloc(numStreams, sizeof(uint64_t));
35!
692
      for (size_t i = 0; i < numStreams; ++i) {
105✔
693
        pColsMerge->srcBlkIds[i] = getOperatorResultBlockId(downStreams[i], 0);
70✔
694
      }
695
      break;
35✔
696
    }
697
    default:
×
698
      qError("Invalid merge type: %d", pInfo->type);
×
699
      code = TSDB_CODE_INVALID_PARA;
×
700
      goto _error;
×
701
  }
702

703
  setOperatorInfo(pOperator, "MultiwayMergeOperator", QUERY_NODE_PHYSICAL_PLAN_MERGE, false, OP_NOT_OPENED, pInfo,
25,520✔
704
                  pTaskInfo);
705
  pOperator->fpSet =
706
      createOperatorFpSet(openMultiwayMergeOperator, doMultiwayMerge, NULL, destroyMultiwayMergeOperatorInfo,
25,519✔
707
                          optrDefaultBufFn, getMultiwayMergeExplainExecInfo, optrDefaultGetNextExtFn, NULL);
708

709
  setOperatorResetStateFn(pOperator, resetMultiwayMergeOperState);
25,519✔
710
  code = appendDownstream(pOperator, downStreams, numStreams);
25,519✔
711
  if (code != TSDB_CODE_SUCCESS) {
25,519!
712
    goto _error;
×
713
  }
714

715
  *pOptrInfo = pOperator;
25,519✔
716
  return TSDB_CODE_SUCCESS;
25,519✔
717

718
_error:
×
719
  if (pInfo != NULL) {
×
720
    destroyMultiwayMergeOperatorInfo(pInfo);
×
721
  }
722
  pTaskInfo->code = code;
×
723
  destroyOperatorAndDownstreams(pOperator, downStreams, numStreams);
×
724
  return code;
×
725
}
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