Amazon Redshift 將不再支援從修補程式 198 開始建立新的 Python UDFs。現有 Python UDF 將繼續正常運作至 2026 年 6 月 30 日。如需詳細資訊，請參閱[部落格文章](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/)。

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

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

傳回輸入參數的自然對數。

[DLOG1 函數](r_DLOG1.md) 的同義詞。

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

```
LN(expression)
```

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

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

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

LN 函數傳回與輸入*運算式*相同的類型。

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

若要傳回數字 2.718281828 的自然對數或以 `e` 為底的對數，請使用下列範例。

```
SELECT LN(2.718281828);

+--------------------+
|         ln         |
+--------------------+
| 0.9999999998311267 |
+--------------------+
```

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

下列範例使用 TICKIT 範例資料庫。如需詳細資訊，請參閱[範本資料庫](c_sampledb.md)。

若要傳回 USERS 資料表的 userid 欄中值的自然對數，請使用下列範例。

```
SELECT username, LN(userid) FROM users ORDER BY userid LIMIT 10;

+----------+--------------------+
| username |         ln         |
+----------+--------------------+
| JSG99FHE |                  0 |
| PGL08LJI | 0.6931471805599453 |
| IFT66TXU | 1.0986122886681098 |
| XDZ38RDD | 1.3862943611198906 |
| AEB55QTM | 1.6094379124341003 |
| NDQ15VBM |  1.791759469228055 |
| OWY35QYB | 1.9459101490553132 |
| AZG78YIP | 2.0794415416798357 |
| MSD36KVR | 2.1972245773362196 |
| WKW41AIW |  2.302585092994046 |
+----------+--------------------+
```