数据库操作

生成的SQL语法不对，常见的如分页语法

语法不对一般是因为没有正确识别数据库类型造成。或者虽然识别出了正确类型但没有找到相应的适配器。 先检查一下pom中有没有相应的适配器， 如果是mysql需要anyline-data-jdbc-mysql 如果是oracle需要anyline-data-jdbc-oracle 其他数据库类似。 具体原

大模型数据分析之NPL2AnyLine2SQL

NLP2SQL技术的方言兼容性是影响其跨数据库系统落地效果的关键因素。 ‌一、SQL方言差异的根源与影响‌ 不同数据库系统对SQL标准的扩展差异显著，例如： ‌语法结构差异‌：Oracle的ROWNUM伪列、MySQL的LIMIT子句、SQL Server的T

操作各种数据库结构以及读写元数据

操作数据库结构 是指读写各种数据库对象信息，如表、列、索引等 //读取当前数据库中所有表信息, Map<String, Table> tables = service.metadata().tables(); Map<String, Column> columns

关于表分区的两种方式

先创建主表，再创建分区表(如PG) 创建主表时同时创建分区(如Doris) 注意区分几个关键词:of,for,by of:一般用来在创建分区表时，指定主表, by:一般用来在创建主表时，指定分区方式以及根据哪几列分区 for:一般用来在创建分区表时, 指定分

pg分区表-按HASH

Table table = service.metadata().table("user_master", false); if(null != table){ service.ddl().drop(table); } MasterTable master = new MasterTable("u

pg分区表-按枚举值(list)

//根据部门编号 分区 Table table = service.metadata().table("user_master", false); if(null != table){ service.ddl().drop(table); } MasterTable master = new Ma

pg分区表-按时间范围(range)

//根据时间范围分区 Table table = service.metadata().table("log_master", false); if(null != table){ service.ddl().drop(table); } MasterTable master = new Mast

pg分区表-按范围(range)

//根据范围分区 Table table = service.metadata().table("log_master", false); if(null != table){ service.ddl().drop(table); } MasterTable master = new Master

验证数据源是否正常可用

提供了两个方法DataSourceHolder.validity()和hit() 其中hit()会抛出异常，可以捕捉用来显示详细信息 service ServiceProxy/DatasourceHolder/RuntimeHolder都提供了相应的方法 其中service不需要提供参数，因为ser

关于跨库操作与数据源自动复制

在低代码与中台项目中经常需要操作多个数据库的元数据，如查询出所有数据库中的表。 但是需要注意：多个库中可以会出现同名的表。另外也有部分数据库不支持跨库，在每个库中单独维护一份系统表。 在实际业务中一般也不需要多个库的元数据同时显示或重，更多的是按库分类。 为了统一处理，推荐先列出数据库列表，再根

南大通用

GBase JDBC 8.3.81.x 版本之前使用使用 SELECT 别名的情况， ResultSetMetaData.getColumnName()返回的是列的别名。8.3.81.x 之后返回的 是列名。 在 8.3.81.x 版本中可以调用 ResultSetMetaData.getColum

JDBC操作clickhouse示例

ClickHouse适合用于在线分析处理查询（OLAP :Online Analytical Processing）MPP架构的列式存储数据库，能够使用 SQL 查询实时生成分析数据报告。 clickhouse不同于hadoop生态，采用 Local attached storage 作为存储 二、

根据SQL获取元数据信息

根据SQL获取元数据信息 service.metadata(String sql, boolean comment) comment:表示是否需要获取列注释，需要数据库官方驱动的支持 如果需要获取表结构应该用service.metadata().table("表名")//返回列、索引等全部表结构

关于Orcle的MERGE INTO 如果存在重复数据 覆盖或忽略

service.insert(table, set, new DefaultConfigStore().override(true, "ID")); service.insert(table, set, new DefaultConfigStore().override(false, "ID"))

关于分页参数

DataSet set service.querys(table, condition(true)); //分页，参数根据配置文件或PageNaviConfig 当前页数会提取http中的参数 PageNavi navi = set.getNavi(); navi.getTotalPage

MySQL LIMIT OFFSET不支持表达式的问题

发现有个项目里这样写 String sql = SELECT * FROM CRM_USER LIMIT (:page) OFFSET (:page-1)*:vol service.querys(sql, configs) 在Pg里可以正常执行，但返回的DataSet中不包含分页的Pgae

关于PostgreSQL的ON CONFLICT，如果存在重复数据 覆盖或忽略

当执行 INSERT 操作时，如果数据表中不存在对应的记录，执行插入操作；如果数据表中存在对应的记录，则执行更新操作 是否存在可以根据 1.指定列判断 或者2 唯一约束名 Table table = service.metadata().table("CRM_USER"); if(

mysql表结构导入postgres

先用mysql数据源获取表结构 Table table = mysql_service.metadata()table("crm_user") 再用pg数据源创建表 pg_service.ddl().create(table) 需要注意的是：schema和catalog需要根据情况调整一下，一般设置

SQL日志开关及格式

默认情况下可以通过ConfigTable设置全局变量。ConfigStore也提供了类似的配置项，仅对当前流程有效

关于MySQL的insert ignore into和replace into

务必注意，如果执行了replace into会把原数据删除，重新插入新数据，如果有自增主键的话，主键值会变化。  //override=true : replace into //override=false: insert ignore into ServiceProxy.insert

返回SQL方言(DDL/DML/DQL)以及SQL日志

在SQL执行过程中，在控制台或日志文件中会生成带占位符的日志。 如果需要在执行完成后返回SQL,可以在service调用的方法中添加ConfigStore参数 在执行完成后从ConfigStore中获取执行的SQL, 因为执行的SQL可能是多条，所以会返回一个List集合， 默

检测数据源是否正常可连接

检测数据源连接状态 DataSourceHolder.validate(String ds)

insert/update过程中列的控制

默认情况下只会处理不为空的列，更新时不更新主键 由于数据来源多种多样，有可能是从别的表中查询的也有可能从第三系统获取或java中生成， 同一组数据可能需要同时插入不同的表，但列不同，这时需要设置insert/update的列 可以按以规则设置insert与update规则一样 DataRow row

关于不同数据库版本的驱动

有些数据库不同的版本之间差别比较大如 MSSQL2000与MSQL2005+ Oracle9i,10g,11g与Oracle12c+ 这种情况只需要 1.在pom中依赖相应的驱动 2.根据不同版本的规则修改连接url anyline-data-jdbc-mssql中已经包含了2000与2005+运行

ConfigStore分页相关的参数

ConfigStore condition = new DefaultConfigStore(first, last); 注意这里的构造函数提供的起止行数，与mysql中的limit并不一样 如果需要通过mysq limit方式分页可以在创建了ConigStore后调用limit condition

获取列信息的几种方式

// 1直接获取元数据 //sql server 列元数据中不返回表名，所以查不到注释 LinkedHashMap<String,Column> columns = service.metadata("SELECT ID AS USER_ID, ID AS ID, CODE AS US

异构数据源迁移核心部分代码Mysql到Apache Ignite|VoltDB

异构数据源迁移，大概过程就3步，其他细节就看具体情况了 1.在目标库创建表结构 2.从源库中查出数据 3.插入到目标库 举个从Mysql到Apache Ignite的示例 过程中有可能需要合并数据参考，可以通过ConfigStore.override(true)实现【目标库不存在则插入，存在则覆盖或

自定义是查询条件

在低代码平台、可视化数据源、自定义报表等场景中经常需要用到用户自定义查询条件 后台根据用户输入的参数生成查询条件 平时程序员硬编码的很简单的条件如WHERE ID = 1 ，其中只有1是可变参数 ID和等号是固定的 但自定义查询条件的场景中ID,等号,1 这三部分全部由用户提供 过程中可能

druid连接SQL Server异常

在获取schema时会有个异常，换成1.1.15版本试一下

不具备更新条件

默认情况下update方法只会更新值有变化的列，可以调用DataSet(DataRow)的 clearUpdateColumns或者  addAllUpdateColumns 更新除了主键之外所有的列

为什么推荐视图

理由是在用到的时候JAVA和配置文件里都可以临时写。 如果数据量不大，结构不复杂，数据不敏感，只是显示个列表或明细确实没什么大问题。 但是以下实际情况簇不是这样： 既然都需要写SQL了复杂度还是有点的 当然不能拿那些helloworld说事，那些SQL都是多余的 

数据源连接失败后一直重连的问题

这跟连接池有关，一般连接池会有失败重试的参数可以设置，如druid 配置文件 spring.datasource.druid.connectionErrorRetryAttempts = 1  spring.datasource.druid.breakAfterAcquireFailure

ehcache不生效

先看pom有没有添加依赖 org.anyline anyline-data-cache-ehcache

关于分页(不)查询总行数

默认情况下分页前会是查询一次总行数。 但还有场景如数量特别大、下划加载更多等不需要总数或项目中单独维护的总数 可以通过PageNaviConfig.IS_AUTO_COUNT=false 全局设置分页查不计算总数 也可以通过ConfigStore.autoCount(false)或Page

各数据库需要的依赖

每个数据库需要 1 个anyline提供的适配器 + 1 个数据库官方的驱动 适配器参考以下，打开适配器可以查看官方驱动的依赖，因为是provided形式的依赖，所以需要把驱动也复制到自己POM中

先准备基础环境

为精简篇幅，把前置工作以及后续重复的工作在这里说明，后面就不再啰嗦了。

从最简单的查询开始

查一个表的全部数据,和一行数据

查询部分列(属性)

查一个职员列表，因为简介等大文本影响IO,所以只查ID,NAME两列

根据情况生成不同的查询条件(FIND_IN_SET)

仅针对MySQL

不提供参数值的两种特殊情况

如根据类别查询时，如果没有提供类别值。 默认情况下是忽略类别条件 但也有另外两种特殊情况 用NULL或''拼接SQL 中断SQL执行，不返回值或返回空集合

为所有的查询sql统一添加查询条件

注意，这种方式并不适合用于多租户场景。

查询条件默认值

如果http request提供了参数值并且不为空，则按提供的参数值查询，否则按默认值查询。

分页查询

查询排序

Neo4J

NOSQL图形数据库,适合于处理对象之间的关系的场景

GBase

GBase 8c 中可以使用 Database 和 Schema 实现业务的隔离，区别在于 Database 的隔离更加彻底，各个 Database 之间共享资源极少，可实现连接隔离、权限隔离等，Database 之间无法直接互访。 Schema 隔离的方式共用资源较多，可以通过 grant 与re

关于默认的jdbc adapter

public static boolean IS_ENABLE_COMMON_JDBC_ADAPTER= false;   // 是否开启默认的jdbc adapter(仅支持部分标准SQL)遇到没有实现adapter的数据库时可以开启 默认情况下是禁用的，也就是说如果

为什么推荐结果集key强转大写

因为有些情况下容易产生歧义，如userId,userID都合理，在前端调用接口时还需要查文档才能确定， 另外不推荐驼峰格式,因为有些数据库会把列名转成大写

为什么多数据源时又要使用多个独立的一个Service

你可能是希望在当前线程中设置一个变量，通过修改这个变更来干预spring获取的数据源，但这样在遇到线程共享时会发生冲突。 所以设计成每个数据源对应一个service,不需要切换数据源，而是根据情况调用不同的service

为什么集中使用同一个Service

大部分情况下只需要注入一个AnylineService(bean.name="anyline.service")就可以了，但两种情况除外 有复杂的业务逻辑，这时应该有对应的service,如果只是分组、求和等简单的数学计算用默认的service就可以 多数据

DriverAdapter

DriverAdapter用来适配不同的数据源驱动，根据数据源类型生成不同的执行命令(如果是支持JDBC的数据源就是SQL和参数) 多数据源适配过程： 系统启动时会把pom中依赖的所有adapter注册到spring上下文环境中 注册数据源时会定义一个key,切换时根据这个key切换 在执行生成

关于查询分区表(子表)性能

查询分区表可以按分区表名称也可以按主表(超表)查询，分别适用不同的场景

流式查询

默认情况下查询数据会把符合条件的数据一次性读到内存中，但是在大数据处理时会比较耗时甚至内存溢出。在这种情况下可以启用流式查询。返回一个迭代器。在迭代器中执行业务处理。 handler支持4种形式,按性能排序ResultSet>Map>DataRow>Entity 其中ResultS

关于ands

最初ands是为了生成in条件，但and已经可以识别集合条件自动生成IN， 2023-10-21后 ands改成了与ors类似的效果，即把之前所有的条件放在一个()内,然后and this

pg分区表-多级分区

进口数据多个国别，多个年份，原始结构如下 ID 年份 国别 品类 金额 1 2001 法国

为什么查一个表的结构时，在日志中会发现要查询出所有的表

因为不同的数据库配置不一样，查出出来的结果有可能大写有可能小定，如mysql这样的数据库，有些人安装完了也不配置直接上线，就会导致区分大小，这时表名crm_user与CRM_USER是不一样的。如果大小写没写对根据表名是查不到结果的。 所以会先把所有表查出来放到一个Map中以表名大小作为key,这样

补充最简单的示例源码

【源码】 多余的依赖一个没有，pom也没有继承

未注册数据源:common

一般在初次测试时会遇到这种问题，正式的开发环境不会遇到 在上文中没有找到spring jdbc template实例时会抛出这个异常。 jdbctemplate一般是连接池插件例化的，springboot2，3环境下默认使用HikariCP连接池(org.springframework.boot:s

关于集合(数组)参数值

集合(数组)参数值在IN，NOT IN等可以接收多个值的查询条件中，所有条目都将参与执行。否则只有第0个条目参与执行. 如 DataRow row= new DataRow(); row.put("NAME",  "1,2,3".split(",")); service.save

关于数据库名称的中划线(减号)引起的语法错误

首先建议把中划线去掉，命名时不要用中划线。如果控制不了的话可以打开界定符 在启动类的spring启动前前加 ConfigTable.IS_SQL_DELIMITER_OPEN = true 或者在spring配置文件中加 anyline.sql-delimiter-op

未指定列(DataRow或Entity中没有需要更新的属性值

说明没有可插入的值 注意检查 是否开启了 IS_AUTO_CHECK_METADATA  会检测列名是否存在表中，如果不存在则忽略 是否开启了 public static boolean IS_UPDATE_NULL_COLUMN = false ; // 是否更新n

指定数据库类型

数据库类型是不需要指定的，经常有这搜索个问题所以说明一下内部是如何判断数据库类型的

为什么保存实体对象时驼峰会自动转成下划线格式

为什么保存实体对象时驼峰会自动转成下划线格式

关于默认主键

在默认情况下，更新数据时以ID作为主键。
可以通过ConfigTable.DEFAULT_PRIMARY_KEY = "CD" 或配置文件统一修改

在实际业务中经常需要根据其他列来执行批量修改可以通过
DataRow或DataSet的setPrimaryKey("user_id")来设置新的主键,这样可以实现按user_id批量更新数据

service.update(DataRow)只更新值有变化的列

service.update(DataRow)只更新值有变化的列

DataRow与Map的区别

DataRow是继承自Map所以Map有的方法DataRow都有， 并且对Map进行了改造和扩展，主要有: 改造了get/set方法，在get/set执行前会先检测key,以实现忽略大小写、下划线、驼峰等格式，效果就是get("userid") get("userId") get("user_id"

getColumns与getMetadatas区别

getColumns返回的是DataRow中查询出来的列属性 getMetadatas返回的是整个表的列属性 如CRM_USER表中有三列，ID,NAME,AGE DataRow row = service.query("CRM_USER(ID,NAME)"); 这时getMetadatas会返回3

环境检测场景中的几个动态表单示例

这里只是后格式转换部分,插入到word参考【anyline office】，最困难的是前端怎么把这个规则告知后端（大概思路是先定义几种规则让用户来选，比如横向显示什么，竖向显示什么，每行最多几列） 先看源数据 主键

DataSet分页

DataSet set = new DataSet(); List pages = set.page(10) //每页10行，分成多少页根据总数 List pages = set.split(10)//分成10页，每页多少行根据总

Entity中的集合(数组)属性保存到数据库中

Entity中的集合(数组)属性保存到数据库中["A","B","C"]与A,B,C格式 如果数据库中是JSON格式则会保存成["A","B","C"]格式 如果数据库中是vachar类型则默认会保存成A,B,C格式(为了方便 findinset函数执行)，如果需要保存成["A","

Entity(Field)与Table(Column)的对应关系

在有些场景中可能需要用到实体类。如: DataRow(DataSet)与Entity相互转换。 查询返回Entity或集合 根据Entity保存或更新数据 这时需要确定Entity与Table的对应关系，以及Field与Column的对应关系 默认情况下anyline根据DefaultEntityA

EntityAdapter接口说明

EntityAdapter主要用来实现实体类与表，属性与列之间的转换。 系统自带一个默认的EntityAdapter，每个项目也可以提供定制的EntityAdapter，参考【EntityAdapter定制】 在执行转换时会按顺序调用,直到成功为止，顺序以EntityAdapter.order()方

EntityAdapter定制

自定义EntityAdapter需要实现EntityAdapter接口，其中的每个方法在接口中都有默认实现，只需要实现需要修改的接口即可，同时需要交给spring管理，一般是加一个@Component注解 如果不针对所有的类，而只针对具体的类，可以覆盖type()方法返回具体的Class或覆盖typ

关于json、object、arry等非基础类型属性

对于非基础类型属性，在数据库可以用json类型。 在插入或更新数据时会把属性值转换成json格式，同样的读取数据时也会把json格式还原成属性对应的数据类型。 需要注意的是，在插入数据时数据需要先知道数据库中是JSON类型才会转换。 这样就需要开启一个开关，来保证插入数据前先检查数据库结构。当然这个

Data truncation: Cannot create a JSON value from a string with CHARACTER SET 'binary'

出现这个异常是因为视图把json类型保存到数据库中，一般来说数据库会设置一个JSON类型。 但在页mysql驱动对json的sql类型会要求一个String类型的数据, 需要打开ConfigTable.IS_AUTO_CHECK_METADATA  = true ,这样

属性关联表主键生成器注解

通常情况下通过配置文件设置一个统一的主键生成器就可以，但如果有一部分表需要单独设置 一种方式是可以通过配置文件单独指定 另一种方式可以通过注解设置 另外一些属性的关联表的主键生成器也可以通过注解设置,这种情况比较特殊在其他JPA中一般不这样用 @Table(name="HR_EMPLOYEE")

upsert(已存在则更新或跳过，中不存在则插入)

在数据中台、数据同步场景中经常有这种需求，如果数量少可以清空后再全量同步一次，这样最省心。也可以插入前检测一下数据是否存在。 在如果数量很大，以方式显然不可取，如果自己实现一般是通过索引(性能)+存储过程(一次交互)实现 当然许多数据库都对这种场景提供了原生支持。用过ORM实现过这种

关于Apache ignite的MERGE 如果存在重复数据 覆盖或忽略

public static void override() throws Exception{ String tab = "tab_override"; Table table = service.metadata().table(tab); if(null != table){ serv

insert/update Map时大小写的问题

在insert/update时如果提供的是List<Map>或Map参数时有可能因为Map的key与列名不一致导致取值失败的问题。因为map严格区分大小写，put("id",1)用get("ID")当然是取不出来了 如果大小写不一致，可以转换成DataSet<DataRow>

sequence

BigDecimal next = service.sequence("SIMPLE_SEQ"); DataRow nexts = service.sequences("SIMPLE_SEQ", "SIMPLE_SEQ2"); BigDecimal cur = service.sequence(fa

删除数据的几种场景

删除会有以下几类情况 1.先查出数据，再执行删除 2.直接执行SQL 3.根据约定参数删除 4.复杂条件可以构造ConfigStore 源码请参考 https://gitee.com/anyline/anyline-simple/tree/master/anyline-simple-d

插入数据后返回主键值

插入数据后返回主键值

关于查询结果集单行与多行的问题

简易方式指定数据源和主键

service.querys("table(col1,col2)") <数据源>放在开头 <主键>放在结尾 ds_sso表示数据源 ID,CODE表示主键

多数据源场景中service注入失败

如果是单个数据源默认情况下AnylineController中已经默认注入了一个AnylineService service;这个service可以操作多个数据源bean.id = @Service("anyline.service") 但是在多数据源情况下，为了更强的隔离性，避免线程共享

插入记录时自动建表

DataSet set = new DataSet(); Long fr = System.currentTimeMillis(); for(int i=0; i<10; i++){ DataRow row = set.add(); row.put("ID", fr+i); row.pu

查询返回指定列

默认情况下查询*也就是查询所有列，但如果表中有大文本会影响性能，可以在表名后加列名来控制查询和返回内容 service.querys("user(id,code)") 生成SQL SELECT id, code FROM user

关于几个 空值 的查询示例

//service.query("crm_user", "+id:null"); // ID IS NULL //service.query("crm_user", "+id:");     // ID IS NULL //以上两种情况 经常是通过变量拼接出来如 "+i

根据所有String类型模糊查询

ConfigStore configs = new DefaultConfigStore(); configs.likes("Z"); ServiceProxy.service().querys("CRM_USER",configs); 会检测目标表中有哪些列是String类型的，生成OR LIKE

metadata缓存

在执行DDL时，需要频繁的读取表结构等元数据，非常耗时，所以会添加一层缓存。 也是就是不会每次都从数据库中读取数据。 以下3种情况会清空缓存： 1.缓存过期 2.执行DDL 3.调用CacheProxy.clear()  这样会存在一个问题。如果表结构还在

遇到anyline没解析或极特殊类型怎么处理

定义列我们一般分成三部分 名称，数据类型，其他属性如果遇到一些anyline没有处理的特殊类型,如set('X','Y','Z') 等这种类型Column对象没有对应的属性可以配置，这种可以直接设置new Column("col_name").setFinalType("set('X','

DataSet/DataRow.getMetadatas

DataSet set = service.querys("表"); set.getMetadatas()会返回列的一些属性，正常情况下只会返回一些基本属性，不会再额外查询列的详细信息，因为那样需要再发起更多的查询，而大部分情况下是不需要列的详细数据的，如列的注释， 如果确实需要可以打开Config

获取表或视图的DDL

//查询表结构时，默认会查询DDL Table table = service.metadata().table("CRM_USER") List ddls = table.ddls(); 对于确认只有一条SQL的数据库可以 String ddl = table.ddl(

查询表上的索引

查询crm_user表上的索引 LinkedHashMap indexs = service.metadata().indexs("crm_user"); for(Index item:indexs.values()){ System.out.printl

修改表名

Table table = service.metadata().table("新表名"); table.update().setName("新表名"); service.ddl().save(table); 注意表名相当于一个表的唯一标识，所以不是直接table.setName(),这样会定位不到

修改列属性(类型兼容)

表中没有数据的情况 一般可以正常修改 但部分数据库有些类型之间不可修改 表中有数据的情况 可能造成值类型不兼容，如果需要自动修改需要开启 //ConfigTable.AFTER_ALTER_COLUMN_EXCEPTION_ACTION // 0:中断执行 // 1:直接修正 // n:行数n时触发另一个监听(默认返回false)

修改列名

//修改列名2种方式 //注意:修改列名时，不要直接设置name属性,修改数据类型时，不要直接设置typeName属性,因为需要原属性 // 1.可以设置newName属性(注意setNewName返回的是update) column.setNewName("B_TEST").setTypeN

修改主键

Table table = service.metadata().table("TEST_PK"); Column pcol = table.addColumn("PKID", "int"); PrimaryKey pk = new PrimaryKey(); pk.addColumn(pcol);

删除列

1.保存表时 在指定列上标记删除 2.保存表时删除数据库中有，但表结构中没有的列 3.直接删除列

关于主键的创建修改删除

创建主键 可以在添加列时就指定当前列作为主键  table.addColumn("ID", "INT").setPrimary(true);  table.addColumn("CODE", "INT").setPrimary(true); 也可以在表上单独设置主键 table

关于列的排序

创建表时会根据position自动排序，如果没有设置position属性则排到最后，如果都没有设置则按添加顺序 table = new Table("表名"); table.addColumn("C2","INT").setPosition(2); table.addColumn("C1","INT

DDL保存表结构时，删除列和添加列

如数据库中原来有3列，C1,C2,C3 保存结构时只提供了C3,C5 在默认情况下 修改C3,添加C5 C1,C2保持不变 打开 ConfigTable.IS_DDL_AUTO_DROP_COLUMN = true 删除C1,C2 修改C3,添加C5

anyline-mvc禁用jdbc环境

最近遇到有些项目需要anyline-mvc但不需要数据库环境 因为anyline-mvc的AnylineController中依赖了anyline-data-jdbc的ConfigStore,所以anylie-data-jdbc被依赖进来了，而anylie-data-jdbc中的DefaultDao

多个ConfigStore合成一个ConfigStore

在代代码，运行时自定义场景中，经常会调用不同的方法生成多个ConfigStore也就是多组查询条件 但在调用service.querys时只能接收一个ConfigStore 解决方式： 生成一个ConfigStore 在合成查询条件时把ConfigStore作为参数输入，通过

复杂条件的合成

ConfigStore a1 = new DefaultConfigStore().and( "id11", 11).and("id12", 12); ConfigStore a2 = new DefaultConfigStore().and( "id21", 2

关于函数操作

在查询条件和查询列中经常需要函数，当然这样查询对性能影响非常严重，只是举例说明一下语法 SELECT  id,to_char(reg_time,'yyyy-mm') as ym FROM crm_user WHERE char(reg_time,'yyyy-mm-dd') LIKE

condition参数与query参数的混淆

在controller中查询数据时经常会用到： String status = "FINAL"; service.query("CRM_USER", condition(true, "TYPE_CODE:type"), "DATA_STATUS:"+status); 实际执行的

关于分页参数

AnylineController中提供了condition(boolean navi)用来根据前端提交的数据封装分页参数 经常要用到两个参数 1.当前第几页 2.每页多少条 默认情况下这两个参数值比较长，是为了避免与其他业务参数冲突。定义在PageNaviConfig中 public static

OR查询条件

应用场景:同一个输入框中输入用户编号或用户姓名或手机号都可以查到指定用户,以上参数会通过同一个key提交到后台

关于数组参数值

标准的url中一般是这样http://127.0.0.1/list?id=1&id=2&id=3 或者用form表表单提交三个name=id的input 也可以提交json格式{id:[1,2,3]} 以上三种情况condition("ID:[id]")都可以解析成WHERE I

关于自定义SQL中的变量赋值

String sql = "SELECT * FROM CRM_USER WHERE CODE = :PARAM_CODE"; DataSet set = service.querys(sql, "PARAM_CODE:1"); //生成SQL SELECT * FROM CRM_USER WHERE CODE = 1 //特别注意这以下情况 CODE:1与SQL中的变量匹配不成功时，SQL会

XML中自定义复杂SQL

文件格式: SELECT M.I

数据源覆盖

在注册动态数据源时，如果key相同会覆盖原来的数据源，但是需要打开spring配置spring.main.allow-bean-definition-overriding=true 否则会抛出异常Invalid bean definition with name 'anyline.jdbc.temp

数据源注销

可以主动注销，DataSourceHolder.destroy(key); 实际最终调用的是JDBCRuntimeHolder.destroy(key);因为这时不只是要注销数据源了，相关的bean都要一块注销 在注册同名数据源时也会自动注销

关于临时数据源连接泄漏的问题

无论是什么数据源都会配置一个连接池，在一个命令执行完后，相关的连接会放回连接池待下一个命令复用 这里只是放回了连接池，并没有真正释放连接，也就是没有与数据库断开连接。 只有在注销数据源时，才会把连接池中的连接彻底断开。 但临时数据时没有提供注销的功能，如果需要注销的话应该使用正

缓存有效期和刷新频率

如果设置了缓存时间100秒有效，再前90(90%*100)秒内会从缓存中提取数据 第90秒后的第一次也从缓存中提取数据，同时开启子线程刷新缓存

关于DDL与事务控制

MySQL的DDL语句是非事务的，即不能对DLL语句进行回滚操作 并且在执行到DDL语句时，会隐式的将当前回话的事务进行一次“COMMIT”操作，也就是说之前未提交的事务会被提交。 因此在MySQL中执行DDL语句时，应该严格地将DDL和DML完全分开，不能混合在一起执行

日期类型

有些数据库对数据类型要求比较严格，不能隐式转换，这时需要开启        ConfigTable.IS_AUTO_CHECK_METADATA = true; 这样在插入数据前可以检测列的数据类型，检测到数据类型才能实现正确的格式转换 例如Oracle

多数据源注解事务异常 found 2:anyline.transaction

在多数据源情况下，通过注解控制事务会报这个异常 org.springframework.beans.factory.NoUniqueBeanDefinitionException: No qualifying bean of type [TransactionManager] is defined:

多数据源事务控制

这里说的是有多个数据源，并且多个数据源需要控制事务。【为会么要创建多个事务管理器】 如果然后有多个数据源，但只需要控制主数据源的事务，不要往下看只需要参考【多数据源注解事务异常】 分两种情况说明 一、需要控制事务的方法内部不需要切换数据源。并且编码阶段已经可以确认是哪个数据源  

为会么要创建多个事务管理器

在多数据源的情况下会生成多个事务管理器。 为了更强的隔离性。否则数据源切换过程中，不好跟踪事务，如果遇到线程共享时，切换数据源也有可能失败，那事务管理器肯定就乱了。 为了在切换数据源过程中，保持事务状态。就是不要因为切换数据源，而把上一个事务强制提交或回滚。

多数据源事务管理器bean.name

在存多数据源的情况下会创建多个事务管理器【为会么要创建多个事务管理器】 事务管理器在spring上下文环境中的命名也就是bean.name 如在默认数据源之外 又创建多个数据源a,b,c spring会针对默认数据生成一个默认事务管理器:transactionManager anyline

数据库读、写过程中的类型转换

读取数据库的过程中，驱动类从数据库中读取出数据后，会有一步类型转换的过程，通常情况下内置的DataReader可以满足大部分的情况， 但如果遇到特殊情况比如希望转换成项目定义的类型,这时需要注册一个自定义的DataReader 可以调用DefaultDriverAdapter静态方法 /*

数据类型之间的转换

在生成SQL的过程中，如果没有占位符，数字类型一般可以直接拼接，String类型需要加单引号， 而日期类型有些数据库可以实现隐式转换，加单引号即可，有些数据库不能实现，需要内置函数转换成日期类型 还有些更复杂的类型类byte,json,array,geometry等类型更需要内置函数 如果有占位符

插入数组类型

pg数组库支持数组类型，在定义时可以这样 table.addColumn("TYPE_IDS", "INT[]"); //在原型基础上加[] 插入数组类型时，需要设置这一列的数据类型，否则会把数组拆开只取下标0的条目，因为不知道数据库中是数组类型 可以打开ConfigTable.IS_AU

Neo4j基础操作

//以下说到的标签相当于关系型数据库中的表 //原生CQL创建节点 service.execute("create (d:Dept{name:'财务部', leader:'张三'})"); //创建多标签(表)节点 service.ex

MongoDB基础操作

DataSet set = new DataSet(); Long fr = System.currentTimeMillis(); for(int i=0; i<10;i ++){ MongoDataRow row = new MongoDataRow(); row.put("_id"

entity()根据表结构获取request提交的参数

entity()根据表结构获取request提交的参数

关于后台日志输出

ConfigTable提供了以下开关用为控制日志输出，系统启动时后台会输出的AnyLine版本信息 可以通过IS_DEBUG=false关闭 ConfigTable属性与配置文件一一对应,配置项参考AnylineProperty public static boolean IS

[检测数据库适配器][检测其他可用的适配器失败][可能没有依赖anyline-data-jdbc-*或没有扫描org.anyline包]

如果后台日志提示[检测数据库适配器][检测失败][检测其他可用的适配器] 说明根据数据源连接信息没有找到合适的适配器(这个适配器用来为不同的数据库生成特定的SQL) 如连接信息中是 mysql数据库，但没有依赖anyline-data-jdbc-mysql 也有可能没有扫描org.anyline这个

关于JSON数据类型

如果属性是Entity或List 类型，数据库中是json类型，在执行插入或更新时会把属性转换成json(String) 相应的在从数据库中查询结果时，会把json类型转换成Entity或List 实例

关于BLOB数据类型

1.通常情况下数据库的blob类型会对应entity的byte[]类型 2.有些情况下数据库是blob类型，而entity的属性是String类型

AnylineService

动态注册多数据源

动态注册多数据源

为什么有时update sql不执行

如果DataRow是通过查询数据库创建的，并且其中的值没有更新，则执行service.update时不会执行更新SQL

数据库操作

org.anyline.service.AnylineService提供了常用的数据库操作接口，其中insert,update,delete,execute比较简单也容易理解 而select操作相对灵活的多， public DataSet selects(String src, ConfigStore configs, String ... conditions); public Data

关于必须条件

 以“+”开头表示当前条件必须拼接 如condition("+NM:nm") 如果客户端提供了nm值，如http://localhost?nm=zh 则正常生成SQL:  SELECT * FROM TAB WHERE NM = 'zh' 如果没有提供nm值,如如http://localhost或 http://local?nm= 则生成SQL: 

关于IN条件

关于IN条件

关于默认值

关于默认值

关于or

OR条件构造相关复杂 可以根据http参数生成OR条件 或在java中取值生成OR条件

关于like

关于like

save与insert区别

save与insert区别

查询时设置主键

查询时设置主键

切换数据源

//用表示数据源,执行完成后会自动切换回默认数据源 service.query("crmcrm_customer"); service.query("HR_DEPARTMENT"); //这里查的还是默认数据源 service.query("erpmm_material"); try { //动态注册一个数据源 //数

前端未提交数据情况下清空一列值

默认情况下前端不传值时，执行update时并不更新这一列 如 DataRow row = entity("ID:id","REMARK:remark","NAME:name"); service.save(row); 这时如果没有提交remark参数值，或remark值为空时，并不更新REMARK列 但有些情况下是前端需要清空一个属性值，有以下种方式 1.提交一个"NULL"的值 2.指定必须更新

AnylineService注入失败

还有可能没有依赖spring-jdbc，因为anyline以是provided形式依赖的，是为了方便项目修改版本。（更多provide依赖参考这里） 如果是spring-mvc项目可以依赖这个 <dependency> <groupId>org.springfram

关于几种OR条件查询的情况

//以下三种格式,只有cd取值成功时，条件才生效 //当cd=1,id=2时 WHERE CODE = 1 OR CODE =2 //当cd=null,id=2时 条件不生效 //当cd=1,id=null时 WHERE CODE = 1 service.querys("HR_USER", condition("CODE:cd|id")); //当cd=1时 WHERE CODE =1 OR

IN条件下多种参数格式的接收

对于标准的url格式 /list?id=1&id=2 以及标准的json格式 {id:[1,2]} 可以通过condition("ID:[id]")的形式接收 对于非标准格式如 /list?id=1,2 可以通过condition("ID:[split(id)]")的形式接收 最终都是生成SQL  WHERE ID IN(1,2)

关于分页参数

默认的分页参数名比较长: public static String DEFAULT_KEY_PAGE_ROWS = "_anyline_page_rows" ; //设置每页显示多少条的key public static String DEFAULT_KEY_PAGE_NO = "_anyline_page" ; //设置当前第几页的key public static

关于自动检测表结构

在执行数据库操作时，许多参数是以String形式获取到的,无法参数识别数据类型，如url中的参数 还有一些数据类型在Java中没有对应关系,如xml/josn/几何图形等 而有些数据库在执行SQL时会执行强类型检测。 不像我们平时用的MySQL在执行时会进行隐式转换，无论什么类型只要能转换成功就可以执行。 而PostgreSQL则要求jdbc参数与表结构对应，如果在va

关于更新部分属性(列)、忽略部分属性(列)

在实际操作中经常需要更新指定的列，或者忽略更新指定的列

关于insert或update时确定哪些列参与到insert或update中

关于insert或update时确定哪些列参与到insert或update中

关于neo4j返回值的数据结构

MATCH (n:User) RETURN n; [ {n:{id:1,name:''}}, {n:{id:2,name:''}}, {n:{id:3,name:''}} ] 而 service.querys("User"); 返回 [ {id:1,name:''}, {id:2,name:''}, {id:3,name:''} ]

查询数据库返回的数据字段全是大写，字段怎么设置返回小写

可以通过ConfigTable设置全局参数 ConfigTable.IS_LOWER_KEY = true; ConfigTable.IS_UPPER_KEY = false;

entity接收request参数

entity接收request参数

数据库适配

MySQL PostgreSQL Oracle SQL Server MariaDB IBM DB2 clickhouse sqlite 达梦 tdengine derby H2 hsqldb 人大金仓 Ope

几个分页查询的示例

比较常用的分页是在controller中通过condition设置 service.querys("user", condition(true, "其他条件")) 这里的true表示需要分页 service.querys("user", condition(20, "其他条件"))&nbs

SQL中的变量及占位符格式

SELECT * FROM CRM_USER WHERE ID = :ID  以:标识的执行时直接替换  以::标识的执行时以?占位   NAME LIKE :NM + '%'   (NAME = :NM)   NAME = ':NM'   NM IN (:NM)  

临时数据源操作

临时数据源操作可以通过ServiceProxy创建临时service 执行完后GC会自动回收，不需要像DataSoureHolder.reg注册的数据源那样 通过RuntimeHolder.​.destroy注销

切换数据源失败可能的原因

切换数据源失败可能的原因 有可能缺少注解@Import(org.anyboot.jdbc.ds.DynamicDataSourceRegister.class)

三种方式切换数据源

切换数据源有两种试: 1.使用通用AnylineService实例 1.1)通过DataSourceHoldersetDataSource("crm")方式设置当前数据源,再调用service.query等方法操作数据库 1.2)service.query("USER");在表名前添加数据源名称 2.通过ServiceProxy返回数据源对应的service(推荐使用这一种方式,隔离性更强,不容易混淆​)

动态多数据源切换实现原理

2023-03-31之前： 首先这里的数据源切换要依赖spring-jdbc环境，jdbc执行之前会调用AbstractRoutingDataSource实现类的determineCurrentLookupKey() 决定使用哪个数据源 所以我们提供了org.anyline.data.j

关于POINT类型

如果是Entity 或者用org.anyline.entity.Point类型 或者用double[] 或Double[] 但是要关闭这个开关 ConfigTable.IS_AUTO_SPLIT_ARRAY = false; 关闭的后果是 更新数据库时 不能把数组值赋值给一列（原

parpare/before/after触发顺序

interceptor.parpare(干预修改SQL条件一般在这一步执行) listener.parpare(干预修改SQL条件也可以在这一步执行) 构造SQL interceptor.before listener.before 执行SQL listener.after interceptor.after