数据集订阅

概述

数据集订阅是一种将BI平台中的数据集定期或按需导出到指定FTP/SFTP服务器的功能，支持定时自动执行和URL触发，可按字段拆分导出，适用于数据备份、跨系统数据同步、定期数据分发等场景，提高数据流通效率和系统集成能力。

前提条件

数据集订阅将导出到用户指定的FTP/SFTP服务器，需要配置相关FTP/SFTP数据账户。

1. 在「数据准备 > 数据账户」页面，点击「新建数据账户」。

   

2. 选择连接器为「FTP/SFTP」，点击「下一步」。

   

3. 配置数据账户，后续操作可参考数据账户。

   
   • 文件名编码格式：支持「UTF-8」和「GBK」
   • 数据库地址（域名或IP）：填写目标服务器的域名（如xxx.com）或 IP 地址（如192.168.xxx.xxx）。
   • 端口：FTP 默认端口为 21，SFTP 默认端口为 22
   • 协议：选择 FTP / SFTP
   • 目录：填写文件存储的根路径，默认 / 代表服务器根目录
   • 用户名/密码：填写账号和密码

创建订阅

1. 点击右上角「九宫格」按钮中的「订阅计划」，进入「订阅计划」页面。

   

2. 选择「数据集订阅」，点击右侧的「添加数据集订阅」按钮，即可进入「数据集订阅」的配置页面。

   

配置订阅

启用订阅

选择「启用」或「禁止」该订阅，启用状态不限制手动触发、URL触发。

订阅名称

为该订阅创建名称，便于在订阅管理中快速找到该订阅。

数据集

选择需要订阅的数据集。

说明

不可选择直连数据集。

拆分订阅

按照数据集的字段进行拆分订阅将数据集拆分成不同的文件至FTP服务器

触发方式

可选择「数据更新后」、「定时执行」、「手动触发」以及「URL触发」四种触发方式。

• 数据更新后：当卡片源数据更新后，卡片数据更新，并触发订阅。

• 定时执行：可以设定每天/每周/每月的某个固定时间发送。

• 手动触发：在订阅计划界面，手动发送。

• URL触发：勾选后，可在外部系统中通过URL直接触发当前订阅的发送。

  说明

  只有创建完成订阅，才可以勾选「URL触发」

有效期

可选择「长期有效」或「时间范围内有效」。若选择「时间范围内有效」：

• 可设置从开始到结束的日期，若不设置，默认为长期有效；
• 当订阅周期结束后，点击「手动发送」或调用API依旧能发送订阅；
• 周期与启用/禁用：启用状态下，周期结束之后，停止发送订阅；禁用状态下，周期还未结束时，依旧不发送。

失败通知

当订阅失败后将通过邮件通知相关用户。

文件输出

• 格式：导出文件的格式，可以选择Excel或CSV

• 名称：导出文件的名称，导出文件的名称，允许使用拆分字段、参数（时间宏）或者固定文本

  • 仅使用固定文本时，单个拆分字段选择了多个值时，此时仅会默认取第一个值
  • 若需要多个值同时生效，需要将拆分字段设置在名称上

• 路径：选择一个FTP/SFTP地址，填入一个不包含根目录的文件输出路径，允许使用拆分字段、时间宏或者固定文本

• 是否带时间戳：选「否」则会覆盖文件，选「是」则会在文件中携带相关时间戳信息

常见问题

关于订阅相关的常见问题，详见常见问题。