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