odbtools/odbctest/mql/basic/mdb/0100class.mql

-- DB 仅存储数据库连接信息，不处理数据
CREATE DB IF NOT EXISTS msqldb (
    -- 数据库驱动类型，单引号或双引号标记的字符串，
    -- 目前支持的类型有 sqlite|mysql ，新的类型需要更新 odbserver
    DRIVER : 'sqlite', 
    -- 数据源定义，单引号或双引号标记的字符串，
    -- 不同数据库类型格式不一样，参考相关数据库驱动文档
    SOURCE : "file:data/testdb?cache=shared",
    -- 附加选项，JSON对象，
    -- 通过 odbserver 支持的，不同数据库类型支持的选项可能不同
    OPTION : {
        "makedir": "auto" -- sqlite 支持，自动创建数据库文件所在目录
    }
    -- mysql示例
    -- driver :  "mysql",
    -- source :  "user:password@tcp(127.0.0.1:3306)/dbname"
) 
;

-- 创建 MDB 相关测试类
-- MDB 统一处理不同数据库类型的数据存取
-- 上面创建的 DB 与 BucketType 对应，兼容早期的内建 BucketType（tsdb|logs|bitlog|promdb|vector）
create class if not exists /mdb () with namespace='mdb'
;

-- 全量映射（也可以指定固定条件映射部分数据），
-- 实际类中没有数据
-- 查询时自动赋值默认类属性：
--  class: 类名/mdb/dba1，
--  id:    组合映射表主键为字符串，
--  name:  与id相同，
--  day:   当前日期，
--  vtime: 当前时间
-- rdb 输出为二维数组，兼容 promdb 等已有 bucket 类型
-- rdb 数据 与 id 一一对应，实际 二维数组中的第一维 有且只有 一个元素
-- 支持 bucket 链式表达式
create class if not exists /mdb/dba1 (
	rdb             bucket {
                        -- 全表映射
                        "type"  : "msqldb",
                        -- 指定表名
                        "table" : "T__matrix__test___422YX2FPSXSLVDA9"
                    },
) with nickname='dba1'
;

-- 条件映射
-- 类中需要有数据，按指定条件映射数据，条件与类数据有关联
-- xrdb 输出为二维数组，兼容 promdb 等已有 bucket 类型，输出字段顺序与 bucket 定义的字段顺序一致
-- xrdb 数据 与 id 为多对一关系，默认输出第一条记录，需要在 bucket 定义时明确数据唯一排序，否则数据输出可能不稳定
-- 支持 bucket 链式表达式
create class if not exists /mdb/dba2 (
	
    xvarchar        varchar,
    xint            int,
    xbigint         bigint,
    xdouble         double,
    xdate           date,
    xrdb            bucket {
                        -- 条件映射
                        "type"  : "msqldb",
                        -- 指定结构化查询信息表、字段、条件
                        -- TODO 后期可解析 sql 语句，方便应用开发
                        "table" : "T__matrix__test___422YX2FPSXSLVDA9",
                        "fields": ["字符串", "大整数", "整数", "浮点", {"name":"双浮点","asname":"vdouble"}],
                        "conds" : {
                            "and": [{ -- 多条件组合
                                "like": ["_tokens","%/mtest/%"]},{ -- 常量条件
                                "or": [{
                                    "=": ["name", {"field":"xvarchar"}]},{ -- 变量条件
                                    "=": ["字符串", {"field":"xvarchar"}]},{
                                    "between": ["strftime('%Y-%m-%d',cast(day as integer)/1000.0+28800,'unixepoch')", "2026-01-01", {"field":"xdate"}]}]}]}, -- sql函数支持
                        "orderby" : ["字符串", {"name":"vdouble","reverse":true}] -- 指定排序，保证 last row 输出稳定结果
                        -- TODO "groupby","having"
                    } "rdb test",
    xmap			map<varchar, varchar>,
    xlist			list<varchar>,
    xset			set<varchar>,
    
    indexes(xvarchar, xint, xbigint, xdouble, xmap, xlist, xset),
    keys(xvarchar)
) with nickname='dba2'
;