LN 関数 - Amazon Redshift
構文引数戻り型例

LN 関数

入力パラメータの自然対数を返します。

DLOG1 関数 のシノニム。

構文

LN(expression)

引数

expression

関数の対象となる列または式。

注記

この関数は、式の参照先が Amazon Redshift のユーザー作成テーブルである場合、あるいは Amazon Redshift の STL または STV システムテーブルである場合に、データ型のエラーを返します。

式の参照先がユーザー作成テーブルまたはシステムテーブルである場合、式のデータ型が以下のいずれかであるときに、エラーが発生します。以下のデータ型の式は、リーダーノードで排他的に実行されます。

  • BOOLEAN

  • CHAR

  • DATE

  • DECIMAL、または NUMERIC

  • TIMESTAMP

  • VARCHAR

以下のデータ型の式は、ユーザー作成テーブルおよび STL または STV システムテーブルで、正常に実行されます。

  • BIGINT

  • DOUBLE PRECISION

  • INTEGER

  • REAL

  • SMALLINT

戻り型

LN 関数は、入力式と同じ型を返します。

例

数値 2.718281828 の自然対数、または e を底とする対数を返すには、次の例を使用します。

SELECT LN(2.718281828);

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

解は 1 の近似値になることに注意してください。

次の例では、TICKIT サンプルデータを使用します。詳細については、「サンプルデータベース」を参照してください。

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 |
+----------+--------------------+