Skip to main content

输出数据工具

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

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

工具组件

Output Data with Anchors.png

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

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

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

配置工具

For Google BigQuery Live Query workflows, you can save results as CSV or Excel files to the workspace’s Google Cloud Storage base storage, or write results to any eligible BigQuery connection in the workspace. Only supported output destinations and file formats appear in the tool. Other storage destinations aren't supported.

Save to CSV or Excel

To save your results to a file:

  1. From the tool configuration window, select Select Output Location to open the Output Data window.

  2. Choose a supported file-output destination.

  3. Enter a File Name.

  4. From Format, choose the required CSV or Excel format.

  5. Review the File Path. To change it, select Customize Location and choose the destination folder.

  6. Select Next to open Output Options.

  7. Choose an available Output Actions on Every Run setting to specify how subsequent runs handle an existing file or workbook.

  8. Configure the options displayed for your selected format.

  9. Select Confirm. To revise the saved configuration, select the pencil icon in the tool configuration panel.

  10. Select Run Job to execute the workflow and publish the file.

注意

CSV and Excel output is also supported in Snowflake Live Query workflows.

保存到Google BigQuery

对于 CDP 表格输出,选择可通过符合条件的连接访问的目录、数据库或架构。当前没有隐式默认架构。您选择目标。在同一连接中,您可以选择一个可用的数据库。

CDP 输出的表名称可进行参数化。

将工作流的结果写入Google BigQuery:

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

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

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

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

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

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

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

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

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

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

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

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

注意

临时输出当前不可用作面向用户的输出选项。

输出权限

您的连接必须具有运行作业并写入所选输出目标所需的权限。

表格输出要求对目标具有相应的创建或写入权限。

参数

使用参数将动态字符串或时间戳值应用于输出数据。您可以将参数应用于表格名称。

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

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

在表格名称中使用参数...

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

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

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

创建字符串参数

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

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

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

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

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

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

创建时间戳参数

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

注意

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

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

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

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

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

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

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

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

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

        • 分钟

        • 小时

        • 天

        • 周

        • 月

        • 季度

        • 年

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

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

覆盖参数

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

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

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

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

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

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