304 lines
12 KiB
C
304 lines
12 KiB
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/>.
|
|
*/
|
|
|
|
#ifndef TDENGINE_TAOS_H
|
|
#define TDENGINE_TAOS_H
|
|
|
|
#include <stdbool.h>
|
|
#include <stdint.h>
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
typedef void TAOS;
|
|
typedef void TAOS_STMT;
|
|
typedef void TAOS_RES;
|
|
typedef void **TAOS_ROW;
|
|
typedef void TAOS_SUB;
|
|
|
|
// 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_VARCHAR 8 // string, alias for varchar
|
|
#define TSDB_DATA_TYPE_TIMESTAMP 9 // 8 bytes
|
|
#define TSDB_DATA_TYPE_NCHAR 10 // unicode string
|
|
#define TSDB_DATA_TYPE_UTINYINT 11 // 1 byte
|
|
#define TSDB_DATA_TYPE_USMALLINT 12 // 2 bytes
|
|
#define TSDB_DATA_TYPE_UINT 13 // 4 bytes
|
|
#define TSDB_DATA_TYPE_UBIGINT 14 // 8 bytes
|
|
#define TSDB_DATA_TYPE_JSON 15 // json string
|
|
#define TSDB_DATA_TYPE_VARBINARY 16 // binary
|
|
#define TSDB_DATA_TYPE_DECIMAL 17 // decimal
|
|
#define TSDB_DATA_TYPE_BLOB 18 // binary
|
|
#define TSDB_DATA_TYPE_MEDIUMBLOB 19
|
|
#define TSDB_DATA_TYPE_BINARY TSDB_DATA_TYPE_VARCHAR // string
|
|
#define TSDB_DATA_TYPE_MAX 20
|
|
|
|
typedef enum {
|
|
TSDB_OPTION_LOCALE,
|
|
TSDB_OPTION_CHARSET,
|
|
TSDB_OPTION_TIMEZONE,
|
|
TSDB_OPTION_CONFIGDIR,
|
|
TSDB_OPTION_SHELL_ACTIVITY_TIMER,
|
|
TSDB_MAX_OPTIONS
|
|
} TSDB_OPTION;
|
|
|
|
typedef enum {
|
|
TSDB_SML_UNKNOWN_PROTOCOL = 0,
|
|
TSDB_SML_LINE_PROTOCOL = 1,
|
|
TSDB_SML_TELNET_PROTOCOL = 2,
|
|
TSDB_SML_JSON_PROTOCOL = 3,
|
|
} TSDB_SML_PROTOCOL_TYPE;
|
|
|
|
typedef enum {
|
|
TSDB_SML_TIMESTAMP_NOT_CONFIGURED = 0,
|
|
TSDB_SML_TIMESTAMP_HOURS,
|
|
TSDB_SML_TIMESTAMP_MINUTES,
|
|
TSDB_SML_TIMESTAMP_SECONDS,
|
|
TSDB_SML_TIMESTAMP_MILLI_SECONDS,
|
|
TSDB_SML_TIMESTAMP_MICRO_SECONDS,
|
|
TSDB_SML_TIMESTAMP_NANO_SECONDS,
|
|
} TSDB_SML_TIMESTAMP_TYPE;
|
|
|
|
typedef struct taosField {
|
|
char name[65];
|
|
int8_t type;
|
|
int32_t bytes;
|
|
} TAOS_FIELD;
|
|
|
|
typedef struct TAOS_FIELD_E {
|
|
char name[65];
|
|
int8_t type;
|
|
uint8_t precision;
|
|
uint8_t scale;
|
|
int32_t bytes;
|
|
} TAOS_FIELD_E;
|
|
|
|
#ifdef WINDOWS
|
|
#define DLL_EXPORT __declspec(dllexport)
|
|
#else
|
|
#define DLL_EXPORT
|
|
#endif
|
|
|
|
typedef void (*__taos_async_fn_t)(void *param, TAOS_RES *res, int code);
|
|
|
|
typedef struct TAOS_MULTI_BIND {
|
|
int buffer_type;
|
|
void *buffer;
|
|
uintptr_t buffer_length;
|
|
int32_t *length;
|
|
char *is_null;
|
|
int num;
|
|
} TAOS_MULTI_BIND;
|
|
|
|
typedef enum {
|
|
SET_CONF_RET_SUCC = 0,
|
|
SET_CONF_RET_ERR_PART = -1,
|
|
SET_CONF_RET_ERR_INNER = -2,
|
|
SET_CONF_RET_ERR_JSON_INVALID = -3,
|
|
SET_CONF_RET_ERR_JSON_PARSE = -4,
|
|
SET_CONF_RET_ERR_ONLY_ONCE = -5,
|
|
SET_CONF_RET_ERR_TOO_LONG = -6
|
|
} SET_CONF_RET_CODE;
|
|
|
|
#define RET_MSG_LENGTH 1024
|
|
typedef struct setConfRet {
|
|
SET_CONF_RET_CODE retCode;
|
|
char retMsg[RET_MSG_LENGTH];
|
|
} setConfRet;
|
|
|
|
DLL_EXPORT void taos_cleanup(void);
|
|
DLL_EXPORT int taos_options(TSDB_OPTION option, const void *arg, ...);
|
|
DLL_EXPORT setConfRet taos_set_config(const char *config);
|
|
DLL_EXPORT int taos_init(void);
|
|
DLL_EXPORT TAOS *taos_connect(const char *ip, const char *user, const char *pass, const char *db, uint16_t port);
|
|
DLL_EXPORT TAOS *taos_connect_auth(const char *ip, const char *user, const char *auth, const char *db, uint16_t port);
|
|
DLL_EXPORT void taos_close(TAOS *taos);
|
|
|
|
const char *taos_data_type(int type);
|
|
|
|
DLL_EXPORT TAOS_STMT *taos_stmt_init(TAOS *taos);
|
|
DLL_EXPORT int taos_stmt_prepare(TAOS_STMT *stmt, const char *sql, unsigned long length);
|
|
DLL_EXPORT int taos_stmt_set_tbname_tags(TAOS_STMT *stmt, const char *name, TAOS_MULTI_BIND *tags);
|
|
DLL_EXPORT int taos_stmt_set_tbname(TAOS_STMT *stmt, const char *name);
|
|
DLL_EXPORT int taos_stmt_set_tags(TAOS_STMT *stmt, TAOS_MULTI_BIND *tags);
|
|
DLL_EXPORT int taos_stmt_set_sub_tbname(TAOS_STMT *stmt, const char *name);
|
|
DLL_EXPORT int taos_stmt_get_tag_fields(TAOS_STMT *stmt, int *fieldNum, TAOS_FIELD_E **fields);
|
|
DLL_EXPORT int taos_stmt_get_col_fields(TAOS_STMT *stmt, int *fieldNum, TAOS_FIELD_E **fields);
|
|
|
|
DLL_EXPORT int taos_stmt_is_insert(TAOS_STMT *stmt, int *insert);
|
|
DLL_EXPORT int taos_stmt_num_params(TAOS_STMT *stmt, int *nums);
|
|
DLL_EXPORT int taos_stmt_get_param(TAOS_STMT *stmt, int idx, int *type, int *bytes);
|
|
DLL_EXPORT int taos_stmt_bind_param(TAOS_STMT *stmt, TAOS_MULTI_BIND *bind);
|
|
DLL_EXPORT int taos_stmt_bind_param_batch(TAOS_STMT *stmt, TAOS_MULTI_BIND *bind);
|
|
DLL_EXPORT int taos_stmt_bind_single_param_batch(TAOS_STMT *stmt, TAOS_MULTI_BIND *bind, int colIdx);
|
|
DLL_EXPORT int taos_stmt_add_batch(TAOS_STMT *stmt);
|
|
DLL_EXPORT int taos_stmt_execute(TAOS_STMT *stmt);
|
|
DLL_EXPORT TAOS_RES *taos_stmt_use_result(TAOS_STMT *stmt);
|
|
DLL_EXPORT int taos_stmt_close(TAOS_STMT *stmt);
|
|
DLL_EXPORT char *taos_stmt_errstr(TAOS_STMT *stmt);
|
|
DLL_EXPORT int taos_stmt_affected_rows(TAOS_STMT *stmt);
|
|
DLL_EXPORT int taos_stmt_affected_rows_once(TAOS_STMT *stmt);
|
|
|
|
DLL_EXPORT TAOS_RES *taos_query(TAOS *taos, const char *sql);
|
|
|
|
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);
|
|
DLL_EXPORT int taos_field_count(TAOS_RES *res);
|
|
DLL_EXPORT int taos_num_fields(TAOS_RES *res);
|
|
DLL_EXPORT int taos_affected_rows(TAOS_RES *res);
|
|
|
|
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);
|
|
DLL_EXPORT bool taos_is_null(TAOS_RES *res, int32_t row, int32_t col);
|
|
DLL_EXPORT bool taos_is_update_query(TAOS_RES *res);
|
|
DLL_EXPORT int taos_fetch_block(TAOS_RES *res, TAOS_ROW *rows);
|
|
DLL_EXPORT int taos_fetch_block_s(TAOS_RES *res, int *numOfRows, TAOS_ROW *rows);
|
|
DLL_EXPORT int taos_fetch_raw_block(TAOS_RES *res, int *numOfRows, void **pData);
|
|
DLL_EXPORT int *taos_get_column_data_offset(TAOS_RES *res, int columnIndex);
|
|
DLL_EXPORT int taos_validate_sql(TAOS *taos, const char *sql);
|
|
DLL_EXPORT void taos_reset_current_db(TAOS *taos);
|
|
|
|
DLL_EXPORT int *taos_fetch_lengths(TAOS_RES *res);
|
|
DLL_EXPORT TAOS_ROW *taos_result_block(TAOS_RES *res);
|
|
|
|
DLL_EXPORT const char *taos_get_server_info(TAOS *taos);
|
|
DLL_EXPORT const char *taos_get_client_info();
|
|
|
|
DLL_EXPORT const char *taos_errstr(TAOS_RES *tres);
|
|
DLL_EXPORT int taos_errno(TAOS_RES *tres);
|
|
|
|
DLL_EXPORT void taos_query_a(TAOS *taos, const char *sql, __taos_async_fn_t fp, void *param);
|
|
DLL_EXPORT void taos_fetch_rows_a(TAOS_RES *res, __taos_async_fn_t fp, void *param);
|
|
DLL_EXPORT void taos_fetch_raw_block_a(TAOS_RES* res, __taos_async_fn_t fp, void* param);
|
|
DLL_EXPORT const void *taos_get_raw_block(TAOS_RES* res);
|
|
|
|
// Shuduo: temporary enable for app build
|
|
#if 1
|
|
typedef void (*__taos_sub_fn_t)(TAOS_SUB *tsub, TAOS_RES *res, void *param, int code);
|
|
DLL_EXPORT TAOS_SUB *taos_subscribe(TAOS *taos, int restart, const char *topic, const char *sql, __taos_sub_fn_t fp,
|
|
void *param, int interval);
|
|
DLL_EXPORT TAOS_RES *taos_consume(TAOS_SUB *tsub);
|
|
DLL_EXPORT void taos_unsubscribe(TAOS_SUB *tsub, int keepProgress);
|
|
#endif
|
|
|
|
DLL_EXPORT int taos_load_table_info(TAOS *taos, const char *tableNameList);
|
|
DLL_EXPORT TAOS_RES *taos_schemaless_insert(TAOS *taos, char *lines[], int numLines, int protocol, int precision);
|
|
|
|
/* --------------------------TMQ INTERFACE------------------------------- */
|
|
|
|
enum {
|
|
TMQ_RESP_ERR__FAIL = -1,
|
|
TMQ_RESP_ERR__SUCCESS = 0,
|
|
};
|
|
|
|
typedef int32_t tmq_resp_err_t;
|
|
|
|
typedef struct tmq_t tmq_t;
|
|
typedef struct tmq_topic_vgroup_t tmq_topic_vgroup_t;
|
|
typedef struct tmq_topic_vgroup_list_t tmq_topic_vgroup_list_t;
|
|
|
|
typedef struct tmq_conf_t tmq_conf_t;
|
|
typedef struct tmq_list_t tmq_list_t;
|
|
|
|
typedef void(tmq_commit_cb(tmq_t *, tmq_resp_err_t, tmq_topic_vgroup_list_t *, void *param));
|
|
|
|
DLL_EXPORT tmq_list_t *tmq_list_new();
|
|
DLL_EXPORT int32_t tmq_list_append(tmq_list_t *, const char *);
|
|
DLL_EXPORT void tmq_list_destroy(tmq_list_t *);
|
|
DLL_EXPORT int32_t tmq_list_get_size(const tmq_list_t *);
|
|
DLL_EXPORT char **tmq_list_to_c_array(const tmq_list_t *);
|
|
|
|
DLL_EXPORT tmq_t *tmq_consumer_new(tmq_conf_t *conf, char *errstr, int32_t errstrLen);
|
|
|
|
DLL_EXPORT const char *tmq_err2str(tmq_resp_err_t);
|
|
|
|
/* ------------------------TMQ CONSUMER INTERFACE------------------------ */
|
|
|
|
DLL_EXPORT tmq_resp_err_t tmq_subscribe(tmq_t *tmq, const tmq_list_t *topic_list);
|
|
DLL_EXPORT tmq_resp_err_t tmq_unsubscribe(tmq_t *tmq);
|
|
DLL_EXPORT tmq_resp_err_t tmq_subscription(tmq_t *tmq, tmq_list_t **topics);
|
|
|
|
// timeout: -1 means infinitely waiting
|
|
DLL_EXPORT TAOS_RES *tmq_consumer_poll(tmq_t *tmq, int64_t timeout);
|
|
|
|
DLL_EXPORT tmq_resp_err_t tmq_consumer_close(tmq_t *tmq);
|
|
DLL_EXPORT tmq_resp_err_t tmq_commit_sync(tmq_t *tmq, const tmq_topic_vgroup_list_t *offsets);
|
|
DLL_EXPORT void tmq_commit_async(tmq_t *tmq, const tmq_topic_vgroup_list_t *offsets, tmq_commit_cb *cb, void *param);
|
|
|
|
#if 0
|
|
DLL_EXPORT tmq_resp_err_t tmq_commit(tmq_t *tmq, const tmq_topic_vgroup_list_t *offsets, int32_t async);
|
|
DLL_EXPORT tmq_resp_err_t tmq_seek(tmq_t *tmq, const tmq_topic_vgroup_t *offset);
|
|
#endif
|
|
|
|
/* ----------------------TMQ CONFIGURATION INTERFACE---------------------- */
|
|
|
|
enum tmq_conf_res_t {
|
|
TMQ_CONF_UNKNOWN = -2,
|
|
TMQ_CONF_INVALID = -1,
|
|
TMQ_CONF_OK = 0,
|
|
};
|
|
|
|
typedef enum tmq_conf_res_t tmq_conf_res_t;
|
|
|
|
DLL_EXPORT tmq_conf_t *tmq_conf_new();
|
|
DLL_EXPORT tmq_conf_res_t tmq_conf_set(tmq_conf_t *conf, const char *key, const char *value);
|
|
DLL_EXPORT void tmq_conf_destroy(tmq_conf_t *conf);
|
|
DLL_EXPORT void tmq_conf_set_auto_commit_cb(tmq_conf_t *conf, tmq_commit_cb *cb, void *param);
|
|
|
|
/* -------------------------TMQ MSG HANDLE INTERFACE---------------------- */
|
|
|
|
DLL_EXPORT const char *tmq_get_topic_name(TAOS_RES *res);
|
|
DLL_EXPORT const char *tmq_get_db_name(TAOS_RES *res);
|
|
DLL_EXPORT int32_t tmq_get_vgroup_id(TAOS_RES *res);
|
|
DLL_EXPORT const char *tmq_get_table_name(TAOS_RES *res);
|
|
|
|
#if 0
|
|
DLL_EXPORT int64_t tmq_get_request_offset(tmq_message_t *message);
|
|
DLL_EXPORT int64_t tmq_get_response_offset(tmq_message_t *message);
|
|
#endif
|
|
|
|
/* ------------------------------ TMQ END -------------------------------- */
|
|
|
|
#if 1 // Shuduo: temporary enable for app build
|
|
typedef void (*TAOS_SUBSCRIBE_CALLBACK)(TAOS_SUB *tsub, TAOS_RES *res, void *param, int code);
|
|
#endif
|
|
|
|
typedef enum {
|
|
TSDB_SRV_STATUS_UNAVAILABLE = 0,
|
|
TSDB_SRV_STATUS_NETWORK_OK = 1,
|
|
TSDB_SRV_STATUS_SERVICE_OK = 2,
|
|
TSDB_SRV_STATUS_SERVICE_DEGRADED = 3,
|
|
TSDB_SRV_STATUS_EXTING = 4,
|
|
} TSDB_SERVER_STATUS;
|
|
|
|
DLL_EXPORT TSDB_SERVER_STATUS taos_check_server_status(const char *fqdn, int port, char *details, int maxlen);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif
|