Scalar JavaScript UDFs¶

本主题介绍标量 JavaScript UDFs（用户定义函数）。

简介

标量 JavaScript UDF 为每个输入行返回一个输出行。输出行必须只包含一个列/一个值。

A basic example is in Introduction to JavaScript UDFs. Additional examples are below.

Note

标量函数 (UDFs) 最多有 500 个输入实参。

示例

本节包含标量 JavaScript UDFs 的示例。

递归

下面的示例显示 JavaScript UDF 可以调用自身（即它可以使用递归）。

创建一个递归 UDF：

CREATE OR REPLACE FUNCTION RECURSION_TEST (STR VARCHAR)
  RETURNS VARCHAR
  LANGUAGE JAVASCRIPT
  AS $$
  return (STR.length <= 1 ? STR : STR.substring(0,1) + '_' + RECURSION_TEST(STR.substring(1)));
  $$
  ;

调用递归 UDF：

SELECT RECURSION_TEST('ABC');
+-----------------------+
| RECURSION_TEST('ABC') |
|-----------------------|
| A_B_C                 |
+-----------------------+

自定义异常

下面的示例演示引发自定义异常的 JavaScript UDF 示例。

创建函数：

CREATE FUNCTION validate_ID(ID FLOAT)
RETURNS VARCHAR
LANGUAGE JAVASCRIPT
AS $$
    try {
        if (ID < 0) {
            throw "ID cannot be negative!";
        } else {
            return "ID validated.";
        }
    } catch (err) {
        return "Error: " + err;
    }
$$;

创建包含有效值和无效值的表：

CREATE TABLE employees (ID INTEGER);
INSERT INTO employees (ID) VALUES 
    (1),
    (-1);

调用函数：

SELECT ID, validate_ID(ID) FROM employees ORDER BY ID;
+----+-------------------------------+
| ID | VALIDATE_ID(ID)               |
|----+-------------------------------|
| -1 | Error: ID cannot be negative! |
|  1 | ID validated.                 |
+----+-------------------------------+

故障排除

See Troubleshooting JavaScript UDFs.