在模型中建模时，有时会需要使用一些外部数据，而这些外部数据并不在目标数据库中。

外部数据往往存在于用户的本地，可以是 EXCEL、CSV等格式的文件，我们在建模查询中将这些外部数据称为本地实体。

将本地实体添加到模型中，即可以在一个查询中与目标数据库中的其他表一起聚合、过滤和计算。

本节为您介绍如何在模型中添加本地实体。

添加本地实体

注意

当使用 SQLServer、MySQL、Postgressql和Oracle这几种数据库进行数据建模时，支持添加本地实体。

单击界面中的添加本地实体，可以看到支持三种方式添加本地实体。第一种为手动添加，后两种为直接导入文件。

手动输入数据

选择第一项添加本地实体，也就是手动输入实体的数据。

• 实体名称不能与其他实体名称重复。

• 可修改列名和列数据类型。

• 通过单击右上角的按钮可添加行或列，您可以删除列和行。总行数不得超过2000行，总的列数不得超过14列。

• 如果输入“NULL”，值自动转换为空值。

  
  

输入完成后，单击界面右下角的添加按钮，即可将实体添加至模型中。

导入实体数据

选择第二项导入EXCEL文件或者第三项导入CSV文件时，也就是导入本地实体的数据。

• 实体名称不能与其他实体名称重复。

• 文件类型必须是 excel 或 csv。

• 导入文件也是限制在2000行，14列内，否则无法导入。

如果 Excel 文件为加密文件，需输入 Excel 的密码。可以设置将第一行转为为列头，隐藏数据表，以及转化空单元格等。与连接 Excel 数据源时的配置相同。

如果导入 CSV文件，则可以设置列分隔符。

单击下一步后，进入实体数据修改界面，与手动输入数据时的操作方法是一致的。在此界面可修改列名，数据类型，数据内容以及增加或删除行列等。

最后单击添加按钮即可。