model_name!PREDICT

使用先前训练的模型 model_name 生成分类预测。

语法

<model_name>!PREDICT(
    INPUT_DATA => <input_data>,
    [CONFIG_OBJECT => <config_object>]
)

实参

必填

INPUT_DATA

包含将特征名称映射到其值的键值对的 OBJECT。在对象字面量中使用 通配符扩展，自动从表中创建键值对，如：

SELECT model_binary!PREDICT(INPUT_DATA => {*})
    as prediction from prediction_purchase_data;

对象中的特征名称必须与训练时指定的名称和类型匹配。缺失或无关的特征将被忽略。

可选

CONFIG_OBJECT

其键值对指定了其他训练选项的 OBJECT。

键

类型

默认值

描述

on_error

STRING

'ABORT'

指定模型推理任务的错误处理方法的字符串（常量）。支持的值包括：

  • 'ABORT'：如果任何一行出现错误，则终止整个预测操作。

  • 'SKIP'：跳过出现错误的行。显示的是错误，而不是结果。

输出

列

类型

描述

PREDICTION

VARIANT

预测结果时一个包含以下键的 OBJECT。

LOGS

VARIANT

包含错误或警告消息。

键

类型

描述

class

STRING

概率最高的预测标签。

probability

VARIANT

包含每个预测类的概率的 OBJECT。对于每个类，键是类名称，值是该类的预测概率。

示例

请参阅 示例。