# trans_array
trans_array函数用于将一行数据转为多行的UDTF，将列中存储的以固定分隔符格式分隔的数组转为多行。
#### 使用限制
- 所有作为key的列必须位于在前面，而要转置的列必须放在后面。
- 在一个select中只能有一个UDTF，不可以再出现其他的列。
- 不可以与group by、cluster by、distribute by、sort by一起使用。
 
#### 命令格式
```
trans_array (<num_keys>, <separator>, <key1>,<key2>,…,<col1>,<col2>,<col3>) as (<key1>,<key2>,...,<col1>, <col2>)
```
#### 参数说明
表1参数说明 
| 参数        | 是否必选 | 参数类型      | 说明                                                                          |
|:---|:---|:---|:---|
| num_keys  | 是    | BIGINT类型。 | BIGINT类型常量，值必须\>=0。在转为多行时作为转置key的列的个数。                                      |
| separator | 是    | STRING类型。 | STRING类型常量，用于将字符串拆分成多个元素的分隔符。为空时返回报错。                                       |
| keys      | 是    | STRING类型。 | 转置时作为key的列， 个数由num_keys指定。如果num_keys指定所有的列都作为key（即num_keys等于所有列的个数），则只返回一行。 |
| cols      | 是    | STRING类型。 | 要转为行的数组，keys之后的所有列视为要转置的数组，必须为STRING类型。                                     |
   
#### 返回值说明
参数的数据类型。
![](https://support.huaweicloud.com/sqlref-spark-dli/public_sys-resources/note_3.0-zh-cn.png)
- 返回转置后的行，新的列名由as指定。
- 作为key的列类型保持不变，其余所有的列是STRING类型。
- 拆分成的行数以个数多的数组为准，不足的补NULL。
 
#### 示例代码
为便于理解函数的使用方法，本文为您提供源数据，基于源数据提供函数相关示例。创建表salary，并添加数据，命令示例如下：
```
CREATE EXTERNAL TABLE salary (
dept_id STRING, -- 部⻔
user_id STRING, -- 员⼯ID
sal STRING -- 薪⽔
) ROW FORMAT DELIMITED FIELDS TERMINATED BY ',' 
stored as textfile;
```
添加数据如下：
```
d1,user1/user4,1000/6000
d1,user2/user5,2000/7000
d1,user3/user6,3000
d2,user4/user7,4000
d2,user5/user8,5000/8000
```
执行SQL（在SQL语句中使用斜杠(/)时，DLI控制台会自动进行转义处理，但通过API调用时需要您手动转义，否则会提示解析失败。）
```
select trans_array(1, "/", dept_id, user_id, sal) as (dept_id, user_id, sal) from salary;
```
返回结果如下：
```
d1,user1,1000
d1,user4,6000
d1,user2,2000
d1,user5,7000
d1,user3,3000
d1,user6,NULL
d2,user4,4000
d2,user7,NULL
d2,user5,5000
d2,user8,8000
```