Skip to main content

输出数据工具

使用输出数据工具将工作流的结果写入受支持的文件类型或数据源。

在工具面板中选择“输出数据”工具,并将其拖放到工作流画布上。

工具组件

Output Data with Anchors.png

图解:带锚点的“输出数据”工具。

“输出数据”工具有 1 个锚点。

输入锚点:将输入锚点连接到工作流,以将工作流结果写入数据源或支持的文件类型。

配置工具

保存到基于文件的连接

将工作流结果写入基于文件的连接:

  1. 从工具的“配置”窗口中,单击选择输出位置以打开“输出数据”窗口。

  2. 连接中选择云数据连接,或从您的现有数据集中选择。

  3. 输入文件名。酌情选择 {x}(添加参数)图标,以向文件名添加参数。如需了解详情,请参阅参数部分。

  4. 选择文件格式

    • CSV:逗号分隔值 (.csv)

    • XLS:Microsoft Excel 1997–2003 (.xls)

    • XLSX:Microsoft Excel (.xlsx)

  5. 接下来,选择要保存输出数据的位置。您可以使用默认的文件路径,或者选中自定义位置复选框来选择其他位置。如果选择自定义位置,则可以使用 {x}(添加参数)图标将参数添加到文件路径。如需了解详情,请参阅参数部分。

  6. 选择下一步以自定义输出选项

  7. 使用每次运行后的输出选项下拉列表,选择在作业运行时如果存在同名文件需要执行的操作。

    1. 对于 CSV 文件:

      1. 新建

      2. 覆盖

    2. 对于 Excel 文件:

      1. 创建新工作簿

      2. 覆盖工作簿

      3. 创建新工作表

      4. 覆盖现有工作表

      5. 附加到工作表

      现在,您可以同时向 Excel 工作簿中的不同工作表写入数据。这意味着您可以使用两个或更多输出工具,将内容写入同一工作簿中的不同工作表。您无需使用“阻止直到完成”工具即可运行此操作。仅当选择覆盖现有工作表时,才支持并发操作。

  8. 如果选择了 CSV 文件格式,请选择一种列分隔符。选项包括逗号制表符竖线分号

  9. 为输出选择其他选项:

    • 包含引号(仅限于 CSV 文件格式)

    • 工作表名称(仅限 XLS 和 XLSX 格式)

    • 分区输出(仅限 XLS 和 XLSX 格式):选择将文件发布为单个工作表文件或包含多个工作表的文件。如果选中,请通过使用列进行分区下拉列表选择要用于根据列值对工作表进行分区的列。

    • 在输出中保留分区列(仅限 XLS 和 XLSX 格式):取消选中可将用于分区的列从最终输出中排除。例如,如果按季度划分,您可以从输出中排除“季度”列。

    • 在第一行包含列名称

  10. 选择确认以保存输出数据详情。然后,您可以在输出数据工具的配置面板中查看所选项,并在需要时使用铅笔图标进行修改。

  11. 选择运行作业将其添加到您的工作流,并将文件保存到所选连接。

保存到基于 SQL 的连接

将工作流的结果写入基于 SQL 的连接:

  1. 从工具的“配置”窗口中,单击选择输出位置以打开“输出数据”窗口。

  2. 连接中选择云数据连接,或从您的现有数据集中选择。

  3. 输入表格名称。酌情选择 {x}(添加参数)图标,以向表格名称添加参数。如需了解详情,请参阅参数部分。

  4. 接下来,选择要保存表格的架构,然后选择下一步

  5. 如果在作业运行时存在同名表格,请通过每次运行后的输出选项下拉列表选择要执行的操作。

    • 创建新表格:创建新表格。

    • 附加到表中:将数据附加到现有表的末尾。

    • 截断现有表:将删除现有表数据,并替换为新数据。

    • 删除现有表:将删除现有表并替换为新表。

    • 与现有表合并:输出数据与现有表合并。

  6. 选择确认以保存输出数据详情。然后,您可以在输出数据工具的配置面板中查看所选项,并在需要时使用铅笔图标进行修改。

  7. 选择运行作业将其添加到您的工作流,并将文件保存到所选连接。

下载文件

要将输出数据下载到电脑,首先将其保存在 Alteryx One 中。最快的选项是将文件保存到基础存储中的默认位置。您也可以自定义基础存储中的位置,或选择其他连接器。

然后在运行工作流后,转至画布上的输出工具,并在右侧面板的作业部分中选择下载

参数

使用参数将动态字符串或时间戳值应用于输出数据。您可以将参数应用于文件名、文件路径或表格名称,具体取决于云连接的类型。

  • 字符串参数具有默认值,可以在每次作业执行、计划或规划中覆盖该默认值。

  • 时间戳参数会在作业执行时自动填充格式化后的时间戳。

文件名表格名称中使用参数...

  1. 文件名表格名称字段中,选择 {x}(添加参数)图标,以打开参数窗口。

  2. 如果您之前创建过参数,请从工作区参数部分中选择它。请注意,参数将插入到“文件名”字段中光标所在的位置。要从文件名中移除参数,请选择该参数,然后选择移除

  3. 如果需要创建新参数,请选择 + 新建。您也可以选择管理参数链接以打开“参数”页面,在其中创建新参数并编辑现有参数。

文件路径中使用参数...

  1. 选中“自定义位置”复选框。

  2. 选择文件路径旁边的编辑(铅笔)图标。

  3. 选择 {x}(添加参数)图标,打开参数窗口。

  4. 如果您之前创建过参数,请从工作区参数部分中选择它。请注意,参数将插入到“文件名”字段中光标所在的位置。要从文件名中移除参数,请选择该参数,然后选择移除

  5. 如果需要创建新参数,请选择 + 新建。您也可以选择管理参数链接以打开“参数”页面,在其中创建新参数并编辑现有参数。

创建字符串参数

使用字符串参数动态地为输出数据添加标签。

  1. 要创建字符串参数,请在“参数”窗口中选择 + 新建,然后从类型下拉列表中选择字符串

  2. 输入参数名称。如果使用该参数,此名称将显示在“文件名”字段中。

  3. 输入描述。描述应清晰明了,便于您和其他用户日后使用。

  4. 输入参数的默认值。如果参数没有动态更新,则使用此值。

  5. 选择创建以创建参数并将其添加到名称或路径。要移除参数,请选择该参数,然后选择移除

创建时间戳参数

使用时间戳参数在作业执行时自动填充格式化后的时间戳。

注意

与字符串参数不同,时间戳参数不会存储在参数页面上。

  1. 要创建时间戳参数,请从“参数”窗口中选择 + 新建,然后从类型下拉列表中选择时间戳

  2. 根据需要自定义时间戳格式。默认格式为 yyyy-MM-dd。选择 + 按钮查看您的自定义选项。格式预览将使用您选择的格式显示今天的日期。

  3. 接下来,设置时间戳值。从以下项目中选择...

    • 作业开始时的确切时间:输出作业开始时的确切时间戳值。

    • 作业开始时的相对时间:输出相对于作业开始时间的时间戳。例如,您可能需要作业开始时间后一小时的时间戳。

      • 发生时间:选择输出在作业开始时间之后之前的时间戳。

      • :为相对时间戳选择一个数值。

      • 单位:为相对时间戳选择一个单位。您的选择包括:

        • 分钟

        • 小时

        • 季度

  4. 接下来,为时间戳参数选择时区

  5. 最后,选择创建来创建参数并将其插入到光标位置。

覆盖参数

当您使用字符串参数运行工作流时,工作流将使用您创建参数时指定的默认值。但您可以选择覆盖此值。

覆盖字符串参数的默认值...

  1. 选择运行作业按钮中的下拉图标。

  2. 选择参数以打开覆盖参数窗口。

  3. 值覆盖列中,为所有不使用默认值的参数输入覆盖值。

  4. 选择保存并运行作业,以使用更新后的参数值运行工作流。