# log2
log2函数用于返回给定数值的以2为底自然对数。
#### 命令格式
```
log2(DOUBLE a)
```
#### 参数说明
表1参数说明 
| 参数 | 是否必选 | 参数类型                            | 说明                                                                                                                          |
|:---|:---|:---|:---|
| a  | 是    | DOUBLE、BIGINT、DECIMAL、STRING类型。 | 参数a的格式包括浮点数格式、整数格式、字符串格式。 参数a非DOUBLE类型时，会隐式转换为DOUBLE类型后参与运算。 |
   
#### 返回值说明
返回DOUBLE类型的值。
![](https://support.huaweicloud.com/sqlref-spark-dli/public_sys-resources/note_3.0-zh-cn.png)
a值为0、负数或NULL时，返回NULL。
#### 示例代码
返回NULL。
```
select log2(null);
```
返回NULL。
```
select log2(0);
```
返回3.1699250014423126。
```
select log2(9);
```
返回4。
```
select log2(16);
```