分区表同步

最近更新 2026/09/23

分区表同步用于将外部存储中可发现的分区更新到空间表的分区元数据中。开启自动同步后，系统会定期检查分区变化；您也可以在表详情中对当前环境立即发起一次同步。

功能说明与适用范围

分区同步适用于数据开发平台「库表」中的 Hive 外部分区表。目标表需要同时满足以下条件：

• 管理模式为「空间-任务表」；
• 存储类型为「外表」；
• 分区类型为「分区表」，并且至少包含一个分区字段。

内表、非分区外表和视图不显示自动同步配置或手动同步入口。手动同步还需要当前用户具有库表编辑权限。

开启自动同步分区

创建符合条件的外部分区表时，「自动同步分区」默认开启。您也可以在后续编辑表时调整该配置。

1. 进入 数据开发平台 > 库表，创建外部分区表，或打开已有外部分区表后点击 编辑。
2. 使用向导式编辑时，展开 高级配置；使用 DDL 编辑时，找到存储配置区域。
3. 勾选或取消勾选 自动同步分区。
4. 点击 仅保存 或 发布上线，使配置生效。

自动同步配置由开发环境和生产环境共用。开启后，系统会定期检查两个环境中的分区变化；关闭后，您仍可以手动同步分区。

在高级配置中开启或关闭自动同步分区

查看同步状态

1. 进入 数据开发平台 > 库表，打开需要查看的外部分区表。
2. 在页面顶部选择 开发环境 或 生产环境。
3. 打开 分区 页签。

页面会显示自动同步是否开启，以及当前环境最近一次同步成功或失败的结果和发起时间。同步失败时，将鼠标移到提示图标上可以查看失败原因。

开发环境和生产环境分别维护最近同步结果。切换环境后，分区列表和同步状态会随之切换，自动同步配置保持不变。

在分区页签查看同步状态并手动同步当前环境

手动同步分区

需要立即更新当前环境的分区时，在表详情的 分区 页签中点击 立即同步。

提交成功后，页面提示「已提交分区同步」，按钮变为「同步中」。该提示表示系统已经受理请求，不代表同步已经完成。同步结束后，页面会更新为「最新同步成功」或「最新同步失败」，并刷新当前环境的分区列表。

手动同步只处理页面当前选择的环境。关闭自动同步不会影响手动同步；没有库表编辑权限时，页面不显示「立即同步」。如果该表已有同步任务正在执行，请等待当前任务结束后再试。

同步规则与注意事项

规则	说明
同步范围	同步会登记外部存储中新增的分区，并清理外部存储中已不存在的分区元数据。
数据文件	同步只调整分区元数据，不搬运、修改或删除外部存储中的数据文件。
环境	自动同步配置由开发环境和生产环境共用；最近结果和分区列表按环境分别展示；手动同步只作用于当前环境。
执行时机	保存自动同步配置不会立即触发同步。如需马上更新分区，请点击「立即同步」。
成功结果	同步成功表示当前可发现的分区目录已与分区元数据对齐，不代表外部数据写入已经完成或数据一定可读。

警告

分区同步可能移除外部存储中已不存在目录对应的分区元数据。执行手动同步前，请确认外部写入已经完成，并且目标目录可被平台正常访问。