AI_FIX_GRAMMAR

AI_FIX_GRAMMAR

云器将 AI 计算下沉至存储层与执行引擎，数据在平台内部即可完成智能处理，无需流转至外部环境，在保障数据安全的同时大幅降低任务延迟。

语法

AI_FIX_GRAMMAR

-- 使用工作区默认模型（推荐） AI_FIX_GRAMMAR(<content> [, json '{}']) -- 手动指定连接和模型 AI_FIX_GRAMMAR('<connection>:<model>', <content> [, json '{}'])

参数说明

model（可选）

指定要调用的语言模型。从 2026 年 9 月起，该参数可以省略——模型通过工作区默认模型自动路由，无需在每次调用时显式传入。

省略 model 参数时调用方式最简洁：

SELECT AI_FIX_GRAMMAR('He dont know what to did.');

工作区默认模型可通过以下方式配置：

方式一：创建新工作区时开启开关（推荐）

2026 年 9 月起新建的工作区，在创建时打开 "启用 AI Function" 开关，系统将自动配置默认模型，调用时无需传入 model 参数。对于此之前创建的工作区，需通过下方方式手动配置。

方式二：工作区级别 ALTER WORKSPACE 配置

通过

ALTER WORKSPACE

ALTER WORKSPACE <workspace_name> SET PROPERTIES ( 'cz.sql.ai.fix.grammar.default.model' = '<connection>:<model>' ); SELECT AI_FIX_GRAMMAR('He dont know what to did.');

方式三：会话级 SET 覆盖

在当前会话中临时指定默认模型，优先级高于工作区属性，仅当前 session 生效：

SET cz.sql.ai.fix.grammar.default.model=conn_bailian:qwen/qwen3.6-flash; SELECT AI_FIX_GRAMMAR('He dont know what to did.');

方式四：API Connection 连接对象

通过

CREATE API CONNECTION

CREATE API CONNECTION conn_bailian TYPE ai_function PROVIDER = 'bailian' BASE_URL = 'https://dashscope.aliyuncs.com/api/v1' API_KEY = 'sk-xxxxxxxxxxxxxxxxxxxxxxxx'; SELECT AI_FIX_GRAMMAR('conn_bailian:qwen3.5-plus', 'He dont know what to did.');

CREATE API CONNECTION

TYPE

ai_function

PROVIDER

'bailian'

'openai'

'anthropic'

BASE_URL

API_KEY

content（必需）

需要修复语法的输入文本，类型为 STRING（支持 CHAR/VARCHAR/STRING）。支持中文、英文、日文、法语等多种语言，无需手动指定语言，模型自动识别。

options（可选）

使用

json '{}'

输出格式控制

output.behavior

formatted_json

formatted_json

raw_string

fail_on_error

三种输出模式对比：

formatted_json

{"value":"模型输出"}

{"value":"","error_message":"..."}

raw_string

fail_on_error

-- formatted_json（默认） SELECT AI_FIX_GRAMMAR('He dont know what to did.', json '{"output.behavior":"formatted_json"}'); -- 结果: {"value":"He doesn't know what to do."} -- raw_string SELECT AI_FIX_GRAMMAR('He dont know what to did.', json '{"output.behavior":"raw_string"}'); -- 结果: He doesn't know what to do. -- fail_on_error SELECT AI_FIX_GRAMMAR('He dont know what to did.', json '{"output.behavior":"fail_on_error"}'); -- 结果（成功时同 raw_string）: He doesn't know what to do.

output.behavior

_

.

-

formatted_json

formatted.json

json

raw_string

raw.string

raw

fail_on_error

fail.on.error

fail-on-error

fail

返回值

返回 STRING 类型，具体格式取决于

output.behavior

• formatted_json

  formatted_json
  （默认）：返回

  {"value":"模型输出"}

  {"value":"模型输出"}
  格式的 JSON 字符串

• raw_string

  raw_string
  /

  fail_on_error

  fail_on_error
  ：返回模型输出的原始字符串

异常情况：

• content 为

  NULL

  NULL
  时返回

  NULL

  NULL
  ；为空字符串

  ''

  ''
  时返回空字符串，不报错
• 默认情况下，若函数无法处理输入，返回

  NULL

  NULL
  ，不报错。在多行查询中，出错的行返回

  NULL

  NULL
  ，不影响其他行的正常执行
• model 不存在时，报错

  CZLH-67000: No available endpoints found

  CZLH-67000: No available endpoints found
• model 格式错误（无正确的前缀）时，报错

  CZLH-65000: Invalid model coordinates

  CZLH-65000: Invalid model coordinates

使用示例

基础用法（省略 model 参数）

SELECT AI_FIX_GRAMMAR('He dont know what to did.'); -- 返回：He doesn't know what to do.

指定连接和模型

-- 英文语法修正 SELECT AI_FIX_GRAMMAR( 'conn_bailian:qwen3.5-plus', 'He dont know what to did.' ) AS fixed; -- 返回：He doesn't know what to do. -- 中文语法修正 SELECT AI_FIX_GRAMMAR( 'conn_bailian:qwen3.5-plus', '我昨天去了北京，那里的天气很好的很。' ) AS fixed; -- 返回：我昨天去了北京，那里的天气很好。 -- 无错误文本保持不变 SELECT AI_FIX_GRAMMAR( 'conn_bailian:qwen3.5-plus', 'The quick brown fox jumps over the lazy dog.' ) AS fixed; -- 返回：The quick brown fox jumps over the lazy dog.

多语言

-- 日文（去掉重复过去式） SELECT AI_FIX_GRAMMAR( 'conn_bailian:qwen3.5-plus', '私は昨日学校に行きましたでした。' ) AS fixed; -- 返回：私は昨日学校に行きました。 -- 法语（修正时态+缩合） SELECT AI_FIX_GRAMMAR( 'conn_bailian:qwen3.5-plus', 'Je suis allé au magasin et je achète du pain.' ) AS fixed; -- 返回：Je suis allé au magasin et j'ai acheté du pain. -- 中英混合文本智能统一 SELECT AI_FIX_GRAMMAR( 'conn_bailian:qwen3.5-plus', '这个product的quality真的很good，我very喜欢。' ) AS fixed; -- 返回：这个产品的质量真的很好，我非常喜欢。

语义理解能力

-- 主谓一致 SELECT AI_FIX_GRAMMAR('conn_bailian:qwen3.5-plus', 'She go to school every days.') AS fixed; -- 返回：She goes to school every day. -- 时态错误 SELECT AI_FIX_GRAMMAR('conn_bailian:qwen3.5-plus', 'Yesterday I go to the store and buy some food.') AS fixed; -- 返回：Yesterday I went to the store and bought some food. -- 中文词语冗余 SELECT AI_FIX_GRAMMAR('conn_bailian:qwen3.5-plus', '他大约大概有三十岁左右。') AS fixed; -- 返回：他大约三十岁。 -- 中文成分残缺 SELECT AI_FIX_GRAMMAR('conn_bailian:qwen3.5-plus', '通过这次活动，使我受到了教育。') AS fixed; -- 返回：这次活动使我受到了教育。

批量处理表数据

SELECT id, original_review, AI_FIX_GRAMMAR('conn_bailian:qwen3.5-plus', original_review) AS cleaned_review FROM customer_reviews WHERE original_review IS NOT NULL AND LENGTH(original_review) > 0;

使用 output.behavior 控制输出格式

SELECT AI_FIX_GRAMMAR( 'conn_bailian:qwen3.5-plus', 'He dont know what to did.', json '{"output.behavior":"formatted_json"}' ) AS fixed;

与其他 AI 函数配合

-- 先修正语法，再分析情感 SELECT id, AI_FIX_GRAMMAR('conn_bailian:qwen3.5-plus', content) AS fixed_content, AI_SENTIMENT('conn_bailian:qwen3.5-plus', AI_FIX_GRAMMAR('conn_bailian:qwen3.5-plus', content) ) AS sentiment FROM feedback WHERE content IS NOT NULL; -- 先修正语法，再生成摘要 SELECT id, AI_SUMMARIZE('conn_bailian:qwen3.5-plus', AI_FIX_GRAMMAR('conn_bailian:qwen3.5-plus', content), 30 ) AS summary FROM articles WHERE content IS NOT NULL;

注意事项

• model 参数可省略：通过工作区开关（新工作区）、

  ALTER WORKSPACE

  ALTER WORKSPACE
  或会话级

  SET

  SET
  配置

  cz.sql.ai.fix.grammar.default.model

  cz.sql.ai.fix.grammar.default.model
  后，调用时无需传 model 参数，系统自动路由至默认模型。
• NULL 返回 NULL，空字符串返回空字符串：content 为

  NULL

  NULL
  时返回

  NULL

  NULL
  ；content 为空字符串

  ''

  ''
  时返回空字符串

  ''

  ''
  ，不报错。纯空白字符（如

  '   '

  ' '
  ）会被发送给模型处理，通常返回空字符串。
• 无错误文本不会被修改：若输入文本语法正确，函数返回原文，不产生不必要的改动。
• 先过滤再修正：对大表使用时，建议先用

  WHERE content IS NOT NULL AND LENGTH(content) > 0

  WHERE content IS NOT NULL AND LENGTH(content) > 0
  过滤空值和空字符串，减少不必要的模型调用。
• 注意语义保持：AI_FIX_GRAMMAR 以修正语法为目标，但在极少数情况下（如原文存在逻辑矛盾），模型可能会修改语义。对语义敏感的场景，建议人工抽检修正结果。
• 中英混合文本统一：对于中英混合的用户生成内容，AI_FIX_GRAMMAR 会智能统一为主要语言，适合内容标准化场景。
• 与其他 AI 函数配合：建议在 AI_SENTIMENT 或 AI_SUMMARIZE 之前先用 AI_FIX_GRAMMAR 清洗文本，可提升下游分析质量。
• 结果具有非确定性：基于 LLM 的修正结果可能因模型版本或调用时机略有差异，同一输入多次执行结果可能不同。
• 输入长度受模型限制：输入文本长度受底层模型 context window 限制，超长文本可能被截断处理。