使用 Cassandra 更新行活动

使用“更新行活动”来更新 Cassandra 中的记录。

关于此任务

使用此任务可更新 Cassandra 实例中的记录。对此活动的调用是同步调用,在此调用中会将输入数据发送到该活动以进行处理并将响应发送回编排。

过程

  1. 在活动编排中,打开活动选项卡,然后展开 Cassandra 文件夹内容。
  2. 更新行活动图标拖至编排上。选择该活动。 此时会显示“Cassandra 更新行活动”核对表
  3. 在核对表中,单击摘要
  4. 复审活动名称字段的内容,并进行所需的更改。
  5. 在核对表中,单击选取端点
  6. 单击浏览,然后使用 Project Explorer 对话框来选择相关的 Cassandra 端点。
  7. 可选:您可以通过单击新建并指定所需的连接详细信息来创建端点。单击确定以保存并使用此配置的端点。
  8. 要对所选端点配置进行所需的更改,请单击编辑以在单独的窗口中访问相应选项。您所作的任何更改都会对活动编排中端点的所有使用产生全局影响。
  9. 在核对表中,单击配置
  10. 配置下,单击 PickTable 并提供 Keyspace 名称。单击浏览以从端点指定的数据库中的当前表列表中动态选择表。

    要选择表,请选择以下一个选项:

    • 单击列表中的某个表,并单击确定
    • 在“过滤器表”部分中提供表名称,然后单击搜索按钮。
  11. 查看网格中显示的所选表的所有列。
  12. UTF-8 编码是 Unicode 的标准字符编码。此为缺省编码。
  13. 如果您已在表中添加/更新/删除现有列,那么使用刷新按钮以获取所选表的更新列详细信息。
    注:
    • 要仅更新数据库中的一行,请直接选择映射输入部分。
    • 要更新多条记录,用户需要选择交付规则选项并启用“批处理”复选框。
  14. 配置下,单击交付规则。选中启用批处理复选框,定义想要一次性更新的行数。
    1. 一旦选中复选框,将在下拉部分中填充“批处理类型”,如下所示:
      • LOGGED
      • UNLOGGED
      • COUNTER
    2. 选择以上任何一个批处理类型。
    3. “写入一致性级别”下拉列表中的缺省值是在测试连接中创建端点时选择的一个值。用户可以通过选择任何一致性级别更改值。
  15. 在“核对表”中选择映射输入。 从更新行活动的选定表生成的 XML 模式将显示为至活动面板中请求输入参数下的节点。

    对于“列”类型映射 <?,?>,模式将包含键、值和更新选项。

    映射的有效 UpdateOption 为:
    • Add:用于添加键值对。
    • Remove:用于除去指定的键。在使用 remove 时,不应将值元素设置为任何值或映射。

    “映射”数据类型的样本输入请求:

    <to_do>      
     <key>Staging</key>
     <value>Box.com</value>
     <updateOption>Add</updateOption>
    </to_do>

    对于“列”类型集 <?> 和“列表” <?>,模式将包含递归元素值和 UpdateOption。

    “列类型列表”<?> 的有效 UpdateOption 值如下所示:
    • Append:用于在现有列表末尾附加单个值。
    • Prepend:用于在现有列表开头附加单个值。
    • Discard:用于丢弃现有列表中的单个值。
    • Append All:用于向现有列表末尾附加值集合。
    • Prepend All:用于向现有列表开头附加值集合。
    • Discard All:用于废弃现有列表中的值集合。
    “列类型集”<?> 的有效 UpdateOption 值如下所示:
    • Add:用于在现有集合中添加单个值。
    • Remove:用于除去现有集合中的单个值。
    • Add All:用于在现有集合中添加值集合。
    • Remove All:用于除去现有集合中的值集合。

    “列表、集合”数据类型的样本输入请求:

    <email>
     <value>john_3@abc.com</value>
     <value>john_4@abc.com</value>
     <value>john_5@abc.com</value>
     <updateOption>Append</updateOption>
    </email>
    
     <projects>
     <value>Salesforce.com</value>
     <value>Box.com</value>
     <value>SL</value>
     <updateOption>Add All</updateOption>
    </projects>
  16. 创建活动的编排变量与输入参数之间的映射。
    注: 在运行时必须为输入结构的任何必要元素都提供值。可以通过为元素指定缺省值或通过将元素映射到输入节点来提供值。在运行时期间,如果没有为必要元素提供值,那么活动会抛出由 Web 管理控制台报告的异常。如果在运行时没有为可选输入参数提供值,那么在运行时期间不会抛出异常。
  17. 核对表中选择映射输出。 所生成用于保存活动的响应的 XML 模式将显示为自活动面板中响应输出参数下的节点。
  18. 创建输出参数与编排变量之间的映射。

结果

您已配置“Cassandra 更新行”活动。
注:

您可以将多个对象作为输入添加到此活动。要将多个对象添加为输入,请在映射输入至活动窗格中右键单击对象名称(例如:过滤器)字段,然后选择展开出现示例