库表映射

最近更新时间:2025-07-08 10:41:53

我的收藏
本文为您介绍对分析集群设置库表映射的相关说明和操作。
注意:
未设置库表映射的对象,无法在分析引擎中进行查询。因此在完成对象加载配置后,需要手动设置库表映射。

操作场景

在分析集群中,支持将多个数据源的数据同步到分析集群。当数据加载到分析集群完成后,默认是无法进行查询的,这是因为所有对象均需要存在映射名称,通过映射名称才可以进行查询,因此需要进行库表映射设置。

前提条件

准备好分析集群,请参见 创建分析集群
集群状态为运行中。

映射名称说明

在分析集群中,所有对象均是由 TDSQL-C MySQL 版分析集群自动从源端数据库中同步而来。但同步到分析集群中的对象必须使用映射名称进行表对象的数据查看。映射名称支持修改,例如源端的库表名称为“db1.ta2”,同步到分析集群后,可设置名称为"db3.ta3"。

如何查看映射名称

1. 登录 TDSQL-C MySQL 版控制台,在上方选择 MySQL 版(分析集群)
2. 在左侧集群列表,单击目标集群,进入集群管理页。
3. 在集群详情页下的计算节点下,单击详情,进入实例详情页面。
4. 对象信息下,可查看到所有同步到分析集群中的库表信息,映射库名和映射表名即为其映射名称。如果字段映射库名和映射表名为空,则代表未设置映射,无法在数据库中进行查询。
说明:
如果存在已同步的对象没有映射名称,则会在映射库名和映射表名前标记红色感叹号,您可通过此标记快速了解是否设置了库表映射。


在修改对象时设置库表映射

在修改对象或者添加新的对象时,可单击下一步,跳转并进行库表映射设置,您可选择其中一个设置,然后单击确定


根据默认规则强制设置所有库表映射名:默认规则为将所有同步到分析集群的数据库以“数据库名_实例 ID”格式进行命名。例如数据库 database1 的源端实例为 cdb-af321a3,则激活此按钮后,此数据库的映射名称为“database1_cdb-af321a3”。
与源端库表名称保持一致,重名对象自动取消映射:将加入同步列表中的对象的映射名设置成和源端的库表名一致。但由于在多源数据合并场景下,可能会出现库表名重复的问题,如果出现重复库表名问题,重复库表的映射名将置为空。需要后续手动进行库表映射设置。
说明:
以上两个选项默认关闭,激活任意按钮后,会将所有已经修改了映射名的对象刷新为对应规则的映射名。建议在初次配置时才选择这两个选项。

在对象列表中设置库表映射

如果对象信息列表下,存在对象没有映射名称,则会在对象列表中映射库名和映射表名列标记红色的感叹号。此时单击对应表的操作列下的设置映射,即可为选中的表进行映射名称设置。


批量为对象设置映射名称

如果需要同时为多个对象设置映射名称,可通过多选的方式,勾选需要设置映射名称的多个对象。然后单击对象信息后的设置映射。在设置映射右上方会提示目前已经选中的对象数量。
说明:
单击数量提示,可在弹窗中清空已经选择的对象。


如何判断库表对象是否设置映射名称

如果一个对象未设置映射名称,则会默认将其库名和表名分别填到映射库名和映射表名文本框中。

如果一个对象已经设置过映射名称,则会将其修改后的库名和表名分别显示到映射库名和映射表名文本框中。