本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# LN 函數
<a name="LN"></a>

LN 函數會傳回輸入參數的自然對數。

## 語法
<a name="LN-synopsis"></a>

```
LN(expression)
```

## 引數
<a name="LN-argument"></a>

 *表達式*   
函數運算的目標欄或表達式。  
如果運算式參考 AWS Clean Rooms 使用者建立的資料表或 AWS Clean Rooms STL 或 STV 系統資料表，則此函數會傳回某些資料類型的錯誤。
如果具有下列資料類型的表達式參考使用者建立的資料表或系統資料表，則會產生錯誤。  
+ BOOLEAN 
+ CHAR 
+ DATE 
+ DECIMAL 或 NUMERIC 
+ TIMESTAMP 
+ VARCHAR 
在使用者建立的資料表和 STL 或 STV 系統資料表上，具有下列資料類型的表達式可以成功執行：  
+ BIGINT 
+ DOUBLE PRECISION 
+ INTEGER 
+ REAL 
+ SMALLINT 

## 傳回類型
<a name="LN-return-type"></a>

LN 函數傳回與表達式相同的類型。

## 範例
<a name="LN-example"></a>

下列範例傳回數字 2.718281828 的自然對數，或以 e 為底的對數：

```
select ln(2.718281828);
ln
--------------------
0.9999999998311267
(1 row)
```

請注意，答案幾乎等於 1。

此範例傳回 USERS 資料表的 USERID 欄中一些值的自然對數：

```
select username, ln(userid) from users order by userid limit 10;

 username |        ln
----------+-------------------
 JSG99FHE |                 0
 PGL08LJI | 0.693147180559945
 IFT66TXU |  1.09861228866811
 XDZ38RDD |  1.38629436111989
 AEB55QTM |   1.6094379124341
 NDQ15VBM |  1.79175946922805
 OWY35QYB |  1.94591014905531
 AZG78YIP |  2.07944154167984
 MSD36KVR |  2.19722457733622
 WKW41AIW |  2.30258509299405
(10 rows)
```