管理 ByteHouse CE 表--大数据研发治理套件（私有化）-火山引擎

文档中心

大数据研发治理套件（私有化）

Table管理

管理 ByteHouse CE 表

库表管理提供对元数据的创建、编辑、鉴权归属的统一管理。本文为您介绍如何管理 ByteHouse CE 表。

约束限制

数据表创建后，除 TTL 外的其他高级参数均无法被更改，请谨慎设置。
仅在数据地图创建并设置了分区键的新数据表才可在表详情页编辑 TTL 生命周期，具体编辑操作请参见查看 ByteHouse CE 表的基本信息管理部分。
页面最多展示 9999 条表数据。

前提条件

已创建 ByteHouse CE 数据库。相关操作说明可参见管理 ByteHouse CE 库。

操作步骤

登录DataLeap控制台。
选择概览 > 数据地图 > 我的库表 > Table管理，进入Table管理页面。
单击ByteHouse CE页签，进入ByteHouse CE页面。
可执行以下操作：
- 新建ByteHouse CE表
  支持可视化和DDL建表。
  - 单击新建ByteHouse CE表按钮，直接进入可视化建表页面，填写表单后，单击提交按钮，完成ByteHouse CE表创建。
  - 单击新建ByteHouse CE表 > DDL建表按钮，进入DDL建表页面，撰写DDL语句后单击解析按钮显示字段信息，并填写表单其他信息后，单击提交按钮完成ByteHouse CE表创建。
- 设置搜索信息，搜索符合条件的信息列表。
  当设置多个搜索条件时，会取各个条件的交集，进行查询。
  - 搜索库名、表名或负责人关键词。
  - 按照是否核心、是否隐藏等信息进行筛选。
  - 单击列表参数名称的升/降序图标按钮，可以按照对应参数的设置结果查看列表。
- 单击列表中某条数据表信息的表名，可以打开该表详情页面，查看并管理该表的信息，详细说明请参见查看 ByteHouse CE 表。
- 单击列表中某数据表所在行操作列的管理链接，可以修改该表的元数据标签信息。
- 单击列表中某数据表所在行操作列的编辑链接，可以修改该表信息。
- 单击列表中某数据表所在行的 ... > 移交按钮，可以变更表的负责人。
- 单击列表中某条数据表信息操作列的 ... > 权限设置按钮，可以前往权限管理 > 权限设置进行审批流程设置。
- 单击列表中某数据表所在行的 ... > 删除按钮，弹出确认删除对话框，单击确定按钮后，可以删除该表。
- 勾选列表中一个或多个表后，可以进行批量移交、批量删除、批量管理等操作。

注意

如果表没有分区，调整其生命周期时会报错。

新建ByteHouse CE表相关参数说明如下表所示。其中名称前带 * 的参数为必填参数，名称前未带 * 的参数为可选参数。

参数	说明
DDL信息
*DDL语句	撰写DDL语句并解析后，配置字段。说明仅选择 DDL建表时，需设置该参数。
基础信息
*集群	集群名称，下拉可选已创建的ByteHouse CE集群。
*库名	数据库名称，下拉可选已创建的ByteHouse CE数据库。说明仅选择可视化建表时，需设置该参数。若没有该库的建表权限，系统会提示进行申请。
管理业务线	数据表所属的业务线，下拉可选已创建的业务线。说明建议各业务线建立规范建模体系，保障建表的命名规范性，相关操作说明请参见创建业务线。当只有一个业务线时，则在创建表时会默认选中当前的业务线。
数据层级	元数据所在的层级，支持以下选项，下拉可选。支持通过搜索层级名称关键词快速选择。贴源层 [sdata] 历史层 [shdata] 明细层 [pdata] 通用汇总层 [cdata] 维度层 [dim] 集市层 [dm] 说明若选择管理业务线，则仅显示该业务线所包含的数据层级选项。
规范建模类目	业务线下的模型规范类目分类，下拉可选已创建的模型规范类目的数据分类。创建模型规范类目数据分类的相关操作说明请参见类目管理。说明选择管理业务线以及已关联的数据层级后，才可设置该参数。
存储策略	元数据的存储策略，支持以下选项，下拉可选。小时增量（hi）日增量（di）周增量（wi）月增量（mi）小时全量（hf）日全量（df）周全量（wf）月全量（mf）最新全量快照（nf）
*表名	创建在所选数据库下的数据表名称。仅支持数字、小写英文字母、下划线。说明仅选择可视化建表时，需设置该参数。
中文名	数据表的中文名称。
描述信息	对数据表的描述说明，以便后续管理。
字段信息
填写方式	可选择按表单或Excel方式填写。
*英文名称	字段的英文名称。英文名称仅支持以字母、下划线开头，由字母、数字或下划线组成。
*字段类型	根据实际情况填写，支持多种类型，下拉可选。
是否可为空	可选择是否设置该字段可以为空。
*字段描述	字段的说明信息，以便后续管理，必填项。
默认值	字段的默认值，自行设定。默认值可以为表达式或者常量，对于 String 或者 Time 类型的常量值，请在输入值时使用单引号，例如 'Hello Word' 和 '1970-01-01'。
*排序键	用于确定数据在数据库中的物理存储顺序。下拉可选已填写且不为空的字段，最多可设置5个排序键且不可重复。
分区键	用于确定每个数据表行所属的数据分区，以将大型数据表分割为多个较小部分。下拉可选已填写且不为空的字段，最多可设置5个。说明仅 Date 或者 Datetime 类型的字段才可按照 DAY 或 MONTH 进行分区。
TTL	表中数据的生命周期，过期数据将被自动删除。下拉选择字段后，设置数据的生命周期，时间单位自动填充为分区键设置的单位。例如 TTL 设置为 `date` `10` `day`，则数据将在 10 天后被自动删除。说明仅设置Date或者Datetime类型的分区键后，才可设置该参数。
分片键	分片字段用以确保一列数据均匀分布在集群各节点下，可最大化利用集群性能进行查询，一般选择取经常出现在Group by中的字段。说明分片字段只能是String/Int/UInt类型，并且不可为空，下拉可选已填写的字段。
*主键	用于组织数据文件，对数据表中每条记录的唯一标识进行约束。主键下拉可选，选项内容与排序键的顺序关联。
采样键	通过定义采样键获取某些部分的采样数据。从字段类型为UInt的排序键和主键中选择，下拉可选。
*表引擎	支持HaMergeTree 和 HaUniqueMergeTree两个引擎选项。选择 HaUniqueMergeTree 时，可以选择唯一键及其生效范围。
*唯一键	用来保证对应字段中的数据的唯一性。下拉可选已填写且不为空的字段，最多可设置10个。支持两个用于确定唯一值粒度的级别选项，分区范围和数据表范围。唯一键可提供 UPSERT 函数，以确保用户可以查询唯一键的最新值。说明当表引擎选择 HaUniqueMergeTree 时，需设置该参数。
唯一键版本字段	确保唯一键相同的数据仅在当前值≥已有值时进行更新。下拉可选，仅支持UInt、Date或DateTime 类型且不可为空的字段。
安全信息
*保密等级	表的安全等级，由低到高有L1、L2、L3和L4四个选项可选。说明表的密级不能高于所在库的密级。
*表权限负责人	表的数据安全权限负责人，自动填充，可编辑，支持多个。
业务信息
门户业务线	数据表所属的资产门户业务线，下拉可选已创建的业务线，支持多选。说明门户业务线主要面向业务视角提供数据分类与管理，一个资产可以归属到多个门户业务线和多个数据分类。
数据分类	数据表所属的业务分类，下拉可选已创建的综合类、自定义两种类型的数据分类，支持多选。该分类是“资产目录”中，指定业务线下的文件目录名称，用于资产门户构建。说明选择门户业务线后，才可设置该参数。
生命状态	表当前的生命状态，支持以下选项，下拉可选。测试：测试调试的表，不用于实际生产开发。临时：测试或开发临时保存一些数据时使用，会定期清理。在线：用户生产开发的有效表。废弃：已废弃不再用于生产或测试的表。待下线：即将下线的表，不再用于生产开发。说明目前生命状态的选项内容仅做标签使用，不会产生相应的作用。
是否核心	可选择是否将表设置为核心。
自定义标签	为表设定的标签，支持以下两种设置方式：下拉可选已有标签，支持通过搜索标签关键词快速选择。自行设置标签：手动输入标签后，在下拉列表中选择该标签。
业务线标签	为表设定的业务线标签，下拉可选已创建的标签，可设置多个。说明选择门户业务线后，才可选择对应业务线下已创建的标签。
业务术语	表所关联的业务术语，下拉可选已创建的业务术语。支持通过搜索业务术语名称关键词快速选择。
业务系统	该表所属的业务系统，下拉可选系统已配置好的选项。支持通过搜索业务系统名称关键词快速选择。

最近更新时间：2026.02.03 19:37:04

这个页面对您有帮助吗？

有用

无用

大数据研发治理套件（私有化）

约束限制 #

前提条件 #

操作步骤 #

约束限制

前提条件

操作步骤