# replace
replace函数用于用new字符串替换str字符串中与old字符串完全重合的部分并返回替换后的str。
如果没有重合的字符串，返回原str。
#### 命令格式
```
replace(string <str>, string <old>, string <new>)
```
#### 参数说明
表1参数说明 
| 参数  | 是否必选 | 参数类型   | 说明       |
|:---|:---|:---|:---|
| str | 是    | STRING | 待替换的字符串。 |
| old | 是    | STRING | 待比较的字符串。 |
| new | 是    | STRING | 替换后的字符串。 |
   
#### 返回值说明
返回STRING类型的值。
![](https://support.huaweicloud.com/sqlref-spark-dli/public_sys-resources/note_3.0-zh-cn.png)
如果任一输入参数值为NULL，返回NULL。
#### 示例代码
返回AA123AA。
```
select replace('abc123abc','abc','AA');
```
返回NULL。
```
select replace('abc123abc',null,'AA');
```