sql.h

/*
   Copyright 2015 Bloomberg Finance L.P.

   Licensed under the Apache License, Version 2.0 (the "License");
   you may not use this file except in compliance with the License.
   You may obtain a copy of the License at

       http://www.apache.org/licenses/LICENSE-2.0

   Unless required by applicable law or agreed to in writing, software
   distributed under the License is distributed on an "AS IS" BASIS,
   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   See the License for the specific language governing permissions and
   limitations under the License.
 */

#ifndef _SQL_H_
#define _SQL_H_

#include <openssl/asn1.h> /* for ub_common_name */

#include "cdb2api.h"
#include "comdb2.h"

#include <bdb_api.h>
#include <bdb_cursor.h>
#include <berkdb/dbinc/queue.h>

#include "tag.h"
#include "osql_srs.h"
#include "osqlsqlthr.h"
#include "osqlcheckboard.h"
#include "osqlshadtbl.h"
#include "fwd_types.h"
#include "comdb2_ruleset.h"
#include <sp.h>
#include "sql_stmt_cache.h"
#include "db_access.h"
#include "sqliteInt.h"
#include "ast.h"
#include "fingerprint.h"

/* I'm now splitting handle_fastsql_requests into two functions.  The
 * outer function will maintain state (such as temporary buffers etc) while
 * the inner function will actually run the sql query.  This will allow me
 * to eventually split the socket i/o (specifically, the waiting for the next
 * query part) and the running of the query into different threads.  This way
 * we can have a small pool of sql threads with big stacks, and a large pool
 * of appsock threads with small stacks. */

#define CHECK_NEXT_QUERIES 20

/* Static rootpages numbers. */
enum { RTPAGE_SQLITE_MASTER = 1, RTPAGE_START = 2 };

struct fingerprint_track {
    unsigned char fingerprint[FINGERPRINTSZ]; /* md5 digest hex string */
    int64_t count;    /* Cumulative number of times executed */
    int64_t cost;     /* Cumulative cost */
    int64_t time;     /* Cumulative preparation and execution time */
    int64_t max_cost; /* Max cost of any query */
    int64_t prepTime; /* Cumulative preparation time only */
    int64_t rows;     /* Cumulative number of rows selected */
    int64_t curr_analyze_gen; /* If the analyze gen number is different */
    int     check_next_queries; /* Check cost of next these many queries */
    int     cost_increased; /* queries with cost greater than avg cost */
    int64_t pre_cost_avg_per_row;     /* Average cost before last Analyze */
    char *zNormSql;   /* The normalized SQL query */
    size_t nNormSql;  /* Length of normalized SQL query */
    int typeMismatch; /* Type(s) did not match when compared to sqlitex's */
    int nameMismatch; /* Column name(s) did not match when compared to sqlitex's */

    hash_t *query_plan_hash;   /* Query plans associated with fingerprint + cost stats */
    int alert_once_query_plan; /* Alert only once if there is a better query plan for a query. Init to 1 */
    int alert_once_query_plan_max; /* Alert (once) if hit max number of plans for associated query. Init to 1 */
    int alert_once_truncated_col;  /* Alert once if we truncated some col in the query. Init to 1 */
};

struct sql_authorizer_state {
    struct sqlclntstate *clnt;         /* pointer to current client info */
    sqlite3 *db;
    int flags;                         /* DDL, PRAGMA, CREATE TRIGGER denied? */
    int numDdls;                       /* number of DDLs found */
    int numVTableLocks;
    char **vTableLocks;
    int hasVTables;
};

/* Thread specific sql state */
struct sqlthdstate {
    struct reqlogger *logger;
    struct sql_thread *sqlthd;
    struct thr_handle *thr_self;
    sqlite3 *sqldb;
    struct sql_authorizer_state authState; /* SQL authorizer state info */

    uint8_t have_lastuser;
    char lastuser[MAX_USERNAME_LEN]; // last user to use this sqlthd

    /* SQL statement cache */
    stmt_cache_t *stmt_cache;

    int dbopen_gen;
    int analyze_gen;
    int views_gen;

    /* A flag to tell us whether we are inside the query preparer plugin. This
     * is especially needed to differentiate between fdb cursors opened by core
     * versus query preparer plugin. */
    int query_preparer_running;
    void *sqldbx;
};

typedef struct osqltimings {
    unsigned long long query_received; /* query received, in need of dispatch */
    unsigned long long query_dispatched; /* start sql processing */
    unsigned long long
        query_finished; /* done processing this query (includes commit) */
    unsigned long long commit_prep;  /* start shipping requests (relevant for
                                        recom/snapisol/serial) */
    unsigned long long commit_start; /* send commit signal */
    unsigned long long commit_end;   /* received signal back (relevant for
                                        socksql/recom/snapisol,serial) */
} osqltimings_t;

typedef struct fdbtimings {
    unsigned long long
        total_time; /* total time for doing remote access, synchronous part */
    unsigned long long total_calls; /* total number of remote rcp calls */
    unsigned long long max_call;    /* longest sync call */
} fdbtimings_t;

typedef struct {
    const char *spname;
    genid_t genid;
} shadbq_t;

struct srs_tran;
typedef struct osqlstate {

    /* == sql_thread == */
    osql_target_t target;    /* where to send the bplog */
    unsigned long long rqid; /* per node offload request session */
    uuid_t uuid;             /* session id, take 2 */
    char *tablename;         /* malloc-ed cache of send tablename for usedb */
    int tablenamelen;        /* tablename length */
    int sentops;             /* number of operations per statement */
    int tran_ops;            /* actual number of operations for a transaction */
    int replicant_numops; /* total num of ops sent by replicant to master which
                             includes USEDB, BLOB, etc. */

    /* == sqlclntstate == */

    int count_changes;   /* enable pragma count_changes=1, for rr, sosql, recom,
                            snapisol, serial */

    /* storage for shadow tables created by offloading */
    LISTC_T(struct shad_tbl) shadtbls;

    /* storage for dbq's shadtbl */
    shadbq_t shadbq;
    hash_t *dbq_hash;

    /* storage for verify, common for all transaction */
    struct temp_table * verify_tbl;
    struct temp_cursor *verify_cur; /* verify cursor */

    /* storage for schemachange, common for all transaction */
    struct temp_table *sc_tbl;
    struct temp_cursor *sc_cur; /* schemachange cursor */

    /* storage for bpfunc, common for all transaction */
    struct temp_table *bpfunc_tbl;
    struct temp_cursor *bpfunc_cur; /* bpfunc cursor */
    int bpfunc_seq;

    struct errstat xerr; /* extended error */

    /* performance */
    osqltimings_t timings; /* measure various timings */
    fdbtimings_t fdbtimes; /* measure remote access */

    /* verify handling */
    /* keep the log of sql strings for the current transaction */
    struct srs_tran *history;
    int replay;  /* set this when a session is replayed, used by sorese */
    int sent_column_data; /* set this if we've already sent the column data */

    /* XXX for debugging */
    char *replay_file;
    int replay_line;
    int last_replay;

    int error_is_remote; /* set if xerr is the error for a distributed tran
                            (i.e. already translated */
    int dirty; /* optimization to nop selectv only transactions */
    int running_ddl; /* ddl transaction */
    unsigned is_reorder_on : 1;

    /* set to 1 if we have already called osql_sock_start in socksql mode */
    unsigned sock_started : 1;
    unsigned has_updstat : 1;
} osqlstate_t;

enum ctrl_sqleng {
    /* No user specified transactions, i.e. BEGIN/COMMIT */
    SQLENG_NORMAL_PROCESS,
    /* "BEGIN" was submitted, mark this as user transaction begin */
    SQLENG_PRE_STRT_STATE,
    /* We have seen 'BEGIN' and now waiting for a non-"BEGIN" user query */
    SQLENG_STRT_STATE,
    /* We have a transaction, ignore further BtreeTransBegin until
     * COMMIT/ROLLBACK */
    SQLENG_INTRANS_STATE,
    /* "COMMIT" was submitted */
    SQLENG_FNSH_STATE,
    /* "ROLLBACK" was submitted */
    SQLENG_FNSH_RBK_STATE,
    /* Transaction has been aborted due to a bad command */
    SQLENG_FNSH_ABORTED_STATE,
    /* We have entered a wrong stated (possibly a bug) */
    SQLENG_WRONG_STATE,
};

enum trans_clntcomm {
    TRANS_CLNTCOMM_NOREPLY = 0,
    TRANS_CLNTCOMM_NORMAL = 1,
    TRANS_CLNTCOMM_CHUNK = 2
};

void sql_set_sqlengine_state(struct sqlclntstate *clnt, char *file, int line,
                             int newstate);


struct fdb_distributed_tran;
typedef struct fdb_distributed_tran fdb_distributed_tran_t;
struct fdb_tbl_ent;
typedef struct fdb_tbl_ent fdb_tbl_ent_t;
struct fdb_access;
typedef struct fdb_access fdb_access_t;
struct fdb_affinity;
typedef struct fdb_affinity fdb_affinity_t;
struct fdb;
typedef struct fdb fdb_t;

typedef struct {
    enum transaction_level mode; /* TRANLEVEL_SOSQL, TRANLEVEL_RECOM, ... */
    struct cursor_tran *cursor_tran; /* id used to open cursors sharing same deadlock identity*/
    tran_type *shadow_tran; /* used to keep local changes to btree, uncommitted yet */
    tran_type *logical_tran; /* used by rowlocks ? */

    fdb_distributed_tran_t *dtran; /* remote transactions, contain each remote cluster tran */
    int rollbacked; /* mark this to catch out-of-order errors */

    sqlite3_stmt *pStmt; /* if sql is in progress, points at the engine */
    fdb_tbl_ent_t **lockedRemTables; /* list of fdb_tbl_ent_t* for read-locked
                                        remote tables */
    int nLockedRemTables; /* number of pointers in lockedRemTablesRootp */
    int trans_has_sp;     /* running a stored procedure */
    int maxchunksize;     /* multi-transaction bulk mode */
    int crtchunksize;     /* how many rows are processed already */
    int nchunks;          /* number of chunks. 0 for a non-chunked transaction. */
    int throttle_txn_chunks_msec; /* wait this many milliseconds before starting a new chunk (if 0 then look at tunable) */

    /* cache the versions of dta files to catch schema changes and fastinits */
    table_version_cache *table_version_cache;
} dbtran_type;
typedef dbtran_type trans_t;

/* analyze sampled (previously misnamed compressed) idx */
typedef struct {
    char name[MAXTABLELEN];
    int ixnum;
    sampler_t *sampler;
    int sampling_pct;
    unsigned long long n_recs;
    unsigned long long n_sampled_recs;
} sampled_idx_t;

typedef struct sqlclntstate_fdb {
    SBUF2 *remote_sql_sb; /* IN REMOTE DB: set if this is on behalf of a remote
                             sql session */
    int flags; /* requester flags, like is this a sqlite_master special request
                  ?*/
    char *trim_key;  /* key used in prefiltering for find ops (sqlite_packed) */
    int trim_keylen; /* lenght of the trim key */
    fdb_access_t *access; /* access control */
    int version;          /* version of the remote-cached object */
    char *dbname;  /* if err is set, this indicate which fdb is responsible, if
                      any */
    char *tblname; /* if err is set, this indicate which tablename is
                      responsible */
    int code_release;    /* code release in the remote requester */
    fdb_affinity_t *aff; /* location affinity information */
    struct errstat
        xerr; /* error in fdb component, used to override sqlite and osql.xerr
                 errors */
    int preserve_err; /* set to ignore up-stream errors when lower system sets
                         xerr */
    /* source side fields */
    int n_fdb_affinities; /* number of fdbs in the fdb_ids and fdb_nodes arrays
                             */
    char **fdb_ids;       /* the fdb for which we have affinity */
    char **fdb_nodes;     /* node numbers preferred for each fdb in fdb_ids */
    int *fdb_last_status; /* used to mark a node bad after a failure */
    int failed_heartbeats; /* used to signal failed communication with remotes */
} sqlclntstate_fdb_t;

enum ucancel_type {
    UCANCEL_INV = 0,
    UCANCEL_ALL = 1,    /* both queued and running */
    UCANCEL_RUN = 2,    /* running only */
    UCANCEL_QUE = 4,    /* queued only */
    UCANCEL_CNO = 8,    /* filter by cnonce */
    UCANCEL_FPT = 16    /* filter by fp */
};

int ucancel_sql_statements(enum ucancel_type type, char *uuid);

CurRange *currange_new();
#define CURRANGEARR_INIT_CAP 2
void currangearr_init(CurRangeArr *arr);
void currangearr_append(CurRangeArr *arr, CurRange *r);
CurRange *currangearr_get(CurRangeArr *arr, int n);
void currangearr_double_if_full(CurRangeArr *arr);
void currangearr_build_hash(CurRangeArr *arr);
void currangearr_free(CurRangeArr *arr);
void currangearr_print(CurRangeArr *arr);
void currange_free(CurRange *cr);

struct stored_proc;
struct lua_State;
struct typessql;
struct dohsql;
struct dohsql_node;
typedef struct fdb_push_connector fdb_push_connector_t;

enum early_verify_error {
    EARLY_ERR_VERIFY = 1,
    EARLY_ERR_SELECTV = 2,
    EARLY_ERR_GENCHANGE = 3
};

enum connection_state
{
    CONNECTION_NEW,
    CONNECTION_IDLE,
    CONNECTION_RESET,
    CONNECTION_QUEUED,
    CONNECTION_RUNNING
};

enum {
  ERR_GENERIC = -1,
  ERR_PREPARE = -2,
  ERR_PREPARE_RETRY = -3,
  ERR_ROW_HEADER = -4,
  ERR_CONVERSION_DT = -5,
};

#define RESPONSE_TYPES                                                         \
    XRESPONSE(RESPONSE_COLUMNS)                                                \
    XRESPONSE(RESPONSE_COLUMNS_LUA)                                            \
    XRESPONSE(RESPONSE_COLUMNS_STR)                                            \
    XRESPONSE(RESPONSE_COLUMNS_FDB_PUSH)                                       \
    XRESPONSE(RESPONSE_COST)                                                   \
    XRESPONSE(RESPONSE_DEBUG)                                                  \
    XRESPONSE(RESPONSE_EFFECTS)                                                \
    XRESPONSE(RESPONSE_ERROR)                                                  \
    XRESPONSE(RESPONSE_ERROR_ACCESS)                                           \
    XRESPONSE(RESPONSE_ERROR_APPSOCK_LIMIT)                                    \
    XRESPONSE(RESPONSE_ERROR_BAD_STATE)                                        \
    XRESPONSE(RESPONSE_ERROR_PREPARE)                                          \
    XRESPONSE(RESPONSE_ERROR_PREPARE_RETRY)                                    \
    XRESPONSE(RESPONSE_ERROR_REJECT)                                           \
    XRESPONSE(RESPONSE_ERROR_INCOMPLETE)                                       \
    XRESPONSE(RESPONSE_REDIRECT_FOREIGN)                                       \
    XRESPONSE(RESPONSE_FLUSH)                                                  \
    XRESPONSE(RESPONSE_HEARTBEAT)                                              \
    XRESPONSE(RESPONSE_QUERY_STATS)                                            \
    XRESPONSE(RESPONSE_ROW)                                                    \
    XRESPONSE(RESPONSE_ROW_LAST)                                               \
    XRESPONSE(RESPONSE_ROW_LAST_DUMMY)                                         \
    XRESPONSE(RESPONSE_ROW_LUA)                                                \
    XRESPONSE(RESPONSE_ROW_STR)                                                \
    XRESPONSE(RESPONSE_TRACE)                                                  \
    XRESPONSE(RESPONSE_ROW_REMTRAN)                                            \
    XRESPONSE(RESPONSE_RAW_PAYLOAD)

#define XRESPONSE(x) x,
enum WriteResponsesEnum { RESPONSE_TYPES };
#undef XRESPONSE

/* read response */
enum {
    RESPONSE_PING_PONG,
    RESPONSE_SP_CMD,
    RESPONSE_BYTES,
};

struct response_data {
    sqlite3_stmt *stmt;
    struct errstat *err;
    uint64_t row_id;
    /* For RESPONSE_COLUMNS_LUA, RESPONSE_ROW_LUA */
    int ncols;
    int pingpong;
    struct stored_proc *sp;
};

char *sp_column_name(struct response_data *, int);
int sp_column_type(struct response_data *, int, size_t, int);
int sp_column_nil(struct response_data *, int);
int sp_column_val(struct response_data *, int, int, void *);
void *sp_column_ptr(struct response_data *, int, int, size_t *);

typedef int(plugin_func)(struct sqlclntstate *);
typedef const char *(api_type_func)(struct sqlclntstate *);
typedef int(response_func)(struct sqlclntstate *, int, void *, int);
typedef void *(replay_func)(struct sqlclntstate *, void *);
typedef int(param_index_func)(struct sqlclntstate *, const char *, int64_t *);
typedef int(param_value_func)(struct sqlclntstate *, struct param_data *, int);
typedef int(cnonce_value_func)(struct sqlclntstate *, snap_uid_t *);
typedef int(get_snapshot_func)(struct sqlclntstate *, int *, int *);
typedef void(add_steps_func)(struct sqlclntstate *, double steps);
typedef void(setup_client_info_func)(struct sqlclntstate *, struct sqlthdstate *, char *);
typedef int(skip_row_func)(struct sqlclntstate *, uint64_t);
typedef int(log_context_func)(struct sqlclntstate *, struct reqlogger *);
typedef uint64_t(ret_uint64_func)(struct sqlclntstate *);
typedef int(override_type_func)(struct sqlclntstate *, int);
typedef void *(auth_func)(struct sqlclntstate *);

#define SQLITE_CALLBACK_API(ret, name)                                         \
    ret (*column_##name)(struct sqlclntstate *, sqlite3_stmt *, int)

struct plugin_callbacks {
    response_func *write_response; /* newsql_write_response */
    response_func *read_response; /* newsql_read_response */

    replay_func *save_stmt; /* newsql_save_stmt */
    replay_func *restore_stmt; /* newsql_restore_stmt */
    replay_func *destroy_stmt; /* newsql_destroy_stmt */
    replay_func *print_stmt; /* newsql_print_stmt */

    // bound params
    plugin_func *param_count; /* newsql_param_count */
    plugin_query_data_func *query_data_func;
    param_index_func *param_index; /* newsql_param_index */
    param_value_func *param_value; /* newsql_param_value */

    // run_statement_typed
    plugin_func *override_count; /* newsql_override_count */
    override_type_func *override_type; /* newsql_override_type */

    plugin_func *has_cnonce; /* newsql_has_cnonce */
    plugin_func *set_cnonce; /* newsql_set_cnonce */
    plugin_func *clr_cnonce; /* newsql_clr_cnonce */
    cnonce_value_func *get_cnonce; /* newsql_has_cnonce */

    get_snapshot_func *get_snapshot; /* newsql_get_snapshot */
    plugin_func *upd_snapshot; /* newsql_update_snapshot */
    plugin_func *clr_snapshot; /* newsql_clear_snapshot */

    plugin_func *has_high_availability; /* newsql_has_high_availability */
    plugin_func *set_high_availability; /* newsql_set_high_availability */
    plugin_func *clr_high_availability; /* newsql_clr_high_availability */
    plugin_func *get_high_availability; /* newsql_get_high_availability*/
    plugin_func *has_parallel_sql;      /* newsql_has_parallel_sql */

    add_steps_func *add_steps; /* newsql_add_steps */
    setup_client_info_func *setup_client_info; /* newsql_setup_client_info */
    skip_row_func *skip_row; /* newsql_skip_row */
    log_context_func *log_context; /* newsql_log_context */
    ret_uint64_func *get_client_starttime; /* newsql_get_client_starttime */
    plugin_func *get_client_retries;       /* newsql_get_client_retries */
    plugin_func *send_intrans_response; /* newsql_send_intrans_response */

    /* These may change depending on underlying tranport (sbuf2 or libevent) */
    plugin_func *close; /* newsql_close_evbuffer */
    plugin_func *flush; /* newsql_flush_evbuffer */
    plugin_func *get_fileno; /* newsql_get_fileno_evbuffer */
    response_func *get_x509_attr; /* newsql_get_x509_attr_evbuffer */
    plugin_func *has_ssl; /* newsql_has_ssl_evbuffer */
    plugin_func *has_x509; /* newsql_has_x509_evbuffer */
    plugin_func *local_check; /* newsql_local_check_evbuffer */
    plugin_func *peer_check; /* newsql_peer_check_evbuffer */
    auth_func *get_authdata; /* newsql_get_authdata */
    plugin_func *free_authdata; /* newsql_free_authdata */
    api_type_func *api_type; /* newsql_api_type */

    /* Optional */
    void *state;
    int (*column_count)(struct sqlclntstate *, sqlite3_stmt *); /* sqlite3_column_count */
    int (*next_row)(struct sqlclntstate *, sqlite3_stmt *);     /* sqlite3_step */
    char *(*tzname)(struct sqlclntstate *, sqlite3_stmt *); /* stmt_tzname */
    SQLITE_CALLBACK_API(int, type);                   /* sqlite3_column_type */
    SQLITE_CALLBACK_API(sqlite_int64, int64);         /* sqlite3_column_int64*/
    SQLITE_CALLBACK_API(double, double);              /* sqlite3_column_double*/
    SQLITE_CALLBACK_API(const unsigned char *, text); /* sqlite3_column_text */
    SQLITE_CALLBACK_API(int, bytes);                  /* sqlite3_column_bytes */
    SQLITE_CALLBACK_API(const void *, blob);          /* sqlite3_column_bytes */
    SQLITE_CALLBACK_API(const dttz_t *, datetime);    /* sqlite3_column_datetime */
    SQLITE_CALLBACK_API(sqlite3_value *, value);      /* sqlite3_column_value */
    const intv_t *(*column_interval)(struct sqlclntstate *, sqlite3_stmt *, int, int);  /* sqlite3_column_interval*/
    int (*sqlite_error)(struct sqlclntstate *, sqlite3_stmt *, const char **errstr);    /* sqlite3_errcode */
    void *(*get_identity)(struct sqlclntstate *);
};

#define make_plugin_callback(clnt, name, func)                                 \
    (clnt)->plugin.func = name##_##func

#define make_plugin_optional_null(clnt, name)                                  \
    (clnt)->plugin.column_##name = NULL

#define plugin_set_callbacks(clnt, name)                                                                               \
    do {                                                                                                               \
        make_plugin_callback(clnt, name, write_response);                                                              \
        make_plugin_callback(clnt, name, read_response);                                                               \
        make_plugin_callback(clnt, name, save_stmt);                                                                   \
        make_plugin_callback(clnt, name, restore_stmt);                                                                \
        make_plugin_callback(clnt, name, destroy_stmt);                                                                \
        make_plugin_callback(clnt, name, print_stmt);                                                                  \
        make_plugin_callback(clnt, name, param_count);                                                                 \
        make_plugin_callback(clnt, name, param_index);                                                                 \
        make_plugin_callback(clnt, name, param_value);                                                                 \
        make_plugin_callback(clnt, name, override_count);                                                              \
        make_plugin_callback(clnt, name, override_type);                                                               \
        make_plugin_callback(clnt, name, has_cnonce);                                                                  \
        make_plugin_callback(clnt, name, set_cnonce);                                                                  \
        make_plugin_callback(clnt, name, clr_cnonce);                                                                  \
        make_plugin_callback(clnt, name, get_cnonce);                                                                  \
        make_plugin_callback(clnt, name, get_snapshot);                                                                \
        make_plugin_callback(clnt, name, upd_snapshot);                                                                \
        make_plugin_callback(clnt, name, clr_snapshot);                                                                \
        make_plugin_callback(clnt, name, has_high_availability);                                                       \
        make_plugin_callback(clnt, name, set_high_availability);                                                       \
        make_plugin_callback(clnt, name, clr_high_availability);                                                       \
        make_plugin_callback(clnt, name, get_high_availability);                                                       \
        make_plugin_callback(clnt, name, has_parallel_sql);                                                            \
        make_plugin_callback(clnt, name, add_steps);                                                                   \
        make_plugin_callback(clnt, name, setup_client_info);                                                           \
        make_plugin_callback(clnt, name, skip_row);                                                                    \
        make_plugin_callback(clnt, name, log_context);                                                                 \
        make_plugin_callback(clnt, name, get_client_starttime);                                                        \
        make_plugin_callback(clnt, name, get_client_retries);                                                          \
        make_plugin_callback(clnt, name, send_intrans_response);                                                       \
        make_plugin_callback(clnt, name, close);                                                                       \
        make_plugin_callback(clnt, name, flush);                                                                       \
        make_plugin_callback(clnt, name, get_fileno);                                                                  \
        make_plugin_callback(clnt, name, get_x509_attr);                                                               \
        make_plugin_callback(clnt, name, has_ssl);                                                                     \
        make_plugin_callback(clnt, name, has_x509);                                                                    \
        make_plugin_callback(clnt, name, local_check);                                                                 \
        make_plugin_callback(clnt, name, peer_check);                                                                  \
        make_plugin_callback(clnt, name, get_authdata);                                                                \
        make_plugin_callback(clnt, name, free_authdata);                                                               \
        make_plugin_callback(clnt, name, api_type);                                                                    \
        make_plugin_callback(clnt, name, get_identity);                                                                \
        make_plugin_optional_null(clnt, count);                                                                        \
        make_plugin_optional_null(clnt, type);                                                                         \
        make_plugin_optional_null(clnt, int64);                                                                        \
        make_plugin_optional_null(clnt, double);                                                                       \
        make_plugin_optional_null(clnt, text);                                                                         \
        make_plugin_optional_null(clnt, bytes);                                                                        \
        make_plugin_optional_null(clnt, blob);                                                                         \
        make_plugin_optional_null(clnt, datetime);                                                                     \
        make_plugin_optional_null(clnt, interval);                                                                     \
        make_plugin_optional_null(clnt, value);                                                                        \
        (clnt)->plugin.state = NULL;                                                                                   \
        (clnt)->plugin.next_row = NULL;                                                                                \
        (clnt)->plugin.tzname = NULL;                                                                                  \
        (clnt)->plugin.query_data_func = NULL;                                                                         \
    } while (0)

int param_count(struct sqlclntstate *);
int param_index(struct sqlclntstate *, const char *, int64_t *);
int param_value(struct sqlclntstate *, struct param_data *, int);
int override_count(struct sqlclntstate *);
int override_type(struct sqlclntstate *, int);
int get_cnonce(struct sqlclntstate *, snap_uid_t *);
int has_high_availability(struct sqlclntstate *);
int has_parallel_sql(struct sqlclntstate *);
int set_high_availability(struct sqlclntstate *);
int clr_high_availability(struct sqlclntstate *);
uint64_t get_client_starttime(struct sqlclntstate *);
int get_client_retries(struct sqlclntstate *);
void *get_authdata(struct sqlclntstate *);
void free_authdata(struct sqlclntstate *);
char *clnt_tzname(struct sqlclntstate *, sqlite3_stmt *);

struct clnt_ddl_context {
    /* Name of the table */
    char *name;
    /* Pointer to a comdb2_ddl_context */
    void *ctx;
    /* Memory allocator of the comdb2_ddl_context */
    comdb2ma mem;
};

#if INSTRUMENT_RECOVER_DEADLOCK_FAILURE
#define RECOVER_DEADLOCK_MAX_STACK 16348
#endif

enum prepare_flags {
    PREPARE_NONE = 0,
    PREPARE_RECREATE = 1,
    PREPARE_DENY_CREATE_TRIGGER = 2,
    PREPARE_DENY_PRAGMA = 4,
    PREPARE_DENY_DDL = 8,
    PREPARE_IGNORE_ERR = 16,
    PREPARE_NO_NORMALIZE = 32,
    PREPARE_ONLY = 64,
    PREPARE_ALLOW_TEMP_DDL = 128,
};

/* This structure is designed to hold several pieces of data related to
 * work-in-progress on client SQL requests. */
struct sqlworkstate {
    const char *zNormSql; /* Normalized version of latest SQL query. */
    char *zOrigNormSql;   /* Normalized version of original SQL query. */
    struct sql_state rec; /* Prepared statement for original SQL query. */
    unsigned char aFingerprint[FINGERPRINTSZ]; /* MD5 of normalized SQL. */
    char zRuleRes[300];   /* Ruleset match result, if any. */
};

struct sql_hist_cost {
    double cost;
    int64_t time;
    int64_t prepTime;
    int64_t rows;
};

struct user {
    char name[MAX_USERNAME_LEN];
    char password[MAX_PASSWORD_LEN];

    uint8_t have_name;
    uint8_t have_password;
    /* 1 if the user is retrieved from a client certificate */
    uint8_t is_x509_user;

    /* Set to allow automatically triggered operations, like autoanalyze, to
       go through. */
    uint8_t bypass_auth;
};

enum remsql_type {
    NO_REMSQL = 0,
    IS_REMSQL = 1,
    IS_REMCREATE = 2
};

struct remsql_set {
    enum remsql_type is_remsql;
    int server_version;
    int table_version;
    int is_schema;
    char tablename[MAXTABLELEN];
    uuid_t uuid;
    char *srcdbname;
    struct errstat xerr;
    uint32_t numdbs;
    char **dbnames;
    int32_t numcols;
    char **columns;
    char **shardnames;
};

#define in_client_trans(clnt) ((clnt)->in_client_trans)
struct string_ref;

struct session_tbl;
void clear_session_tbls(struct sqlclntstate *);

void clear_participants(struct sqlclntstate *);
int add_participant(struct sqlclntstate *, const char *dbname, const char *tier);

struct features {
    unsigned have_ssl : 1;
    unsigned have_sqlite_fmt : 1;
    unsigned allow_incoherent : 1;
    unsigned skip_intrans_results : 1;
    unsigned flat_col_vals : 1;
    unsigned request_fp : 1;
    unsigned require_fastsql : 1;
    unsigned can_redirect_fdb : 1;
    unsigned allow_master_exec : 1;
    unsigned allow_master_dbinfo : 1;
    unsigned queue_me : 1;
};

/* Client specific sql state */
struct sqlclntstate {
    struct thdpool *pPool;     /* When null, the default SQL thread pool is
                                * being used to service the request; otherwise,
                                * a specifically assigned SQL thread pool is
                                * being used. */

    struct sqlworkstate work;  /* This is the primary data related to the SQL
                                * client request in progress.  This includes
                                * the original SQL query and its normalized
                                * variant (if applicable). */

    /* appsock plugin specific data */
    void *authdata;
    void *appdata;
    struct plugin_callbacks plugin;
    struct plugin_callbacks backup; /* allow transient client state mutations */

    /* typessql structs */
    struct plugin_callbacks adapter;
    struct plugin_callbacks adapter_backup;
    struct typessql *typessql_state;
    unsigned typessql : 1; // should query use typessql (determined from set stmt)

    /* bplog write plugin */
    int (*begin)(struct sqlclntstate *clnt, int retries, int keep_id);
    int (*end)(struct sqlclntstate *clnt);
    int (*wait)(struct sqlclntstate *clnt, int timeout, struct errstat *err);

    dbtran_type dbtran;
    pthread_mutex_t dtran_mtx; /* protect dbtran.dtran, if any,
                                  for races betweem sql thread created and
                                  other readers, like appsock */

    /* These are only valid while a query is in progress and will point into
     * the i/o thread's buf */
    pthread_mutex_t sql_lk;
    char *sql;
    struct string_ref *sql_ref;
    struct string_ref *hint_sql_ref;
    int recno;
    int client_understands_query_stats;
    char tzname[CDB2_MAX_TZNAME];
    int dtprec;
    struct conninfo conninfo;

    /* For SQL engine dispatch. */
    int inited_mutex;
    pthread_mutex_t wait_mutex;
    pthread_cond_t wait_cond;
    pthread_mutex_t write_lock;
    pthread_cond_t write_cond;
    int query_rc;

    struct rawnodestats *rawnodestats;

    uuid_t      unifieduuid;         /* assigned to any statement running, used for canceling live sql */
    osqlstate_t osql;                /* offload sql state is kept here */
    enum ctrl_sqleng ctrl_sqlengine; /* use to mark a begin/end out of state,
                                        see enum ctrl_sqleng
                                     */
    int intrans; /* THIS FIELD IS USED BY sqlglue.c TO RECORD THE ENTRANCE (=1)
                   AND THE EXIT(=0) in a sql transaction marked by a succesfull
                   call to BeginTrans, and Commit/Rollback respectively
                   THIS DOES NOT MATCH THE CLIENT TRANSACTION EXCERPT FOR
                   SINGULAR STATEMENTS;
                   STATE OF A CLIENT TRANSACTION IS KEPT HERE
                 */
    struct convert_failure fail_reason; /* detailed error */
    int early_retry;

    /* analyze variables */
    int n_cmp_idx;
    sampled_idx_t *sampled_idx_tbl;

    int last_check_time;
    int query_timeout;
    int statement_timedout;

    uint8_t heartbeat;
    uint8_t ready_for_heartbeats;
    uint8_t no_more_heartbeats;
    uint8_t done;
    plugin_func *done_cb; /* newsql_done_evbuffer */
    unsigned long long sqltick, sqltick_last_seen;

    int using_case_insensitive_like;
    int deadlock_recovered;
    struct timeval last_sql_recover_time;

    /* lua stored procedure */
    struct stored_proc *sp;
    int exec_lua_thread;
    int want_stored_procedure_trace;
    int want_stored_procedure_debug;
    char spname[MAX_SPNAME + 1];
    struct spversion_t spversion;

    unsigned int bdb_osql_trak; /* 32 debug bits interpreted by bdb for your
                                   "set debug bdb"*/
    struct client_query_stats *query_stats;

    SBUF2 *dbglog;
    int queryid;
    unsigned long long dbglog_cookie;
    unsigned long long master_dbglog_cookie;

    int have_query_limits;
    struct query_limits limits;

    /* effects:       per txn. keeps track of replicant effects when in-txn, and master effects when committed.
     * log_effects:   per chunked-txn. keeps track of replicant effects of all chunks,
     *                including the current chunk which hasn't committed yet.
     * chunk_effects: per chunked-txn. keeps track of master effects of all committed chunks.
     * remote_effects: cummulation of all distributed effects
     *
     * I hope the example below explains these effects a little better.
     *
     *   CREATE TABLE t (i INTEGER)$$
     *   SET TRANSACTION CHUNK 1
     *   BEGIN
     *   INSERT INTO t VALUES(1) -- Nothing is committed yet. effects: 1; log_effects: 1; chunk_effects: 0.
     *   INSERT INTO t VALUES(2) -- (1) is committed.         effects: 1; log_effects: 2; chunk_effects: 1;
     *   INSERT INTO t VALUES(3) -- (2) is committed.         effects: 1; log_effects: 3; chunk_effects: 2;
     *   COMMIT                  -- (3) is committed.         effects: 1; log_effects: 3; chunk_effects: 3;
     *
     *   NOTE: handling the num_selects
     *   - any standalone query will use effects.num_selected
     *   - any standalone write will use and preserve effects.num_selected upon receiving master effects
     *   - any client transaction query will use effects.num_selected, incremented for each new query
     *   - any client transaction write will use effects.num_selected, returned or not based on verifyretry
     *   - any client transaction commit will preserve (i.e. not reset) effects.num_selected
     *
     */
    struct query_effects effects;
    struct query_effects log_effects;
    struct query_effects chunk_effects;
    struct query_effects remote_effects;
    int64_t nsteps;

    struct user current_user;
    int authgen;

    char *origin;

    TAILQ_HEAD(, session_tbl) session_tbls;

    int had_errors; /* to remain compatible with blocksql: if a user starts a
                       transaction, we
                       need to pend the first error until a commit is issued.
                       any statements
                       past the first error are ignored. */
    int in_client_trans; /* clnt is in a client transaction (ie. client ran
                            "begin" but not yet commit or rollback */
    char *saved_errstr;  /* if had_errors, save the error string */
    int saved_rc;        /* if had_errors, save the return code */
    char *sqlite_errstr; /* sqlite error string, static, never allocated */

    int prep_rc;    /* last value returned from sqlite3_prepare_v3() */
    int step_rc;    /* last value returned from sqlite3_step() */
    int isselect;   /* track if the query is a select query.*/
    int isUnlocked;
    int writeTransaction;
    int prepare_only;
    int verify_retries; /* how many verify retries we've borne */
    int verifyretry_off;
    int pageordertablescan;
    int snapshot; /* snapshot epoch placeholder */
    int snapshot_file;
    int snapshot_offset;
    int is_hasql_retry;
    int is_readonly;
    int is_readonly_set; /* Whether 'readonly' was set explicitly via SET command? */
    int force_readonly;
    int is_expert;
    int is_fast_expert; /* 1 if not scanning data to generate stat1 */
    int added_to_hist;

    struct thr_handle *thr_self;
    arch_tid appsock_id;
    int holding_pagelocks_flag; /* Rowlocks optimization */

    /* remote settings, used in run_sql */
    sqlclntstate_fdb_t fdb_state;

    int nrows;
    struct sql_hist_cost spcost;

    int planner_effort;
    int osql_max_trans;
    int group_concat_mem_limit;
    /* read-set validation */
    CurRangeArr *arr;
    CurRangeArr *selectv_arr;
    char *prev_cost_string;

    int num_retry;
    unsigned int file;
    unsigned int offset;

    uint64_t enque_timeus;
    uint64_t deque_timeus;

    /* due to some sqlite vagaries, cursor is closed
       and I lose the side row; cache it here! */
    unsigned long long keyDdl;
    int nDataDdl;
    char *dataDdl;

    /* partial indexes */
    unsigned long long ins_keys;
    unsigned long long del_keys;
    int has_sqliterow;
    int verify_indexes;
    void *schema_mems;

    /* indexes on expressions */
    uint8_t **idxInsert;
    uint8_t **idxDelete;

    int8_t wrong_db;
    int8_t high_availability_flag;
    int8_t hasql_on;
    int8_t has_recording;
    int8_t is_retry;
    int8_t get_cost;
    int8_t is_explain;
    uint8_t is_analyze;
    uint8_t is_overlapping;
    uint32_t init_gen;
    int8_t gen_changed;
    uint8_t skip_peer_chk; /* 1 if this is a temp table operation from an SP,
                              where peer check and the dbopen_gen check at commit time are skipped. */
    uint8_t queue_me;
    uint8_t fail_dispatch;
    uint8_t in_sqlite_init; /* clnt is in sqlite init phase when this is set */
    uint8_t secure;         /* clnt is forwarded from pmux over the secure port, */

    int where_trace_flags;

    int ncontext;
    char **context;

    hash_t *ddl_tables;
    hash_t *dml_tables;
    hash_t *ddl_contexts;

    int statement_query_effects;

    int verify_remote_schemas;

    /* sharding scheme */
    struct dohsql *conns;
    int nconns;
    int conns_idx;
    int shard_slice;
    fdb_push_connector_t *fdb_push;

    char *argv0;
    char *stack;

    /* api driver information */
    char *api_driver_name;
    char *api_driver_version;

    int translevel_changed;
    int admin;

    /* Grab this mutex when calling sql_tick. This is to prevent race when
       multiple threads are working on a single clnt (parallel-count, for instance). */
    pthread_mutex_t sql_tick_lk;
    uint32_t start_gen;
    int emitting_flag;
    int need_recover_deadlock;
    int recover_deadlock_rcode;
    int heartbeat_lock;
#ifdef INSTRUMENT_RECOVER_DEADLOCK_FAILURE
    const char *recover_deadlock_func;
    int recover_deadlock_line;
    pthread_t recover_deadlock_thd;
    char recover_deadlock_stack[RECOVER_DEADLOCK_MAX_STACK];
#endif
    struct sqlthdstate *thd;
    int had_lease_at_begin;

    int64_t connid;
    int64_t total_sql;
    int64_t sql_since_reset;
    int64_t num_resets;
    time_t connect_time;
    time_t last_reset_time;
    int state_start_time;
    int64_t netwaitus;
    enum connection_state state;
    pthread_mutex_t state_lk;
    /* The node doesn't change.  The pid does as connections get donated.  We
     * latch both values here since conninfo is lost when connections are reset. */
    int last_pid;
    char* origin_host;
    int8_t sent_data_to_client;
    int8_t is_asof_snapshot;
    LINKC_T(struct sqlclntstate) lnk; /* appsock + sbuf */
    TAILQ_ENTRY(sqlclntstate) lru_entry; /* libevent connections which can be closed */
    TAILQ_ENTRY(sqlclntstate) sql_entry; /* all libevent connections */
    int last_sent_row_sec; /* used to delay releasing locks when bdb_lock is desired */
    int8_t rowbuffer;
    /* 1 if client has requested flat column values. */
    int flat_col_vals;
    plugin_func *recover_ddlk;
    replay_func *recover_ddlk_fail;
    unsigned loading_stat: 1;
    unsigned skip_eventlog: 1;
    unsigned request_fp: 1;
    unsigned dohsql_disable: 1;
    unsigned can_redirect_fdb: 1;
    unsigned force_fdb_push_redirect : 1; // this should only be set if can_redirect_fdb is true
    unsigned force_fdb_push_remote : 1;
    unsigned return_long_column_names : 1; // if 0 then tunable decides
    unsigned in_local_cache : 1;
    unsigned evicted_appsock : 1;
    unsigned set_continue_on_chunk_verify_error : 1; // set stmt enabled
    unsigned continued_on_chunk_verify_error : 1;    // did we continue on verify error?

    unsigned num_adjusted_column_name_length; // does not consider fastsql
    char **adjusted_column_names;

    char *sqlengine_state_file;
    int sqlengine_state_line;
    int last_sqlengine_state;

    int sqlite_row_format;

    // Latch last statement's cost for comdb2_last_cost to fetch
    int64_t last_cost;
    int disable_fdb_push;

    /* Modsnap start point */
    uint32_t modsnap_start_lsn_file; 
    uint32_t modsnap_start_lsn_offset;

    /* Checkpoint LSN prior to modsnap start point */
    uint32_t last_checkpoint_lsn_file;
    uint32_t last_checkpoint_lsn_offset;

    void *modsnap_registration; 
    
    int modsnap_in_progress; 

    int lastresptype;
    char *externalAuthUser;

    struct remsql_set remsql_set;
    int fdb_push_remote; /* cache the global on each prepare */
    int fdb_push_remote_write; /* cache the global on each prepare */
    int n_set_commands; /* save the set that comes from a begin */
    char **set_commands;

    // fdb 2pc
    int use_2pc;
    int is_participant;
    int is_coordinator;

    char *dist_txnid;
    int64_t dist_timestamp;
    char *coordinator_dbname;
    char *coordinator_tier;
    char *coordinator_master;

    hash_t *authz_read_tables;
    hash_t *authz_write_tables;

    int allow_make_request;

    // coordinator participant information
    LISTC_T(struct participant) participants;

    unsigned disabled_logdel : 1; /* 1 if this clnt disabled logdel using set stmt and has not tried to re-enable it */
    unsigned multiline : 1;
    int tail_offset;

    struct features features;
    int discard_this; /* set by a cancel() trap, complement thd->stop_this_statement for queued request */

    // this is not an SQL request, distpatch it elsewhere
    int is_tagged;

    unsigned blocking_tranlog : 1;
};
typedef struct sqlclntstate sqlclntstate;

/* Query stats. */
struct query_path_component {
    char lcl_tbl_name[MAXTABLELEN];
    char rmt_db[MAX_DBNAME_LENGTH];
    int ix;
    int nfind;
    int nnext;
    int nwrite;
    int nblobs;
    LINKC_T(struct query_path_component) lnk;
};

struct temptable {
    int rootpage;
    struct temp_cursor *cursor;
    struct temp_table *tbl;
    int flags;
    Btree *owner;
    struct sp_tmptbl *sp_tmptbl;
};

struct Btree {
    /* for debugging */
    int btreeid;
    struct reqlogger *reqlogger;

    bdb_temp_hash *genid_hash; /* rrn hash for non dtastripe support */

    LISTC_T(BtCursor) cursors;

    unsigned is_temporary : 1;
    unsigned is_hashtable : 1;
    unsigned is_remote : 1;

    hash_t *temp_tables;
    int num_temp_tables;

    void *schema;
    void (*free_schema)(void *);

    char *zFilename;
    fdb_t *fdb;
};

enum { CFIRST = 0, CNEXT = 1, CPREV = 2, CLAST = 3, NORETRY = 256 };

typedef enum {
    CURSORCLASS_TEMPTABLE = 1,
    CURSORCLASS_SQLITEMASTER,
    CURSORCLASS_TABLE,
    CURSORCLASS_INDEX,
    CURSORCLASS_STAT24,
    CURSORCLASS_REMOTE,
} cursorclass_type;

struct rd_blob_buffer {
    int capacity;
    int length;
    int flags;
    int n;
    char *z;
    genid_t genid;
};

struct BtCursor {
    /* direct pointers to stuff -- avoids thread local lookup */
    struct sqlclntstate *clnt;
    struct sql_thread *thd;
    sqlite3 *sqlite;
    Vdbe *vdbe;
    Btree *bt;
    struct dbtable *db;

    int rootpage;

    /* various buffers: */
    uint8_t writeTransaction; /* save tran type during cursor open */
    void *ondisk_buf;         /* ondisk data */
    void *ondisk_key; /* ondisk key. this is effectively also the pointer into the index */
    struct rd_blob_buffer *rd_blob_buffers;
    blob_buffer_t wr_blob_buffers[MAXBLOBS];

    void *lastkey; /* last key: swap with ondisk_key for subsequent lookups */
    void *fndkey;  /* this key is actually found */

    unsigned eof : 1;   /* we reached the end of an index, but the current entry still contains valid data */
    unsigned empty : 1; /* there are no entries in the db - no results to return for any query */
    LINKC_T(BtCursor) lnk;

    /* these are sqlite format buffers */
    void *dtabuf;
    int dtabuflen;
    void *keybuf;
    int keybuflen;

    int dtabuf_alloc;
    int keybuf_alloc;

    struct session_tbl *session_tbl;
    int tblnum;
    int ixnum;

    int cursorid; /* for debugging */
    struct reqlogger *reqlogger;
    int rrn; /* record number */
    char sqlrrn[5];
    int sqlrrnlen;
    unsigned long long genid;

    struct KeyInfo *pKeyInfo;

    /* special case for master table: the table is fake,
       just keep track of which entry we are pointing to */
    int tblpos;
    struct fdb_tbl_ent *crt_sqlite_master_row;

    /* special case for a temp table: pointer to a temp table handle */
    struct temptable *tmptable;

    sampler_t *sampler;

    blob_status_t blobs;

    bdb_cursor_ifn_t *bdbcur;

    int nmove, nfind, nwrite;
    int nblobs;
    int num_nexts;

    int numblobs;

    struct schema *sc; /* points to the schema for the underlying table for this cursor */

    cursorclass_type cursor_class; /* TEMPTABLE, SQLITEMASTER, TABLE, INDEX, STAT2 */

    void *shadtbl; /* fast pointer to shadows, used during transaction */

    int next_is_eof; /* see comments in sqlite3BtreeMoveto */
    int prev_is_eof; /* see comments in sqlite3BtreeMoveto */

    bdb_cursor_ser_t cur_ser;

    /* move me */
    int (*cursor_move)(BtCursor *, int *pRes, int how);
    /* temptables have these -- lua ones need locking */
    int (*cursor_del)(bdb_state_type *, struct temp_cursor *, int *bdberr,
                      BtCursor *);
    int (*cursor_put)(bdb_state_type *, struct temp_table *, void *key,
                      int keylen, void *data, int dtalen, void *unpacked,
                      int *bdberr, BtCursor *);
    int (*cursor_close)(bdb_state_type *, BtCursor *, int *bdberr);
    int (*cursor_find)(bdb_state_type *, struct temp_cursor *, const void *key,
                       int keylen, void *unpacked, int *bdberr, BtCursor *);
    unsigned long long (*cursor_rowid)(struct temp_table *tbl, BtCursor *);
    int (*cursor_count)(BtCursor *, long long *);

    double find_cost;
    double move_cost;
    double write_cost;
    double blob_cost;

    int nCookFields;
    uint8_t is_recording; /* set for indexes; will store deep copies of data&blobs
                               to prevent verify errors */
    uint8_t is_sampled_idx; /* set to 1 if this is a sampled (previously
                               misnamed compressed) index */
    uint8_t is_btree_count;

    uint8_t on_list;

    blob_status_t blob_descriptor;
    int have_blob_descriptor;

    /* remotes */
    struct fdb_cursor_if *fdbc;

    /* cursor access range */
    CurRange *range;
    unsigned char is_equality; /* sqlite will "hint" back if a SeekGE is
                                  actually a SeekEQ */

    unsigned long long col_mask; /* tracking first 63 columns, if bit is set,
                                    column is needed */

    unsigned long long keyDdl; /* rowid for side DDL row */
    char *dataDdl;             /* DDL row, cached during CREATE operations */
    int nDataDdl;   /* length of the cached row for DDL instructions */
    int open_flags; /* flags used to open it */

    int tableversion;

    void *query_preparer_data;

    int permissions; /* permissions for read/write access to table */
};

struct sql_hist {
    LINKC_T(struct sql_hist) lnk;
    struct string_ref *sql_ref;
    struct sql_hist_cost cost;
    int when;
    int64_t txnid;
    struct conninfo conn;
};
typedef LISTC_T(struct query_path_component) query_path_component_tp;
struct sql_thread {
    LINKC_T(struct sql_thread) lnk;
    pthread_mutex_t lk;
    struct Btree *bt, *bttmp;
    int startms;
    int prepms;
    int stime;
    int nmove;
    int nfind;
    int nwrite;
    int bufsz;
    uint32_t id;
    char *buf;
    int in_subrequest;
    query_path_component_tp query_stats;
    hash_t *query_hash;
    query_path_component_tp query_stats_subrequest;
    hash_t *query_hash_subrequest;
    double cost;
    struct sqlclntstate *clnt;
    /* custom error message to send to client */
    char *error;
    struct master_entry *rootpages;
    int rootpage_nentries;
    int selective_rootpages;
    unsigned char had_temptables;
    unsigned char had_tablescans;

    /* current shard; cut 0 we support only one partition */
    int crtshard;
    /* flag to signal that the sql engine should stop executing */
    int stop_this_statement;
};

struct connection_info {
    char *host;
    int64_t connection_id;
    int64_t pid;
    int64_t total_sql;
    int64_t sql_since_reset;
    int64_t num_resets;
    int64_t steps;
    cdb2_client_intv_ds_t time_in_state; 
    cdb2_client_datetime_t connect_time;
    cdb2_client_datetime_t last_reset_time;
    char *state;
    char *sql;
    char *fingerprint;
    int64_t is_admin;
    int64_t is_ssl; /* 1 if this an SSL connection */
    int64_t has_cert; /* 1 if the SSL connection has an X509 certificate */
    char *common_name; /* common name in the certificate */
    char common_name_str[ub_common_name];
    char *identity;

    /* latched in sqlinterfaces, not returned */ 
    time_t connect_time_int;
    time_t last_reset_time_int;
    int node_int;
    int time_in_state_int;
    enum connection_state state_int;
    int64_t in_transaction;
    int64_t in_local_cache;
    char *uuid;
    int64_t is_canceled;
};

/* makes master swing verbose */
extern int gbl_master_swing_osql_verbose;
/* for testing: sleep in osql_sock_restart when master swings */
extern int gbl_master_swing_sock_restart_sleep;
/* allow altering existing tables to retroactively partition data for tpt */
extern int gbl_retro_tpt;

#define is_sqlite_stat(x) (strncmp((x), "sqlite_stat", sizeof("sqlite_stat") - 1) == 0)
#define is_stat1(x) (strcmp((x), "sqlite_stat1") == 0)
#define is_stat2(x) (strcmp((x), "sqlite_stat2") == 0)
#define is_stat4(x) (strcmp((x), "sqlite_stat4") == 0)

/* functions to get/put a locker id to be used for all nontransactional cursors
 */
int get_curtran(bdb_state_type *bdb_state, struct sqlclntstate *clnt);
int put_curtran(bdb_state_type *bdb_state, struct sqlclntstate *clnt);
int get_curtran_flags(bdb_state_type *bdb_state, struct sqlclntstate *clnt,
                      uint32_t flags);
int put_curtran_flags(bdb_state_type *bdb_state, struct sqlclntstate *clnt,
                      uint32_t flags);

unsigned long long osql_log_time(void);
void osql_log_time_done(struct sqlclntstate *clnt);

void clnt_to_ruleset_item_criteria(struct sqlclntstate *clnt,
                                   struct ruleset_item_criteria *context);

int dispatch_sql_query(struct sqlclntstate *);
int dispatch_sql_query_no_wait(struct sqlclntstate *);
void signal_clnt_as_done(struct sqlclntstate *clnt);

int handle_sql_begin(struct sqlthdstate *thd, struct sqlclntstate *clnt,
                     enum trans_clntcomm sideeffects);
int handle_sql_commitrollback(struct sqlthdstate *thd,
                              struct sqlclntstate *clnt,
                              enum trans_clntcomm sideeffects);

int replicant_is_able_to_retry(struct sqlclntstate *clnt);
void sql_get_query_id(struct sql_thread *thd);

#ifdef PER_THREAD_MALLOC
int sql_mem_init(void *);
int sql_mem_init_with_save(void *, void **);
void sql_mem_shutdown(void *);
void sql_mem_shutdown_and_restore(void *, void **);
#else
#define sql_mem_init(...)
#define sql_mem_init_with_save(...)
#define sql_mem_shutdown(...)
#define sql_mem_shutdown_and_restore(...)
#endif

int sqlite3_open_serial(const char *filename, sqlite3 **, struct sqlthdstate *);
int sqlite3_close_serial(sqlite3 **);

void reset_clnt(struct sqlclntstate *, int initial);
void cleanup_clnt(struct sqlclntstate *);
void free_client_info(struct sqlclntstate *);
void free_client_adj_col_names(struct sqlclntstate *);
void reset_query_effects(struct sqlclntstate *, int, int);

int sqlite_to_ondisk(struct schema *s, const void *inp, int len, void *outp,
                     const char *tzname, blob_buffer_t *outblob, int maxblobs,
                     struct convert_failure *fail_reason, BtCursor *pCur);

int has_sqlcache_hint(const char *sql, const char **start, const char **end);

void sqlite3VdbeRecordPack(UnpackedRecord *unpacked, Mem *pOut);
char *sql_field_default_trans(struct field *f, int is_out);

void fdb_packedsqlite_process_sqlitemaster_row(char *row, int rowlen,
                                               char **etype, char **name,
                                               char **tbl_name, int *rootpage,
                                               char **sql, char **csc2,
                                               unsigned long long *version,
                                               int new_rootpage);

int fdb_packedsqlite_extract_genid(char *key, int *outlen, char *outbuf);

unsigned long long comdb2_table_version(const char *tablename);

int fdb_add_remote_time(BtCursor *pCur, unsigned long long start,
                        unsigned long long end);
/**
 * Remote query push support
 * Save in clnt information that this is a standalone select that
 * refers to a remote table
 *
 */
int fdb_push_setup(Parse *pParse, struct dohsql_node *node);

/**
 * Same as fdb_push_setup, but for remote writes
 *
 */
int fdb_push_write_setup(Parse *pParse, enum ast_type type, Table *pTab);

/**
 * Free remote push support
 */
void fdb_push_free(fdb_push_connector_t **fdb_push);

/**
 * Pack an sqlite result to be send to a remote db
 *
 */
void fdb_sqlite_row(sqlclntstate *clnt, sqlite3_stmt *stmt, Mem *res);

/**
 * Free a packed sqlite row after being used
 *
 */
void fdb_sqlite_row_free(Mem *res);

/**
 * Handle sending and receiving rows from pushing a query remotely
 *
 */
int handle_fdb_push(struct sqlclntstate *clnt, struct errstat *err);
/**
 * Same as handle_fdb_push, but for writes
 *
 */
int handle_fdb_push_write(struct sqlclntstate *clnt, struct errstat *err,
                          int n_extra_sets, const char **sets);

int sqlite3LockStmtTables(sqlite3_stmt *pStmt);
int sqlite3UnlockStmtTablesRemotes(struct sqlclntstate *clnt);
void sql_remote_schema_changed(struct sqlclntstate *clnt, sqlite3_stmt *pStmt);
int release_locks_on_emit_row(struct sqlclntstate *clnt);

void clearClientSideRow(struct sqlclntstate *clnt);
struct temptable get_tbl_by_rootpg(const sqlite3 *, int);
void clone_temp_table(sqlite3_stmt *, struct temptable *);
int sqlengine_prepare_engine(struct sqlthdstate *, struct sqlclntstate *,
                             int recreate);
int sqlserver2sqlclient_error(int rc);
uint16_t stmt_num_tbls(sqlite3_stmt *);
int newsql_dump_query_plan(struct sqlclntstate *clnt, sqlite3 *hndl);
void init_cursor(BtCursor *, Vdbe *, Btree *);
void run_stmt_setup(struct sqlclntstate *, sqlite3_stmt *);
void sql_index_name_trans(char *namebuf, int len, struct schema *, struct dbtable *, int ixnum, void *trans);

int get_prepared_stmt(struct sqlthdstate *, struct sqlclntstate *, struct sql_state *, struct errstat *, int);
int get_prepared_stmt_no_lock(struct sqlthdstate *, struct sqlclntstate *, struct sql_state *, struct errstat *, int);
int get_prepared_stmt_try_lock(struct sqlthdstate *, struct sqlclntstate *, struct sql_state *, struct errstat *, int);

void sqlengine_thd_start(struct thdpool *, struct sqlthdstate *, enum thrtype);
void sqlengine_thd_end(struct thdpool *, struct sqlthdstate *);

#define SQL_POOL_LEGACY_NAME          ("sqlenginepool")
#define SQL_POOL_DEFLT_NAME           ("default")
#define SQL_POOL_STACK_SIZE           (4 * 1024 * 1024) /* 4 MiB */
#define SQL_POOL_DEFLT_MIN_THREADS    (4)
#define SQL_POOL_DEFLT_MAX_THREADS    (48)
#define SQL_POOL_NAMED_MAX_THREADS    (1)
#define SQL_POOL_LINGER_SECS          (30) /* 30 seconds */
#define SQL_POOL_DEFLT_MAXQ_OVERRIDE  (500)
#define SQL_POOL_NAMED_MAXQ_OVERRIDE  (500)
#define SQL_POOL_MAXQ_AGE_MS          (5 * 60 * 1000) /* 5 minutes */
#define SQL_POOL_STOP_TIMEOUT_US      (5000000) /* 5 seconds */

typedef struct pool_entry {
    const char *zName;
    long long int nThreads;
    struct thdpool *pPool;
} pool_entry_t;

int get_default_sql_pool_max_threads(void);
struct thdpool *get_default_sql_pool(int);
struct thdpool *get_sql_pool(struct sqlclntstate *);
struct thdpool *get_named_sql_pool(const char *, int, int);

int64_t get_all_sql_pool_timeouts(void);
int list_all_sql_pools(SBUF2 *);
void print_all_sql_pool_stats(FILE *);
void foreach_all_sql_pools(thdpool_foreach_fn, void *);
void stop_all_sql_pools(void);
void resume_all_sql_pools(void);
int destroy_sql_pool(const char *, int);
void destroy_all_sql_pools(void);

int get_data(BtCursor *pCur, struct schema *sc, uint8_t *in, int fnum, Mem *m,
             uint8_t flip_orig, const char *tzname);

#define cur_is_remote(pCur) (pCur->cursor_class == CURSORCLASS_REMOTE)

response_func write_response;
response_func read_response;
plugin_func get_fileno;

int typestr_to_type(const char *ctype);
int column_count(struct sqlclntstate *, sqlite3_stmt *);
int sqlite_error(struct sqlclntstate *, sqlite3_stmt *, const char **errstr);
int next_row(struct sqlclntstate *, sqlite3_stmt *);
int sqlite_stmt_error(sqlite3_stmt *stmt, const char **errstr);
int sqlite3_is_success(int);
int sqlite3_is_prepare_only(struct sqlclntstate *);
int sqlite3_maybe_step(struct sqlclntstate *, sqlite3_stmt *);
int get_sqlite3_column_type(struct sqlclntstate *clnt, sqlite3_stmt *stmt,
                            int col, int skip_decltype);
int is_column_type_null(struct sqlclntstate *clnt, sqlite3_stmt *stmt, int col);

int column_type(struct sqlclntstate *, sqlite3_stmt *, int);
sqlite_int64 column_int64(struct sqlclntstate *, sqlite3_stmt *, int);
double column_double(struct sqlclntstate *, sqlite3_stmt *, int);
const unsigned char *column_text(struct sqlclntstate *, sqlite3_stmt *, int);
int column_bytes(struct sqlclntstate *, sqlite3_stmt *, int);
const void *column_blob(struct sqlclntstate *, sqlite3_stmt *, int);
const dttz_t *column_datetime(struct sqlclntstate *, sqlite3_stmt *, int);
const intv_t *column_interval(struct sqlclntstate *, sqlite3_stmt *, int, int);
sqlite3_value *column_value(struct sqlclntstate *, sqlite3_stmt *, int);

struct query_stats {
    int64_t nfstrap;
    int64_t nsql;
    int64_t nsteps;
    int64_t ncommits;
    int64_t nretries;
    int64_t ndeadlocks;
    int64_t nlockwaits;
    int64_t nbpoolhits;
    int64_t nbpoolmisses;
    int64_t npreads;
    int64_t npwrites;
};
int get_query_stats(struct query_stats *stats);

void save_thd_cost_and_reset(struct sqlthdstate *thd, Vdbe *pVdbe);
void restore_thd_cost_and_reset(struct sqlthdstate *thd, Vdbe *pVdbe);
void clnt_query_cost(struct sqlthdstate *thd, double *pCost, int64_t *pPrepMs);

int clear_fingerprints(int *plans_count);
void calc_fingerprint(const char *zNormSql, size_t *pnNormSql,
                      unsigned char fingerprint[FINGERPRINTSZ]);
void add_fingerprint(struct sqlclntstate *, sqlite3_stmt *, struct string_ref *, const char *, int64_t, int64_t,
                     int64_t, int64_t, struct reqlogger *, unsigned char *, int);

long long run_sql_return_ll(const char *query, struct errstat *err);
long long run_sql_thd_return_ll(const char *query, struct sql_thread *thd,
                                struct errstat *err);

struct query_plan_item {
    unsigned char plan_fingerprint[FINGERPRINTSZ]; /* md5 digest hex string */
    struct string_ref *plan_ref;
    double avg_cost_per_row;
    double total_cost_per_row;
    int nexecutions;
    int alert_once_cost; /* Only log query plan cost differences once per query plan in trace, but reset if the avg cost changes. Init to 1 */
};
int free_query_plan_hash(hash_t *query_plan_hash);
int clear_query_plans();
struct string_ref *form_query_plan(sqlite3_stmt *stmt);
void add_query_plan(int64_t cost, int64_t nrows, struct fingerprint_track *t, struct string_ref *zSql_ref,
                    struct string_ref *query_plan_ref, unsigned char *plan_fingerprint, char *params);

struct query_field {
    unsigned char fingerprint[FINGERPRINTSZ];
    unsigned char plan_fingerprint[FINGERPRINTSZ];
    struct string_ref *zSql_ref;
    struct string_ref *query_plan_ref;
    char *params;
    time_t timestamp; /* fingerprints last updated time */
};
char *get_params_string(struct sqlclntstate *clnt);
int clear_sample_queries();
void add_query_to_samples_queries(const unsigned char *fingerprint, const unsigned char *plan_fingerprint,
                                  struct string_ref *zSql_ref, struct string_ref *query_plan_ref, char *params);

/* Connection tracking */
int gather_connection_info(struct connection_info **info, int *num_connections);
void free_connection_info(struct connection_info *info, int num_connections);
void clnt_change_state(struct sqlclntstate *clnt, enum connection_state state);

struct sqlclntstate *get_sql_clnt(void);

struct client_sql_systable_data {
    char *host;
    char *task;
    char *fingerprint;
    int64_t count;
    int64_t timems;
    int64_t cost;
    int64_t rows;

    char fp[FINGERPRINTSZ*2+1];
};

struct query_count {
    char fingerprint[FINGERPRINTSZ];

    // TODO: counter_t that we automatically reset when needed
    int64_t count;
    int64_t last_count;

    int64_t cost;
    int64_t last_cost;

    int64_t rows;
    int64_t last_rows;

    int64_t timems;
    int64_t last_timems;
};

struct fixed_row_source {
    void *data;
    int ncolumns;
    int rownum;
    int *types;
    char **names;
    int (*fixed_values_callback)(struct sqlclntstate *, struct fixed_row_source *src, int rownum, int colnum, void **value, int *len);
};


void add_fingerprint_to_rawstats(struct rawnodestats *stats,
                                 unsigned char *fingerprint, int cost,
                                 int rows, int timems);

/**
 * If bdb_lock_desired, run recovery (releasing locks)
 * and pause proportionally with the number of retries
 *
 */
int clnt_check_bdb_lock_desired(struct sqlclntstate *clnt);

/**
 * Bdb transaction objects with curtran lockid
 */
tran_type *curtran_gettran(void);

void curtran_assert_nolocks(void);

void curtran_puttran(tran_type *tran);
int sbuf_is_local(SBUF2 *);
int fdb_access_control_create(struct sqlclntstate *, char *str);
int disable_server_sql_timeouts(void);
int osql_clean_sqlclntstate(struct sqlclntstate *);
void handle_failed_dispatch(struct sqlclntstate *, char *err);
int start_new_transaction(struct sqlclntstate *);
int sqlite3LockStmtTablesRecover(sqlite3_stmt *);

struct sql_col_info {
    int count;
    int capacity;
    int *type;
};

void init_lru_evbuffer(struct sqlclntstate *);
void add_lru_evbuffer(struct sqlclntstate *);
void rem_lru_evbuffer(struct sqlclntstate *);
void add_sql_evbuffer(struct sqlclntstate *);
void rem_sql_evbuffer(struct sqlclntstate *);
void update_col_info(struct sql_col_info *info, int);
void sqlengine_work_appsock(struct sqlthdstate *, struct sqlclntstate *);
const char *sqlite3ErrStr(int);
char *param_string_value(struct sqlclntstate *clnt, int n, char *out, int outlen);
void ssl_set_clnt_user(struct sqlclntstate *);

/* use backup to restore the sqlite3 plugin interface */
void clnt_plugin_reset(struct sqlclntstate *clnt);

int check_sql_client_disconnect(struct sqlclntstate *clnt, char *file, int line);

/* Convert a sequence of Mem * to a serialized sqlite row */
int sqlite3_unpacked_to_packed(Mem *mems, int nmems, char **ret_rec,
                               int *ret_rec_len);

int send_row(struct sqlclntstate *clnt, struct sqlite3_stmt *stmt,
             uint64_t row_id, int postpone, struct errstat *err);

int comdb2_sql_tick(void);
int comdb2_sql_tick_no_recover_deadlock(void);
int forward_set_commands(struct sqlclntstate *clnt, cdb2_hndl_tp *hndl,
                         struct errstat *err);

void wait_for_transactions(void);

int osql_test_create_genshard(struct schema_change_type *sc, char **errmsg, int nshards,
                              char **dbnames, uint32_t numcols, char **columns, char **shardnames);
int osql_test_remove_genshard(struct schema_change_type *sc, char **errmsg);

void cancel_connections(int only_queued, uuid_t uuid, char *fp);

struct sp_tmptbl {
    pthread_mutex_t lk;
    uint64_t rowid;
};
void set_tmptbl(struct sp_tmptbl *);
int endianness_mismatch(struct sqlclntstate *clnt);

#endif /* _SQL_H_ */