Snowflake：插入行

使用 Snowflake：插入行，通过 SQL API，使用程序化访问令牌，从旅程步骤中向 Snowflake 表格写入一行。列值作为绑定参数传递，而不是在 SQL 语句文本内部，因此值不会脱离其列并更改语句的功能。此节点使用其自身的程序化访问令牌进行身份验证。它不使用在“设置”中其他地方配置的任何账户级集成。

典型用途：

• 填充报告表： 每到达一个旅程步骤就插入一行，用于下游的仪表板或计划查询。
• 实时记录事件： 将原始旅程数据直接写入仓库，而不是等待批处理管道。
• 与现有数据连接： 插入设备或标签值，您的 Snowflake 表格可以根据这些值与您自己的数据集进行连接。

警告

默认情况下，程序化访问令牌的有效期为 15 天。节点将在令牌过期当天开始失败，且不会有任何预先警告。请在您自己的日历中设置提醒以轮换令牌，否则在您设置此节点两周后，请求将无声地停止工作。

配置节点

1. 从左侧面板的 Integrations 部分拖动 Snowflake：插入行 到画布上。
2. 双击该节点并输入 步骤名称。
3. 在 账户主机 中，输入您 Snowflake 账户的 URL 中的主机，例如 ab12345.eu-central-1.snowflakecomputing.com。不要包含 https:// 或结尾的斜杠。Pushwoosh 会自行添加 https:// 和 API 路径。

4. 在 程序化访问令牌 中，输入一个来自 Snowsight > 您的用户 > 设置 > 身份验证 > 程序化访问令牌 的令牌。它会像 webhook 密钥头一样被屏蔽存储。

5. 在 表格 中，输入目标表格，格式为 TABLE、SCHEMA.TABLE 或 DATABASE.SCHEMA.TABLE，仅使用字母、数字和下划线。此节点不会单独要求仓库、数据库或模式：一个裸的 TABLE 会根据令牌用户默认的数据库和模式进行解析，而 DATABASE.SCHEMA.TABLE 值会覆盖这些默认值。

6. 在 列 中，为要写入的每个表格列添加一行。输入列名和值。名称必须非空且唯一，并遵循与 表格 相同的字母/数字/下划线规则。值可以是固定文本或 traveler 宏，例如 {{tag:Name}}，与 Webhook 主体中的宏相同。或者点击 插入动态值 来选择此旅程中先前步骤产生的属性，例如 LLM 响应或映射的 Webhook 值。

示例

当 表格 设置为 PW.PUBLIC.TRAVELERS 时，将 列 设置为 DEVICE_ID 并使用 traveler 的设备 ID ({{device:hwid}})，会向该表的 DEVICE_ID 列插入一行。

7. 点击 保存。

响应

traveler 会继续前进到您在画布上连接的下一个步骤。

步骤运行后的属性

属性	包含内容
snowflake_statement_handle	已提交语句的句柄

如何在后续步骤中使用它

无论此属性如何，traveler 都已继续到下一步。如果您需要稍后通过 Snowflake 自己的 API 检查该语句的状态，请使用 更新用户个人资料 将其保存到标签中。

失败和意外响应

失败的请求会将 traveler 从旅程中移除。请参阅错误和失败的请求。

示例场景：将旅程活动流式传输到 Snowflake

一个团队希望将旅程活动记录在他们自己的报告已经查询的同一个 Snowflake 表格中。

1. 在您想要记录的步骤之后立即添加 Snowflake：插入行。将 表格 设置为 PW.PUBLIC.TRAVELERS。在 列 中，将 DEVICE_ID 设置为 {{device:hwid}}。
2. 点击 保存。

一旦运行，该行就会进入团队的 Snowflake 报告已经读取的同一个表格中。