集成测试包括 3 个模块:测试用例、测试环境以及测试引擎。
用于定义待测试的 SQL 以及测试结果的断言数据。 每个用例定义一条 SQL,SQL 可定义多种数据库执行类型。
用于搭建运行测试用例的数据库和 ShardingSphere-Proxy 环境。 环境又具体分为环境准备方式,数据库类型和场景。
环境准备方式分为 Native 和 Docker,未来还将增加 Embed 类型的支持。
当前默认采用 Native 环境,使用 ShardingSphere-JDBC + H2 数据库运行测试用例。
通过 Maven 的 -P -Pit.env.docker
参数可以指定 Docker 环境的运行方式。
未来将采用 Embed 环境的 ShardingSphere-JDBC + MySQL,替换 Native 执行测试用例的默认环境类型。
数据库类型目前支持 MySQL、PostgreSQL、SQLServer 和 Oracle,并且可以支持使用 ShardingSphere-JDBC 或是使用 ShardingSphere-Proxy 执行测试用例。
场景用于对 ShardingSphere 支持规则进行测试,目前支持数据分片和读写分离的相关场景,未来会不断完善场景的组合。
用于批量读取测试用例,并逐条执行和断言测试结果。
测试引擎通过将用例和环境进行排列组合,以达到用最少的用例测试尽可能多场景的目的。
每条 SQL 会以 数据库类型 * 接入端类型 * SQL 执行模式 * JDBC 执行模式 * 场景
的组合方式生成测试报告,目前各个维度的支持情况如下:
因此,1 条 SQL 会驱动:数据库类型(5) * 接入端类型(2) * SQL 执行模式(2) * JDBC 执行模式(2) * 场景(4) = 160
个测试用例运行,以达到项目对于高质量的追求。
模块路径:shardingsphere-test/shardingsphere-integration-test/shardingsphere-integration-test-suite
SQL 用例在 resources/cases/${SQL-TYPE}/${SQL-TYPE}-integration-test-cases.xml
。
用例文件格式如下:
<integration-test-cases>
<test-case sql="${SQL}">
<assertion parameters="${value_1}:${type_1}, ${value_2}:${type_2}" expected-data-file="${dataset_file_1}.xml" />
<!-- ... more assertions -->
<assertion parameters="${value_3}:${type_3}, ${value_4}:${type_4}" expected-data-file="${dataset_file_2}.xml" />
</test-case>
<!-- ... more test cases -->
</integration-test-cases>
expected-data-file
的查找规则是:
dataset\${SCENARIO_NAME}\${DATABASE_TYPE}\${dataset_file}.xml
文件;dataset\${SCENARIO_NAME}\${dataset_file}.xml
文件;dataset\${dataset_file}.xml
文件;断言文件格式如下:
<dataset>
<metadata>
<column name="column_1" />
<!-- ... more columns -->
<column name="column_n" />
</metadata>
<row values="value_01, value_02" />
<!-- ... more rows -->
<row values="value_n1, value_n2" />
</dataset>
${SCENARIO-TYPE}
表示场景名称,在测试引擎运行中用于标识唯一场景。
${DATABASE-TYPE}
表示数据库类型。
目录:src/test/resources/env/${SCENARIO-TYPE}
scenario-env.properties
: 数据源配置;rules.yaml
: 规则配置;databases.xml
: 真实库名称;dataset.xml
: 初始化数据;init-sql\${DATABASE-TYPE}\init.sql
: 初始化数据库表结构;authority.xml
: 待补充。目录:src/test/resources/docker/${SCENARIO-TYPE}
docker-compose.yml
: Docker-Compose 配置文件,用于 Docker 环境启动;proxy/conf/config-${SCENARIO-TYPE}.yaml
: 规则配置。Docker 环境配置为 ShardingSphere-Proxy 提供了远程调试端口,可以在 docker-compose.yml
文件的 shardingsphere-proxy
中找到第 2 个暴露的端口用于远程调试。
通过配置 src/test/resources/env/engine-env.properties
控制测试引擎。
所有的属性值都可以通过 Maven 命令行 -D
的方式动态注入。
# 场景类型,多个值可用逗号分隔。可选值:db, tbl, dbtbl_with_replica_query, replica_query
it.scenarios=db,tbl,dbtbl_with_replica_query,replica_query
# 是否运行附加测试用例
it.run.additional.cases=false
# 配置环境类型,只支持单值。可选值:docker或空,默认值:空
it.cluster.env.type=${it.env}
# 待测试的接入端类型,多个值可用逗号分隔。可选值:jdbc, proxy, 默认值:jdbc
it.cluster.adapters=jdbc
# 场景类型,多个值可用逗号分隔。可选值:H2, MySQL, Oracle, SQLServer, PostgreSQL
it.cluster.databases=H2,MySQL,Oracle,SQLServer,PostgreSQL
标准测试引擎
运行 org.apache.shardingsphere.test.integration.engine.${SQL-TYPE}.General${SQL-TYPE}IT
以启动不同 SQL 类型的测试引擎。
批量测试引擎
运行 org.apache.shardingsphere.test.integration.engine.dml.BatchDMLIT
,以启动为 DML 语句提供的测试 addBatch()
的批量测试引擎。
附加测试引擎
运行 org.apache.shardingsphere.test.integration.engine.${SQL-TYPE}.Additional${SQL-TYPE}IT
以启动使用更多 JDBC 方法调用的测试引擎。
附加测试引擎需要通过设置 it.run.additional.cases=true
开启。
./mvnw -B clean install -f shardingsphere-test/shardingsphere-integration-test/pom.xml -Pit.env.docker -Dit.cluster.adapters=proxy,jdbc -Dit.scenarios=${scenario_name_1,scenario_name_1,scenario_name_n} -Dit.cluster.databases=MySQL
运行以上命令会构建出一个用于集成测试的 Docker 镜像 apache/shardingsphere-proxy-test:latest
。
如果仅修改了测试代码,可以复用已有的测试镜像,无须重新构建。使用以下命令可以跳过镜像构建,直接运行集成测试:
./mvnw -B clean install -f shardingsphere-test/shardingsphere-integration-test/shardingsphere-integration-test-suite/pom.xml -Pit.env.docker -Dit.cluster.adapters=proxy,jdbc -Dit.scenarios=${scenario_name_1,scenario_name_1,scenario_name_n} -Dit.cluster.databases=MySQL