Snowflake 中表函数（UDTF）的正确调用方式详解

在 snowflake 中创建用户定义表函数（udtf）后，必须通过 `from table(…)` 语法调用，不能像标量函数那样直接在 `select` 列表中使用，否则会报错“unknown user-defined function”。

你遇到的错误 Error: Unknown user-defined function L2.”xx_proc_getDqtReport” 并非函数未创建成功，而是调用方式不合法。虽然 CREATE OR REPLACE FUNCTION 执行成功且 SHOW USER FUNCTIONS 可能暂未显示（取决于权限或缓存），但根本原因在于：Snowflake 的表函数（UDTF）属于关系型对象，只能出现在 FROM 子句中，不能作为表达式直接用于 SELECT 列表。

✅ 正确调用方式（必须使用 TABLE() 函数包装）：

SELECT *  FROM TABLE(l2."xx_proc_getDqtReport"('l1', 'dtidr_elg_raw'));

❌ 错误调用方式（导致 Unknown function 错误）：

-- ❌ 错误：UDTF 不支持此语法 SELECT l2."xx_proc_getDqtReport"('l1', 'dtidr_elg_raw');  -- ❌ 错误：即使加了 * 也不行 SELECT * FROM l2."xx_proc_getDqtReport"('l1', 'dtidr_elg_raw'); -- 缺少 TABLE()

⚠️ 补充注意事项：

• 命名规范与大小写敏感性：你使用双引号 “xx_proc_getDqtReport” 是正确的（保留大小写），但需确保调用时完全匹配——包括大小写、下划线和引号。建议统一使用小写无引号命名以避免混淆（如 xx_proc_getdqtreport），除非有强约束。

• 权限检查：若 SHOW USER FUNCTIONS 查不到该函数，请确认当前角色对 L2 schema 具有 USAGE 权限，并对函数本身具有 SELECT（对 UDTF 实际是执行权限）权限。可运行：

  SHOW FUNCTIONS IN SCHEMA l2;

• 代码逻辑风险提示（非报错主因，但需优化）：

  • 动态 sql 中拼接 ${tablename} 存在 SQL 注入风险，应改用绑定参数（但注意：Snowflake javaScript UDTF 中 statement.execute() 不支持绑定参数用于对象名，因此需严格校验输入，例如添加正则过滤表名是否仅含字母数字和下划线）；
  • USE SCHEMA 语句在 UDTF 中无效（上下文隔离），应显式指定全限定名，如 l1.dtidr_elg_raw；
  • LISTAGG(DISTINCT …) 在大表上可能超内存，建议评估数据量并考虑采样或分页；
  • current_timestamp() 应写作 CURRENT_TIMESTAMP()（标准函数名），避免歧义。

✅ 推荐改进后的最小可运行调用示例：

-- 创建后验证存在性 SHOW FUNCTIONS LIKE '%getDqtReport%' IN SCHEMA l2;  -- 正确执行（关键：TABLE() 包裹 + FROM 子句） SELECT * FROM TABLE(l2."xx_proc_getDqtReport"('L1', 'DTIDR_ELG_RAW'));

总结：Snowflake 对 UDTF 的调用有严格语法约定——它不是值，而是一个可查询的关系源。牢记 FROM TABLE(function(…)) 这一黄金法则，即可规避绝大多数“Unknown function”类错误。