メインコンテンツまでスキップ
メインコンテンツまでスキップ

CREATE FUNCTION - ユーザー定義関数 (UDF)

ユーザー定義関数 (UDF) をラムダ式から作成します。式は、関数のパラメータ、定数、演算子、または他の関数呼び出しから構成されなければなりません。

構文

CREATE FUNCTION name [ON CLUSTER cluster] AS (parameter0, ...) -> expression

関数は任意の数のパラメータを持つことができます。

いくつかの制限があります:

  • 関数の名前は、ユーザー定義関数とシステム関数の間でユニークでなければなりません。
  • 再帰関数は許可されていません。
  • 関数で使用されるすべての変数は、そのパラメータリストに指定されている必要があります。

いずれかの制限に違反した場合、例外が発生します。

クエリ:

CREATE FUNCTION linear_equation AS (x, k, b) -> k*x + b;
SELECT number, linear_equation(number, 2, 1) FROM numbers(3);

結果:

┌─number─┬─plus(multiply(2, number), 1)─┐
│      0 │                            1 │
│      1 │                            3 │
│      2 │                            5 │
└────────┴──────────────────────────────┘

次のクエリでは、条件付き関数 がユーザー定義関数内で呼び出されています:

CREATE FUNCTION parity_str AS (n) -> if(n % 2, 'odd', 'even');
SELECT number, parity_str(number) FROM numbers(3);

結果:

┌─number─┬─if(modulo(number, 2), 'odd', 'even')─┐
│      0 │ even                                 │
│      1 │ odd                                  │
│      2 │ even                                 │
└────────┴──────────────────────────────────────┘

実行可能な UDF

ClickHouse Cloud のユーザー定義関数