clientMain.c 29.5 KB
Newer Older
L
Liu Jicong 已提交
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16
/*
 * 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 "catalog.h"
17
#include "clientInt.h"
18
#include "clientLog.h"
L
Liu Jicong 已提交
19
#include "clientStmt.h"
L
Liu Jicong 已提交
20
#include "os.h"
H
Haojun Liao 已提交
21
#include "query.h"
L
Liu Jicong 已提交
22
#include "scheduler.h"
23
#include "tglobal.h"
L
Liu Jicong 已提交
24 25 26
#include "tmsg.h"
#include "tref.h"
#include "trpc.h"
S
version  
Shengliang Guan 已提交
27
#include "version.h"
28 29 30 31 32

#define TSC_VAR_NOT_RELEASE 1
#define TSC_VAR_RELEASED    0

static int32_t sentinel = TSC_VAR_NOT_RELEASE;
33
static int32_t createParseContext(const SRequestObj *pRequest, SParseContext **pCxt);
34 35 36 37 38 39 40 41 42 43 44

int taos_options(TSDB_OPTION option, const void *arg, ...) {
  static int32_t lock = 0;

  for (int i = 1; atomic_val_compare_exchange_32(&lock, 0, 1) != 0; ++i) {
    if (i % 1000 == 0) {
      tscInfo("haven't acquire lock after spin %d times.", i);
      sched_yield();
    }
  }

L
Liu Jicong 已提交
45
  int ret = taos_options_imp(option, (const char *)arg);
46 47 48 49 50 51
  atomic_store_32(&lock, 0);
  return ret;
}

// this function may be called by user or system, or by both simultaneously.
void taos_cleanup(void) {
H
Haojun Liao 已提交
52
  tscInfo("start to cleanup client environment");
53 54 55 56 57

  if (atomic_val_compare_exchange_32(&sentinel, TSC_VAR_NOT_RELEASE, TSC_VAR_RELEASED) != TSC_VAR_NOT_RELEASE) {
    return;
  }

H
Haojun Liao 已提交
58 59
  int32_t id = clientReqRefPool;
  clientReqRefPool = -1;
60 61
  taosCloseRef(id);

H
Haojun Liao 已提交
62
  cleanupTaskQueue();
63

64 65
  id = clientConnRefPool;
  clientConnRefPool = -1;
66 67
  taosCloseRef(id);

68 69
  hbMgrCleanUp();

D
dapan1121 已提交
70
  catalogDestroy();
D
dapan1121 已提交
71
  schedulerDestroy();
H
Haojun Liao 已提交
72

D
dapan1121 已提交
73 74
  rpcCleanup();

H
Haojun Liao 已提交
75
  tscInfo("all local resources released");
76
  taosCleanupCfg();
77
  taosCloseLog();
78 79
}

L
Liu Jicong 已提交
80
setConfRet taos_set_config(const char *config) {
81 82 83 84 85
  // TODO
  setConfRet ret = {SET_CONF_RET_SUCC, {0}};
  return ret;
}

86
TAOS *taos_connect(const char *ip, const char *user, const char *pass, const char *db, uint16_t port) {
S
Shengliang Guan 已提交
87
  tscDebug("try to connect to %s:%u, user:%s db:%s", ip, port, user, db);
H
Haojun Liao 已提交
88 89 90
  if (user == NULL) {
    user = TSDB_DEFAULT_USER;
  }
91

H
Haojun Liao 已提交
92 93 94
  if (pass == NULL) {
    pass = TSDB_DEFAULT_PASS;
  }
95

L
Liu Jicong 已提交
96
  return taos_connect_internal(ip, user, pass, NULL, db, port, CONN_TYPE__QUERY);
97 98
}

L
Liu Jicong 已提交
99
void taos_close(TAOS *taos) {
100 101 102 103
  if (taos == NULL) {
    return;
  }

H
Haojun Liao 已提交
104
  STscObj *pTscObj = (STscObj *)taos;
L
Liu Jicong 已提交
105
  tscDebug("0x%" PRIx64 " try to close connection, numOfReq:%d", pTscObj->id, pTscObj->numOfReqs);
106

D
dapan1121 已提交
107
  taosRemoveRef(clientConnRefPool, pTscObj->id);
108 109
}

110 111 112 113 114
int taos_errno(TAOS_RES *tres) {
  if (tres == NULL) {
    return terrno;
  }

115 116 117 118
  if (TD_RES_TMQ(tres)) {
    return 0;
  }

L
Liu Jicong 已提交
119
  return ((SRequestObj *)tres)->code;
120 121
}

122
const char *taos_errstr(TAOS_RES *res) {
123
  if (res == NULL) {
L
Liu Jicong 已提交
124
    return (const char *)tstrerror(terrno);
125 126
  }

127 128 129 130 131
  if (TD_RES_TMQ(res)) {
    return "success";
  }

  SRequestObj *pRequest = (SRequestObj *)res;
132
  if (NULL != pRequest->msgBuf && (strlen(pRequest->msgBuf) > 0 || pRequest->code == TSDB_CODE_RPC_FQDN_ERROR)) {
133 134
    return pRequest->msgBuf;
  } else {
L
Liu Jicong 已提交
135
    return (const char *)tstrerror(pRequest->code);
136
  }
137 138 139
}

void taos_free_result(TAOS_RES *res) {
D
stmt  
dapan1121 已提交
140 141 142
  if (NULL == res) {
    return;
  }
143

L
Liu Jicong 已提交
144 145 146
  if (TD_RES_QUERY(res)) {
    SRequestObj *pRequest = (SRequestObj *)res;
    destroyRequest(pRequest);
L
Liu Jicong 已提交
147 148 149 150 151 152
  } else if (TD_RES_TMQ(res)) {
    SMqRspObj *pRsp = (SMqRspObj *)res;
    if (pRsp->rsp.blockData) taosArrayDestroyP(pRsp->rsp.blockData, taosMemoryFree);
    if (pRsp->rsp.blockDataLen) taosArrayDestroy(pRsp->rsp.blockDataLen);
    if (pRsp->rsp.blockTags) taosArrayDestroy(pRsp->rsp.blockTags);
    if (pRsp->rsp.blockTagSchema) taosArrayDestroy(pRsp->rsp.blockTagSchema);
L
Liu Jicong 已提交
153 154
    if (pRsp->rsp.withTbName) taosArrayDestroyP(pRsp->rsp.blockTbName, taosMemoryFree);
    if (pRsp->rsp.withSchema) taosArrayDestroyP(pRsp->rsp.blockSchema, (FDelete)tDeleteSSchemaWrapper);
L
Liu Jicong 已提交
155 156
    pRsp->resInfo.pRspMsg = NULL;
    doFreeReqResultInfo(&pRsp->resInfo);
L
Liu Jicong 已提交
157
  }
158 159
}

L
Liu Jicong 已提交
160
int taos_field_count(TAOS_RES *res) {
H
Haojun Liao 已提交
161 162 163 164
  if (res == NULL) {
    return 0;
  }

L
Liu Jicong 已提交
165
  SReqResultInfo *pResInfo = tscGetCurResInfo(res);
H
Haojun Liao 已提交
166 167 168
  return pResInfo->numOfCols;
}

L
Liu Jicong 已提交
169
int taos_num_fields(TAOS_RES *res) { return taos_field_count(res); }
H
Haojun Liao 已提交
170 171 172 173 174 175

TAOS_FIELD *taos_fetch_fields(TAOS_RES *res) {
  if (taos_num_fields(res) == 0) {
    return NULL;
  }

L
Liu Jicong 已提交
176
  SReqResultInfo *pResInfo = tscGetCurResInfo(res);
177
  return pResInfo->userFields;
H
Haojun Liao 已提交
178 179
}

180 181
static void syncQueryFn(void *param, void *res, int32_t code) {
  SSyncQueryParam *pParam = param;
182 183 184 185 186 187
  pParam->pRequest = res;
  pParam->pRequest->code = code;

  tsem_post(&pParam->sem);
}

188 189 190 191 192
TAOS_RES *taos_query(TAOS *taos, const char *sql) {
  if (taos == NULL || sql == NULL) {
    return NULL;
  }

193
  STscObj *pTscObj = (STscObj *)taos;
194 195

#if SYNC_ON_TOP_OF_ASYNC
196
  SSyncQueryParam *param = taosMemoryCalloc(1, sizeof(SSyncQueryParam));
197 198 199 200 201 202 203
  tsem_init(&param->sem, 0, 0);

  taos_query_a(pTscObj, sql, syncQueryFn, param);
  tsem_wait(&param->sem);

  return param->pRequest;
#else
204 205 206 207 208 209 210 211 212
  size_t sqlLen = strlen(sql);
  if (sqlLen > (size_t)TSDB_MAX_ALLOWED_SQL_LEN) {
    tscError("sql string exceeds max length:%d", TSDB_MAX_ALLOWED_SQL_LEN);
    terrno = TSDB_CODE_TSC_EXCEED_SQL_LIMIT;
    return NULL;
  }

  return execQuery(pTscObj, sql, sqlLen);
#endif
213
}
214

215 216
TAOS_ROW taos_fetch_row(TAOS_RES *res) {
  if (res == NULL) {
217 218 219
    return NULL;
  }

L
Liu Jicong 已提交
220 221
  if (TD_RES_QUERY(res)) {
    SRequestObj *pRequest = (SRequestObj *)res;
222 223 224
#if SYNC_ON_TOP_OF_ASYNC
    return doAsyncFetchRows(pRequest, true, true);
#else
L
Liu Jicong 已提交
225 226 227 228
    if (pRequest->type == TSDB_SQL_RETRIEVE_EMPTY_RESULT || pRequest->type == TSDB_SQL_INSERT ||
        pRequest->code != TSDB_CODE_SUCCESS || taos_num_fields(res) == 0) {
      return NULL;
    }
229
    return doFetchRows(pRequest, true, true);
230
#endif
L
Liu Jicong 已提交
231 232

  } else if (TD_RES_TMQ(res)) {
L
Liu Jicong 已提交
233 234 235 236 237 238 239
    SMqRspObj      *msg = ((SMqRspObj *)res);
    SReqResultInfo *pResultInfo;
    if (msg->resIter == -1) {
      pResultInfo = tmqGetNextResInfo(res, true);
    } else {
      pResultInfo = tmqGetCurResInfo(res);
    }
240

L
Liu Jicong 已提交
241
    if (pResultInfo->current < pResultInfo->numOfRows) {
L
Liu Jicong 已提交
242 243
      doSetOneRowPtr(pResultInfo);
      pResultInfo->current += 1;
L
Liu Jicong 已提交
244 245
      return pResultInfo->row;
    } else {
L
Liu Jicong 已提交
246 247 248 249 250
      pResultInfo = tmqGetNextResInfo(res, true);
      if (pResultInfo == NULL) return NULL;
      doSetOneRowPtr(pResultInfo);
      pResultInfo->current += 1;
      return pResultInfo->row;
L
Liu Jicong 已提交
251 252
    }
  } else {
253
    // assert to avoid un-initialization error
L
Liu Jicong 已提交
254 255 256
    ASSERT(0);
  }
  return NULL;
257
}
H
Haojun Liao 已提交
258

L
Liu Jicong 已提交
259
int taos_print_row(char *str, TAOS_ROW row, TAOS_FIELD *fields, int num_fields) {
H
Haojun Liao 已提交
260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317
  int32_t len = 0;
  for (int i = 0; i < num_fields; ++i) {
    if (i > 0) {
      str[len++] = ' ';
    }

    if (row[i] == NULL) {
      len += sprintf(str + len, "%s", TSDB_DATA_NULL_STR);
      continue;
    }

    switch (fields[i].type) {
      case TSDB_DATA_TYPE_TINYINT:
        len += sprintf(str + len, "%d", *((int8_t *)row[i]));
        break;

      case TSDB_DATA_TYPE_UTINYINT:
        len += sprintf(str + len, "%u", *((uint8_t *)row[i]));
        break;

      case TSDB_DATA_TYPE_SMALLINT:
        len += sprintf(str + len, "%d", *((int16_t *)row[i]));
        break;

      case TSDB_DATA_TYPE_USMALLINT:
        len += sprintf(str + len, "%u", *((uint16_t *)row[i]));
        break;

      case TSDB_DATA_TYPE_INT:
        len += sprintf(str + len, "%d", *((int32_t *)row[i]));
        break;

      case TSDB_DATA_TYPE_UINT:
        len += sprintf(str + len, "%u", *((uint32_t *)row[i]));
        break;

      case TSDB_DATA_TYPE_BIGINT:
        len += sprintf(str + len, "%" PRId64, *((int64_t *)row[i]));
        break;

      case TSDB_DATA_TYPE_UBIGINT:
        len += sprintf(str + len, "%" PRIu64, *((uint64_t *)row[i]));
        break;

      case TSDB_DATA_TYPE_FLOAT: {
        float fv = 0;
        fv = GET_FLOAT_VAL(row[i]);
        len += sprintf(str + len, "%f", fv);
      } break;

      case TSDB_DATA_TYPE_DOUBLE: {
        double dv = 0;
        dv = GET_DOUBLE_VAL(row[i]);
        len += sprintf(str + len, "%lf", dv);
      } break;

      case TSDB_DATA_TYPE_BINARY:
      case TSDB_DATA_TYPE_NCHAR: {
L
Liu Jicong 已提交
318
        int32_t charLen = varDataLen((char *)row[i] - VARSTR_HEADER_SIZE);
H
Haojun Liao 已提交
319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338
        if (fields[i].type == TSDB_DATA_TYPE_BINARY) {
          assert(charLen <= fields[i].bytes && charLen >= 0);
        } else {
          assert(charLen <= fields[i].bytes * TSDB_NCHAR_SIZE && charLen >= 0);
        }

        memcpy(str + len, row[i], charLen);
        len += charLen;
      } break;

      case TSDB_DATA_TYPE_TIMESTAMP:
        len += sprintf(str + len, "%" PRId64, *((int64_t *)row[i]));
        break;

      case TSDB_DATA_TYPE_BOOL:
        len += sprintf(str + len, "%d", *((int8_t *)row[i]));
      default:
        break;
    }
  }
L
Liu Jicong 已提交
339
  str[len] = 0;
H
Haojun Liao 已提交
340 341 342

  return len;
}
343

L
Liu Jicong 已提交
344
int *taos_fetch_lengths(TAOS_RES *res) {
345 346 347 348
  if (res == NULL) {
    return NULL;
  }

L
Liu Jicong 已提交
349 350
  SReqResultInfo *pResInfo = tscGetCurResInfo(res);
  return pResInfo->length;
351 352
}

353
TAOS_ROW *taos_result_block(TAOS_RES *res) {
L
Liu Jicong 已提交
354
  if (res == NULL) {
355 356 357 358 359 360 361 362
    terrno = TSDB_CODE_INVALID_PARA;
    return NULL;
  }

  if (taos_is_update_query(res)) {
    return NULL;
  }

L
Liu Jicong 已提交
363 364
  SReqResultInfo *pResInfo = tscGetCurResInfo(res);
  return &pResInfo->row;
365 366
}

367
// todo intergrate with tDataTypes
368 369
const char *taos_data_type(int type) {
  switch (type) {
L
Liu Jicong 已提交
370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396
    case TSDB_DATA_TYPE_NULL:
      return "TSDB_DATA_TYPE_NULL";
    case TSDB_DATA_TYPE_BOOL:
      return "TSDB_DATA_TYPE_BOOL";
    case TSDB_DATA_TYPE_TINYINT:
      return "TSDB_DATA_TYPE_TINYINT";
    case TSDB_DATA_TYPE_SMALLINT:
      return "TSDB_DATA_TYPE_SMALLINT";
    case TSDB_DATA_TYPE_INT:
      return "TSDB_DATA_TYPE_INT";
    case TSDB_DATA_TYPE_BIGINT:
      return "TSDB_DATA_TYPE_BIGINT";
    case TSDB_DATA_TYPE_FLOAT:
      return "TSDB_DATA_TYPE_FLOAT";
    case TSDB_DATA_TYPE_DOUBLE:
      return "TSDB_DATA_TYPE_DOUBLE";
    case TSDB_DATA_TYPE_VARCHAR:
      return "TSDB_DATA_TYPE_VARCHAR";
      //    case TSDB_DATA_TYPE_BINARY:          return "TSDB_DATA_TYPE_VARCHAR";
    case TSDB_DATA_TYPE_TIMESTAMP:
      return "TSDB_DATA_TYPE_TIMESTAMP";
    case TSDB_DATA_TYPE_NCHAR:
      return "TSDB_DATA_TYPE_NCHAR";
    case TSDB_DATA_TYPE_JSON:
      return "TSDB_DATA_TYPE_JSON";
    default:
      return "UNKNOWN";
397 398
  }
}
399 400 401

const char *taos_get_client_info() { return version; }

X
Xiaoyu Wang 已提交
402
int taos_affected_rows(TAOS_RES *res) {
L
Liu Jicong 已提交
403
  if (res == NULL || TD_RES_TMQ(res)) {
H
Haojun Liao 已提交
404 405 406
    return 0;
  }

L
Liu Jicong 已提交
407 408
  SRequestObj    *pRequest = (SRequestObj *)res;
  SReqResultInfo *pResInfo = &pRequest->body.resInfo;
H
Haojun Liao 已提交
409
  return pResInfo->numOfRows;
X
Xiaoyu Wang 已提交
410
}
411

412
int taos_result_precision(TAOS_RES *res) {
L
Liu Jicong 已提交
413
  if (res == NULL) {
H
Haojun Liao 已提交
414 415
    return TSDB_TIME_PRECISION_MILLI;
  }
416

L
Liu Jicong 已提交
417 418 419 420 421 422 423 424
  if (TD_RES_QUERY(res)) {
    SRequestObj *pRequest = (SRequestObj *)res;
    return pRequest->body.resInfo.precision;
  } else if (TD_RES_TMQ(res)) {
    SReqResultInfo *info = tmqGetCurResInfo(res);
    return info->precision;
  }
  return TSDB_TIME_PRECISION_MILLI;
425
}
426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441

int taos_select_db(TAOS *taos, const char *db) {
  STscObj *pObj = (STscObj *)taos;
  if (pObj == NULL) {
    terrno = TSDB_CODE_TSC_DISCONNECTED;
    return TSDB_CODE_TSC_DISCONNECTED;
  }

  if (db == NULL || strlen(db) == 0) {
    terrno = TSDB_CODE_TSC_INVALID_INPUT;
    return terrno;
  }

  char sql[256] = {0};
  snprintf(sql, tListLen(sql), "use %s", db);

L
Liu Jicong 已提交
442 443
  TAOS_RES *pRequest = taos_query(taos, sql);
  int32_t   code = taos_errno(pRequest);
444 445 446 447 448 449 450 451 452 453

  taos_free_result(pRequest);
  return code;
}

void taos_stop_query(TAOS_RES *res) {
  if (res == NULL) {
    return;
  }

L
Liu Jicong 已提交
454 455
  SRequestObj *pRequest = (SRequestObj *)res;
  int32_t      numOfFields = taos_num_fields(pRequest);
456 457 458 459 460 461

  // It is not a query, no need to stop.
  if (numOfFields == 0) {
    return;
  }

D
dapan1121 已提交
462
  schedulerFreeJob(pRequest->body.queryJob);
463 464 465
}

bool taos_is_null(TAOS_RES *res, int32_t row, int32_t col) {
L
Liu Jicong 已提交
466
  SReqResultInfo *pResultInfo = tscGetCurResInfo(res);
467 468 469 470
  if (col >= pResultInfo->numOfCols || col < 0 || row >= pResultInfo->numOfRows || row < 0) {
    return true;
  }

L
Liu Jicong 已提交
471
  SResultColumn *pCol = &pResultInfo->pCol[col];
472 473 474 475 476
  if (IS_VAR_DATA_TYPE(pResultInfo->fields[col].type)) {
    return (pCol->offset[row] == -1);
  } else {
    return colDataIsNull_f(pCol->nullbitmap, row);
  }
477 478
}

L
Liu Jicong 已提交
479
bool taos_is_update_query(TAOS_RES *res) { return taos_num_fields(res) == 0; }
480

L
Liu Jicong 已提交
481
int taos_fetch_block(TAOS_RES *res, TAOS_ROW *rows) {
H
Haojun Liao 已提交
482
  int32_t numOfRows = 0;
L
Liu Jicong 已提交
483
  /*int32_t code = */ taos_fetch_block_s(res, &numOfRows, rows);
H
Haojun Liao 已提交
484 485 486
  return numOfRows;
}

L
Liu Jicong 已提交
487 488
int taos_fetch_block_s(TAOS_RES *res, int *numOfRows, TAOS_ROW *rows) {
  if (res == NULL) {
489 490
    return 0;
  }
491

L
Liu Jicong 已提交
492 493
  if (TD_RES_QUERY(res)) {
    SRequestObj *pRequest = (SRequestObj *)res;
494

L
Liu Jicong 已提交
495 496
    (*rows) = NULL;
    (*numOfRows) = 0;
H
Haojun Liao 已提交
497

L
Liu Jicong 已提交
498 499 500 501
    if (pRequest->type == TSDB_SQL_RETRIEVE_EMPTY_RESULT || pRequest->type == TSDB_SQL_INSERT ||
        pRequest->code != TSDB_CODE_SUCCESS || taos_num_fields(res) == 0) {
      return 0;
    }
502

503
#if SYNC_ON_TOP_OF_ASYNC
504
    doAsyncFetchRows(pRequest, false, true);
505 506 507
#else
    doFetchRows(pRequest, true, true);
#endif
508

L
Liu Jicong 已提交
509 510 511
    // TODO refactor
    SReqResultInfo *pResultInfo = &pRequest->body.resInfo;
    pResultInfo->current = pResultInfo->numOfRows;
512

L
Liu Jicong 已提交
513 514 515 516
    (*rows) = pResultInfo->row;
    (*numOfRows) = pResultInfo->numOfRows;
    return pRequest->code;
  } else if (TD_RES_TMQ(res)) {
L
Liu Jicong 已提交
517
    SReqResultInfo *pResultInfo = tmqGetNextResInfo(res, true);
L
Liu Jicong 已提交
518
    if (pResultInfo == NULL) return -1;
H
Haojun Liao 已提交
519

L
Liu Jicong 已提交
520 521 522
    pResultInfo->current = pResultInfo->numOfRows;
    (*rows) = pResultInfo->row;
    (*numOfRows) = pResultInfo->numOfRows;
H
Haojun Liao 已提交
523
    return 0;
L
Liu Jicong 已提交
524 525 526
  } else {
    ASSERT(0);
    return -1;
H
Haojun Liao 已提交
527
  }
L
Liu Jicong 已提交
528
}
H
Haojun Liao 已提交
529

L
Liu Jicong 已提交
530 531
int taos_fetch_raw_block(TAOS_RES *res, int *numOfRows, void **pData) {
  if (res == NULL) {
H
Haojun Liao 已提交
532 533
    return 0;
  }
534

535
  if (TD_RES_TMQ(res)) {
L
Liu Jicong 已提交
536
    SReqResultInfo *pResultInfo = tmqGetNextResInfo(res, false);
L
Liu Jicong 已提交
537 538 539 540
    if (pResultInfo == NULL) {
      (*numOfRows) = 0;
      return 0;
    }
H
Haojun Liao 已提交
541

L
Liu Jicong 已提交
542 543 544 545
    pResultInfo->current = pResultInfo->numOfRows;
    (*numOfRows) = pResultInfo->numOfRows;
    (*pData) = (void *)pResultInfo->pData;
    return 0;
546
  }
L
Liu Jicong 已提交
547

548 549 550 551 552
  SRequestObj *pRequest = (SRequestObj *)res;

  if (pRequest->type == TSDB_SQL_RETRIEVE_EMPTY_RESULT || pRequest->type == TSDB_SQL_INSERT ||
      pRequest->code != TSDB_CODE_SUCCESS || taos_num_fields(res) == 0) {
    return 0;
L
Liu Jicong 已提交
553
  }
554

555 556 557
#if SYNC_ON_TOP_OF_ASYNC
  doAsyncFetchRows(pRequest, false, false);
#else
558
  doFetchRows(pRequest, false, false);
559
#endif
560 561 562 563 564 565 566 567

  SReqResultInfo *pResultInfo = &pRequest->body.resInfo;

  pResultInfo->current = pResultInfo->numOfRows;
  (*numOfRows) = pResultInfo->numOfRows;
  (*pData) = (void *)pResultInfo->pData;

  return 0;
568 569
}

H
Haojun Liao 已提交
570
int *taos_get_column_data_offset(TAOS_RES *res, int columnIndex) {
L
Liu Jicong 已提交
571
  if (res == NULL) {
H
Haojun Liao 已提交
572 573 574
    return 0;
  }

L
Liu Jicong 已提交
575
  int32_t numOfFields = taos_num_fields(res);
H
Haojun Liao 已提交
576 577 578 579
  if (columnIndex < 0 || columnIndex >= numOfFields || numOfFields == 0) {
    return 0;
  }

L
Liu Jicong 已提交
580 581
  SReqResultInfo *pResInfo = tscGetCurResInfo(res);
  TAOS_FIELD     *pField = &pResInfo->userFields[columnIndex];
H
Haojun Liao 已提交
582 583 584 585
  if (!IS_VAR_DATA_TYPE(pField->type)) {
    return 0;
  }

L
Liu Jicong 已提交
586
  return pResInfo->pCol[columnIndex].offset;
H
Haojun Liao 已提交
587 588
}

L
Liu Jicong 已提交
589
int taos_validate_sql(TAOS *taos, const char *sql) { return true; }
590

591
void taos_reset_current_db(TAOS *taos) {
H
Haojun Liao 已提交
592 593 594 595 596
  if (taos == NULL) {
    return;
  }

  resetConnectDB(taos);
597 598
}

599 600 601 602 603
const char *taos_get_server_info(TAOS *taos) {
  if (taos == NULL) {
    return NULL;
  }

L
Liu Jicong 已提交
604
  STscObj *pTscObj = (STscObj *)taos;
605 606 607
  return pTscObj->ver;
}

608
typedef struct SqlParseWrapper {
609
  SParseContext *pCtx;
610
  SCatalogReq    catalogReq;
611 612
  SRequestObj   *pRequest;
  SQuery        *pQuery;
613 614
} SqlParseWrapper;

615 616 617 618 619 620 621 622 623 624 625 626 627 628 629 630 631 632
static void destorySqlParseWrapper(SqlParseWrapper *pWrapper) {
  taosArrayDestroy(pWrapper->catalogReq.pDbVgroup);
  taosArrayDestroy(pWrapper->catalogReq.pDbCfg);
  taosArrayDestroy(pWrapper->catalogReq.pDbInfo);
  taosArrayDestroy(pWrapper->catalogReq.pTableMeta);
  taosArrayDestroy(pWrapper->catalogReq.pTableHash);
  taosArrayDestroy(pWrapper->catalogReq.pUdf);
  taosArrayDestroy(pWrapper->catalogReq.pIndex);
  taosArrayDestroy(pWrapper->catalogReq.pUser);
  taosArrayDestroy(pWrapper->catalogReq.pTableIndex);
  taosMemoryFree(pWrapper->pCtx);
  taosMemoryFree(pWrapper);
}

void retrieveMetaCallback(SMetaData *pResultMeta, void *param, int32_t code) {
  SqlParseWrapper *pWrapper = (SqlParseWrapper *)param;
  SQuery          *pQuery = pWrapper->pQuery;
  SRequestObj     *pRequest = pWrapper->pRequest;
633

634 635
  if (code == TSDB_CODE_SUCCESS) {
    code = qAnalyseSqlSemantic(pWrapper->pCtx, &pWrapper->catalogReq, pResultMeta, pQuery);
636 637
  }

638 639 640 641 642
  if (code == TSDB_CODE_SUCCESS) {
    if (pQuery->haveResultSet) {
      setResSchemaInfo(&pRequest->body.resInfo, pQuery->pResSchema, pQuery->numOfResCols);
      setResPrecision(&pRequest->body.resInfo, pQuery->precision);
    }
643

644 645
    TSWAP(pRequest->dbList, (pQuery)->pDbList);
    TSWAP(pRequest->tableList, (pQuery)->pTableList);
646

647
    destorySqlParseWrapper(pWrapper);
648 649
    launchAsyncQuery(pRequest, pQuery);
  } else {
650
    destorySqlParseWrapper(pWrapper);
651
    tscDebug("error happens, code:%d", code);
652
    if (NEED_CLIENT_HANDLE_ERROR(code)) {
653 654
      tscDebug("0x%" PRIx64 " client retry to handle the error, code:%d - %s, tryCount:%d, reqId:0x%" PRIx64,
               pRequest->self, code, tstrerror(code), pRequest->retry, pRequest->requestId);
655 656 657 658
      pRequest->prevCode = code;
      doAsyncQuery(pRequest, true);
      return;
    }
659

660
    // return to app directly
661 662
    tscError("0x%" PRIx64 " error occurs, code:%s, return to user app, reqId:0x%" PRIx64, pRequest->self,
             tstrerror(code), pRequest->requestId);
663 664 665
    pRequest->code = code;
    pRequest->body.queryFp(pRequest->body.param, pRequest, code);
  }
666 667
}

668
void taos_query_a(TAOS *taos, const char *sql, __taos_async_fn_t fp, void *param) {
669 670
  ASSERT(fp != NULL);

671
  if (taos == NULL || sql == NULL) {
672 673
    terrno = TSDB_CODE_INVALID_PARA;
    fp(param, NULL, terrno);
674 675 676
    return;
  }

677 678 679 680 681 682
  size_t sqlLen = strlen(sql);
  if (sqlLen > (size_t)TSDB_MAX_ALLOWED_SQL_LEN) {
    tscError("sql string exceeds max length:%d", TSDB_MAX_ALLOWED_SQL_LEN);
    terrno = TSDB_CODE_TSC_EXCEED_SQL_LIMIT;

    fp(param, NULL, terrno);
683 684 685
    return;
  }

686
  SRequestObj *pRequest = NULL;
687
  int32_t      code = buildRequest(taos, sql, sqlLen, &pRequest);
688 689
  if (code != TSDB_CODE_SUCCESS) {
    terrno = code;
690
    fp(param, NULL, terrno);
691 692
    return;
  }
693

694
  pRequest->body.queryFp = fp;
695
  pRequest->body.param = param;
696 697
  doAsyncQuery(pRequest, false);
}
698

699
int32_t createParseContext(const SRequestObj *pRequest, SParseContext **pCxt) {
700 701 702 703 704 705 706
  const STscObj *pTscObj = pRequest->pTscObj;

  *pCxt = taosMemoryCalloc(1, sizeof(SParseContext));
  if (*pCxt == NULL) {
    return TSDB_CODE_OUT_OF_MEMORY;
  }

707 708
  **pCxt = (SParseContext){
      .requestId = pRequest->requestId,
X
Xiaoyu Wang 已提交
709
      .requestRid = pRequest->self,
710 711 712 713 714 715 716 717 718 719 720 721 722 723
      .acctId = pTscObj->acctId,
      .db = pRequest->pDb,
      .topicQuery = false,
      .pSql = pRequest->sqlstr,
      .sqlLen = pRequest->sqlLen,
      .pMsg = pRequest->msgBuf,
      .msgLen = ERROR_MSG_BUF_DEFAULT_SIZE,
      .pTransporter = pTscObj->pAppInfo->pTransporter,
      .pStmtCb = NULL,
      .pUser = pTscObj->user,
      .schemalessType = pTscObj->schemalessType,
      .isSuperUser = (0 == strcmp(pTscObj->user, TSDB_DEFAULT_USER)),
      .async = true,
  };
724 725 726
  return TSDB_CODE_SUCCESS;
}

727 728 729 730
void doAsyncQuery(SRequestObj *pRequest, bool updateMetaForce) {
  SParseContext *pCxt = NULL;
  STscObj       *pTscObj = pRequest->pTscObj;
  int32_t        code = 0;
731 732

  if (pRequest->retry++ > REQUEST_TOTAL_EXEC_TIMES) {
733
    code = pRequest->prevCode;
734 735 736
    goto _error;
  }

737
  code = createParseContext(pRequest, &pCxt);
738 739 740
  if (code != TSDB_CODE_SUCCESS) {
    goto _error;
  }
741 742 743 744 745

  pCxt->mgmtEpSet = getEpSet_s(&pTscObj->pAppInfo->mgmtEp);
  code = catalogGetHandle(pTscObj->pAppInfo->clusterId, &pCxt->pCatalog);
  if (code != TSDB_CODE_SUCCESS) {
    goto _error;
746 747
  }

748 749
  SQuery *pQuery = NULL;

750
  SCatalogReq catalogReq = {.forceUpdate = updateMetaForce};
751 752 753 754 755 756
  code = qParseSqlSyntax(pCxt, &pQuery, &catalogReq);
  if (code != TSDB_CODE_SUCCESS) {
    goto _error;
  }

  SqlParseWrapper *pWrapper = taosMemoryCalloc(1, sizeof(SqlParseWrapper));
757
  if (pWrapper == NULL) {
758
    code = TSDB_CODE_OUT_OF_MEMORY;
759 760 761
    goto _error;
  }

762 763 764 765 766
  pWrapper->pCtx = pCxt;
  pWrapper->pQuery = pQuery;
  pWrapper->pRequest = pRequest;
  pWrapper->catalogReq = catalogReq;

X
Xiaoyu Wang 已提交
767
  SRequestConnInfo conn = {.pTrans = pCxt->pTransporter,
D
dapan1121 已提交
768 769 770 771
                           .requestId = pCxt->requestId,
                           .requestObjRefId = pCxt->requestRid,
                           .mgmtEps = pCxt->mgmtEpSet};

X
Xiaoyu Wang 已提交
772 773
  code = catalogAsyncGetAllMeta(pCxt->pCatalog, &conn, pRequest->requestId, &catalogReq, retrieveMetaCallback, pWrapper,
                                &pRequest->body.queryJob);
774 775
  if (code == TSDB_CODE_SUCCESS) {
    return;
776 777
  }

778 779 780
_error:
  tscError("0x%" PRIx64 " error happens, code:%d - %s, reqId:0x%" PRIx64, pRequest->self, code, tstrerror(code),
           pRequest->requestId);
781 782
  terrno = code;
  pRequest->code = code;
783
  pRequest->body.queryFp(pRequest->body.param, pRequest, code);
784 785
}

786 787
static void fetchCallback(void *pResult, void *param, int32_t code) {
  SRequestObj *pRequest = (SRequestObj *)param;
788

789
  SReqResultInfo *pResultInfo = &pRequest->body.resInfo;
790 791 792 793 794 795 796 797 798 799 800 801

  pResultInfo->pData = pResult;
  pResultInfo->numOfRows = 0;

  if (code != TSDB_CODE_SUCCESS) {
    pRequest->code = code;
    pRequest->body.fetchFp(pRequest->body.param, pRequest, 0);
    return;
  }

  if (pRequest->code != TSDB_CODE_SUCCESS) {
    pRequest->body.fetchFp(pRequest->body.param, pRequest, 0);
802
    return;
803 804
  }

805 806
  pRequest->code =
      setQueryResultFromRsp(pResultInfo, (SRetrieveTableRsp *)pResultInfo->pData, pResultInfo->convertUcs4, false);
807 808 809
  if (pRequest->code != TSDB_CODE_SUCCESS) {
    pResultInfo->numOfRows = 0;
    pRequest->code = code;
810 811 812 813 814 815
    tscError("0x%" PRIx64 " fetch results failed, code:%s, reqId:0x%" PRIx64, pRequest->self, tstrerror(code),
             pRequest->requestId);
  } else {
    tscDebug("0x%" PRIx64 " fetch results, numOfRows:%d total Rows:%" PRId64 ", complete:%d, reqId:0x%" PRIx64,
             pRequest->self, pResultInfo->numOfRows, pResultInfo->totalRows, pResultInfo->completed,
             pRequest->requestId);
816 817 818 819 820
  }

  pRequest->body.fetchFp(pRequest->body.param, pRequest, pResultInfo->numOfRows);
}

821
void taos_fetch_rows_a(TAOS_RES *res, __taos_async_fn_t fp, void *param) {
822
  ASSERT(res != NULL && fp != NULL);
823 824 825 826 827 828 829 830 831 832 833 834 835 836 837 838 839 840 841 842

  SRequestObj *pRequest = res;
  pRequest->body.fetchFp = fp;

  SReqResultInfo *pResultInfo = &pRequest->body.resInfo;
  if (taos_num_fields(pRequest) == 0) {
    pResultInfo->numOfRows = 0;
    pRequest->body.fetchFp(param, pRequest, pResultInfo->numOfRows);
    return;
  }

  if (pResultInfo->pData == NULL || pResultInfo->current >= pResultInfo->numOfRows) {
    // All data has returned to App already, no need to try again
    if (pResultInfo->completed) {
      pResultInfo->numOfRows = 0;
      pRequest->body.fetchFp(param, pRequest, pResultInfo->numOfRows);
      return;
    }
  }

843
  schedulerAsyncFetchRows(pRequest->body.queryJob, fetchCallback, pRequest);
L
Liu Jicong 已提交
844
}
845

846
void taos_fetch_raw_block_a(TAOS_RES *res, __taos_async_fn_t fp, void *param) {
847 848
  ASSERT(res != NULL && fp != NULL);
  SRequestObj *pRequest = res;
H
Haojun Liao 已提交
849

850
  pRequest->body.resInfo.convertUcs4 = false;
851 852 853 854 855

  SReqResultInfo *pResultInfo = &pRequest->body.resInfo;

  // set the current block is all consumed
  pResultInfo->current = pResultInfo->numOfRows;
856 857 858
  taos_fetch_rows_a(res, fp, param);
}

859
const void *taos_get_raw_block(TAOS_RES *res) {
H
Haojun Liao 已提交
860
  ASSERT(res != NULL);
861
  SRequestObj *pRequest = res;
H
Haojun Liao 已提交
862 863 864 865

  return pRequest->body.resInfo.pData;
}

L
Liu Jicong 已提交
866 867 868 869
TAOS_SUB *taos_subscribe(TAOS *taos, int restart, const char *topic, const char *sql, TAOS_SUBSCRIBE_CALLBACK fp,
                         void *param, int interval) {
  // TODO
  return NULL;
870 871 872
}

TAOS_RES *taos_consume(TAOS_SUB *tsub) {
L
Liu Jicong 已提交
873 874
  // TODO
  return NULL;
875 876 877
}

void taos_unsubscribe(TAOS_SUB *tsub, int keepProgress) {
L
Liu Jicong 已提交
878
  // TODO
879 880
}

881 882 883 884 885
int taos_load_table_info(TAOS *taos, const char *tableNameList) {
  // TODO
  return -1;
}

L
Liu Jicong 已提交
886
TAOS_STMT *taos_stmt_init(TAOS *taos) {
D
stmt  
dapan1121 已提交
887
  if (taos == NULL) {
D
stmt  
dapan1121 已提交
888
    tscError("NULL parameter for %s", __FUNCTION__);
D
stmt  
dapan1121 已提交
889 890 891 892 893
    terrno = TSDB_CODE_INVALID_PARA;
    return NULL;
  }

  return stmtInit(taos);
894 895
}

D
stmt  
dapan1121 已提交
896 897
int taos_stmt_prepare(TAOS_STMT *stmt, const char *sql, unsigned long length) {
  if (stmt == NULL || sql == NULL) {
D
stmt  
dapan1121 已提交
898
    tscError("NULL parameter for %s", __FUNCTION__);
D
stmt  
dapan1121 已提交
899 900 901 902
    terrno = TSDB_CODE_INVALID_PARA;
    return terrno;
  }

D
stmt  
dapan1121 已提交
903
  return stmtPrepare(stmt, sql, length);
904 905
}

D
dapan1121 已提交
906
int taos_stmt_set_tbname_tags(TAOS_STMT *stmt, const char *name, TAOS_MULTI_BIND *tags) {
D
stmt  
dapan1121 已提交
907
  if (stmt == NULL || name == NULL) {
D
stmt  
dapan1121 已提交
908
    tscError("NULL parameter for %s", __FUNCTION__);
D
stmt  
dapan1121 已提交
909 910 911 912
    terrno = TSDB_CODE_INVALID_PARA;
    return terrno;
  }

D
stmt  
dapan1121 已提交
913 914 915 916 917 918 919 920 921 922
  int32_t code = stmtSetTbName(stmt, name);
  if (code) {
    return code;
  }

  if (tags) {
    return stmtSetTbTags(stmt, tags);
  }

  return TSDB_CODE_SUCCESS;
923 924
}

D
stmt  
dapan1121 已提交
925 926
int taos_stmt_set_tbname(TAOS_STMT *stmt, const char *name) {
  if (stmt == NULL || name == NULL) {
D
stmt  
dapan1121 已提交
927
    tscError("NULL parameter for %s", __FUNCTION__);
D
stmt  
dapan1121 已提交
928
    terrno = TSDB_CODE_INVALID_PARA;
D
stmt  
dapan1121 已提交
929
    return terrno;
D
stmt  
dapan1121 已提交
930 931
  }

D
stmt  
dapan1121 已提交
932
  return stmtSetTbName(stmt, name);
933 934
}

D
dapan1121 已提交
935 936 937 938 939 940 941 942 943 944
int taos_stmt_set_tags(TAOS_STMT *stmt, TAOS_MULTI_BIND *tags) {
  if (stmt == NULL || tags == NULL) {
    tscError("NULL parameter for %s", __FUNCTION__);
    terrno = TSDB_CODE_INVALID_PARA;
    return terrno;
  }

  return stmtSetTbTags(stmt, tags);
}

945
int taos_stmt_set_sub_tbname(TAOS_STMT *stmt, const char *name) { return taos_stmt_set_tbname(stmt, name); }
D
dapan1121 已提交
946

947
int taos_stmt_get_tag_fields(TAOS_STMT *stmt, int *fieldNum, TAOS_FIELD_E **fields) {
D
dapan1121 已提交
948 949 950 951 952
  if (stmt == NULL || NULL == fieldNum) {
    tscError("NULL parameter for %s", __FUNCTION__);
    terrno = TSDB_CODE_INVALID_PARA;
    return terrno;
  }
953

D
dapan1121 已提交
954 955 956
  return stmtGetTagFields(stmt, fieldNum, fields);
}

957
int taos_stmt_get_col_fields(TAOS_STMT *stmt, int *fieldNum, TAOS_FIELD_E **fields) {
D
dapan1121 已提交
958 959 960 961 962
  if (stmt == NULL || NULL == fieldNum) {
    tscError("NULL parameter for %s", __FUNCTION__);
    terrno = TSDB_CODE_INVALID_PARA;
    return terrno;
  }
963

D
dapan1121 已提交
964 965 966
  return stmtGetColFields(stmt, fieldNum, fields);
}

D
dapan1121 已提交
967
int taos_stmt_bind_param(TAOS_STMT *stmt, TAOS_MULTI_BIND *bind) {
D
stmt  
dapan1121 已提交
968
  if (stmt == NULL || bind == NULL) {
D
stmt  
dapan1121 已提交
969
    tscError("NULL parameter for %s", __FUNCTION__);
D
stmt  
dapan1121 已提交
970
    terrno = TSDB_CODE_INVALID_PARA;
D
stmt  
dapan1121 已提交
971
    return terrno;
D
stmt  
dapan1121 已提交
972
  }
973

D
stmt  
dapan1121 已提交
974 975 976 977 978
  if (bind->num > 1) {
    tscError("invalid bind number %d for %s", bind->num, __FUNCTION__);
    terrno = TSDB_CODE_INVALID_PARA;
    return terrno;
  }
979

D
stmt  
dapan1121 已提交
980
  return stmtBindBatch(stmt, bind, -1);
981 982
}

D
dapan1121 已提交
983
int taos_stmt_bind_param_batch(TAOS_STMT *stmt, TAOS_MULTI_BIND *bind) {
D
stmt  
dapan1121 已提交
984
  if (stmt == NULL || bind == NULL) {
D
stmt  
dapan1121 已提交
985
    tscError("NULL parameter for %s", __FUNCTION__);
D
stmt  
dapan1121 已提交
986 987 988 989
    terrno = TSDB_CODE_INVALID_PARA;
    return terrno;
  }

D
stmt  
dapan1121 已提交
990 991
  if (bind->num <= 0 || bind->num > INT16_MAX) {
    tscError("invalid bind num %d", bind->num);
D
stmt  
dapan1121 已提交
992 993 994 995
    terrno = TSDB_CODE_INVALID_PARA;
    return terrno;
  }

D
dapan1121 已提交
996 997 998 999 1000 1001 1002 1003
  int32_t insert = 0;
  stmtIsInsert(stmt, &insert);
  if (0 == insert && bind->num > 1) {
    tscError("only one row data allowed for query");
    terrno = TSDB_CODE_INVALID_PARA;
    return terrno;
  }

D
stmt  
dapan1121 已提交
1004
  return stmtBindBatch(stmt, bind, -1);
1005 1006
}

D
dapan1121 已提交
1007
int taos_stmt_bind_single_param_batch(TAOS_STMT *stmt, TAOS_MULTI_BIND *bind, int colIdx) {
D
stmt  
dapan1121 已提交
1008
  if (stmt == NULL || bind == NULL) {
D
stmt  
dapan1121 已提交
1009
    tscError("NULL parameter for %s", __FUNCTION__);
D
stmt  
dapan1121 已提交
1010 1011 1012 1013
    terrno = TSDB_CODE_INVALID_PARA;
    return terrno;
  }

D
stmt  
dapan1121 已提交
1014
  if (colIdx < 0) {
D
stmt  
dapan1121 已提交
1015 1016 1017 1018
    tscError("invalid bind column idx %d", colIdx);
    terrno = TSDB_CODE_INVALID_PARA;
    return terrno;
  }
D
dapan1121 已提交
1019 1020 1021 1022 1023 1024 1025 1026

  int32_t insert = 0;
  stmtIsInsert(stmt, &insert);
  if (0 == insert && bind->num > 1) {
    tscError("only one row data allowed for query");
    terrno = TSDB_CODE_INVALID_PARA;
    return terrno;
  }
1027

D
stmt  
dapan1121 已提交
1028
  return stmtBindBatch(stmt, bind, colIdx);
1029 1030
}

D
stmt  
dapan1121 已提交
1031 1032
int taos_stmt_add_batch(TAOS_STMT *stmt) {
  if (stmt == NULL) {
D
stmt  
dapan1121 已提交
1033
    tscError("NULL parameter for %s", __FUNCTION__);
D
stmt  
dapan1121 已提交
1034 1035 1036 1037
    terrno = TSDB_CODE_INVALID_PARA;
    return terrno;
  }

D
stmt  
dapan1121 已提交
1038
  return stmtAddBatch(stmt);
1039 1040
}

D
stmt  
dapan1121 已提交
1041 1042
int taos_stmt_execute(TAOS_STMT *stmt) {
  if (stmt == NULL) {
D
stmt  
dapan1121 已提交
1043
    tscError("NULL parameter for %s", __FUNCTION__);
D
stmt  
dapan1121 已提交
1044 1045 1046 1047
    terrno = TSDB_CODE_INVALID_PARA;
    return terrno;
  }

D
stmt  
dapan1121 已提交
1048
  return stmtExec(stmt);
1049 1050
}

1051
int taos_stmt_is_insert(TAOS_STMT *stmt, int *insert) {
D
stmt  
dapan1121 已提交
1052
  if (stmt == NULL || insert == NULL) {
D
stmt  
dapan1121 已提交
1053
    tscError("NULL parameter for %s", __FUNCTION__);
D
stmt  
dapan1121 已提交
1054 1055 1056 1057 1058
    terrno = TSDB_CODE_INVALID_PARA;
    return terrno;
  }

  return stmtIsInsert(stmt, insert);
1059 1060
}

1061
int taos_stmt_num_params(TAOS_STMT *stmt, int *nums) {
D
stmt  
dapan1121 已提交
1062
  if (stmt == NULL || nums == NULL) {
D
stmt  
dapan1121 已提交
1063
    tscError("NULL parameter for %s", __FUNCTION__);
D
stmt  
dapan1121 已提交
1064 1065 1066 1067 1068
    terrno = TSDB_CODE_INVALID_PARA;
    return terrno;
  }

  return stmtGetParamNum(stmt, nums);
1069 1070
}

D
dapan1121 已提交
1071 1072 1073 1074 1075 1076 1077 1078 1079 1080
int taos_stmt_get_param(TAOS_STMT *stmt, int idx, int *type, int *bytes) {
  if (stmt == NULL || type == NULL || NULL == bytes || idx < 0) {
    tscError("invalid parameter for %s", __FUNCTION__);
    terrno = TSDB_CODE_INVALID_PARA;
    return terrno;
  }

  return stmtGetParam(stmt, idx, type, bytes);
}

D
stmt  
dapan1121 已提交
1081
TAOS_RES *taos_stmt_use_result(TAOS_STMT *stmt) {
D
stmt  
dapan1121 已提交
1082
  if (stmt == NULL) {
D
stmt  
dapan1121 已提交
1083
    tscError("NULL parameter for %s", __FUNCTION__);
D
stmt  
dapan1121 已提交
1084
    terrno = TSDB_CODE_INVALID_PARA;
D
stmt  
dapan1121 已提交
1085
    return NULL;
D
stmt  
dapan1121 已提交
1086 1087
  }

D
stmt  
dapan1121 已提交
1088
  return stmtUseResult(stmt);
1089 1090
}

1091
char *taos_stmt_errstr(TAOS_STMT *stmt) { return (char *)stmtErrstr(stmt); }
1092

D
stmt  
dapan1121 已提交
1093
int taos_stmt_affected_rows(TAOS_STMT *stmt) {
D
stmt  
dapan1121 已提交
1094
  if (stmt == NULL) {
D
stmt  
dapan1121 已提交
1095
    tscError("NULL parameter for %s", __FUNCTION__);
D
stmt  
dapan1121 已提交
1096
    terrno = TSDB_CODE_INVALID_PARA;
D
stmt  
dapan1121 已提交
1097
    return 0;
D
stmt  
dapan1121 已提交
1098 1099
  }

D
stmt  
dapan1121 已提交
1100
  return stmtAffectedRows(stmt);
1101 1102
}

D
dapan1121 已提交
1103 1104 1105 1106 1107 1108 1109 1110 1111 1112
int taos_stmt_affected_rows_once(TAOS_STMT *stmt) {
  if (stmt == NULL) {
    tscError("NULL parameter for %s", __FUNCTION__);
    terrno = TSDB_CODE_INVALID_PARA;
    return 0;
  }

  return stmtAffectedRowsOnce(stmt);
}

D
stmt  
dapan1121 已提交
1113 1114
int taos_stmt_close(TAOS_STMT *stmt) {
  if (stmt == NULL) {
D
stmt  
dapan1121 已提交
1115
    tscError("NULL parameter for %s", __FUNCTION__);
D
stmt  
dapan1121 已提交
1116 1117 1118 1119
    terrno = TSDB_CODE_INVALID_PARA;
    return terrno;
  }

D
stmt  
dapan1121 已提交
1120
  return stmtClose(stmt);
D
stmt  
dapan1121 已提交
1121
}