MySQL Shell 9.0  /  ...  /  返回自定义结果

10.4.2 返回自定义结果

SQL 处理程序函数可以返回一个结果对象。要定义自定义结果,请使用 shell.create_result(data)data 可以是字典,用于单个结果,也可以是字典列表,用于多个结果。

单个结果

单个结果的数据字典必须是字典,并且包含以下内容

  • affectedItemsCount: (整数) 由处理的 SQL 影响的项目数量。

  • info: (字符串) 定义有关结果的附加信息。

  • executionTime: (双精度) 处理 SQL 所花费的时间(以秒为单位)。

  • autoIncrementValue: (整数) 最后自动生成的插入 ID。

  • warnings: 描述由处理的 SQL 生成的警告的文档列表。

  • columns: 描述结果的列元数据的可选列表。

  • data: 定义结果中包含的数据的可选参数。请参阅 第 10.4.3 节,“结果数据规范”

多个结果

为了支持多个结果,请在 data 参数中定义字典列表。请参阅 单个结果,了解有关允许的字典元素的信息。

您还可以将错误定义字典添加到此列表中,以指示在 SQL 处理期间发生的错误。错误字典必须具有以下属性

  • error: (字符串) 错误描述。

  • code: (整数) 与错误关联的代码。