更新时间:2024-11-29 GMT+08:00

添加实时查询变量

操作场景

平台支持基于PL/SQL语法的实时查询变量计算,在以下两种场景中,业务管理人员可定义实时查询变量。

  • 规则中某个变量所处维度不同于规则所处维度,则需将该变量从规则中抽取出来,单独定义为实时查询变量,否则在进行规则计算时,会产生跨维度MOTService查询,影响性能。
  • 多个规则公用的变量,可以抽取出来,单独定义为实时查询变量,减少重复计算次数。

实时查询变量定义语法为ANSI标准SQL语法,支持查询15天以内数据,在定义中,可引用平台定制的事件变量和批次变量,可查询当前数据源数据以外的其他数据表(POC表,黑白名单等),定义完成后需先通过语法检查才能正式提交,减少人为原因产生的错误变量。

操作步骤

  1. 参考访问RTD WebUI界面,使用业务用户登录RTD WebUI管理界面,选择要操作的租户。
  2. 选择“业务管理 > 变量&规则配置 > 实时查询变量”。
  3. 单击“新增”,参见以下表格设置实时查询变量的相关属性参数。

    表1 实时查询变量参数一览表

    参数名

    说明

    事件源类型

    选择变量所属事件源类型。

    维度名称

    选择变量对应维度。

    名称

    输入变量名称。

    说明:
    • 实时查询变量名称的前缀为“rv_”。
    • 变量名称不区分大小写,必须由字母或下划线开头,且字符范围限制为[A-Z]、[a-z]、[0-9]、_,长度限制为[4-30]个字符。

    类型

    选择变量类型。可选string、long、integer、double、boolean、timestamp。

    默认值

    可选,输入变量默认值。

    变量类型

    选择变量规则类型:

    • 普通变量:变量“上线”即可参与每一笔报文(全部流量)的计算。
    • 灰度变量:需设置流量占比。
      • 确认“发布规则”前上线,该变量使用设置的流量占比计算;
      • 确认“发布规则”后上线,该变量参与每一笔报文(全部流量)的计算,即单击该变量所属“操作”列中的“发布规则”,单击“确定”后再上线。

    流量占比

    设置数据分流占比,选择“灰度变量”时必选。取值为(0-99]的整数。

    SQL

    输入实时查询变量的SQL代码。

    描述

    输入变量描述信息。

    参数设置完成后,单击“检核参数”,设置规则里用到的参数变量的值,然后单击“语法检查”,检查代码的语法正确性。

    若检查未通过,用户可根据提示信息进行修改具体代码,然后重新执行检查。

  4. 语法检查完成后,单击“确认”,添加实时查询变量。

    变量添加完成后,在实时查询变量界面勾选变量,选择“更多操作 > 上线”/“更多操作 > 下线”,完成变量的上线下线操作。