1. 内容概述

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

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

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

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

2. 添加本地实体

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

手动输入数据

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

• 实体名称不能与其他实体名称重复。
• 可修改列名和列数据类型。
• 通过单击右上角的按钮可添加行或列，您可以删除列和行。总行数不得超过2000行，总的列数不得超过14列。
• 如果输入“NULL”，值自动转换为空值。

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

导入实体数据

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

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

• 文件类型必须是 excel 或 csv。 
• 导入文件也是限制在2000行，14列内，否则无法导入。
  
  

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

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

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

最后单击“添加”按钮即可。