website/_dev/howto_test.cn.md - kylin - Git at Google

 ---
 layout: dev-cn
 title:  "如何测试"
 categories: development
 permalink: /cn/development/howto_test.html
 ---

 一般来说，应该有单元测试来涵盖个别 classes；必须有集成测试来涵盖端到端的场景，如构建，合并和查询。单元测试必须独立运行（不需要外部沙箱）。

 ## 测试 v1.5 及以上

 * `mvn clean test` 运行单元测试，它的测试覆盖范围有限。
     * 单元测试没有额外的依赖且能在任何机器上运行。
     * 单元测试不覆盖端到端的场景，如构建，合并和查询。
     * 单元测试只需几分钟即可完成。
 * `dev-support/test_all_against_hdp_2_4_0_0_169.sh` 运行集成测试，有很好的覆盖率。
     * 集成测试 __最好运行在 Hadoop 沙箱上__。我们建议您在沙箱中检出一个代码副本，并在其中直接运行 test_all_against_hdp_2_2_4_2_2.sh。如果您不想在沙箱上添加代码，请参阅 __更多关于 V1.5+ UT/IT 分离__ 的内容。
     * 正如名称所示，脚本仅适用于 HDP 2.4.0.0-169.2，但您可以从中理解集成测试是如何运行的。
     * 集成测试从生成随机数据开始，然后构建 Cube、合并 Cube，最后查询结果并与 H2 引擎进行比较。
     * 集成测试需要一到两个小时才能完成。
 * `nohup dev-support/test_all_against_hdp_2_4_0_0_169.sh < /dev/null 2>&1 > nohup.out &` 以无人值守的方式运行集成测试。

 ## 更多关于 V1.5 UT/IT 分离

 运行 `mvn verify -Dhdp.version=2.4.0.0-169` （假定您运行在 HDP 2.4 沙箱上）是运行完整的所有测试套件所需的全部内容。

 它将按顺序执行以下步骤：

     1. Build Artifacts
     2. Run all UTs (takes few minutes)
     3. Provision Cubes on the sandbox environment for IT uasge (takes 1~2 hours)
     4. Run all ITs (takes few tens of minutes)
     5. Verify jar stuff

 如果您的代码改动很小那么只需要运行 UT，使用：
 `mvn test`
 如果您的沙箱已经配置，并且您的代码更改不会影响沙箱配置的结果，（并且您不想等待数小时的配置），只需运行以下命令来单独运行 UT 和 IT：
 `mvn test`
 `mvn failsafe:integration-test`

 ### Cube 配置

 测试用的 cube 配置确实会运行 kylin cube 作业，以在沙箱中准备样例 cube。这些准备好的 cubes 将会被集成测试使用，当前准备步骤与 maven 预集成测试阶段绑定，且其包含运行 BuildCubeWithEngine（需要 HBase），BuildCubeWithStream（需要 Kafka）。您可以在沙箱或进行开发的计算机中运行 mvn 命令。对于后者情况您需要在 __$KYLIN_HOME/examples/test_case_data/sandbox/kylin.properties__ 中设置 kylin.job.use-remote-cli=true。
 尝试将 `-DfastBuildMode=true` 附加到 mvn verify 命令，通过跳过增量 Cubing 来加速配置。
	---
	layout: dev-cn
	title: "如何测试"
	categories: development
	permalink: /cn/development/howto_test.html
	---

	一般来说，应该有单元测试来涵盖个别 classes；必须有集成测试来涵盖端到端的场景，如构建，合并和查询。单元测试必须独立运行（不需要外部沙箱）。

	## 测试 v1.5 及以上

	* `mvn clean test` 运行单元测试，它的测试覆盖范围有限。
	* 单元测试没有额外的依赖且能在任何机器上运行。
	* 单元测试不覆盖端到端的场景，如构建，合并和查询。
	* 单元测试只需几分钟即可完成。
	* `dev-support/test_all_against_hdp_2_4_0_0_169.sh` 运行集成测试，有很好的覆盖率。
	* 集成测试 __最好运行在 Hadoop 沙箱上__。我们建议您在沙箱中检出一个代码副本，并在其中直接运行 test_all_against_hdp_2_2_4_2_2.sh。如果您不想在沙箱上添加代码，请参阅 __更多关于 V1.5+ UT/IT 分离__ 的内容。
	* 正如名称所示，脚本仅适用于 HDP 2.4.0.0-169.2，但您可以从中理解集成测试是如何运行的。
	* 集成测试从生成随机数据开始，然后构建 Cube、合并 Cube，最后查询结果并与 H2 引擎进行比较。
	* 集成测试需要一到两个小时才能完成。
	* `nohup dev-support/test_all_against_hdp_2_4_0_0_169.sh < /dev/null 2>&1 > nohup.out &` 以无人值守的方式运行集成测试。

	## 更多关于 V1.5 UT/IT 分离

	运行 `mvn verify -Dhdp.version=2.4.0.0-169` （假定您运行在 HDP 2.4 沙箱上）是运行完整的所有测试套件所需的全部内容。

	它将按顺序执行以下步骤：

	1. Build Artifacts
	2. Run all UTs (takes few minutes)
	3. Provision Cubes on the sandbox environment for IT uasge (takes 1~2 hours)
	4. Run all ITs (takes few tens of minutes)
	5. Verify jar stuff

	如果您的代码改动很小那么只需要运行 UT，使用：
	`mvn test`
	如果您的沙箱已经配置，并且您的代码更改不会影响沙箱配置的结果，（并且您不想等待数小时的配置），只需运行以下命令来单独运行 UT 和 IT：
	`mvn test`
	`mvn failsafe:integration-test`

	### Cube 配置

	测试用的 cube 配置确实会运行 kylin cube 作业，以在沙箱中准备样例 cube。这些准备好的 cubes 将会被集成测试使用，当前准备步骤与 maven 预集成测试阶段绑定，且其包含运行 BuildCubeWithEngine（需要 HBase），BuildCubeWithStream（需要 Kafka）。您可以在沙箱或进行开发的计算机中运行 mvn 命令。对于后者情况您需要在 __$KYLIN_HOME/examples/test_case_data/sandbox/kylin.properties__ 中设置 kylin.job.use-remote-cli=true。
	尝试将 `-DfastBuildMode=true` 附加到 mvn verify 命令，通过跳过增量 Cubing 来加速配置。