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

taosdata / TDengine / #3844

10 Apr 2025 08:48AM UTC coverage: 43.852% (-19.2%) from 63.077%
#3844

push

travis-ci

web-flow
fix: the REPLICA parameter supports plural forms when used to create and alter a database (#30732)

104394 of 310659 branches covered (33.6%)

Branch coverage included in aggregate %.

167442 of 309240 relevant lines covered (54.15%)

3866624.94 hits per line

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

55.6
/source/dnode/vnode/src/vnd/vnodeSnapshot.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 "tsdb.h"
17
#include "vnd.h"
18

19
static int32_t vnodeExtractSnapInfoDiff(void *buf, int32_t bufLen, TFileSetRangeArray **ppRanges) {
8✔
20
  int32_t            code = 0;
8✔
21
  STsdbFSetPartList *pList = tsdbFSetPartListCreate();
8✔
22
  if (pList == NULL) {
8!
23
    code = terrno;
×
24
    goto _out;
×
25
  }
26

27
  code = tDeserializeTsdbFSetPartList(buf, bufLen, pList);
8✔
28
  if (code) goto _out;
8!
29

30
  code = tsdbFSetPartListToRangeDiff(pList, ppRanges);
8✔
31
  if (code) goto _out;
8!
32

33
_out:
8✔
34
  tsdbFSetPartListDestroy(&pList);
8✔
35
  return code;
8✔
36
}
37

38
// SVSnapReader ========================================================
39
struct SVSnapReader {
40
  SVnode *pVnode;
41
  int64_t sver;
42
  int64_t ever;
43
  int64_t index;
44
  // config
45
  int8_t cfgDone;
46
  // meta
47
  int8_t           metaDone;
48
  SMetaSnapReader *pMetaReader;
49
  // tsdb
50
  int8_t              tsdbDone;
51
  TFileSetRangeArray *pRanges;
52
  STsdbSnapReader    *pTsdbReader;
53
  // tsdb raw
54
  int8_t              tsdbRAWDone;
55
  STsdbSnapRAWReader *pTsdbRAWReader;
56

57
  // tq
58
  int8_t         tqHandleDone;
59
  STqSnapReader *pTqSnapReader;
60
  int8_t         tqOffsetDone;
61
  STqSnapReader *pTqOffsetReader;
62
  int8_t         tqCheckInfoDone;
63
  STqSnapReader *pTqCheckInfoReader;
64
  // stream
65
  int8_t              streamTaskDone;
66
  SStreamTaskReader  *pStreamTaskReader;
67
  int8_t              streamStateDone;
68
  SStreamStateReader *pStreamStateReader;
69
  // rsma
70
  int8_t              rsmaDone;
71
  TFileSetRangeArray *pRsmaRanges[TSDB_RETENTION_L2];
72
  SRSmaSnapReader    *pRsmaReader;
73
};
74

75
static TFileSetRangeArray **vnodeSnapReaderGetTsdbRanges(SVSnapReader *pReader, int32_t tsdbTyp) {
16✔
76
  if (!(sizeof(pReader->pRsmaRanges) / sizeof(pReader->pRsmaRanges[0]) == 2)) {
77
    terrno = TSDB_CODE_INVALID_PARA;
78
    return NULL;
79
  }
80
  switch (tsdbTyp) {
16!
81
    case SNAP_DATA_TSDB:
8✔
82
      return &pReader->pRanges;
8✔
83
    case SNAP_DATA_RSMA1:
4✔
84
      return &pReader->pRsmaRanges[0];
4✔
85
    case SNAP_DATA_RSMA2:
4✔
86
      return &pReader->pRsmaRanges[1];
4✔
87
    default:
×
88
      return NULL;
×
89
  }
90
}
91

92
static int32_t vnodeSnapReaderDealWithSnapInfo(SVSnapReader *pReader, SSnapshotParam *pParam) {
4✔
93
  int32_t code = 0;
4✔
94
  SVnode *pVnode = pReader->pVnode;
4✔
95

96
  if (pParam->data) {
4!
97
    // decode
98
    SSyncTLV *datHead = (void *)pParam->data;
4✔
99
    if (datHead->typ != TDMT_SYNC_PREP_SNAPSHOT_REPLY) {
4!
100
      code = TSDB_CODE_INVALID_DATA_FMT;
×
101
      terrno = code;
×
102
      goto _out;
×
103
    }
104

105
    STsdbRepOpts         tsdbOpts = {0};
4✔
106
    TFileSetRangeArray **ppRanges = NULL;
4✔
107
    int32_t              offset = 0;
4✔
108

109
    while (offset + sizeof(SSyncTLV) < datHead->len) {
12✔
110
      SSyncTLV *subField = (void *)(datHead->val + offset);
8✔
111
      offset += sizeof(SSyncTLV) + subField->len;
8✔
112
      void   *buf = subField->val;
8✔
113
      int32_t bufLen = subField->len;
8✔
114

115
      switch (subField->typ) {
8!
116
        case SNAP_DATA_TSDB:
4✔
117
        case SNAP_DATA_RSMA1:
118
        case SNAP_DATA_RSMA2: {
119
          ppRanges = vnodeSnapReaderGetTsdbRanges(pReader, subField->typ);
4✔
120
          if (ppRanges == NULL) {
4!
121
            vError("vgId:%d, unexpected subfield type in snapshot param. subtyp:%d", TD_VID(pVnode), subField->typ);
×
122
            code = TSDB_CODE_INVALID_DATA_FMT;
×
123
            goto _out;
×
124
          }
125
          code = vnodeExtractSnapInfoDiff(buf, bufLen, ppRanges);
4✔
126
          if (code) {
4!
127
            vError("vgId:%d, failed to get range diff since %s", TD_VID(pVnode), terrstr());
×
128
            goto _out;
×
129
          }
130
        } break;
4✔
131
        case SNAP_DATA_RAW: {
4✔
132
          code = tDeserializeTsdbRepOpts(buf, bufLen, &tsdbOpts);
4✔
133
          if (code) {
4!
134
            vError("vgId:%d, failed to deserialize tsdb rep opts since %s", TD_VID(pVnode), terrstr());
×
135
            goto _out;
×
136
          }
137
        } break;
4✔
138
        default:
×
139
          vError("vgId:%d, unexpected subfield type of snap info. typ:%d", TD_VID(pVnode), subField->typ);
×
140
          code = TSDB_CODE_INVALID_DATA_FMT;
×
141
          goto _out;
×
142
      }
143
    }
144

145
    // toggle snap replication mode
146
    vInfo("vgId:%d, vnode snap reader supported tsdb rep of format:%d", TD_VID(pVnode), tsdbOpts.format);
4!
147
    if (pReader->sver == 0 && tsdbOpts.format == TSDB_SNAP_REP_FMT_RAW) {
4!
148
      pReader->tsdbDone = true;
4✔
149
    } else {
150
      pReader->tsdbRAWDone = true;
×
151
    }
152

153
    vInfo("vgId:%d, vnode snap writer enabled replication mode: %s", TD_VID(pVnode),
4!
154
          (pReader->tsdbDone ? "raw" : "normal"));
155
  }
156

157
_out:
×
158
  return code;
4✔
159
}
160

161
int32_t vnodeSnapReaderOpen(SVnode *pVnode, SSnapshotParam *pParam, SVSnapReader **ppReader) {
4✔
162
  int32_t       code = 0;
4✔
163
  int64_t       sver = pParam->start;
4✔
164
  int64_t       ever = pParam->end;
4✔
165
  SVSnapReader *pReader = NULL;
4✔
166

167
  pReader = (SVSnapReader *)taosMemoryCalloc(1, sizeof(*pReader));
4!
168
  if (pReader == NULL) {
4!
169
    code = terrno;
×
170
    goto _exit;
×
171
  }
172
  pReader->pVnode = pVnode;
4✔
173
  pReader->sver = sver;
4✔
174
  pReader->ever = ever;
4✔
175

176
  // snapshot info
177
  code = vnodeSnapReaderDealWithSnapInfo(pReader, pParam);
4✔
178
  if (code) goto _exit;
4!
179

180
  // open tsdb snapshot raw reader
181
  if (!pReader->tsdbRAWDone) {
4!
182
    code = tsdbSnapRAWReaderOpen(pVnode->pTsdb, ever, SNAP_DATA_RAW, &pReader->pTsdbRAWReader);
4✔
183
    if (code) goto _exit;
4!
184
  }
185

186
  // check snapshot ever
187
  SSnapshot snapshot = {0};
4✔
188
  code = vnodeGetSnapshot(pVnode, &snapshot);
4✔
189
  if (code) goto _exit;
4!
190
  if (ever != snapshot.lastApplyIndex) {
4!
191
    vError("vgId:%d, abort reader open due to vnode snapshot changed. ever:%" PRId64 ", commit ver:%" PRId64,
×
192
           TD_VID(pVnode), ever, snapshot.lastApplyIndex);
193
    code = TSDB_CODE_SYN_INTERNAL_ERROR;
×
194
    goto _exit;
×
195
  }
196

197
_exit:
4✔
198
  if (code) {
4!
199
    vError("vgId:%d, vnode snapshot reader open failed since %s", TD_VID(pVnode), tstrerror(code));
×
200
    *ppReader = NULL;
×
201
  } else {
202
    vInfo("vgId:%d, vnode snapshot reader opened, sver:%" PRId64 " ever:%" PRId64, TD_VID(pVnode), sver, ever);
4!
203
    *ppReader = pReader;
4✔
204
  }
205
  return code;
4✔
206
}
207

208
static void vnodeSnapReaderDestroyTsdbRanges(SVSnapReader *pReader) {
4✔
209
  int32_t tsdbTyps[TSDB_RETENTION_MAX] = {SNAP_DATA_TSDB, SNAP_DATA_RSMA1, SNAP_DATA_RSMA2};
4✔
210
  for (int32_t j = 0; j < TSDB_RETENTION_MAX; ++j) {
16✔
211
    TFileSetRangeArray **ppRanges = vnodeSnapReaderGetTsdbRanges(pReader, tsdbTyps[j]);
12✔
212
    if (ppRanges == NULL) continue;
12!
213
    tsdbTFileSetRangeArrayDestroy(ppRanges);
12✔
214
  }
215
}
4✔
216

217
void vnodeSnapReaderClose(SVSnapReader *pReader) {
4✔
218
  vInfo("vgId:%d, close vnode snapshot reader", TD_VID(pReader->pVnode));
4!
219
  vnodeSnapReaderDestroyTsdbRanges(pReader);
4✔
220
#ifdef USE_RSMA
221
  if (pReader->pRsmaReader) {
4!
222
    rsmaSnapReaderClose(&pReader->pRsmaReader);
×
223
  }
224
#endif
225

226
  if (pReader->pTsdbReader) {
4!
227
    tsdbSnapReaderClose(&pReader->pTsdbReader);
×
228
  }
229

230
  if (pReader->pTsdbRAWReader) {
4!
231
    tsdbSnapRAWReaderClose(&pReader->pTsdbRAWReader);
×
232
  }
233

234
  if (pReader->pMetaReader) {
4!
235
    metaSnapReaderClose(&pReader->pMetaReader);
×
236
  }
237
#ifdef USE_TQ
238
  if (pReader->pTqSnapReader) {
4!
239
    tqSnapReaderClose(&pReader->pTqSnapReader);
×
240
  }
241

242
  if (pReader->pTqOffsetReader) {
4!
243
    tqSnapReaderClose(&pReader->pTqOffsetReader);
×
244
  }
245

246
  if (pReader->pTqCheckInfoReader) {
4!
247
    tqSnapReaderClose(&pReader->pTqCheckInfoReader);
×
248
  }
249
#endif
250
  taosMemoryFree(pReader);
4!
251
}
4✔
252

253
int32_t vnodeSnapRead(SVSnapReader *pReader, uint8_t **ppData, uint32_t *nData) {
2,192✔
254
  int32_t code = 0;
2,192✔
255
  int32_t lino;
256
  SVnode *pVnode = pReader->pVnode;
2,192✔
257
  int32_t vgId = TD_VID(pReader->pVnode);
2,192✔
258

259
  // CONFIG ==============
260
  // FIXME: if commit multiple times and the config changed?
261
  if (!pReader->cfgDone) {
2,192✔
262
    char    fName[TSDB_FILENAME_LEN];
263
    int32_t offset = 0;
4✔
264

265
    vnodeGetPrimaryDir(pVnode->path, pVnode->diskPrimary, pVnode->pTfs, fName, TSDB_FILENAME_LEN);
4✔
266
    offset = strlen(fName);
4✔
267
    snprintf(fName + offset, TSDB_FILENAME_LEN - offset - 1, "%s%s", TD_DIRSEP, VND_INFO_FNAME);
4✔
268

269
    TdFilePtr pFile = taosOpenFile(fName, TD_FILE_READ);
4✔
270
    if (NULL == pFile) {
4!
271
      code = terrno;
×
272
      TSDB_CHECK_CODE(code, lino, _exit);
×
273
    }
274

275
    int64_t size;
276
    code = taosFStatFile(pFile, &size, NULL);
4✔
277
    if (code != 0) {
4!
278
      if (taosCloseFile(&pFile) != 0) {
×
279
        vError("vgId:%d, failed to close file", vgId);
×
280
      }
281
      TSDB_CHECK_CODE(code, lino, _exit);
×
282
    }
283

284
    *ppData = taosMemoryMalloc(sizeof(SSnapDataHdr) + size + 1);
4!
285
    if (*ppData == NULL) {
4!
286
      if (taosCloseFile(&pFile) != 0) {
×
287
        vError("vgId:%d, failed to close file", vgId);
×
288
      }
289
      TSDB_CHECK_CODE(code = terrno, lino, _exit);
×
290
    }
291
    ((SSnapDataHdr *)(*ppData))->type = SNAP_DATA_CFG;
4✔
292
    ((SSnapDataHdr *)(*ppData))->size = size + 1;
4✔
293
    ((SSnapDataHdr *)(*ppData))->data[size] = '\0';
4✔
294

295
    if (taosReadFile(pFile, ((SSnapDataHdr *)(*ppData))->data, size) < 0) {
4!
296
      taosMemoryFree(*ppData);
×
297
      if (taosCloseFile(&pFile) != 0) {
×
298
        vError("vgId:%d, failed to close file", vgId);
×
299
      }
300
      TSDB_CHECK_CODE(code = terrno, lino, _exit);
×
301
    }
302

303
    if (taosCloseFile(&pFile) != 0) {
4!
304
      vError("vgId:%d, failed to close file", vgId);
×
305
    }
306

307
    pReader->cfgDone = 1;
4✔
308
    goto _exit;
4✔
309
  }
310

311
  // META ==============
312
  if (!pReader->metaDone) {
2,188✔
313
    // open reader if not
314
    if (pReader->pMetaReader == NULL) {
2,014✔
315
      code = metaSnapReaderOpen(pReader->pVnode->pMeta, pReader->sver, pReader->ever, &pReader->pMetaReader);
4✔
316
      TSDB_CHECK_CODE(code, lino, _exit);
4!
317
    }
318

319
    code = metaSnapRead(pReader->pMetaReader, ppData);
2,014✔
320
    TSDB_CHECK_CODE(code, lino, _exit);
2,014!
321

322
    if (*ppData) {
2,014✔
323
      goto _exit;
2,010✔
324
    } else {
325
      pReader->metaDone = 1;
4✔
326
      metaSnapReaderClose(&pReader->pMetaReader);
4✔
327
    }
328
  }
329

330
  // TSDB ==============
331
  if (!pReader->tsdbDone) {
178!
332
    // open if not
333
    if (pReader->pTsdbReader == NULL) {
×
334
      code = tsdbSnapReaderOpen(pReader->pVnode->pTsdb, pReader->sver, pReader->ever, SNAP_DATA_TSDB, pReader->pRanges,
×
335
                                &pReader->pTsdbReader);
336
      TSDB_CHECK_CODE(code, lino, _exit);
×
337
    }
338

339
    code = tsdbSnapRead(pReader->pTsdbReader, ppData);
×
340
    TSDB_CHECK_CODE(code, lino, _exit);
×
341
    if (*ppData) {
×
342
      goto _exit;
×
343
    } else {
344
      pReader->tsdbDone = 1;
×
345
      tsdbSnapReaderClose(&pReader->pTsdbReader);
×
346
    }
347
  }
348

349
  if (!pReader->tsdbRAWDone) {
178✔
350
    // open if not
351
    if (pReader->pTsdbRAWReader == NULL) {
170!
352
      code = tsdbSnapRAWReaderOpen(pReader->pVnode->pTsdb, pReader->ever, SNAP_DATA_RAW, &pReader->pTsdbRAWReader);
×
353
      TSDB_CHECK_CODE(code, lino, _exit);
×
354
    }
355

356
    code = tsdbSnapRAWRead(pReader->pTsdbRAWReader, ppData);
170✔
357
    TSDB_CHECK_CODE(code, lino, _exit);
170!
358
    if (*ppData) {
170✔
359
      goto _exit;
166✔
360
    } else {
361
      pReader->tsdbRAWDone = 1;
4✔
362
      tsdbSnapRAWReaderClose(&pReader->pTsdbRAWReader);
4✔
363
    }
364
  }
365

366
  // TQ ================
367
#ifdef USE_TQ
368
  vInfo("vgId:%d tq transform start", vgId);
12!
369
  if (!pReader->tqHandleDone) {
12✔
370
    if (pReader->pTqSnapReader == NULL) {
4!
371
      code = tqSnapReaderOpen(pReader->pVnode->pTq, pReader->sver, pReader->ever, SNAP_DATA_TQ_HANDLE,
4✔
372
                              &pReader->pTqSnapReader);
373
      TSDB_CHECK_CODE(code, lino, _exit);
4!
374
    }
375

376
    code = tqSnapRead(pReader->pTqSnapReader, ppData);
4✔
377
    TSDB_CHECK_CODE(code, lino, _exit);
4!
378
    if (*ppData) {
4!
379
      goto _exit;
×
380
    } else {
381
      pReader->tqHandleDone = 1;
4✔
382
      tqSnapReaderClose(&pReader->pTqSnapReader);
4✔
383
    }
384
  }
385
  if (!pReader->tqCheckInfoDone) {
12✔
386
    if (pReader->pTqCheckInfoReader == NULL) {
4!
387
      code = tqSnapReaderOpen(pReader->pVnode->pTq, pReader->sver, pReader->ever, SNAP_DATA_TQ_CHECKINFO,
4✔
388
                              &pReader->pTqCheckInfoReader);
389
      TSDB_CHECK_CODE(code, lino, _exit);
4!
390
    }
391

392
    code = tqSnapRead(pReader->pTqCheckInfoReader, ppData);
4✔
393
    TSDB_CHECK_CODE(code, lino, _exit);
4!
394
    if (*ppData) {
4!
395
      goto _exit;
×
396
    } else {
397
      pReader->tqCheckInfoDone = 1;
4✔
398
      tqSnapReaderClose(&pReader->pTqCheckInfoReader);
4✔
399
    }
400
  }
401
  if (!pReader->tqOffsetDone) {
12✔
402
    if (pReader->pTqOffsetReader == NULL) {
4!
403
      code = tqSnapReaderOpen(pReader->pVnode->pTq, pReader->sver, pReader->ever, SNAP_DATA_TQ_OFFSET,
4✔
404
                              &pReader->pTqOffsetReader);
405
      TSDB_CHECK_CODE(code, lino, _exit);
4!
406
    }
407

408
    code = tqSnapRead(pReader->pTqOffsetReader, ppData);
4✔
409
    TSDB_CHECK_CODE(code, lino, _exit);
4!
410
    if (*ppData) {
4!
411
      goto _exit;
×
412
    } else {
413
      pReader->tqOffsetDone = 1;
4✔
414
      tqSnapReaderClose(&pReader->pTqOffsetReader);
4✔
415
    }
416
  }
417
#endif
418
  // STREAM ============
419
#ifdef USE_STREAM
420
  vInfo("vgId:%d stream task start to take snapshot", vgId);
12!
421
  if (!pReader->streamTaskDone) {
12!
422
    if (pReader->pStreamTaskReader == NULL) {
12✔
423
      code = streamTaskSnapReaderOpen(pReader->pVnode->pTq, pReader->sver, pReader->sver, &pReader->pStreamTaskReader);
4✔
424
      TSDB_CHECK_CODE(code, lino, _exit);
4!
425
    }
426

427
    code = streamTaskSnapRead(pReader->pStreamTaskReader, ppData);
12✔
428
    TSDB_CHECK_CODE(code, lino, _exit);
12!
429
    if (*ppData) {
12✔
430
      vInfo("vgId:%d no streamTask snapshot", vgId);
8!
431
      goto _exit;
8✔
432
    } else {
433
      pReader->streamTaskDone = 1;
4✔
434
      code = streamTaskSnapReaderClose(pReader->pStreamTaskReader);
4✔
435
      TSDB_CHECK_CODE(code, lino, _exit);
4!
436
      pReader->pStreamTaskReader = NULL;
4✔
437
    }
438
  }
439
  if (!pReader->streamStateDone) {
4!
440
    if (pReader->pStreamStateReader == NULL) {
4!
441
      code =
442
          streamStateSnapReaderOpen(pReader->pVnode->pTq, pReader->sver, pReader->sver, &pReader->pStreamStateReader);
4✔
443
      if (code) {
4!
444
        pReader->streamStateDone = 1;
×
445
        pReader->pStreamStateReader = NULL;
×
446
        TSDB_CHECK_CODE(code, lino, _exit);
×
447
      }
448
    }
449
    code = streamStateSnapRead(pReader->pStreamStateReader, ppData);
4✔
450
    TSDB_CHECK_CODE(code, lino, _exit);
4!
451
    if (*ppData) {
4!
452
      goto _exit;
×
453
    } else {
454
      pReader->streamStateDone = 1;
4✔
455
      code = streamStateSnapReaderClose(pReader->pStreamStateReader);
4✔
456
      TSDB_CHECK_CODE(code, lino, _exit);
4!
457
      pReader->pStreamStateReader = NULL;
4✔
458
    }
459
  }
460
#endif
461
  // RSMA ==============
462
#ifdef USE_RSMA
463
  if (VND_IS_RSMA(pReader->pVnode) && !pReader->rsmaDone) {
4!
464
    // open if not
465
    if (pReader->pRsmaReader == NULL) {
×
466
      code = rsmaSnapReaderOpen(pReader->pVnode->pSma, pReader->sver, pReader->ever, &pReader->pRsmaReader);
×
467
      TSDB_CHECK_CODE(code, lino, _exit);
×
468
    }
469

470
    code = rsmaSnapRead(pReader->pRsmaReader, ppData);
×
471
    TSDB_CHECK_CODE(code, lino, _exit);
×
472
    if (*ppData) {
×
473
      goto _exit;
×
474
    } else {
475
      pReader->rsmaDone = 1;
×
476
      rsmaSnapReaderClose(&pReader->pRsmaReader);
×
477
    }
478
  }
479
#endif
480
  *ppData = NULL;
4✔
481
  *nData = 0;
4✔
482

483
_exit:
2,192✔
484
  if (code) {
2,192!
485
    vError("vgId:%d, vnode snapshot read failed at %s:%d since %s", vgId, __FILE__, lino, tstrerror(code));
×
486
  } else {
487
    if (*ppData) {
2,192✔
488
      SSnapDataHdr *pHdr = (SSnapDataHdr *)(*ppData);
2,188✔
489

490
      pReader->index++;
2,188✔
491
      *nData = sizeof(SSnapDataHdr) + pHdr->size;
2,188✔
492
      pHdr->index = pReader->index;
2,188✔
493
      vDebug("vgId:%d, vnode snapshot read data, index:%" PRId64 " type:%d blockLen:%d ", vgId, pReader->index,
2,188!
494
             pHdr->type, *nData);
495
    } else {
496
      vInfo("vgId:%d, vnode snapshot read data end, index:%" PRId64, vgId, pReader->index);
4!
497
    }
498
  }
499
  return code;
2,192✔
500
}
501

502
// SVSnapWriter ========================================================
503
struct SVSnapWriter {
504
  SVnode *pVnode;
505
  int64_t sver;
506
  int64_t ever;
507
  int64_t commitID;
508
  int64_t index;
509
  // config
510
  SVnodeInfo info;
511
  // meta
512
  SMetaSnapWriter *pMetaSnapWriter;
513
  // tsdb
514
  TFileSetRangeArray *pRanges;
515
  STsdbSnapWriter    *pTsdbSnapWriter;
516
  // tsdb raw
517
  STsdbSnapRAWWriter *pTsdbSnapRAWWriter;
518
  // tq
519
  STqSnapWriter *pTqSnapHandleWriter;
520
  STqSnapWriter *pTqSnapOffsetWriter;
521
  STqSnapWriter *pTqSnapCheckInfoWriter;
522
  // stream
523
  SStreamTaskWriter  *pStreamTaskWriter;
524
  SStreamStateWriter *pStreamStateWriter;
525
  // rsma
526
  TFileSetRangeArray *pRsmaRanges[TSDB_RETENTION_L2];
527
  SRSmaSnapWriter    *pRsmaSnapWriter;
528
};
529

530
TFileSetRangeArray **vnodeSnapWriterGetTsdbRanges(SVSnapWriter *pWriter, int32_t tsdbTyp) {
16✔
531
  switch (tsdbTyp) {
16!
532
    case SNAP_DATA_TSDB:
8✔
533
      return &pWriter->pRanges;
8✔
534
    case SNAP_DATA_RSMA1:
4✔
535
      return &pWriter->pRsmaRanges[0];
4✔
536
    case SNAP_DATA_RSMA2:
4✔
537
      return &pWriter->pRsmaRanges[1];
4✔
538
    default:
×
539
      return NULL;
×
540
  }
541
}
542

543
static int32_t vnodeSnapWriterDealWithSnapInfo(SVSnapWriter *pWriter, SSnapshotParam *pParam) {
4✔
544
  SVnode *pVnode = pWriter->pVnode;
4✔
545
  int32_t code = 0;
4✔
546
  int32_t lino;
547

548
  if (pParam->data) {
4!
549
    SSyncTLV *datHead = (void *)pParam->data;
4✔
550
    if (datHead->typ != TDMT_SYNC_PREP_SNAPSHOT_REPLY) {
4!
551
      TSDB_CHECK_CODE(code = TSDB_CODE_INVALID_DATA_FMT, lino, _exit);
×
552
    }
553

554
    STsdbRepOpts         tsdbOpts = {0};
4✔
555
    TFileSetRangeArray **ppRanges = NULL;
4✔
556
    int32_t              offset = 0;
4✔
557

558
    while (offset + sizeof(SSyncTLV) < datHead->len) {
12✔
559
      SSyncTLV *subField = (void *)(datHead->val + offset);
8✔
560
      offset += sizeof(SSyncTLV) + subField->len;
8✔
561
      void   *buf = subField->val;
8✔
562
      int32_t bufLen = subField->len;
8✔
563

564
      switch (subField->typ) {
8!
565
        case SNAP_DATA_TSDB:
4✔
566
        case SNAP_DATA_RSMA1:
567
        case SNAP_DATA_RSMA2: {
568
          ppRanges = vnodeSnapWriterGetTsdbRanges(pWriter, subField->typ);
4✔
569
          if (ppRanges == NULL) {
4!
570
            vError("vgId:%d, unexpected subfield type in snapshot param. subtyp:%d", TD_VID(pVnode), subField->typ);
×
571
            TSDB_CHECK_CODE(code = terrno, lino, _exit);
×
572
          }
573

574
          code = vnodeExtractSnapInfoDiff(buf, bufLen, ppRanges);
4✔
575
          TSDB_CHECK_CODE(code, lino, _exit);
4!
576
        } break;
4✔
577
        case SNAP_DATA_RAW: {
4✔
578
          code = tDeserializeTsdbRepOpts(buf, bufLen, &tsdbOpts);
4✔
579
          TSDB_CHECK_CODE(code, lino, _exit);
4!
580
        } break;
4✔
581
        default:
×
582
          vError("vgId:%d, unexpected subfield type of snap info. typ:%d", TD_VID(pVnode), subField->typ);
×
583
          TSDB_CHECK_CODE(code = TSDB_CODE_INVALID_DATA_FMT, lino, _exit);
×
584
          goto _exit;
585
      }
586
    }
587

588
    vInfo("vgId:%d, vnode snap writer supported tsdb rep of format:%d", TD_VID(pVnode), tsdbOpts.format);
4!
589
  }
590

591
_exit:
×
592
  if (code) {
4!
593
    vError("vgId:%d %s failed at %s:%d since %s", TD_VID(pVnode), __func__, __FILE__, __LINE__, tstrerror(code));
×
594
  }
595
  return code;
4✔
596
}
597

598
extern int32_t tsdbDisableAndCancelAllBgTask(STsdb *pTsdb);
599
extern void    tsdbEnableBgTask(STsdb *pTsdb);
600

601
static int32_t vnodeCancelAndDisableAllBgTask(SVnode *pVnode) {
4✔
602
  TAOS_CHECK_RETURN(tsdbDisableAndCancelAllBgTask(pVnode->pTsdb));
4!
603
  TAOS_CHECK_RETURN(vnodeSyncCommit(pVnode));
4!
604
  return 0;
4✔
605
}
606

607
static int32_t vnodeEnableBgTask(SVnode *pVnode) {
4✔
608
  tsdbEnableBgTask(pVnode->pTsdb);
4✔
609
  return 0;
4✔
610
}
611

612
int32_t vnodeSnapWriterOpen(SVnode *pVnode, SSnapshotParam *pParam, SVSnapWriter **ppWriter) {
4✔
613
  int32_t       code = 0;
4✔
614
  int32_t       lino;
615
  SVSnapWriter *pWriter = NULL;
4✔
616
  int64_t       sver = pParam->start;
4✔
617
  int64_t       ever = pParam->end;
4✔
618

619
  // disable write, cancel and disable all bg tasks
620
  (void)taosThreadMutexLock(&pVnode->mutex);
4✔
621
  pVnode->disableWrite = true;
4✔
622
  (void)taosThreadMutexUnlock(&pVnode->mutex);
4✔
623

624
  code = vnodeCancelAndDisableAllBgTask(pVnode);
4✔
625
  TSDB_CHECK_CODE(code, lino, _exit);
4!
626

627
  // alloc
628
  pWriter = (SVSnapWriter *)taosMemoryCalloc(1, sizeof(*pWriter));
4!
629
  if (pWriter == NULL) {
4!
630
    TSDB_CHECK_CODE(code = terrno, lino, _exit);
×
631
  }
632
  pWriter->pVnode = pVnode;
4✔
633
  pWriter->sver = sver;
4✔
634
  pWriter->ever = ever;
4✔
635

636
  // inc commit ID
637
  pWriter->commitID = ++pVnode->state.commitID;
4✔
638

639
  // snapshot info
640
  code = vnodeSnapWriterDealWithSnapInfo(pWriter, pParam);
4✔
641
  TSDB_CHECK_CODE(code, lino, _exit);
4!
642

643
_exit:
4✔
644
  if (code) {
4!
645
    vError("vgId:%d, vnode snapshot writer open failed since %s", TD_VID(pVnode), tstrerror(code));
×
646
    if (pWriter) taosMemoryFreeClear(pWriter);
×
647
    *ppWriter = NULL;
×
648
  } else {
649
    vInfo("vgId:%d, vnode snapshot writer opened, sver:%" PRId64 " ever:%" PRId64 " commit id:%" PRId64, TD_VID(pVnode),
4!
650
          sver, ever, pWriter->commitID);
651
    *ppWriter = pWriter;
4✔
652
  }
653
  return code;
4✔
654
}
655

656
static void vnodeSnapWriterDestroyTsdbRanges(SVSnapWriter *pWriter) {
4✔
657
  int32_t tsdbTyps[TSDB_RETENTION_MAX] = {SNAP_DATA_TSDB, SNAP_DATA_RSMA1, SNAP_DATA_RSMA2};
4✔
658
  for (int32_t j = 0; j < TSDB_RETENTION_MAX; ++j) {
16✔
659
    TFileSetRangeArray **ppRanges = vnodeSnapWriterGetTsdbRanges(pWriter, tsdbTyps[j]);
12✔
660
    if (ppRanges == NULL) continue;
12!
661
    tsdbTFileSetRangeArrayDestroy(ppRanges);
12✔
662
  }
663
}
4✔
664

665
int32_t vnodeSnapWriterClose(SVSnapWriter *pWriter, int8_t rollback, SSnapshot *pSnapshot) {
4✔
666
  int32_t code = 0;
4✔
667
  SVnode *pVnode = pWriter->pVnode;
4✔
668

669
  vnodeSnapWriterDestroyTsdbRanges(pWriter);
4✔
670

671
  // prepare
672
  if (pWriter->pTsdbSnapWriter) {
4!
673
    code = tsdbSnapWriterPrepareClose(pWriter->pTsdbSnapWriter, rollback);
×
674
    if (code) goto _exit;
×
675
  }
676

677
  if (pWriter->pTsdbSnapRAWWriter) {
4!
678
    code = tsdbSnapRAWWriterPrepareClose(pWriter->pTsdbSnapRAWWriter);
4✔
679
    if (code) goto _exit;
4!
680
  }
681
#ifdef USE_RSMA
682
  if (pWriter->pRsmaSnapWriter) {
4!
683
    code = rsmaSnapWriterPrepareClose(pWriter->pRsmaSnapWriter, rollback);
×
684
    if (code) goto _exit;
×
685
  }
686
#endif
687
  // commit json
688
  if (!rollback) {
4!
689
    pWriter->info.state.committed = pWriter->ever;
4✔
690
    pVnode->config = pWriter->info.config;
4✔
691
    pVnode->state = (SVState){.committed = pWriter->info.state.committed,
4✔
692
                              .applied = pWriter->info.state.committed,
4✔
693
                              .commitID = pWriter->commitID,
4✔
694
                              .commitTerm = pWriter->info.state.commitTerm,
4✔
695
                              .applyTerm = pWriter->info.state.commitTerm};
4✔
696
    pVnode->statis = pWriter->info.statis;
4✔
697
    char dir[TSDB_FILENAME_LEN] = {0};
4✔
698
    vnodeGetPrimaryDir(pVnode->path, pVnode->diskPrimary, pVnode->pTfs, dir, TSDB_FILENAME_LEN);
4✔
699

700
    code = vnodeCommitInfo(dir);
4✔
701
    if (code) goto _exit;
4!
702

703
  } else {
704
    vnodeRollback(pWriter->pVnode);
×
705
  }
706

707
  // commit/rollback sub-system
708
  if (pWriter->pMetaSnapWriter) {
4!
709
    code = metaSnapWriterClose(&pWriter->pMetaSnapWriter, rollback);
4✔
710
    if (code) goto _exit;
4!
711
  }
712

713
  if (pWriter->pTsdbSnapWriter) {
4!
714
    code = tsdbSnapWriterClose(&pWriter->pTsdbSnapWriter, rollback);
×
715
    if (code) goto _exit;
×
716
  }
717

718
  if (pWriter->pTsdbSnapRAWWriter) {
4!
719
    code = tsdbSnapRAWWriterClose(&pWriter->pTsdbSnapRAWWriter, rollback);
4✔
720
    if (code) goto _exit;
4!
721
  }
722
#ifdef USE_TQ
723
  if (pWriter->pTqSnapHandleWriter) {
4!
724
    code = tqSnapWriterClose(&pWriter->pTqSnapHandleWriter, rollback);
×
725
    if (code) goto _exit;
×
726
  }
727

728
  if (pWriter->pTqSnapCheckInfoWriter) {
4!
729
    code = tqSnapWriterClose(&pWriter->pTqSnapCheckInfoWriter, rollback);
×
730
    if (code) goto _exit;
×
731
  }
732

733
  if (pWriter->pTqSnapOffsetWriter) {
4!
734
    code = tqSnapWriterClose(&pWriter->pTqSnapOffsetWriter, rollback);
×
735
    if (code) goto _exit;
×
736
  }
737
#endif
738
#ifdef USE_STREAM
739
  if (pWriter->pStreamTaskWriter) {
4!
740
    code = streamTaskSnapWriterClose(pWriter->pStreamTaskWriter, rollback, pWriter->pStreamStateWriter == NULL ? 1 : 0);
4✔
741

742
    if (code) goto _exit;
4!
743
  }
744

745
  if (pWriter->pStreamStateWriter) {
4!
746
    code = streamStateSnapWriterClose(pWriter->pStreamStateWriter, rollback);
×
747
    if (code) goto _exit;
×
748

749
    code = streamStateRebuildFromSnap(pWriter->pStreamStateWriter, 0);
×
750
    pWriter->pStreamStateWriter = NULL;
×
751
    if (code) goto _exit;
×
752
  }
753
#endif
754
#ifdef USE_RSMA
755
  if (pWriter->pRsmaSnapWriter) {
4!
756
    code = rsmaSnapWriterClose(&pWriter->pRsmaSnapWriter, rollback);
×
757
    if (code) goto _exit;
×
758
  }
759
#endif
760
  code = vnodeBegin(pVnode);
4✔
761
  if (code) goto _exit;
4!
762

763
  (void)taosThreadMutexLock(&pVnode->mutex);
4✔
764
  pVnode->disableWrite = false;
4✔
765
  (void)taosThreadMutexUnlock(&pVnode->mutex);
4✔
766

767
_exit:
4✔
768
  if (code) {
4!
769
    vError("vgId:%d, vnode snapshot writer close failed since %s", TD_VID(pWriter->pVnode), tstrerror(code));
×
770
  } else {
771
    vInfo("vgId:%d, vnode snapshot writer closed, rollback:%d", TD_VID(pVnode), rollback);
4!
772
    taosMemoryFree(pWriter);
4!
773
  }
774
  if (vnodeEnableBgTask(pVnode) != 0) {
4!
775
    tsdbError("vgId:%d, failed to enable bg task", TD_VID(pVnode));
×
776
  }
777
  return code;
4✔
778
}
779

780
static int32_t vnodeSnapWriteInfo(SVSnapWriter *pWriter, uint8_t *pData, uint32_t nData) {
4✔
781
  int32_t       code = 0;
4✔
782
  int32_t       lino;
783
  SVnode       *pVnode = pWriter->pVnode;
4✔
784
  SSnapDataHdr *pHdr = (SSnapDataHdr *)pData;
4✔
785

786
  // decode info
787
  code = vnodeDecodeInfo(pHdr->data, &pWriter->info);
4✔
788
  TSDB_CHECK_CODE(code, lino, _exit);
4!
789

790
  // change some value
791
  pWriter->info.state.commitID = pWriter->commitID;
4✔
792

793
  // modify info as needed
794
  char dir[TSDB_FILENAME_LEN] = {0};
4✔
795
  vnodeGetPrimaryDir(pVnode->path, pVnode->diskPrimary, pVnode->pTfs, dir, TSDB_FILENAME_LEN);
4✔
796

797
  SVnodeStats vndStats = pWriter->info.config.vndStats;
4✔
798
  pWriter->info.config = pVnode->config;
4✔
799
  pWriter->info.config.vndStats = vndStats;
4✔
800
  vDebug("vgId:%d, save config while write snapshot", pWriter->pVnode->config.vgId);
4!
801
  code = vnodeSaveInfo(dir, &pWriter->info);
4✔
802
  TSDB_CHECK_CODE(code, lino, _exit);
4!
803

804
_exit:
4✔
805
  return code;
4✔
806
}
807

808
int32_t vnodeSnapWrite(SVSnapWriter *pWriter, uint8_t *pData, uint32_t nData) {
2,188✔
809
  int32_t       code = 0;
2,188✔
810
  int32_t       lino;
811
  SSnapDataHdr *pHdr = (SSnapDataHdr *)pData;
2,188✔
812
  SVnode       *pVnode = pWriter->pVnode;
2,188✔
813

814
  if (!(pHdr->size + sizeof(SSnapDataHdr) == nData)) {
2,188!
815
    return TSDB_CODE_INVALID_PARA;
×
816
  }
817

818
  if (pHdr->index != pWriter->index + 1) {
2,188!
819
    vError("vgId:%d, unexpected vnode snapshot msg. index:%" PRId64 ", expected index:%" PRId64, TD_VID(pVnode),
×
820
           pHdr->index, pWriter->index + 1);
821
    TSDB_CHECK_CODE(code = TSDB_CODE_INVALID_MSG, lino, _exit);
×
822
  }
823

824
  pWriter->index = pHdr->index;
2,188✔
825

826
  vDebug("vgId:%d, vnode snapshot write data, index:%" PRId64 " type:%d blockLen:%d", TD_VID(pVnode), pHdr->index,
2,188!
827
         pHdr->type, nData);
828

829
  switch (pHdr->type) {
2,188!
830
    case SNAP_DATA_CFG: {
4✔
831
      code = vnodeSnapWriteInfo(pWriter, pData, nData);
4✔
832
      TSDB_CHECK_CODE(code, lino, _exit);
4!
833
    } break;
4✔
834
    case SNAP_DATA_META: {
2,010✔
835
      // meta
836
      if (pWriter->pMetaSnapWriter == NULL) {
2,010✔
837
        code = metaSnapWriterOpen(pVnode->pMeta, pWriter->sver, pWriter->ever, &pWriter->pMetaSnapWriter);
4✔
838
        TSDB_CHECK_CODE(code, lino, _exit);
4!
839
      }
840

841
      code = metaSnapWrite(pWriter->pMetaSnapWriter, pData, nData);
2,010✔
842
      TSDB_CHECK_CODE(code, lino, _exit);
2,010!
843
    } break;
2,010✔
844
    case SNAP_DATA_TSDB:
×
845
    case SNAP_DATA_DEL: {
846
      // tsdb
847
      if (pWriter->pTsdbSnapWriter == NULL) {
×
848
        code = tsdbSnapWriterOpen(pVnode->pTsdb, pWriter->sver, pWriter->ever, pWriter->pRanges,
×
849
                                  &pWriter->pTsdbSnapWriter);
850
        TSDB_CHECK_CODE(code, lino, _exit);
×
851
      }
852

853
      code = tsdbSnapWrite(pWriter->pTsdbSnapWriter, pHdr);
×
854
      TSDB_CHECK_CODE(code, lino, _exit);
×
855
    } break;
×
856
    case SNAP_DATA_RAW: {
166✔
857
      // tsdb
858
      if (pWriter->pTsdbSnapRAWWriter == NULL) {
166✔
859
        code = tsdbSnapRAWWriterOpen(pVnode->pTsdb, pWriter->ever, &pWriter->pTsdbSnapRAWWriter);
4✔
860
        TSDB_CHECK_CODE(code, lino, _exit);
4!
861
      }
862

863
      code = tsdbSnapRAWWrite(pWriter->pTsdbSnapRAWWriter, pHdr);
166✔
864
      TSDB_CHECK_CODE(code, lino, _exit);
166!
865
    } break;
166✔
866
#ifdef USE_TQ
867
    case SNAP_DATA_TQ_HANDLE: {
×
868
      // tq handle
869
      if (pWriter->pTqSnapHandleWriter == NULL) {
×
870
        code = tqSnapWriterOpen(pVnode->pTq, pWriter->sver, pWriter->ever, &pWriter->pTqSnapHandleWriter);
×
871
        TSDB_CHECK_CODE(code, lino, _exit);
×
872
      }
873

874
      code = tqSnapHandleWrite(pWriter->pTqSnapHandleWriter, pData, nData);
×
875
      TSDB_CHECK_CODE(code, lino, _exit);
×
876
    } break;
×
877
    case SNAP_DATA_TQ_CHECKINFO: {
×
878
      // tq checkinfo
879
      if (pWriter->pTqSnapCheckInfoWriter == NULL) {
×
880
        code = tqSnapWriterOpen(pVnode->pTq, pWriter->sver, pWriter->ever, &pWriter->pTqSnapCheckInfoWriter);
×
881
        TSDB_CHECK_CODE(code, lino, _exit);
×
882
      }
883

884
      code = tqSnapCheckInfoWrite(pWriter->pTqSnapCheckInfoWriter, pData, nData);
×
885
      TSDB_CHECK_CODE(code, lino, _exit);
×
886
    } break;
×
887
    case SNAP_DATA_TQ_OFFSET: {
×
888
      // tq offset
889
      if (pWriter->pTqSnapOffsetWriter == NULL) {
×
890
        code = tqSnapWriterOpen(pVnode->pTq, pWriter->sver, pWriter->ever, &pWriter->pTqSnapOffsetWriter);
×
891
        TSDB_CHECK_CODE(code, lino, _exit);
×
892
      }
893

894
      code = tqSnapOffsetWrite(pWriter->pTqSnapOffsetWriter, pData, nData);
×
895
      TSDB_CHECK_CODE(code, lino, _exit);
×
896
    } break;
×
897
#endif
898
#ifdef USE_STREAM
899
    case SNAP_DATA_STREAM_TASK:
8✔
900
    case SNAP_DATA_STREAM_TASK_CHECKPOINT: {
901
      if (pWriter->pStreamTaskWriter == NULL) {
8✔
902
        code = streamTaskSnapWriterOpen(pVnode->pTq, pWriter->sver, pWriter->ever, &pWriter->pStreamTaskWriter);
4✔
903
        TSDB_CHECK_CODE(code, lino, _exit);
4!
904
      }
905
      code = streamTaskSnapWrite(pWriter->pStreamTaskWriter, pData, nData);
8✔
906
      TSDB_CHECK_CODE(code, lino, _exit);
8!
907
    } break;
8✔
908
    case SNAP_DATA_STREAM_STATE_BACKEND: {
×
909
      if (pWriter->pStreamStateWriter == NULL) {
×
910
        code = streamStateSnapWriterOpen(pVnode->pTq, pWriter->sver, pWriter->ever, &pWriter->pStreamStateWriter);
×
911
        TSDB_CHECK_CODE(code, lino, _exit);
×
912
      }
913
      code = streamStateSnapWrite(pWriter->pStreamStateWriter, pData, nData);
×
914
      TSDB_CHECK_CODE(code, lino, _exit);
×
915

916
    } break;
×
917
#endif
918
#ifdef USE_RSMA
919
    case SNAP_DATA_RSMA1:
×
920
    case SNAP_DATA_RSMA2:
921
    case SNAP_DATA_QTASK: {
922
      // rsma1/rsma2/qtask for rsma
923
      if (pWriter->pRsmaSnapWriter == NULL) {
×
924
        code = rsmaSnapWriterOpen(pVnode->pSma, pWriter->sver, pWriter->ever, (void **)pWriter->pRsmaRanges,
×
925
                                  &pWriter->pRsmaSnapWriter);
926
        TSDB_CHECK_CODE(code, lino, _exit);
×
927
      }
928

929
      code = rsmaSnapWrite(pWriter->pRsmaSnapWriter, pData, nData);
×
930
      TSDB_CHECK_CODE(code, lino, _exit);
×
931
    } break;
×
932
#endif
933
    default:
×
934
      break;
×
935
  }
936
_exit:
2,188✔
937
  if (code) {
2,188!
938
    vError("vgId:%d, vnode snapshot write failed since %s, index:%" PRId64 " type:%d nData:%d", TD_VID(pVnode),
×
939
           tstrerror(code), pHdr->index, pHdr->type, nData);
940
  }
941
  return code;
2,188✔
942
}
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