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

taosdata / TDengine / #4997

20 Mar 2026 06:10AM UTC coverage: 71.739% (-0.3%) from 72.069%
#4997

push

travis-ci

web-flow
feat: add query phase tracking for SHOW QUERIES (#34706)

148 of 183 new or added lines in 10 files covered. (80.87%)

9273 existing lines in 172 files now uncovered.

244572 of 340921 relevant lines covered (71.74%)

133392941.95 hits per line

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

81.59
/source/libs/executor/src/querytask.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 "filter.h"
17
#include "function.h"
18
#include "functionMgt.h"
19
#include "os.h"
20
#include "querynodes.h"
21
#include "tfill.h"
22
#include "tname.h"
23

24
#include "tdatablock.h"
25
#include "tmsg.h"
26

27
#include "executorInt.h"
28
#include "index.h"
29
#include "operator.h"
30
#include "query.h"
31
#include "querytask.h"
32
#include "storageapi.h"
33
#include "thash.h"
34
#include "ttypes.h"
35
#include "tref.h"
36

37
#define CLEAR_QUERY_STATUS(q, st) ((q)->status &= (~(st)))
38

39
int32_t doCreateTask(uint64_t queryId, uint64_t taskId, int32_t vgId, EOPTR_EXEC_MODEL model, SStorageAPI* pAPI,
339,182,910✔
40
                     SExecTaskInfo** pTaskInfo) {
41
  if (pTaskInfo == NULL) {
339,182,910✔
42
    return TSDB_CODE_SUCCESS;
×
43
  }
44

45
  SExecTaskInfo* p = taosMemoryCalloc(1, sizeof(SExecTaskInfo));
339,182,910✔
46
  if (p == NULL) {
339,149,998✔
47
    return terrno;
×
48
  }
49

50
  setTaskStatus(p, TASK_NOT_COMPLETED);
339,149,998✔
51
  p->cost.created = taosGetTimestampUs();
339,198,014✔
52

53
  p->execModel = model;
339,182,218✔
54
  p->stopInfo.pStopInfo = taosArrayInit(4, sizeof(SExchangeOpStopInfo));
339,193,396✔
55
  p->pResultBlockList = taosArrayInit(128, POINTER_BYTES);
339,181,592✔
56
  if (p->stopInfo.pStopInfo == NULL || p->pResultBlockList == NULL) {
339,151,277✔
57
    doDestroyTask(p);
270✔
58
    return terrno;
×
59
  }
60

61
  p->storageAPI = *pAPI;
339,171,423✔
62
  taosInitRWLatch(&p->lock);
339,184,718✔
63

64
  p->id.vgId = vgId;
339,172,672✔
65
  p->id.queryId = queryId;
339,168,552✔
66
  p->id.taskId = taskId;
339,188,471✔
67
  p->id.str = taosMemoryMalloc(64);
339,182,540✔
68
  if (p->id.str == NULL) {
339,141,242✔
69
    doDestroyTask(p);
×
70
    return terrno;
×
71
  }
72

73
  buildTaskId(taskId, queryId, p->id.str, 64);
339,156,986✔
74
  p->schemaInfos = taosArrayInit(1, sizeof(SSchemaInfo));
339,135,413✔
75
  if (p->id.str == NULL || p->schemaInfos == NULL) {
339,094,939✔
76
    doDestroyTask(p);
4,569✔
77
    return terrno;
×
78
  }
79

80
  *pTaskInfo = p;
339,117,566✔
81
  return TSDB_CODE_SUCCESS;
339,143,666✔
82
}
83

84
int32_t getTaskCode(void* pTaskInfo) { return ((SExecTaskInfo*)pTaskInfo)->code; }
19,215✔
85

86
bool isTaskKilled(void* pTaskInfo) { return (0 != ((SExecTaskInfo*)pTaskInfo)->code); }
1,779,853,699✔
87

88
void setTaskKilled(SExecTaskInfo* pTaskInfo, int32_t rspCode) {
73,673✔
89
  pTaskInfo->code = rspCode;
73,673✔
90
  (void)stopTableScanOperator(pTaskInfo->pRoot, pTaskInfo->id.str, &pTaskInfo->storageAPI);
73,673✔
91
}
73,673✔
92

93
void setTaskStatus(SExecTaskInfo* pTaskInfo, int8_t status) {
1,056,262,172✔
94
  if (status == TASK_NOT_COMPLETED) {
1,056,262,172✔
95
    pTaskInfo->status = status;
339,339,771✔
96
  } else {
97
    // QUERY_NOT_COMPLETED is not compatible with any other status, so clear its position first
98
    CLEAR_QUERY_STATUS(pTaskInfo, TASK_NOT_COMPLETED);
716,922,401✔
99
    pTaskInfo->status |= status;
716,945,009✔
100
  }
101
}
1,056,301,440✔
102

103

104
int32_t initTaskSubJobCtx(SExecTaskInfo* pTaskInfo, SArray** subEndPoints, SReadHandle* readHandle) {
39,188,214✔
105
  int32_t code = 0, lino = 0;
39,188,214✔
106
  int32_t subJobNum = taosArrayGetSize(*subEndPoints);
39,188,214✔
107
  
108
  pTaskInfo->pSubJobCtx = taosMemoryCalloc(1, sizeof(*pTaskInfo->pSubJobCtx));
39,188,214✔
109
  TSDB_CHECK_NULL(pTaskInfo->pSubJobCtx, code, lino, _exit, terrno);
39,184,358✔
110
  
111
  STaskSubJobCtx* ctx = pTaskInfo->pSubJobCtx;
39,184,894✔
112

113
  ctx->queryId = pTaskInfo->id.queryId;
39,188,201✔
114
  ctx->taskId = pTaskInfo->id.taskId;
39,189,822✔
115
  ctx->idStr = pTaskInfo->id.str;
39,187,104✔
116
  ctx->pTaskInfo = pTaskInfo;
39,185,443✔
117
  ctx->subEndPoints = *subEndPoints;
39,182,176✔
118
  ctx->rpcHandle = (readHandle && readHandle->pMsgCb) ? readHandle->pMsgCb->clientRpc : NULL;
39,186,581✔
119
  ctx->isStream = pTaskInfo && IS_STREAM_MODE(pTaskInfo);
39,192,567✔
120

121
  *subEndPoints = NULL;
39,188,202✔
122
  
123
  ctx->subResNodes = taosArrayInit_s(POINTER_BYTES, subJobNum);
39,192,018✔
124
  if (NULL == ctx->subResNodes) {
39,188,724✔
125
    qError("%s taosArrayInit_s %d subResNodes failed, error:%s", GET_TASKID(pTaskInfo), subJobNum, tstrerror(terrno));
×
126
    TSDB_CHECK_NULL(ctx->subResNodes, code, lino, _exit, terrno);
×
127
  }
128
  
129
  TAOS_CHECK_EXIT(tsem_init(&ctx->ready, 0, 0));
39,187,626✔
130

131
  int64_t refId = taosAddRef(fetchObjRefPool, ctx);
39,186,581✔
132
  if (refId < 0) {
39,189,822✔
133
    qError("%s failed at line %d since %s", __func__, __LINE__, tstrerror(terrno));
×
134
    TAOS_CHECK_EXIT(terrno);
×
135
  }
136
  
137
  ctx->subJobRefId = refId;
39,189,822✔
138

139
  qDebug("%s subJobCtx %" PRIu64 " with %d endPoints inited", pTaskInfo->id.str, (uint64_t)refId, (int32_t)taosArrayGetSize(ctx->subEndPoints));
39,183,836✔
140

141
_exit:
38,952,111✔
142

143
  if (code) {
39,183,836✔
144
    destroySubJobCtx(pTaskInfo->pSubJobCtx);
×
145
    pTaskInfo->pSubJobCtx = NULL;
×
146
    
147
    qError("%s failed at line %d since %s", __func__, lino, tstrerror(code));
×
148
  }
149

150
  return code;
39,182,738✔
151
}
152

153

154

155
int32_t createExecTaskInfo(SSubplan* pPlan, SExecTaskInfo** pTaskInfo, SReadHandle* pHandle, uint64_t taskId,
339,067,468✔
156
                           int32_t vgId, char* sql, EOPTR_EXEC_MODEL model, SArray** subEndPoints, bool enableExplain) {
157
  int32_t code = doCreateTask(pPlan->id.queryId, taskId, vgId, model, &pHandle->api, pTaskInfo);
339,067,468✔
158
  if (*pTaskInfo == NULL || code != 0) {
339,007,161✔
UNCOV
159
    nodesDestroyNode((SNode*)pPlan);
×
160
    return code;
×
161
  }
162

163
  (*pTaskInfo)->pSubplan = pPlan;
339,026,721✔
164

165
  if (NULL != sql) {
339,037,015✔
166
    (*pTaskInfo)->sql = taosStrdup(sql);
315,249,504✔
167
    if (NULL == (*pTaskInfo)->sql) {
315,251,634✔
168
      code = terrno;
×
169
      doDestroyTask(*pTaskInfo);
×
170
      (*pTaskInfo) = NULL;
×
171
      return code;
×
172
    }
173
  }
174

175
  (*pTaskInfo)->pWorkerCb = pHandle->pWorkerCb;
339,041,046✔
176
  (*pTaskInfo)->pStreamRuntimeInfo = pHandle->streamRtInfo;
339,042,257✔
177
  (*pTaskInfo)->enableExplain = enableExplain;
339,042,419✔
178

179
  if (subEndPoints && taosArrayGetSize(*subEndPoints) > 0) {
339,014,691✔
180
    code = initTaskSubJobCtx(*pTaskInfo, subEndPoints, pHandle);
39,189,273✔
181
    if (code != TSDB_CODE_SUCCESS) {
39,183,836✔
182
      doDestroyTask(*pTaskInfo);
×
183
      (*pTaskInfo) = NULL;
×
UNCOV
184
      return code;
×
185
    }
186
  }
187
  
188
  setTaskScalarExtraInfo(*pTaskInfo);
338,995,162✔
189
  
190
  code = createOperator(pPlan->pNode, *pTaskInfo, pHandle, pPlan->pTagCond, pPlan->pTagIndexCond, pPlan->user,
339,043,881✔
191
                        pPlan->dbFName, &((*pTaskInfo)->pRoot), model);
339,023,372✔
192

193
  if (NULL == (*pTaskInfo)->pRoot || code != 0) {
338,855,193✔
194
    doDestroyTask(*pTaskInfo);
472,623✔
195
    (*pTaskInfo) = NULL;
469,108✔
196
  }
197
  return code;
338,915,505✔
198
}
199

200
void cleanupQueriedTableScanInfo(void* p) {
258,093,818✔
201
  SSchemaInfo* pSchemaInfo = p;
258,093,818✔
202

203
  taosMemoryFreeClear(pSchemaInfo->dbname);
258,093,818✔
204
  taosMemoryFreeClear(pSchemaInfo->tablename);
258,097,528✔
205
  tDeleteSchemaWrapper(pSchemaInfo->sw);
258,042,064✔
206
  tDeleteSchemaWrapper(pSchemaInfo->qsw);
258,034,713✔
207
}
258,038,789✔
208

209
int32_t initQueriedTableSchemaInfo(SReadHandle* pHandle, SScanPhysiNode* pScanNode, const char* dbName,
258,136,578✔
210
                                   SExecTaskInfo* pTaskInfo) {
211
  SMetaReader mr = {0};
258,136,578✔
212
  if (pHandle == NULL) {
258,143,896✔
UNCOV
213
    return TSDB_CODE_INVALID_PARA;
×
214
  }
215

216
  SStorageAPI* pAPI = &pTaskInfo->storageAPI;
258,143,896✔
217

218
  pAPI->metaReaderFn.initReader(&mr, pHandle->vnode, META_READER_LOCK, &pAPI->metaFn);
258,136,649✔
219
  int32_t code = pAPI->metaReaderFn.getEntryGetUidCache(&mr, pScanNode->uid);
258,150,625✔
220
  if (code != TSDB_CODE_SUCCESS) {
257,972,706✔
UNCOV
221
    qError("failed to get the table meta, uid:0x%" PRIx64 ", suid:0x%" PRIx64 ", %s", pScanNode->uid, pScanNode->suid,
×
222
           GET_TASKID(pTaskInfo));
223

224
    pAPI->metaReaderFn.clearReader(&mr);
×
UNCOV
225
    return code;
×
226
  }
227

228
  SSchemaInfo schemaInfo = {0};
257,972,706✔
229

230
  schemaInfo.tablename = taosStrdup(mr.me.name);
257,983,826✔
231
  schemaInfo.dbname = taosStrdup(dbName);
258,017,860✔
232
  if (schemaInfo.tablename == NULL || schemaInfo.dbname == NULL) {
258,036,973✔
233
    pAPI->metaReaderFn.clearReader(&mr);
124,981✔
234
    cleanupQueriedTableScanInfo(&schemaInfo);
×
UNCOV
235
    return terrno;
×
236
  }
237

238
  if (mr.me.type == TSDB_VIRTUAL_NORMAL_TABLE || mr.me.type == TSDB_VIRTUAL_CHILD_TABLE) {
257,911,992✔
239
    schemaInfo.rversion = mr.me.colRef.version;
290,000✔
240
  }
241

242
  if (mr.me.type == TSDB_SUPER_TABLE) {
257,911,992✔
243
    schemaInfo.sw = tCloneSSchemaWrapper(&mr.me.stbEntry.schemaRow);
112,560,284✔
244
    schemaInfo.tversion = mr.me.stbEntry.schemaTag.version;
112,560,284✔
245
  } else if (mr.me.type == TSDB_CHILD_TABLE || mr.me.type == TSDB_VIRTUAL_CHILD_TABLE) {
145,435,380✔
246
    tDecoderClear(&mr.coder);
102,656,723✔
247

248
    tb_uid_t suid = mr.me.ctbEntry.suid;
102,674,685✔
249
    code = pAPI->metaReaderFn.getEntryGetUidCache(&mr, suid);
102,674,685✔
250
    if (code != TSDB_CODE_SUCCESS) {
102,670,595✔
251
      pAPI->metaReaderFn.clearReader(&mr);
×
252
      cleanupQueriedTableScanInfo(&schemaInfo);
×
UNCOV
253
      return code;
×
254
    }
255

256
    schemaInfo.sw = tCloneSSchemaWrapper(&mr.me.stbEntry.schemaRow);
102,675,066✔
257
    schemaInfo.tversion = mr.me.stbEntry.schemaTag.version;
102,675,066✔
258
  } else {
259
    schemaInfo.sw = tCloneSSchemaWrapper(&mr.me.ntbEntry.schemaRow);
42,781,706✔
260
  }
261

262
  pAPI->metaReaderFn.clearReader(&mr);
258,017,056✔
263

264
  if (schemaInfo.sw == NULL) {
257,913,212✔
265
    cleanupQueriedTableScanInfo(&schemaInfo);
×
UNCOV
266
    return terrno;
×
267
  }
268

269
  schemaInfo.qsw = extractQueriedColumnSchema(pScanNode);
257,913,212✔
270
  if (schemaInfo.qsw == NULL) {
257,975,492✔
271
    cleanupQueriedTableScanInfo(&schemaInfo);
×
UNCOV
272
    return terrno;
×
273
  }
274

275
  void* p = taosArrayPush(pTaskInfo->schemaInfos, &schemaInfo);
257,975,492✔
276
  if (p == NULL) {
258,030,629✔
277
    cleanupQueriedTableScanInfo(&schemaInfo);
×
UNCOV
278
    return terrno;
×
279
  }
280

281
  return code;
258,030,629✔
282
}
283

284
SSchemaWrapper* extractQueriedColumnSchema(SScanPhysiNode* pScanNode) {
257,964,125✔
285
  int32_t numOfCols = LIST_LENGTH(pScanNode->pScanCols);
257,964,125✔
286
  int32_t numOfTags = LIST_LENGTH(pScanNode->pScanPseudoCols);
258,078,020✔
287

288
  SSchemaWrapper* pqSw = taosMemoryCalloc(1, sizeof(SSchemaWrapper));
258,022,616✔
289
  if (pqSw == NULL) {
257,895,790✔
UNCOV
290
    return NULL;
×
291
  }
292

293
  pqSw->pSchema = taosMemoryCalloc(numOfCols + numOfTags, sizeof(SSchema));
257,895,790✔
294
  if (pqSw->pSchema == NULL) {
257,769,917✔
295
    taosMemoryFree(pqSw);
×
UNCOV
296
    return NULL;
×
297
  }
298

299
  for (int32_t i = 0; i < numOfCols; ++i) {
1,141,487,572✔
300
    STargetNode* pNode = (STargetNode*)nodesListGetNode(pScanNode->pScanCols, i);
883,425,949✔
301
    SColumnNode* pColNode = (SColumnNode*)pNode->pExpr;
883,444,729✔
302

303
    SSchema* pSchema = &pqSw->pSchema[pqSw->nCols++];
883,517,043✔
304
    pSchema->colId = pColNode->colId;
883,447,956✔
305
    pSchema->type = pColNode->node.resType.type;
883,524,065✔
306
    pSchema->bytes = pColNode->node.resType.bytes;
883,522,890✔
307
    tstrncpy(pSchema->name, pColNode->colName, tListLen(pSchema->name));
883,573,139✔
308
  }
309

310
  // this the tags and pseudo function columns, we only keep the tag columns
311
  for (int32_t i = 0; i < numOfTags; ++i) {
401,830,938✔
312
    STargetNode* pNode = (STargetNode*)nodesListGetNode(pScanNode->pScanPseudoCols, i);
143,776,393✔
313

314
    int32_t type = nodeType(pNode->pExpr);
143,788,686✔
315
    if (type == QUERY_NODE_COLUMN) {
143,823,863✔
316
      SColumnNode* pColNode = (SColumnNode*)pNode->pExpr;
106,733,788✔
317

318
      SSchema* pSchema = &pqSw->pSchema[pqSw->nCols++];
106,740,224✔
319
      pSchema->colId = pColNode->colId;
106,738,617✔
320
      pSchema->type = pColNode->node.resType.type;
106,712,178✔
321
      pSchema->bytes = pColNode->node.resType.bytes;
106,708,491✔
322
      tstrncpy(pSchema->name, pColNode->colName, tListLen(pSchema->name));
106,693,886✔
323
    }
324
  }
325

326
  return pqSw;
258,054,545✔
327
}
328

329
static void cleanupTmqInfo(STmqTaskInfo* pTmqInfo) {
339,098,081✔
330
  tDeleteSchemaWrapper(pTmqInfo->schema);
339,098,081✔
331
  tOffsetDestroy(&pTmqInfo->currentOffset);
339,133,023✔
332
}
339,094,376✔
333

334
static void freeBlock(void* pParam) {
618,137,934✔
335
  SSDataBlock* pBlock = *(SSDataBlock**)pParam;
618,137,934✔
336
  blockDataDestroy(pBlock);
618,146,156✔
337
}
618,131,084✔
338

339

340
void destroySubJobCtx(STaskSubJobCtx* pCtx) {
39,184,960✔
341
  if (pCtx->transporterId > 0) {
39,184,960✔
342
    int32_t ret = asyncFreeConnById(pCtx->rpcHandle, pCtx->transporterId);
9,333✔
343
    if (ret != 0) {
9,333✔
UNCOV
344
      qDebug("%s failed to free subQ rpc handle, code:%s", pCtx->idStr, tstrerror(ret));
×
345
    }
346
    pCtx->transporterId = -1;
9,333✔
347
  }
348

349
  if (pCtx->subEndPoints != NULL) {
39,190,946✔
350
    size_t size = taosArrayGetSize(pCtx->subEndPoints);
39,187,667✔
351
    if (size > 0) {
39,180,572✔
352
      int32_t code = tsem_destroy(&pCtx->ready);
39,181,121✔
353
      if (code != TSDB_CODE_SUCCESS) {
39,183,851✔
UNCOV
354
        qError("%s failed at line %d since %s", __func__, __LINE__, tstrerror(code));
×
355
      }
356
      taosArrayDestroy(pCtx->subResNodes);
39,183,851✔
357
    }
358
    if (pCtx->isStream) {
39,182,779✔
359
      taosArrayDestroyP(pCtx->subEndPoints, (FDelete)nodesDestroyNode);
15,394✔
360
    } else {
361
      taosArrayDestroyP(pCtx->subEndPoints, NULL);
39,168,470✔
362
    }
363
    pCtx->subEndPoints = NULL;
39,180,515✔
364
  }
365
  
366
  taosMemoryFreeClear(pCtx);  
39,184,854✔
367
}
39,187,104✔
368

369
void doDestroyTask(SExecTaskInfo* pTaskInfo) {
339,182,944✔
370
  qDebug("%s execTask is freed", GET_TASKID(pTaskInfo));
339,182,944✔
371
  destroyOperator(pTaskInfo->pRoot);
339,181,795✔
372
  pTaskInfo->pRoot = NULL;
339,097,512✔
373

374
  if (pTaskInfo->pSubJobCtx) {
339,120,081✔
375
    int32_t  code = taosRemoveRef(fetchObjRefPool, pTaskInfo->pSubJobCtx->subJobRefId);
39,186,567✔
376
    if (code != TSDB_CODE_SUCCESS) {
39,188,227✔
UNCOV
377
      qError("%s failed at line %d since %s", __func__, __LINE__, tstrerror(code));
×
378
    }
379
  }
380

381
  taosArrayDestroyEx(pTaskInfo->schemaInfos, cleanupQueriedTableScanInfo);
339,154,337✔
382
  cleanupTmqInfo(&pTaskInfo->tmqInfo);
339,079,059✔
383

384
  if (!pTaskInfo->localFetch.localExec) {
339,088,682✔
385
    nodesDestroyNode((SNode*)pTaskInfo->pSubplan);
339,117,240✔
386
    pTaskInfo->pSubplan = NULL;
339,103,766✔
387
  }
388

389
  taosArrayDestroyEx(pTaskInfo->pResultBlockList, freeBlock);
339,116,409✔
390
  taosArrayDestroy(pTaskInfo->stopInfo.pStopInfo);
339,136,266✔
391
  if (!pTaskInfo->paramSet) {
339,135,524✔
392
    freeOperatorParam(pTaskInfo->pOpParam, OP_GET_PARAM);
333,170,893✔
393
    pTaskInfo->pOpParam = NULL;
333,085,014✔
394
  }
395
  taosMemoryFreeClear(pTaskInfo->sql);
339,070,830✔
396
  taosMemoryFreeClear(pTaskInfo->id.str);
339,108,169✔
397
  taosMemoryFreeClear(pTaskInfo);
339,119,947✔
398
}
339,083,796✔
399

400
void buildTaskId(uint64_t taskId, uint64_t queryId, char* dst, int32_t len) {
350,817,315✔
401
  int32_t ret = snprintf(dst, len, "TID:0x%" PRIx64 " QID:0x%" PRIx64, taskId, queryId);
350,817,315✔
402
  if (ret < 0) {
350,817,315✔
UNCOV
403
    qError("TID:0x%"PRIx64" QID:0x%"PRIx64" create task id failed,  ignore and continue", taskId, queryId);
×
404
  }
405
}
350,817,315✔
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