#4962

Committed 09 Feb 2026 01:16AM UTC coverage: 66.872% (+0.07%) from 66.798%

Build # #4962

Build Type

push

travis-ci

Committed by

web-flow

Commit Message

docs: add support for recording STMT to CSV files (#34276)

* docs: add support for recording STMT to CSV files

* docs: update version for STMT recording feature in CSV files

Coverage Stats

205763 of 307696 relevant lines covered (66.87%)

127640448.9 hits per line

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

89.86

/source/client/src/clientSmlTelnet.c

/*
 * Copyright (c) 2019 TAOS Data, Inc. <jhtao@taosdata.com>
 *
 * This program is free software: you can use, redistribute, and/or modify
 * it under the terms of the GNU Affero General Public License, version 3
 * or later ("AGPL"), as published by the Free Software Foundation.
 *
 * This program is distributed in the hope that it will be useful, but WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
 * FITNESS FOR A PARTICULAR PURPOSE.
 *
 * You should have received a copy of the GNU Affero General Public License
 * along with this program. If not, see <http://www.gnu.org/licenses/>.
 */

#include <ctype.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>

#include "clientSml.h"

int32_t is_same_child_table_telnet(const void *a, const void *b) {
  SSmlLineInfo *t1 = (SSmlLineInfo *)a;
  SSmlLineInfo *t2 = (SSmlLineInfo *)b;
  if (t1 == NULL || t2 == NULL || t1->measure == NULL || t2->measure == NULL || t1->tags == NULL || t2->tags == NULL)
    return 1;
  return (((t1->measureLen == t2->measureLen) && memcmp(t1->measure, t2->measure, t1->measureLen) == 0) &&
          ((t1->tagsLen == t2->tagsLen) && memcmp(t1->tags, t2->tags, t1->tagsLen) == 0))
             ? 0
             : 1;
}

int64_t smlParseOpenTsdbTime(SSmlHandle *info, const char *data, int32_t len) {
  uint8_t toPrecision = info->currSTableMeta ? info->currSTableMeta->tableInfo.precision : TSDB_TIME_PRECISION_NANO;

  if (unlikely(!data)) {
    smlBuildInvalidDataMsg(&info->msgBuf, "timestamp can not be null", NULL);
    return -1;
  }
  if (unlikely(len == 1 && data[0] == '0')) {
    return taosGetTimestampNs() / smlFactorNS[toPrecision];
  }
  int8_t fromPrecision = smlGetTsTypeByLen(len);
  if (unlikely(fromPrecision == -1)) {
    smlBuildInvalidDataMsg(&info->msgBuf,
                           "timestamp precision can only be seconds(10 digits) or milli seconds(13 digits)", data);
    return -1;
  }
  int64_t ts = smlGetTimeValue(data, len, fromPrecision, toPrecision);
  if (unlikely(ts == -1)) {
    smlBuildInvalidDataMsg(&info->msgBuf, "invalid timestamp", data);
    return -1;
  }
  return ts;
}

static void smlParseTelnetElement(char **sql, char *sqlEnd, char **data, int32_t *len) {
  while (*sql < sqlEnd) {
    if (unlikely((**sql != SPACE && !(*data)))) {
      *data = *sql;
    } else if (unlikely(**sql == SPACE && *data)) {
      *len = *sql - *data;
      break;
    }
    (*sql)++;
  }
}

static int32_t smlProcessTagTelnet(SSmlHandle *info, char *data, char *sqlEnd){
  SArray *preLineKV = info->preLineTagKV;
  taosArrayClearEx(preLineKV, freeSSmlKv);
  int     cnt = 0;

  const char *sql = data;
  while (sql < sqlEnd) {
    JUMP_SPACE(sql, sqlEnd)
    if (unlikely(*sql == '\0' || *sql == '\n')) break;

    const char *key = sql;
    size_t      keyLen = 0;

    // parse key
    while (sql < sqlEnd) {
      if (unlikely(*sql == SPACE)) {
        smlBuildInvalidDataMsg(&info->msgBuf, "invalid data", sql);
        return TSDB_CODE_SML_INVALID_DATA;
      }
      if (unlikely(*sql == EQUAL)) {
        keyLen = sql - key;
        sql++;
        break;
      }
      sql++;
    }

    if (unlikely(IS_INVALID_COL_LEN(keyLen))) {
      smlBuildInvalidDataMsg(&info->msgBuf, "invalid key or key is too long than 64", key);
      return TSDB_CODE_TSC_INVALID_COLUMN_LENGTH;
    }

    // parse value
    const char *value = sql;
    size_t      valueLen = 0;
    while (sql < sqlEnd) {
      // parse value
      if (unlikely(*sql == SPACE)) {
        break;
      }
      if (unlikely(*sql == EQUAL)) {
        smlBuildInvalidDataMsg(&info->msgBuf, "invalid data", sql);
        return TSDB_CODE_SML_INVALID_DATA;
      }
      sql++;
    }
    valueLen = sql - value;

    if (unlikely(valueLen == 0)) {
      smlBuildInvalidDataMsg(&info->msgBuf, "invalid value", value);
      return TSDB_CODE_TSC_INVALID_VALUE;
    }

    if (unlikely(valueLen > (TSDB_MAX_TAGS_LEN - VARSTR_HEADER_SIZE) / TSDB_NCHAR_SIZE)) {
      return TSDB_CODE_PAR_INVALID_VAR_COLUMN_LEN;
    }

    SSmlKv kv = {.key = key,
        .keyLen = keyLen,
        .type = TSDB_DATA_TYPE_NCHAR,
        .value = value,
        .length = valueLen,
        .keyEscaped = false,
        .valueEscaped = false};
    if (taosArrayPush(preLineKV, &kv) == NULL){
      return terrno;
    }
    if (info->dataFormat && !isSmlTagAligned(info, cnt, &kv)) {
      return TSDB_CODE_SML_INVALID_DATA;
    }
    cnt++;
  }
  return TSDB_CODE_SUCCESS;
}

static int32_t smlParseTelnetTags(SSmlHandle *info, char *data, char *sqlEnd, SSmlLineInfo *elements) {
  if (is_same_child_table_telnet(elements, &info->preLine) == 0) {
    elements->measureTag = info->preLine.measureTag;
    return TSDB_CODE_SUCCESS;
  }

  int32_t code = 0;
  int32_t lino = 0;
  if(info->dataFormat){
    SML_CHECK_CODE(smlProcessSuperTable(info, elements));
  }
  SML_CHECK_CODE(smlProcessTagTelnet(info, data, sqlEnd));
  SML_CHECK_CODE(smlJoinMeasureTag(elements));

  code = smlProcessChildTable(info, elements);

END:
  if(info->reRun){
    return TSDB_CODE_SUCCESS;
  }
  RETURN
}

// format: <metric> <timestamp> <value> <tagk_1>=<tagv_1>[ <tagk_n>=<tagv_n>]
int32_t smlParseTelnetString(SSmlHandle *info, char *sql, char *sqlEnd, SSmlLineInfo *elements) {
  if (!sql) return TSDB_CODE_SML_INVALID_DATA;

  // parse metric
  smlParseTelnetElement(&sql, sqlEnd, &elements->measure, &elements->measureLen);
  if (unlikely((!(elements->measure) || IS_INVALID_TABLE_LEN(elements->measureLen)))) {
    smlBuildInvalidDataMsg(&info->msgBuf, "SML telnet invalid measure", sql);
    return TSDB_CODE_TSC_INVALID_TABLE_ID_LENGTH;
  }

  // parse timestamp
  smlParseTelnetElement(&sql, sqlEnd, &elements->timestamp, &elements->timestampLen);
  if (unlikely(!elements->timestamp || elements->timestampLen == 0)) {
    smlBuildInvalidDataMsg(&info->msgBuf, "SML telnet invalid timestamp", sql);
    return TSDB_CODE_SML_INVALID_DATA;
  }

  bool needConverTime = false;  // get TS before parse tag(get meta), so need convert time
  if (info->dataFormat && info->currSTableMeta == NULL) {
    needConverTime = true;
  }
  int64_t ts = smlParseOpenTsdbTime(info, elements->timestamp, elements->timestampLen);
  if (unlikely(ts < 0)) {
    smlBuildInvalidDataMsg(&info->msgBuf, "SML telnet parse timestamp failed", sql);
    return TSDB_CODE_INVALID_TIMESTAMP;
  }

  // parse value
  smlParseTelnetElement(&sql, sqlEnd, &elements->cols, &elements->colsLen);
  if (unlikely(!elements->cols || elements->colsLen == 0)) {
    smlBuildInvalidDataMsg(&info->msgBuf, "SML telnet invalid value", sql);
    return TSDB_CODE_TSC_INVALID_VALUE;
  }

  SSmlKv kv = {.key = VALUE, .keyLen = VALUE_LEN, .value = elements->cols, .length = (size_t)elements->colsLen};
  int ret = smlParseValue(&kv, &info->msgBuf);
  if (ret != TSDB_CODE_SUCCESS) {
    uError("SML:0x%" PRIx64 " %s parse value error:%d.", info->id, __FUNCTION__, ret);
    return TSDB_CODE_TSC_INVALID_VALUE;
  }

  JUMP_SPACE(sql, sqlEnd)

  elements->tags = sql;
  elements->tagsLen = sqlEnd - sql;
  if (unlikely(!elements->tags || elements->tagsLen == 0)) {
    smlBuildInvalidDataMsg(&info->msgBuf, "SML telnet invalid tag value", sql);
    return TSDB_CODE_TSC_INVALID_VALUE;
  }

  ret = smlParseTelnetTags(info, sql, sqlEnd, elements);
  if (unlikely(ret != TSDB_CODE_SUCCESS)) {
    return ret;
  }

  if (unlikely(info->reRun)) {
    return TSDB_CODE_SUCCESS;
  }

  SSmlKv kvTs = {0};
  smlBuildTsKv(&kvTs, ts);
  if (needConverTime && info->currSTableMeta != NULL) {
    kvTs.i = convertTimePrecision(kvTs.i, TSDB_TIME_PRECISION_NANO, info->currSTableMeta->tableInfo.precision);
  }

  if (info->dataFormat){
    ret = smlParseEndTelnetJsonFormat(info, elements, &kvTs, &kv);
  } else {
    ret = smlParseEndTelnetJsonUnFormat(info, elements, &kvTs, &kv);
  }
  info->preLine = *elements;

  return ret;
}

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 <ctype.h>
17	#include <stdio.h>
18	#include <stdlib.h>
19	#include <string.h>
20
21	#include "clientSml.h"
22
23	int32_t is_same_child_table_telnet(const void a, const void b) {	611,598✔
24	SSmlLineInfo t1 = (SSmlLineInfo )a;	611,598✔
25	SSmlLineInfo t2 = (SSmlLineInfo )b;	611,598✔
26	if (t1 == NULL \|\| t2 == NULL \|\| t1->measure == NULL \|\| t2->measure == NULL \|\| t1->tags == NULL \|\| t2->tags == NULL)	611,598✔
27	return 1;	516,167✔
28	return (((t1->measureLen == t2->measureLen) && memcmp(t1->measure, t2->measure, t1->measureLen) == 0) &&	115,222✔
29	((t1->tagsLen == t2->tagsLen) && memcmp(t1->tags, t2->tags, t1->tagsLen) == 0))	105,294✔
30	? 0
31	: 1;	274,105✔
32	}
33
34	int64_t smlParseOpenTsdbTime(SSmlHandle info, const char data, int32_t len) {	241,436✔
35	uint8_t toPrecision = info->currSTableMeta ? info->currSTableMeta->tableInfo.precision : TSDB_TIME_PRECISION_NANO;	241,436✔
36
37	if (unlikely(!data)) {	241,436✔
38	smlBuildInvalidDataMsg(&info->msgBuf, "timestamp can not be null", NULL);	×
39	return -1;	×
40	}
41	if (unlikely(len == 1 && data[0] == '0')) {	241,436✔
42	return taosGetTimestampNs() / smlFactorNS[toPrecision];	2,260✔
43	}
44	int8_t fromPrecision = smlGetTsTypeByLen(len);	240,306✔
45	if (unlikely(fromPrecision == -1)) {	240,306✔
46	smlBuildInvalidDataMsg(&info->msgBuf,	11,865✔
47	"timestamp precision can only be seconds(10 digits) or milli seconds(13 digits)", data);
48	return -1;	11,865✔
49	}
50	int64_t ts = smlGetTimeValue(data, len, fromPrecision, toPrecision);	228,441✔
51	if (unlikely(ts == -1)) {	228,441✔
52	smlBuildInvalidDataMsg(&info->msgBuf, "invalid timestamp", data);	×
53	return -1;	×
54	}
55	return ts;	228,441✔
56	}
57
58	static void smlParseTelnetElement(char *sql, char sqlEnd, char *data, int32_t len) {	719,788✔
59	while (*sql < sqlEnd) {	8,031,359✔
60	if (unlikely((*sql != SPACE && !(data)))) {	8,024,014✔
61	data = sql;	719,776✔
62	} else if (unlikely(*sql == SPACE && data)) {	7,304,238✔
63	len = sql - *data;	712,443✔
64	break;	712,443✔
65	}
66	(*sql)++;	7,311,571✔
67	}
68	}	719,788✔
69
70	static int32_t smlProcessTagTelnet(SSmlHandle info, char data, char *sqlEnd){	102,544✔
71	SArray *preLineKV = info->preLineTagKV;	102,544✔
72	taosArrayClearEx(preLineKV, freeSSmlKv);	102,544✔
73	int cnt = 0;	102,544✔
74
75	const char *sql = data;	102,544✔
76	while (sql < sqlEnd) {	911,656✔
77	JUMP_SPACE(sql, sqlEnd)	1,564,548✔
78	if (unlikely(sql == '\0' \|\| sql == '\n')) break;	826,201✔
79
80	const char *key = sql;	813,067✔
81	size_t keyLen = 0;	813,067✔
82
83	// parse key
84	while (sql < sqlEnd) {	2,804,107✔
85	if (unlikely(*sql == SPACE)) {	2,803,542✔
86	smlBuildInvalidDataMsg(&info->msgBuf, "invalid data", sql);	1,130✔
87	return TSDB_CODE_SML_INVALID_DATA;	1,130✔
88	}
89	if (unlikely(*sql == EQUAL)) {	2,802,412✔
90	keyLen = sql - key;	811,372✔
91	sql++;	811,372✔
92	break;	811,372✔
93	}
94	sql++;	1,991,040✔
95	}
96
97	if (unlikely(IS_INVALID_COL_LEN(keyLen))) {	811,937✔
98	smlBuildInvalidDataMsg(&info->msgBuf, "invalid key or key is too long than 64", key);	1,130✔
99	return TSDB_CODE_TSC_INVALID_COLUMN_LENGTH;	1,130✔
100	}
101
102	// parse value
103	const char *value = sql;	810,807✔
104	size_t valueLen = 0;	810,807✔
105	while (sql < sqlEnd) {	8,831,945✔
106	// parse value
107	if (unlikely(*sql == SPACE)) {	8,746,490✔
108	break;	725,352✔
109	}
110	if (unlikely(*sql == EQUAL)) {	8,021,138✔
111	smlBuildInvalidDataMsg(&info->msgBuf, "invalid data", sql);	×
112	return TSDB_CODE_SML_INVALID_DATA;	×
113	}
114	sql++;	8,021,138✔
115	}
116	valueLen = sql - value;	810,807✔
117
118	if (unlikely(valueLen == 0)) {	810,807✔
119	smlBuildInvalidDataMsg(&info->msgBuf, "invalid value", value);	×
120	return TSDB_CODE_TSC_INVALID_VALUE;	×
121	}
122
123	if (unlikely(valueLen > (TSDB_MAX_TAGS_LEN - VARSTR_HEADER_SIZE) / TSDB_NCHAR_SIZE)) {	810,807✔
124	return TSDB_CODE_PAR_INVALID_VAR_COLUMN_LEN;	×
125	}
126
127	SSmlKv kv = {.key = key,	810,807✔
128	.keyLen = keyLen,
129	.type = TSDB_DATA_TYPE_NCHAR,
130	.value = value,
131	.length = valueLen,
132	.keyEscaped = false,
133	.valueEscaped = false};
134	if (taosArrayPush(preLineKV, &kv) == NULL){	810,807✔
135	return terrno;	×
136	}
137	if (info->dataFormat && !isSmlTagAligned(info, cnt, &kv)) {	810,807✔
138	return TSDB_CODE_SML_INVALID_DATA;	1,695✔
139	}
140	cnt++;	809,112✔
141	}
142	return TSDB_CODE_SUCCESS;	98,589✔
143	}
144
145	static int32_t smlParseTelnetTags(SSmlHandle info, char data, char sqlEnd, SSmlLineInfo elements) {	219,401✔
146	if (is_same_child_table_telnet(elements, &info->preLine) == 0) {	219,401✔
147	elements->measureTag = info->preLine.measureTag;	29,717✔
148	return TSDB_CODE_SUCCESS;	29,717✔
149	}
150
151	int32_t code = 0;	189,684✔
152	int32_t lino = 0;	189,684✔
153	if(info->dataFormat){	189,684✔
154	SML_CHECK_CODE(smlProcessSuperTable(info, elements));	96,841✔
155	}
156	SML_CHECK_CODE(smlProcessTagTelnet(info, data, sqlEnd));	102,544✔
157	SML_CHECK_CODE(smlJoinMeasureTag(elements));	98,589✔
158
159	code = smlProcessChildTable(info, elements);	98,589✔
160
161	END:	189,684✔
162	if(info->reRun){	189,684✔
163	return TSDB_CODE_SUCCESS;	87,073✔
164	}
165	RETURN	102,611✔
166	}
167
168	// format: <metric> <timestamp> <value> <tagk_1>=<tagv_1>[ <tagk_n>=<tagv_n>]
169	int32_t smlParseTelnetString(SSmlHandle info, char sql, char sqlEnd, SSmlLineInfo elements) {	248,781✔
170	if (!sql) return TSDB_CODE_SML_INVALID_DATA;	248,781✔
171
172	// parse metric
173	smlParseTelnetElement(&sql, sqlEnd, &elements->measure, &elements->measureLen);	248,781✔
174	if (unlikely((!(elements->measure) \|\| IS_INVALID_TABLE_LEN(elements->measureLen)))) {	248,781✔
175	smlBuildInvalidDataMsg(&info->msgBuf, "SML telnet invalid measure", sql);	7,345✔
176	return TSDB_CODE_TSC_INVALID_TABLE_ID_LENGTH;	7,345✔
177	}
178
179	// parse timestamp
180	smlParseTelnetElement(&sql, sqlEnd, &elements->timestamp, &elements->timestampLen);	241,436✔
181	if (unlikely(!elements->timestamp \|\| elements->timestampLen == 0)) {	241,436✔
182	smlBuildInvalidDataMsg(&info->msgBuf, "SML telnet invalid timestamp", sql);	×
183	return TSDB_CODE_SML_INVALID_DATA;	×
184	}
185
186	bool needConverTime = false; // get TS before parse tag(get meta), so need convert time	241,436✔
187	if (info->dataFormat && info->currSTableMeta == NULL) {	241,436✔
188	needConverTime = true;	118,660✔
189	}
190	int64_t ts = smlParseOpenTsdbTime(info, elements->timestamp, elements->timestampLen);	241,436✔
191	if (unlikely(ts < 0)) {	241,436✔
192	smlBuildInvalidDataMsg(&info->msgBuf, "SML telnet parse timestamp failed", sql);	11,865✔
193	return TSDB_CODE_INVALID_TIMESTAMP;	11,865✔
194	}
195
196	// parse value
197	smlParseTelnetElement(&sql, sqlEnd, &elements->cols, &elements->colsLen);	229,571✔
198	if (unlikely(!elements->cols \|\| elements->colsLen == 0)) {	229,571✔
199	smlBuildInvalidDataMsg(&info->msgBuf, "SML telnet invalid value", sql);	565✔
200	return TSDB_CODE_TSC_INVALID_VALUE;	565✔
201	}
202
203	SSmlKv kv = {.key = VALUE, .keyLen = VALUE_LEN, .value = elements->cols, .length = (size_t)elements->colsLen};	229,006✔
204	int ret = smlParseValue(&kv, &info->msgBuf);	229,006✔
205	if (ret != TSDB_CODE_SUCCESS) {	228,994✔
206	uError("SML:0x%" PRIx64 " %s parse value error:%d.", info->id, __FUNCTION__, ret);	9,605✔
207	return TSDB_CODE_TSC_INVALID_VALUE;	9,605✔
208	}
209
210	JUMP_SPACE(sql, sqlEnd)	447,234✔
211
212	elements->tags = sql;	219,389✔
213	elements->tagsLen = sqlEnd - sql;	219,389✔
214	if (unlikely(!elements->tags \|\| elements->tagsLen == 0)) {	219,389✔
215	smlBuildInvalidDataMsg(&info->msgBuf, "SML telnet invalid tag value", sql);	×
216	return TSDB_CODE_TSC_INVALID_VALUE;	×
217	}
218
219	ret = smlParseTelnetTags(info, sql, sqlEnd, elements);	219,389✔
220	if (unlikely(ret != TSDB_CODE_SUCCESS)) {	219,401✔
221	return ret;	4,022✔
222	}
223
224	if (unlikely(info->reRun)) {	215,379✔
225	return TSDB_CODE_SUCCESS;	87,073✔
226	}
227
228	SSmlKv kvTs = {0};	128,306✔
229	smlBuildTsKv(&kvTs, ts);	128,306✔
230	if (needConverTime && info->currSTableMeta != NULL) {	128,294✔
231	kvTs.i = convertTimePrecision(kvTs.i, TSDB_TIME_PRECISION_NANO, info->currSTableMeta->tableInfo.precision);	7,225✔
232	}
233
234	if (info->dataFormat){	128,294✔
235	ret = smlParseEndTelnetJsonFormat(info, elements, &kvTs, &kv);	28,665✔
236	} else {
237	ret = smlParseEndTelnetJsonUnFormat(info, elements, &kvTs, &kv);	99,629✔
238	}
239	info->preLine = *elements;	128,306✔
240
241	return ret;	128,306✔
242	}

taosdata / TDengine / #4962

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

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