tcq.h

/*
 * 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 _TD_CQ_H_
#define _TD_CQ_H_

#ifdef __cplusplus
extern "C" {
#endif

#include "tdataformat.h"

typedef int32_t (*FCqWrite)(int32_t vgId, void *pHead, int32_t qtype, void *pMsg);

typedef struct {
  int32_t  vgId;
  char     user[TSDB_USER_LEN];
  char     pass[TSDB_KEY_LEN];
  char     db[TSDB_ACCT_ID_LEN + TSDB_DB_NAME_LEN]; // size must same with SVnodeObj.db[TSDB_ACCT_ID_LEN + TSDB_DB_NAME_LEN]
  FCqWrite cqWrite;
} SCqCfg;

// SCqContext
typedef struct {
  int32_t  vgId;
  int32_t  master;
  int32_t  num;      // number of continuous streams
  char     user[TSDB_USER_LEN];
  char     pass[TSDB_KEY_LEN];
  char     db[TSDB_DB_NAME_LEN];
  FCqWrite cqWrite;
  struct SCqObj *pHead;
  void    *dbConn;
  void    *tmrCtrl;
  pthread_mutex_t mutex;
  int32_t delete;
  int32_t cqObjNum;
} SCqContext;

// the following API shall be called by vnode
void *cqOpen(void *ahandle, const SCqCfg *pCfg);
void  cqClose(void *handle);

// if vnode is master, vnode call this API to start CQ
void  cqStart(void *handle);

// if vnode is slave/unsynced, vnode shall call this API to stop CQ
void  cqStop(void *handle);

// cqCreate is called by TSDB to start an instance of CQ 
void *cqCreate(void *handle, uint64_t uid, int32_t sid, const char* dstTable, char *sqlStr, STSchema *pSchema, int start);

// cqDrop is called by TSDB to stop an instance of CQ, handle is the return value of cqCreate
void  cqDrop(void *handle);

extern int32_t cqDebugFlag;


#ifdef __cplusplus
}
#endif

#endif  // _TD_CQ_H_