79 lines
2.8 KiB
Markdown
79 lines
2.8 KiB
Markdown
<!--
|
|
Licensed to the Apache Software Foundation (ASF) under one
|
|
or more contributor license agreements. See the NOTICE file
|
|
distributed with this work for additional information
|
|
regarding copyright ownership. The ASF licenses this file
|
|
to you 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.
|
|
-->
|
|
|
|
# 新加case注意事项
|
|
|
|
## 常规 case
|
|
1. 变量名前要写 def，否则是全局变量，并行跑的 case 的时候可能被其他 case 影响。
|
|
|
|
Problematic code:
|
|
```
|
|
ret = ***
|
|
```
|
|
Correct code:
|
|
```
|
|
def ret = ***
|
|
```
|
|
2. 尽量不要在 case 中 global 的设置 session variable，或者修改集群配置，可能会影响其他 case。
|
|
|
|
Problematic code:
|
|
```
|
|
sql """set global enable_pipeline_x_engine=true;"""
|
|
```
|
|
Correct code:
|
|
```
|
|
sql """set enable_pipeline_x_engine=true;"""
|
|
```
|
|
3. 如果必须要设置 global，或者要改集群配置，可以指定 case 以 nonConcurrent 的方式运行。
|
|
|
|
[示例](https://github.com/apache/doris/blob/master/regression-test/suites/query_p0/sql_functions/cast_function/test_cast_string_to_array.groovy#L18)
|
|
4. case 中涉及时间相关的，最好固定时间，不要用类似 now() 函数这种动态值，避免过一段时间后 case 就跑不过了。
|
|
|
|
Problematic code:
|
|
```
|
|
sql """select count(*) from table where created < now();"""
|
|
```
|
|
Correct code:
|
|
```
|
|
sql """select count(*) from table where created < '2023-11-13';"""
|
|
```
|
|
5. case 中 streamload 后请加上 sync 一下，避免在多 FE 环境中执行不稳定。
|
|
|
|
Problematic code:
|
|
```
|
|
streamLoad { ... }
|
|
sql """select count(*) from table """
|
|
```
|
|
Correct code:
|
|
```
|
|
streamLoad { ... }
|
|
sql """sync"""
|
|
sql """select count(*) from table """
|
|
```
|
|
|
|
6. UDF 的 case，需要把对应的 jar 包拷贝到所有 BE 机器上。
|
|
|
|
[示例](https://github.com/apache/doris/blob/master/regression-test/suites/javaudf_p0/test_javaudf_case.groovy#L27)
|
|
|
|
|
|
## 兼容性 case
|
|
指重启 FE 测试或升级测试中，在初始集群上创建的资源或规则，在集群重启或升级后也能正常使用，比如权限、UDF等。
|
|
这些 case 需要拆分成两个文件，load.groovy 和 xxxx.groovy，放到一个文件夹中并加上 `restart_fe` 组标签，[示例](https://github.com/apache/doris/pull/37118)。
|
|
|