类别：: 系统函数（系统信息）

SYSTEM$ADD_EVENT（适用于 Snowflake Scripting）¶

添加一个用于跟踪的事件。

使用来自以 Snowflake Scripting 编写的处理程序的跟踪事件时，使用 SYSTEM$ADD_EVENT 添加事件。

有关更多信息，请参阅在 Snowflake Scripting 中发出跟踪事件。

语法¶

SYSTEM$ADD_EVENT('<name>', '<object>');

实参¶

'name': 要添加的事件的名称。
'object': 包含表示要添加的属性之名称-值对的对象。

示例¶

以下示例中的代码使用 SYSTEM$ADD_EVENT 函数添加一个名为 name_a 的事件和一个名为 name_b 的事件。name_b 关联两个属性，即 score 和 pass。该代码还为范围设置两个属性，即 key1 和 key2。

CREATE OR REPLACE PROCEDURE pi_proc()
  RETURNS DOUBLE
  LANGUAGE SQL
  AS $$
  BEGIN
    -- Add an event without attributes
    SYSTEM$ADD_EVENT('name_a');

    -- Add an event with attributes
    LET attr := {'score': 89, 'pass': TRUE};
    SYSTEM$ADD_EVENT('name_b', attr);

    -- Set attributes for the span
    SYSTEM$SET_SPAN_ATTRIBUTES({'key1': 'value1', 'key2': TRUE});

    RETURN 3.14;
  END;
  $$;