通过将各个步骤合并到同一个链中,可以进一步简化数据管理。在此连通学习路径中,我们将介绍替换 Wdata 表中数据的最佳方法,这是一个使用一个链的两步过程。
主要业务用例 | 表管理 |
主要学习目标 | 使用链替换 Wdata 表中的数据 |
先决条件 | |
配套模板 | CLP | 替换表中的数据 |
步骤 1:运行链
- 导航到 CLP | 将数据上传到表 链
- 单击 执行 ,然后选择 使用输入运行
- 为运行时输入添加值
- 表 ID - CLP 员工详细信息表的 ID
- 文件名 - 任何你想命名的文件名称,在这个例子中,我们将文件命名为“员工详细信息”
- 文件位置 - https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail.csv
- 点击 开始
- 链完成后,单击 将文件导入表 节点以验证成功
- CLP 员工详细信息表中现在有可用的数据,我们现在将用更新的数据集替换它,使用单链删除旧数据并上传新数据。
步骤 2:创建链
- 添加新的 链
- 命名链: CLP | 替换表中的数据
- 保存链条
步骤 3:运行时输入
我们使用运行时输入命令来启动链。这使我们能够指定文件名以及运行链时将导入该文件的表的 ID。
- 在开始区域添加一个来自 Chain Trigger Events 的 Runtime Inputs 命令
- 通过双击命令来编辑运行时输入链事件
- 添加以下三个输入:
- 输入 1:
- 类型:TextField
- 显示名称: 表格 ID
- 必填:勾选
- 输入 2:
- 类型:TextField
- 显示名称: 文件名
- 必填:勾选
- 输入 3:
- 类型:TextField
- 显示名称: 文件位置
- 必填:勾选
- 输入 1:
- 添加以下三个输入:
- 保存命令
步骤 4:列出文件
为了删除表中的旧文件,我们需要文件 ID。为了以编程方式找到 FileID,我们将使用列出文件命令。该命令使用表 ID 搜索该表中的所有文件,并为我们提供文件的输出以及有关这些文件的信息,包括文件 ID。
- 将 列出文件 命令添 加到 Chain 画布
- 将 运行时输入 链事件连接到 列出 文件 命令
- 双击命令进行配置
- 点击 表ID 字段
- 在左侧的 变量 面板中,单击向下的箭头展开 触发器
- 单击向下箭头展开 运行时输入
- 选择 表ID
- 点击 表ID 字段
- 保存命令
步骤 5:从表中取消导入文件
与将数据上传到表类似,从表中删除数据是一个两步过程。该文件必须先移至暂存状态,然后才能删除。要将文件设置为暂存,需要取消导入它。我们将使用从表命令取消导入文件来准备要删除的数据集。
- 将 从表 取消导入文件命令添加到链画布
- 将 列出文件 命令连接到 从表中取消导入文件 命令
- 双击命令进行配置
- 点击 表ID 字段
- 在左侧的 变量 面板中,单击向下的箭头展开 触发器
- 单击向下箭头展开 运行时输入
- 选择 表ID
- 点击 文件ID 字段
- 在左侧变量面板中,单击向下箭头展开 列出文件
- 选择 文件列表
- 点击列表文件-文件列表变量,将变量
- 单击选择转换,然后选择 从 JSON 获取值
- 单击加号添加变量转换
- 在值字段中输入'0',然后按回车键。出现 =0 后,输入'id'并再次按回车键。该变量现在将读取 List Files 命令的 JSON 输出并找到表中第一个文件的 id。
- 点击 表ID 字段
提示!解析 JSON 值时要特别注意大写和小写
-
-
-
- 单击“接受”
- 单击“接受”
-
-
- 保存命令
步骤 6:下载文件
接下来,我们可以从表中删除暂存的文件,或者准备上传新的文件。建议在取消导入旧文件后上传新文件,以确保在正式删除任何数据之前该过程成功。为了准备上传新文件,我们首先必须使用 HTTP 请求获取命令下载该文件。我们已经在线托管了一个文件供Chain下载,以演示如何从云端下载文件。
- 从 HTTP 请求 连接器向链画布添加 获取 命令
- 将 Un-import File from Table 命令连接到 Get 命令
- 双击命令进行配置
- 点击 URL 字段
- 在左侧的 选择变量 面 板中,单击向下的箭头展开 触发器
- 单击向下箭头展开 运行时输入
- 选择 文件位置
- 将 内容类型 字段更新为: application/csv
- 点击 URL 字段
- 保存命令
步骤 7:创建文件
就像我们在 将数据上传到表连接学习路径中所做的那样,我们将遵循将数据上传到 Wdata 表的两步流程。首先需要以暂存状态创建文件,然后才能导入以供最终使用。我们将使用创建文件命令在暂存状态下的 Wdata 表中创建文件,表明它已创建但尚未作为数据集导入。
- 将 Workiva Connector 中的 创建文件 命令添加到 Chain 画布
- 将 Get 命令连接到 Create File 命令
- 双击命令进行配置
- 点击 表ID 字段
- 在左侧的 选择变量 面 板中,单击向下的箭头展开 触发器
- 单击向下箭头展开 运行时输入
- 选择 表ID
- 点击 文件 字段
- 在左侧的 Select a Variable 面 板中,单击向下箭头展开 GET
- 选择 回应
- 点击 名称 字段
- 在左侧的 选择变量 面板中,单击向下的箭头展开 触发器
- 单击向下箭头展开 运行时输入
- 选择 文件名
- 在左侧的 选择一个变量 面板中,单击向下的箭头展开 运行时
- 选择 Chain.ExecutionDateTime
- 在两个变量后输入“.csv”
- 我们使用 Chain.ExecutionDateTime 变量来显示文件的生成时间并确保每个文件都有唯一的名称
- 点击 表ID 字段
步骤 8:将文件导入表
将文件上传到 Wdata 表的第二步是导入数据,使其可用于查询。此步骤将暂存文件作为数据集导入到指定的表中。
- 将 将文件导入表 命令从 Workiva 连接器 添加到链画布
- 将 创建文件 命令连接到 将文件导入表 命令
- 双击命令进行配置
- 点击 表ID 字段
- 在左侧的 选择变量 面板中,单击向下的箭头展开 触发器
- 单击向下箭头展开 运行时输入
- 选择 表ID
- 点击 文件ID 字段
- 在左侧的 选择变量 面板中,单击向下的箭头展开 创建文件
- 选择 结果
- 点击 创建文件-结果 进行转换
- 在 选择转换 下拉菜单中,选择 从 JSON 获取值
- 点击 + 按钮
- 在值字段中,输入 id 并按 Enter
- 点击 接受
- 点击 表ID 字段
- 保存命令
步骤 9:删除文件
现在,新数据已上传并可供使用,旧数据集也已暂存,最后一步是正式删除旧数据。此步骤使用删除文件命令从表中删除数据集。
- 将 删除文件 命令从 Workiva 连接器 添加到链画布
- 将 将文件导入表 命令连接到 删除 文件 命令
- 双击命令进行配置
- 为了确保删除与取消导入的文件相同的文件,我们将以与从表命令中取消导入文件相同的方式生成文件 ID,如下所示:
- 点击 文件ID 字段
- 在左侧变量面板中,单击向下箭头展开 列出文件
- 选择 文件列表
- 点击列表文件-文件列表变量,将变量
- 单击选择转换,然后选择 从 JSON 获取值
- 单击加号添加变量转换
- 在值字段中输入'0',然后按回车键。出现 =0 后,输入'id'并再次按回车键。该变量现在将读取 List Files 命令的 JSON 输出并找到表中第一个文件的 id。
提示!解析 JSON 值时要特别注意大写和小写
-
-
-
- 单击“接受”
- 单击“接受”
-
-
- 保存命令
步骤 10:测试练习
现在链已完成,请测试结果。
- 单击 执行 ,然后选择 使用输入运行
- 为运行时输入添加值
- 表 ID - CLP 员工详细信息表的 ID
- 文件名 - 任何你想命名的文件名称,在这个例子中,我们将文件命名为“员工详细信息”
- 文件位置 - https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail_replace.csv
- 点击 开始
- Chain 应该已经成功删除了旧文件,并用新文件替换到你的表中
- 您可以通过导航到 Wdata 中的表格并查看右侧面板中的数据集来验证表格中的数据是否已被替换
要了解有关使用链简化数据收集的更多信息,请查看其余的 数据集中路径!