同步表管理

1. 概述

1.1 什么是同步表

同步表是简道云推出的一种全新表类型,其定位与表单、聚合表、数据工厂输出表不同。它主要用于将外部平台的数据实时或定期同步到简道云中,供表单直接调用,从而实现内外数据的连接与融合。

配置一个同步表主要包含三个环节:

  • 配置来源:选择需要同步的外部数据源,例如金蝶云星空(企业版)、飞书表格等。
  • 配置去向指定同步表的归属应用,从而在该应用的表单中调用同步表。
  • 配置同步细节:设置同步起点、同步频率等运行规则。

1.2 功能简介

在「同步表管理」页面下,可查看所有已配置的同步表信息,支持手动/定时同步数据等操作。

1.3 推荐配置方式

为了满足企业内不同角色的使用需求,同步表在「开放平台」与「应用搭建后台」提供了两种视图,推荐以下配置方式:

  • 系统管理员:负责其他平台数据接入及后续运维,包括:新建数据连接、新建同步表、配置同步规则等操作。
  • 表单搭建者:在搭建表单时调用同步表数据。

2. 同步表权限说明

同步表相关权限说明如下:

角色名称

功能页面

应用后台-同步表

开放平台-数据集成

企业创建者

  • 可查看
  • 可编辑
  • 可查看
  • 可编辑

系统管理员

  • 可查看
  • 可编辑
  • 可查看
  • 可编辑

普通管理组

  • 可查看应用内所有同步表
  • 可查看数据详情
  • 不可查看引用详情、同步日志
  • 不可创建同步表、同步数据
  • 不可查看
  • 不可编辑

应用管理组

  • 可查看应用内所有同步表
  • 可查看数据详情
  • 不可查看引用详情、同步日志
  • 不可创建同步表、同步数据
  • 不可查看
  • 不可编辑

普通成员

  • 不可查看
  • 不可编辑
  • 不可查看
  • 不可编辑

3. 新建同步表

点击「新建同步表」,对同步表进行配置。如下图所示:

3.1 配置来源

1)配置来源可选择:

  • 已有数据连接:使用「数据连接管理」已经配置好的数据连接
  • 新建数据连接:从数据源市场可用的数据源中配置新的数据连接

2)选择某一数据连接作为「数据来源」,点击「下一步」。如下图所示:

3.2 配置去向

选择某一应用作为「数据去向」,根据同步规则,将数据源数据同步至所选应用中。如下图所示:

3.3 配置同步细节

1)点击「添加表」,勾选需要同步数据的表。如下图所示:

2)右侧区域可配置同步表名称&同步规则,说明见下表:

配置项

说明

同步表名称

同步至应用后的表名称

字段详情

展示该表的原始名称、当前字段名称、字段类型以及主键信息

取数起点

全量表无此配置

增量表支持配置 首次同步 取数起点,即从配置日期开始按照同步规则取数

同步表配置完成后,此配置不支持修改,可通过「同步指定范围数据」修改取数起点

同步模式

全量表:全量同步,即删除并重新获取全部数据,按照主键去重。

增量表:增量同步,即根据游标和业务时间字段,从上次同步完成的节点开始取数。 旧数据按照主键更新,新数据直接插入。

示例说明:

  • 游标 lastSyncTime :记录上一次成功完成数据同步的时间点,例如 2026-01-01 00:00:00
  • 最后修改日期:数据最后一次更新的时间戳,例如 2026-01-15 00:00:00
  • 指定取数时间范围为:2026-01-01 00:00:00 至 2026-01-15 00:00:00

筛选规则:先圈定出指定取数时间范围内最后修改日期晚于 lastSyncTime 的「新增 / 修改」目标数据

同步规则

  • 若主键已存在,则执行更新,覆盖旧数据;
  • 若主键不存在,则执行插入,新增数据。

同步后处理:将 lastSyncTime 更新为本次同步数据最晚的最后修改时间,作为下一次增量同步的起点

定时同步

开启「定时同步」后,将数据定时同步至所选应用

支持配置数据开始同步时间和同步周期

3)上述信息配置完成后,即可新建同步表。如下图所示:

4. 同步表管理

同步表配置完成后,将以列表的形式展示在「同步表管理」tab 下,支持查看同步状态,同步数据等操作。如下图所示:

4.1 同步数据

4.1.1 手动同步

点击右侧「同步数据」按钮,可对单张表进行同步。如下图所示:

4.1.2 定时同步

在「新建同步表」时支持配置定时同步,设置开始同步时间和同步周期。与新建同步表时的定时同步配置保持一致。如下图所示:

4.1.3 批量同步表/批量定时同步

在列表勾选多张表,支持批量手动同步/批量定时同步。如下图所示:

4.1.4 修改同步细节

点击「修改同步细节」,可对同步表的部分配置项进行修改。如下图所示:

主表&子表支持修改的内容如下:

  • 主表:支持修改同步表名称、定时同步
  • 子表:支持修改同步表名称

4.1.5 同步指定范围数据

仅增量表支持此功能。

新建同步表时,配置的是首次同步取数起点。若后期想要获取更久之前的历史数据,可通过此配置修改取数起点。

4.2 查看日志

选择某同步表,点击「查看日志」,可以查看同步信息,比如:同步耗时,同步后游标位置,写入数据量等等。

4.3 删除

如果不需要该同步表,点击「删除」即可。在删除之前,请先在应用后台中「查看引用详情」,确保该表没有被表单引用,避免因误删导致表单配置丢失。如下图所示:

若同步表包含主表+子表,删除主表时会一并删除子表。若仅包含主表,删除时只删除主表。

5. 应用后台-同步表

点击同步表名称,可跳转至「应用后台-同步表」。如下图所示:

5.1 查看数据详情

若同步表同步成功后,点击「查看数据详情」,可查看该表的明细数据。如下图所示:

5.2 查看引用详情

点击「查看引用详情」,可查看此同步表被哪些表单中的哪些字段引用。点击「前往修改」可一键定位到引用同步表的表单中进行查看或编辑。如下图所示:

5.3 同步日志/同步数据

在应用后台,也支持查看同步日志或同步数据,详情请参见本文第 3 节。

5.4 创建同步表

点击「创建同步表」可跳转到开放平台,详情请参见本文第 3 节。

文档内容是否对您有帮助?
有帮助
没帮助没帮助
如需获取即时帮助,请联系技术支持
咨询
扫码领取100+零代码资料简道云官方微信号400-111-0890
图标在线咨询
立即体验