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

taosdata / TDengine / #4894

22 Dec 2025 09:33AM UTC coverage: 65.72% (+0.2%) from 65.57%
#4894

push

travis-ci

web-flow
Update README.md (#34007)

* Update README.md

* docs: update table of contents and improve installation instructions in README

* docs: adjust words

---------

Signed-off-by: WANG Xu <feici02@outlook.com>
Co-authored-by: WANG Xu <feici02@outlook.com>

184394 of 280577 relevant lines covered (65.72%)

111859687.16 hits per line

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

81.42
/source/dnode/vnode/src/tsdb/tsdbIter.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 "tsdbIter.h"
17

18
// STsdbIter ================
19
struct STsdbIter {
20
  EIterType type;
21
  bool      noMoreData;
22
  bool      filterByVersion;
23
  int64_t   range[2];
24
  union {
25
    SRowInfo    row[1];
26
    STombRecord record[1];
27
  };
28
  SRBTreeNode node[1];
29
  union {
30
    struct {
31
      SSttFileReader     *reader;
32
      const TSttBlkArray *sttBlkArray;
33
      int32_t             sttBlkArrayIdx;
34
      SBlockData          blockData[1];
35
      int32_t             blockDataIdx;
36
    } sttData[1];
37
    struct {
38
      SDataFileReader     *reader;
39
      const TBrinBlkArray *brinBlkArray;
40
      int32_t              brinBlkArrayIdx;
41
      SBrinBlock           brinBlock[1];
42
      int32_t              brinBlockIdx;
43
      SBlockData           blockData[1];
44
      int32_t              blockDataIdx;
45
    } dataData[1];
46
    struct {
47
      SMemTable  *memt;
48
      STsdbRowKey from[1];
49
      SRBTreeIter iter[1];
50
      STbData    *tbData;
51
      STbDataIter tbIter[1];
52
    } memtData[1];
53
    struct {
54
      SSttFileReader      *reader;
55
      const TTombBlkArray *tombBlkArray;
56
      int32_t              tombBlkArrayIdx;
57
      STombBlock           tombBlock[1];
58
      int32_t              tombBlockIdx;
59
    } sttTomb[1];
60
    struct {
61
      SDataFileReader     *reader;
62
      const TTombBlkArray *tombBlkArray;
63
      int32_t              tombBlkArrayIdx;
64
      STombBlock           tombBlock[1];
65
      int32_t              tombBlockIdx;
66
    } dataTomb[1];
67
    struct {
68
      SMemTable  *memt;
69
      SRBTreeIter rbtIter[1];
70
      STbData    *tbData;
71
      SDelData   *delData;
72
    } memtTomb[1];
73
  };
74
};
75

76
static int32_t tsdbSttIterNext(STsdbIter *iter, const TABLEID *tbid) {
2,147,483,647✔
77
  while (!iter->noMoreData) {
2,147,483,647✔
78
    for (; iter->sttData->blockDataIdx < iter->sttData->blockData->nRow; iter->sttData->blockDataIdx++) {
2,147,483,647✔
79
      int64_t version = iter->sttData->blockData->aVersion[iter->sttData->blockDataIdx];
2,147,483,647✔
80

81
      if (iter->filterByVersion && (version < iter->range[0] || version > iter->range[1])) {
2,147,483,647✔
82
        continue;
×
83
      }
84

85
      iter->row->suid = iter->sttData->blockData->suid;
2,147,483,647✔
86
      iter->row->uid = iter->sttData->blockData->uid ? iter->sttData->blockData->uid
2,147,483,647✔
87
                                                     : iter->sttData->blockData->aUid[iter->sttData->blockDataIdx];
2,147,483,647✔
88

89
      if (tbid && iter->row->suid == tbid->suid && iter->row->uid == tbid->uid) {
2,147,483,647✔
90
        continue;
156,479,072✔
91
      }
92

93
      iter->row->row = tsdbRowFromBlockData(iter->sttData->blockData, iter->sttData->blockDataIdx);
2,147,483,647✔
94
      iter->sttData->blockDataIdx++;
2,147,483,647✔
95
      goto _exit;
2,147,483,647✔
96
    }
97

98
    if (iter->sttData->sttBlkArrayIdx >= TARRAY2_SIZE(iter->sttData->sttBlkArray)) {
15,702,713✔
99
      iter->noMoreData = true;
2,891,377✔
100
      break;
595,284✔
101
    }
102

103
    for (; iter->sttData->sttBlkArrayIdx < TARRAY2_SIZE(iter->sttData->sttBlkArray); iter->sttData->sttBlkArrayIdx++) {
12,873,188✔
104
      const SSttBlk *sttBlk = TARRAY2_GET_PTR(iter->sttData->sttBlkArray, iter->sttData->sttBlkArrayIdx);
12,860,564✔
105

106
      if (iter->filterByVersion && (sttBlk->maxVer < iter->range[0] || sttBlk->minVer > iter->range[1])) {
12,860,564✔
107
        continue;
×
108
      }
109

110
      if (tbid && tbid->suid == sttBlk->suid && tbid->uid == sttBlk->minUid && tbid->uid == sttBlk->maxUid) {
12,860,564✔
111
        continue;
61,852✔
112
      }
113

114
      int32_t code = tsdbSttFileReadBlockData(iter->sttData->reader, sttBlk, iter->sttData->blockData);
12,798,712✔
115
      if (code) return code;
12,797,732✔
116

117
      iter->sttData->blockDataIdx = 0;
12,797,732✔
118
      iter->sttData->sttBlkArrayIdx++;
12,798,246✔
119
      break;
12,798,024✔
120
    }
121
  }
122

123
_exit:
269✔
124
  return 0;
2,147,483,647✔
125
}
126

127
static int32_t tsdbDataIterNext(STsdbIter *iter, const TABLEID *tbid) {
1,260,189,911✔
128
  int32_t code;
129

130
  while (!iter->noMoreData) {
1,260,219,521✔
131
    for (;;) {
132
      // SBlockData
133
      for (; iter->dataData->blockDataIdx < iter->dataData->blockData->nRow; iter->dataData->blockDataIdx++) {
1,275,102,583✔
134
        int64_t version = iter->dataData->blockData->aVersion[iter->dataData->blockDataIdx];
1,274,680,727✔
135
        if (iter->filterByVersion && (version < iter->range[0] || version > iter->range[1])) {
1,274,670,816✔
136
          continue;
14,423,440✔
137
        }
138

139
        if (tbid && tbid->suid == iter->dataData->blockData->suid && tbid->uid == iter->dataData->blockData->uid) {
1,260,233,127✔
140
          iter->dataData->blockDataIdx = iter->dataData->blockData->nRow;
40,516✔
141
          break;
40,516✔
142
        }
143

144
        iter->row->row = tsdbRowFromBlockData(iter->dataData->blockData, iter->dataData->blockDataIdx);
1,260,192,611✔
145
        iter->dataData->blockDataIdx++;
1,260,204,735✔
146
        goto _exit;
1,260,203,859✔
147
      }
148

149
      // SBrinBlock
150
      if (iter->dataData->brinBlockIdx >= iter->dataData->brinBlock->numOfRecords) {
459,457✔
151
        break;
59,220✔
152
      }
153

154
      for (; iter->dataData->brinBlockIdx < iter->dataData->brinBlock->numOfRecords; iter->dataData->brinBlockIdx++) {
460,982✔
155
        SBrinRecord record[1];
449,171✔
156
        code = tBrinBlockGet(iter->dataData->brinBlock, iter->dataData->brinBlockIdx, record);
449,171✔
157
        if (code) return code;
449,171✔
158

159
        if (iter->filterByVersion && (record->maxVer < iter->range[0] || record->minVer > iter->range[1])) {
449,171✔
160
          continue;
12,360✔
161
        }
162

163
        if (tbid && tbid->suid == record->suid && tbid->uid == record->uid) {
436,811✔
164
          continue;
44,014✔
165
        }
166

167
        iter->row->suid = record->suid;
392,797✔
168
        iter->row->uid = record->uid;
392,797✔
169

170
        code = tsdbDataFileReadBlockData(iter->dataData->reader, record, iter->dataData->blockData);
392,797✔
171
        if (code) return code;
392,797✔
172

173
        iter->dataData->blockDataIdx = 0;
392,797✔
174
        iter->dataData->brinBlockIdx++;
392,797✔
175
        break;
392,797✔
176
      }
177
    }
178

179
    if (iter->dataData->brinBlkArrayIdx >= TARRAY2_SIZE(iter->dataData->brinBlkArray)) {
59,220✔
180
      iter->noMoreData = true;
29,610✔
181
      break;
23,200✔
182
    }
183

184
    for (; iter->dataData->brinBlkArrayIdx < TARRAY2_SIZE(iter->dataData->brinBlkArray);
29,610✔
185
         iter->dataData->brinBlkArrayIdx++) {
×
186
      const SBrinBlk *brinBlk = TARRAY2_GET_PTR(iter->dataData->brinBlkArray, iter->dataData->brinBlkArrayIdx);
29,610✔
187

188
      if (iter->filterByVersion && (brinBlk->maxVer < iter->range[0] || brinBlk->minVer > iter->range[1])) {
29,610✔
189
        continue;
×
190
      }
191

192
      if (tbid && tbid->uid == brinBlk->minTbid.uid && tbid->uid == brinBlk->maxTbid.uid) {
29,610✔
193
        continue;
×
194
      }
195

196
      code = tsdbDataFileReadBrinBlock(iter->dataData->reader, brinBlk, iter->dataData->brinBlock);
29,610✔
197
      if (code) return code;
29,610✔
198

199
      iter->dataData->brinBlockIdx = 0;
29,610✔
200
      iter->dataData->brinBlkArrayIdx++;
29,610✔
201
      break;
29,610✔
202
    }
203
  }
204

205
_exit:
3✔
206
  return 0;
1,260,226,772✔
207
}
208

209
static int32_t tsdbMemTableIterNext(STsdbIter *iter, const TABLEID *tbid) {
2,147,483,647✔
210
  SRBTreeNode *node;
211

212
  while (!iter->noMoreData) {
2,147,483,647✔
213
    for (TSDBROW *row; iter->memtData->tbData && (row = tsdbTbDataIterGet(iter->memtData->tbIter));) {
2,147,483,647✔
214
      if (tbid && tbid->suid == iter->memtData->tbData->suid && tbid->uid == iter->memtData->tbData->uid) {
2,147,483,647✔
215
        iter->memtData->tbData = NULL;
38,513,976✔
216
        break;
38,514,404✔
217
      }
218

219
      if (iter->filterByVersion) {
2,147,483,647✔
220
        int64_t version = TSDBROW_VERSION(row);
×
221
        if (version < iter->range[0] || version > iter->range[1]) {
×
222
          continue;
×
223
        }
224
      }
225

226
      iter->row->row = row[0];
2,147,483,647✔
227

228
      bool r = tsdbTbDataIterNext(iter->memtData->tbIter);
2,147,483,647✔
229
      goto _exit;
2,147,483,647✔
230
    }
231

232
    for (;;) {
233
      node = tRBTreeIterNext(iter->memtData->iter);
102,504,746✔
234
      if (!node) {
102,512,866✔
235
        iter->noMoreData = true;
15,567,098✔
236
        goto _exit;
5,071✔
237
      }
238

239
      iter->memtData->tbData = TCONTAINER_OF(node, STbData, rbtn);
86,945,768✔
240
      if (tbid && tbid->suid == iter->memtData->tbData->suid && tbid->uid == iter->memtData->tbData->uid) {
86,945,968✔
241
        continue;
×
242
      } else {
243
        iter->row->suid = iter->memtData->tbData->suid;
86,945,349✔
244
        iter->row->uid = iter->memtData->tbData->uid;
86,949,039✔
245
        tsdbTbDataIterOpen(iter->memtData->tbData, iter->memtData->from, 0, iter->memtData->tbIter);
86,950,774✔
246
        break;
86,956,072✔
247
      }
248
    }
249
  }
250

251
_exit:
74✔
252
  return 0;
2,147,483,647✔
253
}
254

255
static int32_t tsdbDataTombIterNext(STsdbIter *iter, const TABLEID *tbid) {
×
256
  while (!iter->noMoreData) {
×
257
    for (; iter->dataTomb->tombBlockIdx < TOMB_BLOCK_SIZE(iter->dataTomb->tombBlock); iter->dataTomb->tombBlockIdx++) {
×
258
      int32_t code = tTombBlockGet(iter->dataTomb->tombBlock, iter->dataTomb->tombBlockIdx, iter->record);
×
259
      if (code) return code;
×
260

261
      if (iter->filterByVersion && (iter->record->version < iter->range[0] || iter->record->version > iter->range[1])) {
×
262
        continue;
×
263
      }
264

265
      if (tbid && iter->record->suid == tbid->suid && iter->record->uid == tbid->uid) {
×
266
        continue;
×
267
      }
268
      iter->dataTomb->tombBlockIdx++;
×
269
      goto _exit;
×
270
    }
271

272
    if (iter->dataTomb->tombBlkArrayIdx >= TARRAY2_SIZE(iter->dataTomb->tombBlkArray)) {
×
273
      iter->noMoreData = true;
×
274
      goto _exit;
×
275
    }
276

277
    for (; iter->dataTomb->tombBlkArrayIdx < TARRAY2_SIZE(iter->dataTomb->tombBlkArray);
×
278
         iter->dataTomb->tombBlkArrayIdx++) {
×
279
      const STombBlk *tombBlk = TARRAY2_GET_PTR(iter->dataTomb->tombBlkArray, iter->dataTomb->tombBlkArrayIdx);
×
280

281
      if (tbid && tbid->suid == tombBlk->minTbid.suid && tbid->uid == tombBlk->minTbid.uid &&
×
282
          tbid->suid == tombBlk->maxTbid.suid && tbid->uid == tombBlk->maxTbid.uid) {
×
283
        continue;
×
284
      }
285

286
      int32_t code = tsdbDataFileReadTombBlock(iter->dataTomb->reader, tombBlk, iter->dataTomb->tombBlock);
×
287
      if (code) return code;
×
288

289
      iter->dataTomb->tombBlockIdx = 0;
×
290
      iter->dataTomb->tombBlkArrayIdx++;
×
291
      break;
×
292
    }
293
  }
294

295
_exit:
×
296
  return 0;
×
297
}
298

299
static int32_t tsdbMemTombIterNext(STsdbIter *iter, const TABLEID *tbid) {
3,003,491✔
300
  while (!iter->noMoreData) {
5,089,881✔
301
    for (; iter->memtTomb->delData;) {
5,089,881✔
302
      if (tbid && tbid->uid == iter->memtTomb->tbData->uid) {
1,844,002✔
303
        iter->memtTomb->delData = NULL;
×
304
        break;
×
305
      }
306

307
      if (iter->filterByVersion &&
1,844,002✔
308
          (iter->memtTomb->delData->version < iter->range[0] || iter->memtTomb->delData->version > iter->range[1])) {
×
309
        continue;
×
310
      }
311

312
      iter->record->suid = iter->memtTomb->tbData->suid;
1,844,002✔
313
      iter->record->uid = iter->memtTomb->tbData->uid;
1,844,002✔
314
      iter->record->version = iter->memtTomb->delData->version;
1,844,002✔
315
      iter->record->skey = iter->memtTomb->delData->sKey;
1,844,002✔
316
      iter->record->ekey = iter->memtTomb->delData->eKey;
1,844,002✔
317

318
      iter->memtTomb->delData = iter->memtTomb->delData->pNext;
1,844,002✔
319
      goto _exit;
1,844,002✔
320
    }
321

322
    for (;;) {
×
323
      SRBTreeNode *node = tRBTreeIterNext(iter->memtTomb->rbtIter);
3,245,879✔
324
      if (node == NULL) {
3,245,879✔
325
        iter->noMoreData = true;
1,159,489✔
326
        goto _exit;
1,159,489✔
327
      }
328

329
      iter->memtTomb->tbData = TCONTAINER_OF(node, STbData, rbtn);
2,086,390✔
330
      if (tbid && tbid->uid == iter->memtTomb->tbData->uid) {
2,086,390✔
331
        continue;
×
332
      } else {
333
        iter->memtTomb->delData = iter->memtTomb->tbData->pHead;
2,086,390✔
334
        break;
2,086,390✔
335
      }
336
    }
337
  }
338

339
_exit:
×
340
  return 0;
3,003,491✔
341
}
342

343
static int32_t tsdbSttIterOpen(STsdbIter *iter) {
2,943,633✔
344
  int32_t code;
345

346
  code = tsdbSttFileReadSttBlk(iter->sttData->reader, &iter->sttData->sttBlkArray);
2,943,633✔
347
  if (code) return code;
2,943,633✔
348

349
  if (TARRAY2_SIZE(iter->sttData->sttBlkArray) == 0) {
2,943,633✔
350
    iter->noMoreData = true;
51,948✔
351
    return 0;
51,948✔
352
  }
353

354
  iter->sttData->sttBlkArrayIdx = 0;
2,891,685✔
355
  code = tBlockDataCreate(iter->sttData->blockData);
2,891,685✔
356
  if (code) return code;
2,891,685✔
357
  iter->sttData->blockDataIdx = 0;
2,891,685✔
358

359
  return tsdbSttIterNext(iter, NULL);
2,891,685✔
360
}
361

362
static int32_t tsdbDataIterOpen(STsdbIter *iter) {
133,995✔
363
  int32_t code;
364

365
  // SBrinBlk
366
  code = tsdbDataFileReadBrinBlk(iter->dataData->reader, &iter->dataData->brinBlkArray);
133,995✔
367
  if (code) return code;
133,307✔
368

369
  if (TARRAY2_SIZE(iter->dataData->brinBlkArray) == 0) {
133,307✔
370
    iter->noMoreData = true;
104,385✔
371
    return 0;
103,697✔
372
  }
373

374
  iter->dataData->brinBlkArrayIdx = 0;
29,610✔
375

376
  // SBrinBlock
377
  code = tBrinBlockInit(iter->dataData->brinBlock);
29,610✔
378
  if (code) return code;
29,610✔
379
  iter->dataData->brinBlockIdx = 0;
29,610✔
380

381
  // SBlockData
382
  code = tBlockDataCreate(iter->dataData->blockData);
29,610✔
383
  if (code) return code;
29,610✔
384
  iter->dataData->blockDataIdx = 0;
29,610✔
385

386
  return tsdbDataIterNext(iter, NULL);
29,610✔
387
}
388

389
static int32_t tsdbMemTableIterOpen(STsdbIter *iter) {
15,597,606✔
390
  if (iter->memtData->memt->nRow == 0) {
15,597,606✔
391
    iter->noMoreData = true;
59,784✔
392
    return 0;
59,784✔
393
  }
394

395
  iter->memtData->iter[0] = tRBTreeIterCreate(iter->memtData->memt->tbDataTree, 1);
15,564,239✔
396
  return tsdbMemTableIterNext(iter, NULL);
15,561,107✔
397
}
398

399
static int32_t tsdbSttIterClose(STsdbIter *iter) {
2,943,633✔
400
  tBlockDataDestroy(iter->sttData->blockData);
2,943,633✔
401
  return 0;
2,943,633✔
402
}
403

404
static int32_t tsdbDataTombIterOpen(STsdbIter *iter) {
133,995✔
405
  int32_t code;
406

407
  code = tsdbDataFileReadTombBlk(iter->dataTomb->reader, &iter->dataTomb->tombBlkArray);
133,995✔
408
  if (code) return code;
133,995✔
409

410
  if (TARRAY2_SIZE(iter->dataTomb->tombBlkArray) == 0) {
133,995✔
411
    iter->noMoreData = true;
133,995✔
412
    return 0;
133,307✔
413
  }
414
  iter->dataTomb->tombBlkArrayIdx = 0;
×
415

416
  tTombBlockInit(iter->dataTomb->tombBlock);
×
417
  iter->dataTomb->tombBlockIdx = 0;
×
418

419
  return tsdbDataTombIterNext(iter, NULL);
×
420
}
421

422
static int32_t tsdbMemTombIterOpen(STsdbIter *iter) {
15,620,004✔
423
  int32_t code;
424

425
  if (iter->memtTomb->memt->nDel == 0) {
15,620,004✔
426
    iter->noMoreData = true;
14,463,455✔
427
    return 0;
14,462,627✔
428
  }
429

430
  iter->memtTomb->rbtIter[0] = tRBTreeIterCreate(iter->memtTomb->memt->tbDataTree, 1);
1,160,268✔
431
  return tsdbMemTombIterNext(iter, NULL);
1,160,268✔
432
}
433

434
static int32_t tsdbDataIterClose(STsdbIter *iter) {
133,995✔
435
  tBrinBlockDestroy(iter->dataData->brinBlock);
133,995✔
436
  tBlockDataDestroy(iter->dataData->blockData);
133,995✔
437
  return 0;
133,995✔
438
}
439

440
static int32_t tsdbMemTableIterClose(STsdbIter *iter) { return 0; }
15,614,271✔
441

442
static int32_t tsdbSttTombIterNext(STsdbIter *iter, const TABLEID *tbid) {
6,847,955✔
443
  while (!iter->noMoreData) {
8,478,423✔
444
    for (; iter->sttTomb->tombBlockIdx < TOMB_BLOCK_SIZE(iter->sttTomb->tombBlock); iter->sttTomb->tombBlockIdx++) {
9,571,075✔
445
      int32_t code = tTombBlockGet(iter->sttTomb->tombBlock, iter->sttTomb->tombBlockIdx, iter->record);
6,310,139✔
446
      if (code) return code;
6,310,139✔
447

448
      if (iter->filterByVersion && (iter->record->version < iter->range[0] || iter->record->version > iter->range[1])) {
6,310,139✔
449
        continue;
×
450
      }
451

452
      if (tbid && iter->record->suid == tbid->suid && iter->record->uid == tbid->uid) {
6,310,139✔
453
        continue;
1,092,652✔
454
      }
455

456
      iter->sttTomb->tombBlockIdx++;
5,217,487✔
457
      goto _exit;
5,217,487✔
458
    }
459

460
    if (iter->sttTomb->tombBlkArrayIdx >= TARRAY2_SIZE(iter->sttTomb->tombBlkArray)) {
3,260,936✔
461
      iter->noMoreData = true;
1,630,468✔
462
      goto _exit;
1,630,468✔
463
    }
464

465
    for (; iter->sttTomb->tombBlkArrayIdx < TARRAY2_SIZE(iter->sttTomb->tombBlkArray);
1,630,468✔
466
         iter->sttTomb->tombBlkArrayIdx++) {
×
467
      const STombBlk *tombBlk = TARRAY2_GET_PTR(iter->sttTomb->tombBlkArray, iter->sttTomb->tombBlkArrayIdx);
1,630,468✔
468

469
      if (iter->filterByVersion && (tombBlk->maxVer < iter->range[0] || tombBlk->minVer > iter->range[1])) {
1,630,468✔
470
        continue;
×
471
      }
472

473
      if (tbid && tbid->suid == tombBlk->minTbid.suid && tbid->uid == tombBlk->minTbid.uid &&
1,630,468✔
474
          tbid->suid == tombBlk->maxTbid.suid && tbid->uid == tombBlk->maxTbid.uid) {
×
475
        continue;
×
476
      }
477

478
      int32_t code = tsdbSttFileReadTombBlock(iter->sttTomb->reader, tombBlk, iter->sttTomb->tombBlock);
1,630,468✔
479
      if (code) return code;
1,630,468✔
480

481
      iter->sttTomb->tombBlockIdx = 0;
1,630,468✔
482
      iter->sttTomb->tombBlkArrayIdx++;
1,630,468✔
483
      break;
1,630,468✔
484
    }
485
  }
486

487
_exit:
×
488
  return 0;
6,847,955✔
489
}
490

491
static int32_t tsdbSttTombIterOpen(STsdbIter *iter) {
2,943,633✔
492
  int32_t code;
493

494
  code = tsdbSttFileReadTombBlk(iter->sttTomb->reader, &iter->sttTomb->tombBlkArray);
2,943,633✔
495
  if (code) return code;
2,941,568✔
496

497
  if (TARRAY2_SIZE(iter->sttTomb->tombBlkArray) == 0) {
2,941,568✔
498
    iter->noMoreData = true;
1,312,477✔
499
    return 0;
1,311,789✔
500
  }
501

502
  iter->sttTomb->tombBlkArrayIdx = 0;
1,630,468✔
503
  tTombBlockInit(iter->sttTomb->tombBlock);
1,630,468✔
504
  iter->sttTomb->tombBlockIdx = 0;
1,630,468✔
505

506
  return tsdbSttTombIterNext(iter, NULL);
1,630,468✔
507
}
508

509
int32_t tsdbIterOpen(const STsdbIterConfig *config, STsdbIter **iter) {
37,371,983✔
510
  int32_t code;
511

512
  iter[0] = taosMemoryCalloc(1, sizeof(*iter[0]));
37,371,983✔
513
  if (iter[0] == NULL) {
37,369,455✔
514
    return terrno;
×
515
  }
516

517
  iter[0]->type = config->type;
37,373,077✔
518
  iter[0]->noMoreData = false;
37,381,031✔
519
  iter[0]->filterByVersion = config->filterByVersion;
37,381,584✔
520
  if (iter[0]->filterByVersion) {
37,385,510✔
521
    iter[0]->range[0] = config->verRange[0];
1,918✔
522
    iter[0]->range[1] = config->verRange[1];
1,918✔
523
  }
524

525
  switch (config->type) {
37,388,601✔
526
    case TSDB_ITER_TYPE_STT:
2,943,633✔
527
      iter[0]->sttData->reader = config->sttReader;
2,943,633✔
528
      code = tsdbSttIterOpen(iter[0]);
2,943,633✔
529
      break;
2,941,742✔
530
    case TSDB_ITER_TYPE_DATA:
133,995✔
531
      iter[0]->dataData->reader = config->dataReader;
133,995✔
532
      code = tsdbDataIterOpen(iter[0]);
133,995✔
533
      break;
133,995✔
534
    case TSDB_ITER_TYPE_MEMT:
15,605,524✔
535
      iter[0]->memtData->memt = config->memt;
15,605,524✔
536
      iter[0]->memtData->from[0] = config->from[0];
15,617,324✔
537
      code = tsdbMemTableIterOpen(iter[0]);
15,623,895✔
538
      break;
15,623,899✔
539
    case TSDB_ITER_TYPE_STT_TOMB:
2,942,945✔
540
      iter[0]->sttTomb->reader = config->sttReader;
2,942,945✔
541
      code = tsdbSttTombIterOpen(iter[0]);
2,943,633✔
542
      break;
2,941,568✔
543
    case TSDB_ITER_TYPE_DATA_TOMB:
133,307✔
544
      iter[0]->dataTomb->reader = config->dataReader;
133,307✔
545
      code = tsdbDataTombIterOpen(iter[0]);
133,995✔
546
      break;
133,995✔
547
    case TSDB_ITER_TYPE_MEMT_TOMB:
15,618,720✔
548
      iter[0]->memtTomb->memt = config->memt;
15,618,720✔
549
      code = tsdbMemTombIterOpen(iter[0]);
15,624,570✔
550
      break;
15,615,401✔
551
    default:
×
552
      return TSDB_CODE_INVALID_PARA;
×
553
  }
554

555
  if (code) {
37,390,600✔
556
    taosMemoryFree(iter[0]);
×
557
    iter[0] = NULL;
×
558
  }
559
  return code;
37,390,600✔
560
}
561

562
static int32_t tsdbSttTombIterClose(STsdbIter *iter) {
2,943,633✔
563
  tTombBlockDestroy(iter->sttTomb->tombBlock);
2,943,633✔
564
  return 0;
2,943,633✔
565
}
566

567
static int32_t tsdbDataTombIterClose(STsdbIter *iter) {
133,995✔
568
  tTombBlockDestroy(iter->dataTomb->tombBlock);
133,995✔
569
  return 0;
133,995✔
570
}
571

572
int32_t tsdbIterClose(STsdbIter **iter) {
37,379,851✔
573
  switch (iter[0]->type) {
37,379,851✔
574
    case TSDB_ITER_TYPE_STT:
2,943,633✔
575
      tsdbSttIterClose(iter[0]);
2,943,633✔
576
      break;
2,943,633✔
577
    case TSDB_ITER_TYPE_DATA:
133,995✔
578
      tsdbDataIterClose(iter[0]);
133,995✔
579
      break;
133,995✔
580
    case TSDB_ITER_TYPE_MEMT:
15,619,390✔
581
      tsdbMemTableIterClose(iter[0]);
15,619,390✔
582
      break;
15,617,651✔
583
    case TSDB_ITER_TYPE_STT_TOMB:
2,943,633✔
584
      tsdbSttTombIterClose(iter[0]);
2,943,633✔
585
      break;
2,943,633✔
586
    case TSDB_ITER_TYPE_DATA_TOMB:
133,995✔
587
      tsdbDataTombIterClose(iter[0]);
133,995✔
588
      break;
133,995✔
589
    case TSDB_ITER_TYPE_MEMT_TOMB:
15,607,639✔
590
      break;
15,607,639✔
591
    default:
×
592
      return TSDB_CODE_INVALID_PARA;
×
593
  }
594
  taosMemoryFree(iter[0]);
37,380,546✔
595
  iter[0] = NULL;
37,386,576✔
596
  return 0;
37,388,791✔
597
}
598

599
int32_t tsdbIterNext(STsdbIter *iter) {
2,147,483,647✔
600
  switch (iter->type) {
2,147,483,647✔
601
    case TSDB_ITER_TYPE_STT:
2,147,483,647✔
602
      return tsdbSttIterNext(iter, NULL);
2,147,483,647✔
603
    case TSDB_ITER_TYPE_DATA:
1,260,149,345✔
604
      return tsdbDataIterNext(iter, NULL);
1,260,149,345✔
605
    case TSDB_ITER_TYPE_MEMT:
2,147,483,647✔
606
      return tsdbMemTableIterNext(iter, NULL);
2,147,483,647✔
607
    case TSDB_ITER_TYPE_STT_TOMB:
5,104,842✔
608
      return tsdbSttTombIterNext(iter, NULL);
5,104,842✔
609
    case TSDB_ITER_TYPE_DATA_TOMB:
×
610
      return tsdbDataTombIterNext(iter, NULL);
×
611
    case TSDB_ITER_TYPE_MEMT_TOMB:
×
612
      return tsdbMemTombIterNext(iter, NULL);
×
613
    default:
×
614
      return TSDB_CODE_INVALID_PARA;
×
615
  }
616
  return 0;
617
}
618

619
static int32_t tsdbIterSkipTableData(STsdbIter *iter, const TABLEID *tbid) {
40,539,423✔
620
  switch (iter->type) {
40,539,423✔
621
    case TSDB_ITER_TYPE_STT:
397,157✔
622
      return tsdbSttIterNext(iter, tbid);
397,157✔
623
    case TSDB_ITER_TYPE_DATA:
40,516✔
624
      return tsdbDataIterNext(iter, tbid);
40,516✔
625
    case TSDB_ITER_TYPE_MEMT:
39,972,090✔
626
      return tsdbMemTableIterNext(iter, tbid);
39,972,090✔
627
    case TSDB_ITER_TYPE_STT_TOMB:
112,645✔
628
      return tsdbSttTombIterNext(iter, tbid);
112,645✔
629
    case TSDB_ITER_TYPE_DATA_TOMB:
×
630
      return tsdbDataTombIterNext(iter, tbid);
×
631
    case TSDB_ITER_TYPE_MEMT_TOMB:
20,130✔
632
      return tsdbMemTombIterNext(iter, tbid);
20,130✔
633
    default:
×
634
      return TSDB_CODE_INVALID_PARA;
×
635
  }
636
  return 0;
637
}
638

639
static int32_t tsdbIterCmprFn(const SRBTreeNode *n1, const SRBTreeNode *n2) {
2,147,483,647✔
640
  STsdbIter *iter1 = TCONTAINER_OF(n1, STsdbIter, node);
2,147,483,647✔
641
  STsdbIter *iter2 = TCONTAINER_OF(n2, STsdbIter, node);
2,147,483,647✔
642
  return tRowInfoCmprFn(&iter1->row, &iter2->row);
2,147,483,647✔
643
}
644

645
static int32_t tsdbTombIterCmprFn(const SRBTreeNode *n1, const SRBTreeNode *n2) {
11,536,370✔
646
  STsdbIter *iter1 = TCONTAINER_OF(n1, STsdbIter, node);
11,536,370✔
647
  STsdbIter *iter2 = TCONTAINER_OF(n2, STsdbIter, node);
11,536,370✔
648

649
  if (iter1->record->suid < iter2->record->suid) {
11,536,370✔
650
    return -1;
173,412✔
651
  } else if (iter1->record->suid > iter2->record->suid) {
11,362,958✔
652
    return 1;
139,986✔
653
  }
654

655
  if (iter1->record->uid < iter2->record->uid) {
11,222,972✔
656
    return -1;
813,248✔
657
  } else if (iter1->record->uid > iter2->record->uid) {
10,409,724✔
658
    return 1;
1,393,730✔
659
  }
660

661
  if (iter1->record->version < iter2->record->version) {
9,015,994✔
662
    return -1;
5,529,212✔
663
  } else if (iter1->record->version > iter2->record->version) {
3,486,782✔
664
    return 1;
3,486,782✔
665
  }
666

667
  return 0;
×
668
}
669

670
// SIterMerger ================
671
struct SIterMerger {
672
  bool       isTomb;
673
  STsdbIter *iter;
674
  SRBTree    iterTree[1];
675
};
676

677
int32_t tsdbIterMergerOpen(const TTsdbIterArray *iterArray, SIterMerger **merger, bool isTomb) {
33,488,666✔
678
  STsdbIter   *iter;
679
  SRBTreeNode *node;
680

681
  merger[0] = taosMemoryCalloc(1, sizeof(*merger[0]));
33,488,666✔
682
  if (merger[0] == NULL) {
33,480,729✔
683
    return terrno;
×
684
  }
685

686
  merger[0]->isTomb = isTomb;
33,480,956✔
687
  if (isTomb) {
33,486,667✔
688
    tRBTreeCreate(merger[0]->iterTree, tsdbTombIterCmprFn);
16,743,262✔
689
  } else {
690
    tRBTreeCreate(merger[0]->iterTree, tsdbIterCmprFn);
16,743,405✔
691
  }
692
  TARRAY2_FOREACH(iterArray, iter) {
70,901,522✔
693
    while (!iter->noMoreData) {
37,389,352✔
694
      if (tRBTreePut(merger[0]->iterTree, iter->node) == NULL) {
21,252,289✔
695
        int32_t code = tsdbIterNext(iter);
×
696
        if (code) {
×
697
          tsdbIterMergerClose(merger);
×
698
          return code;
×
699
        }
700
        continue;
×
701
      }
702
      break;
21,256,941✔
703
    }
704
  }
705

706
  return tsdbIterMergerNext(merger[0]);
33,480,374✔
707
}
708

709
void tsdbIterMergerClose(SIterMerger **merger) {
33,500,091✔
710
  if (merger[0]) {
33,500,091✔
711
    taosMemoryFree(merger[0]);
33,506,292✔
712
    merger[0] = NULL;
33,494,812✔
713
  }
714
}
33,495,029✔
715

716
int32_t tsdbIterMergerNext(SIterMerger *merger) {
2,147,483,647✔
717
  int32_t      code;
718
  int32_t      c;
719
  SRBTreeNode *node;
720

721
  while (merger->iter) {
2,147,483,647✔
722
    code = tsdbIterNext(merger->iter);
2,147,483,647✔
723
    if (code) return code;
2,147,483,647✔
724

725
    if (merger->iter->noMoreData) {
2,147,483,647✔
726
      merger->iter = NULL;
8,148,700✔
727
    } else if ((node = tRBTreeMin(merger->iterTree))) {
2,147,483,647✔
728
      c = merger->iterTree->cmprFn(merger->iter->node, node);
2,147,483,647✔
729
      if (c > 0) {
2,147,483,647✔
730
        node = tRBTreePut(merger->iterTree, merger->iter->node);
39,375,853✔
731
        merger->iter = NULL;
39,372,013✔
732
      } else if (c == 0) {
2,147,483,647✔
733
        continue;
×
734
      }
735
    }
736
    break;
2,147,483,647✔
737
  }
738

739
  if (merger->iter == NULL && (node = tRBTreeDropMin(merger->iterTree))) {
2,147,483,647✔
740
    merger->iter = TCONTAINER_OF(node, STsdbIter, node);
60,514,936✔
741
  }
742

743
  return 0;
2,147,483,647✔
744
}
745

746
SRowInfo *tsdbIterMergerGetData(SIterMerger *merger) { return merger->iter ? merger->iter->row : NULL; }
2,147,483,647✔
747

748
STombRecord *tsdbIterMergerGetTombRecord(SIterMerger *merger) { return merger->iter ? merger->iter->record : NULL; }
23,837,507✔
749

750
int32_t tsdbIterMergerSkipTableData(SIterMerger *merger, const TABLEID *tbid) {
40,461,221✔
751
  int32_t      code;
752
  int32_t      c;
753
  SRBTreeNode *node;
754

755
  while (merger->iter && tbid->suid == merger->iter->row->suid && tbid->uid == merger->iter->row->uid) {
81,009,094✔
756
    int32_t code = tsdbIterSkipTableData(merger->iter, tbid);
40,547,459✔
757
    if (code) return code;
40,549,231✔
758

759
    while (1) {
760
      if (merger->iter->noMoreData) {
40,549,231✔
761
        merger->iter = NULL;
13,119,927✔
762
      } else if ((node = tRBTreeMin(merger->iterTree))) {
27,429,476✔
763
        c = merger->iterTree->cmprFn(merger->iter->node, node);
182,890✔
764
        if (c > 0) {
182,890✔
765
          node = tRBTreePut(merger->iterTree, merger->iter->node);
113,074✔
766
          merger->iter = NULL;
113,074✔
767
        } else if (c == 0) {
69,816✔
768
          code = tsdbIterNext(merger->iter);
×
769
          if (code) return code;
×
770
          continue;
×
771
        }
772
      }
773
      break;
40,545,789✔
774
    }
775

776
    if (!merger->iter && (node = tRBTreeDropMin(merger->iterTree))) {
40,545,789✔
777
      merger->iter = TCONTAINER_OF(node, STsdbIter, node);
235,941✔
778
    }
779
  }
780

781
  return 0;
40,470,418✔
782
}
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