CREATE FUNCTION

SELECT、UPDATE、INSERTに含まれるユーザー指定のJavaまたはJavascriptコードを実行するか、ユーザー定義集計に対してビルディング・ブロックを指定します。関数は、それらが作成されたキースペース内でのみ使用できます。

構文

CREATE [ OR REPLACE ] FUNCTION [ IF NOT EXISTS ] [keyspace_name.]function_name (argument_list [ , ... ])
  ( CALLED | RETURNS NULL ) ON NULL INPUT RETURNS type 
  [ DETERMINISTIC ]
  [ MONOTONIC [ ON argument_name ] ]
  LANGUAGE ( java | javascript ) AS $$ code_block $$ ;

function_name

キースペース修飾関数名を指定します。名前は文字または数字で始まる必要があります。大文字と小文字の区別を維持する場合は、名前を二重引用符で囲みます。

OR REPLACE

同じ名前の関数が既に存在する場合、その関数を上書きします。

注: IF NOT EXISTSオプションとともに使用することはできません。

IF NOT EXISTS

同じ名前の関数が既に存在する場合に処理を実行せず、エラー・メッセージを抑制します。

argument_list

処理のためにコード・ブロックにデータ型が渡された引数のコンマ区切りリスト。

arg_name cql_type [,...]

リストでは、引き数名、CQLデータ型の順に指定します。

要求に対しては、対応するデータ型のカラムまたは手動で入力された（リテラル）カラムから引数値が読み取られます。

CALLED ON NULL INPUT

入力値がNullである場合や欠落している場合も、ユーザー指定のコード・ブロックを実行します。

RETURNS NULL ON NULL INPUT

ユーザー指定のコード・ブロックをNull値に対して実行せず、Nullを返します。

RETURNS cql_data_type

コード・ブロックからの出力期待値を互換性のあるCQLデータ型にマップします。

DETERMINISTIC

特定の入力に対して常に同じ出力を返す関数について指定します。たとえば、toJson()は確定的な関数ですが、now()およびcurrentDate()は決定的な関数ではありません。

デフォルト：false（非確定的）。

注: GROUP BYは、確定的で、単調な関数のみをサポートしています。

MONOTONIC [ ON argument_name ]

すべての引数または指定された引数は、全体的に非増加または非減少の場合、単調です。

注: GROUP BYは、確定的で、単調な関数のみをサポートしています。

LANGUAGE language_name

サポートされている型はjavaまたはjavascriptです。

ヒント: enable_scripted_user_defined_functionsがfalseで、enable_user_defined_functionsがtrueの場合、Javaがサポートされている唯一の言語となります。

‘code_block' | $$ code_block $$

コード・ブロックは単一引用符で囲むか、コード・ブロックに特殊文字が含まれている場合は二重ドル記号（$$）で囲みます。コードは関数としてラップされ、ターゲット変数に適用されます。

例

CREATE OR REPLACE FUNCTION cycling.fLog (
  input double
) 
  CALLED ON NULL INPUT 
  RETURNS double 
  LANGUAGE java AS 
    $$
      return Double.valueOf(Math.log(input.doubleValue()));
    $$ 
;

CREATE OR REPLACE FUNCTION cycling.left (
  column text, num int
) 
  RETURNS NULL ON NULL INPUT 
  RETURNS text 
  LANGUAGE javascript AS 
    $$
      column.substring(0, num)
    $$
;

SELECT left(firstname, 1), lastname
FROM cycling.cyclist_name;

 cycling.left(firstname, 1) | lastname
----------------------------+-----------------
                          A |           FRAME
                       null |        MATTHEWS
                       null |             VOS
                          P |       TIRALONGO
                          M |             VOS
                          S |      KRUIKSWIJK
                          A | VAN DER BREGGEN