使用自定义宏的指导原则

在创建或使用自定义宏时，请记住以下指导原则：

自定义宏的名称必须是字母数字。 名称字符串中不能使用空格，但可使用下划线 (_)。

如果已使用属性 ENABLE_SELECT_SORT_BY = TRUE 配置数据源，则 必须 用“ORDER BY”子句编写原始 SQL 自定义宏，以便按所使用的受众级别的受众键字段对返回的记录排序。 否则，如果排序顺序与预期不符，则在“快照”进程的派生字段中使用自定义宏时将生成错误。

如果不比较自定义宏的返回值，则当该值为数字时，会将非零值视为 TRUE（并且因此会选择与其关联的 ID），并将零值视为 FALSE。 字符串值将始终被视为 FALSE。

创建使用原始 SQL 的自定义宏时，使用临时表可以通过确定原始 SQL 需要处理的数据量的范围来显著提高它的性能。

当自定义宏在其基础逻辑中使用临时表时，会将一个临时表向上强制用于数据库，以使该逻辑不会失败。

但如果在顶级 SELECT 中使用自定义宏，则没有历史记录可供 Campaign 用来将临时表向上强制用于数据库，逻辑将失败。

因此，在创建使用原始 SQL 的自定义宏时，可能需要创建同一个自定义宏的两个版本 - 一个使用临时表标记，另一个不使用临时表标记。

没有临时表标记的自定义宏可在树顶部使用（例如，在第一个 SELECT 中）。 当可能有要利用的临时表时，可在树中的其他任何位置使用具有临时表标记的自定义宏。

在针对非规范化数据进行查询时，如果组合由自定义宏返回的值，则可能会发生自行联接，这可能不是期望的行为。

例如，如果基于返回值的原始 SQL 使用自定义宏并且（例如，在“快照”进程中）从该自定义宏所基于的表中输出自定义宏和其他字段，Campaign 将对该表执行自行联接。 如果表是非规范化的，则会生成一个 Cartesian 产品（即，显示的记录数大于预期数量）。

现在，会自动引用自定义宏，因为自定义宏的定义未复制到当前进程中。

执行时，会通过在 UA_CustomMacros 系统表（其中存储定义）中查找自定义宏的定义来解析自定义宏，然后再使用/执行该自定义宏。

与存储查询不同，自定义查询名称必须唯一，与文件夹路径无关。 在 5.0 之前的版本中，例如，在文件夹 F1 和 F2 中都可以存在名为 A 的存储查询。

Campaign 支持来自早期版本的存储查询。 但是，对非唯一存储查询的引用必须使用旧语法：

storedquery(<查询名称>)

在解析自定义宏中的用户变量时，Campaign 会在检查语法时使用用户变量的当前值。 如果当前值留空，Campaign 将生成错误。

临时表标记作为一种性能优化高级功能来提供，它通过临时表中可供当前进程使用的受众 ID 的集合确定从数据库拉下的数据量的范围。 此 ID 的临时表列表可能是当前单元中的 ID 的超集。 因此，对临时表执行的聚合函数（例如，求平均值或求和）不受支持，可能会生成错误结果。

如果打算在多个不同的数据库中使用自定义宏，则可能要使用 IBM Unica 表达式而非原始 SQL，因为特定数据库可能有专用的原始 SQL。

如果自定义宏包含原始 SQL 和其他自定义宏，则将在执行原始 SQL 之前解析、执行自定义宏并返回其值。

Campaign 将逗号视为参数分隔符。 如果使用逗号作为参数中的字符，请用左大括号和右大括号 ({}) 括起文本，如下所示：

TestCM( {STRING_CONCAT(UserVar.Test1, UserVar.Test2) } )

下表详细介绍了 Campaign 如何处理查询和派生字段中的自定义宏。

查询和派生字段中的自定义宏（“选择”、“分段”和“受众”进程）

自定义宏的类型	使用方式
原始 SQL： ID	作为单独查询来运行。 将 ID 列表与其他结果合并。 如果自定义宏包含其他自定义宏和原始 SQL，将先解析和执行自定义宏，然后执行原始 SQL。
原始 SQL： ID + 值	预期将在表达式中使用返回值或将其用作比较。 如果不以此方式使用该值，则 Campaign 会在进行 ID 选择时将非零值视为 TRUE，将零值和字符串视为 FALSE。
IBM Unica 表达式	解析表达式并执行语法检查。 支持每个表使用一个查询，并匹配/合并 ID。

在原始 SQL 查询中（“选择”、“分段”和“受众”进程）

自定义宏的类型	使用方式
原始 SQL： ID	解析自定义宏，然后执行查询。
原始 SQL： ID + 值	不支持。
IBM Unica 表达式	解析表达式，但不执行语法检查。 如果表达式不正确，则在执行时由数据库服务器进行检测。