taos.h 4.9 KB
Newer Older
H
hzcheng 已提交
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24
/*
 * 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/>.
 */

#ifndef TDENGINE_TAOS_H
#define TDENGINE_TAOS_H

#include <stdint.h>

#ifdef __cplusplus
extern "C" {
#endif

S
slguan 已提交
25 26 27 28 29 30
typedef void    TAOS;
typedef void**  TAOS_ROW;
typedef void    TAOS_RES;
typedef void    TAOS_SUB;
typedef void    TAOS_STREAM;
typedef void    TAOS_STMT;
H
hzcheng 已提交
31

H
hzcheng 已提交
32 33 34 35 36 37 38 39 40 41 42 43 44
// Data type definition
#define TSDB_DATA_TYPE_NULL       0     // 1 bytes
#define TSDB_DATA_TYPE_BOOL       1     // 1 bytes
#define TSDB_DATA_TYPE_TINYINT    2     // 1 byte
#define TSDB_DATA_TYPE_SMALLINT   3     // 2 bytes
#define TSDB_DATA_TYPE_INT        4     // 4 bytes
#define TSDB_DATA_TYPE_BIGINT     5     // 8 bytes
#define TSDB_DATA_TYPE_FLOAT      6     // 4 bytes
#define TSDB_DATA_TYPE_DOUBLE     7     // 8 bytes
#define TSDB_DATA_TYPE_BINARY     8     // string
#define TSDB_DATA_TYPE_TIMESTAMP  9     // 8 bytes
#define TSDB_DATA_TYPE_NCHAR      10    // unicode string

H
hzcheng 已提交
45 46 47 48 49 50 51 52 53
typedef enum {
  TSDB_OPTION_LOCALE,
  TSDB_OPTION_CHARSET,
  TSDB_OPTION_TIMEZONE,
  TSDB_OPTION_CONFIGDIR,
  TSDB_OPTION_SHELL_ACTIVITY_TIMER,
  TSDB_MAX_OPTIONS
} TSDB_OPTION;

S
slguan 已提交
54
typedef struct taosField {
B
Bomin Zhang 已提交
55
  char     name[65];
56
  uint8_t  type;
57
  int16_t  bytes;
H
hzcheng 已提交
58 59
} TAOS_FIELD;

L
[#1054]  
lihui 已提交
60 61 62 63 64 65 66
#ifdef _TD_GO_DLL_
  #define DLL_EXPORT    __declspec(dllexport)
#else
  #define DLL_EXPORT 
#endif

DLL_EXPORT void  taos_init();
67
DLL_EXPORT void  taos_cleanup();
L
[#1054]  
lihui 已提交
68 69 70
DLL_EXPORT int   taos_options(TSDB_OPTION option, const void *arg, ...);
DLL_EXPORT TAOS *taos_connect(const char *ip, const char *user, const char *pass, const char *db, uint16_t port);
DLL_EXPORT void  taos_close(TAOS *taos);
S
slguan 已提交
71 72 73 74

typedef struct TAOS_BIND {
  int            buffer_type;
  void *         buffer;
75 76
  uintptr_t      buffer_length;  // unused
  uintptr_t      *length;
S
slguan 已提交
77 78 79 80 81 82 83 84 85 86 87 88 89
  int *          is_null;
  int            is_unsigned;  // unused
  int *          error;        // unused
} TAOS_BIND;

TAOS_STMT *taos_stmt_init(TAOS *taos);
int        taos_stmt_prepare(TAOS_STMT *stmt, const char *sql, unsigned long length);
int        taos_stmt_bind_param(TAOS_STMT *stmt, TAOS_BIND *bind);
int        taos_stmt_add_batch(TAOS_STMT *stmt);
int        taos_stmt_execute(TAOS_STMT *stmt);
TAOS_RES * taos_stmt_use_result(TAOS_STMT *stmt);
int        taos_stmt_close(TAOS_STMT *stmt);

H
Haojun Liao 已提交
90
DLL_EXPORT TAOS_RES *taos_query(TAOS *taos, const char *sql);
L
[#1054]  
lihui 已提交
91 92 93
DLL_EXPORT TAOS_ROW taos_fetch_row(TAOS_RES *res);
DLL_EXPORT int taos_result_precision(TAOS_RES *res);  // get the time precision of result
DLL_EXPORT void taos_free_result(TAOS_RES *res);
H
Haojun Liao 已提交
94
DLL_EXPORT int taos_field_count(TAOS_RES *tres);
L
[#1054]  
lihui 已提交
95
DLL_EXPORT int taos_num_fields(TAOS_RES *res);
H
Haojun Liao 已提交
96
DLL_EXPORT int taos_affected_rows(TAOS_RES *taos);
L
[#1054]  
lihui 已提交
97 98 99 100
DLL_EXPORT TAOS_FIELD *taos_fetch_fields(TAOS_RES *res);
DLL_EXPORT int taos_select_db(TAOS *taos, const char *db);
DLL_EXPORT int taos_print_row(char *str, TAOS_ROW row, TAOS_FIELD *fields, int num_fields);
DLL_EXPORT void taos_stop_query(TAOS_RES *res);
H
hzcheng 已提交
101 102

int taos_fetch_block(TAOS_RES *res, TAOS_ROW *rows);
S
slguan 已提交
103
int taos_validate_sql(TAOS *taos, const char *sql);
H
hzcheng 已提交
104

105 106
int* taos_fetch_lengths(TAOS_RES *res);

H
hzcheng 已提交
107 108 109
// TAOS_RES   *taos_list_tables(TAOS *mysql, const char *wild);
// TAOS_RES   *taos_list_dbs(TAOS *mysql, const char *wild);

S
slguan 已提交
110
// TODO: the return value should be `const`
L
[#1054]  
lihui 已提交
111 112
DLL_EXPORT char *taos_get_server_info(TAOS *taos);
DLL_EXPORT char *taos_get_client_info();
H
Haojun Liao 已提交
113
DLL_EXPORT char *taos_errstr(TAOS_RES *tres);
S
slguan 已提交
114

H
Haojun Liao 已提交
115
DLL_EXPORT int taos_errno(TAOS_RES *tres);
H
hzcheng 已提交
116

L
[#1054]  
lihui 已提交
117 118 119
DLL_EXPORT void taos_query_a(TAOS *taos, const char *sql, void (*fp)(void *param, TAOS_RES *, int code), void *param);
DLL_EXPORT void taos_fetch_rows_a(TAOS_RES *res, void (*fp)(void *param, TAOS_RES *, int numOfRows), void *param);
DLL_EXPORT void taos_fetch_row_a(TAOS_RES *res, void (*fp)(void *param, TAOS_RES *, TAOS_ROW row), void *param);
H
hzcheng 已提交
120

weixin_48148422's avatar
weixin_48148422 已提交
121
typedef void (*TAOS_SUBSCRIBE_CALLBACK)(TAOS_SUB* tsub, TAOS_RES *res, void* param, int code);
weixin_48148422's avatar
weixin_48148422 已提交
122
DLL_EXPORT TAOS_SUB *taos_subscribe(TAOS* taos, int restart, const char* topic, const char *sql, TAOS_SUBSCRIBE_CALLBACK fp, void *param, int interval);
weixin_48148422's avatar
weixin_48148422 已提交
123
DLL_EXPORT TAOS_RES *taos_consume(TAOS_SUB *tsub);
weixin_48148422's avatar
weixin_48148422 已提交
124
DLL_EXPORT void      taos_unsubscribe(TAOS_SUB *tsub, int keepProgress);
H
hzcheng 已提交
125

L
[#1054]  
lihui 已提交
126
DLL_EXPORT TAOS_STREAM *taos_open_stream(TAOS *taos, const char *sql, void (*fp)(void *param, TAOS_RES *, TAOS_ROW row),
H
hzcheng 已提交
127
                              int64_t stime, void *param, void (*callback)(void *));
L
[#1054]  
lihui 已提交
128
DLL_EXPORT void taos_close_stream(TAOS_STREAM *tstr);
H
hzcheng 已提交
129

L
[#1054]  
lihui 已提交
130
DLL_EXPORT int taos_load_table_info(TAOS *taos, const char* tableNameList);
S
slguan 已提交
131

H
hzcheng 已提交
132 133 134 135 136
#ifdef __cplusplus
}
#endif

#endif