DataFocus
简体中文
← 返回博客

DataFocus · 博客

将 CSV、Excel 和 JSON 文件导入 OT Flash

从桌面上的一份表格到绑定本体、可搜索的 OT Flash 数据表,只用数据表管理、本体管理和数据搜索三个界面,一步步走完。

要把 CSV 或 Excel 文件导入 OT Flash,先打开 Tables(数据表管理),点击 Import Table,选择 “Import table from local”,选定文件格式(CSV、EXCEL 或 JSON)并上传文件,设置解析选项,确认列名和类型,最后点击 Submit。新数据表会出现在数据表列表的最前面。若要让它成为某个本体的一部分,打开该本体的 Data Tables 模块,使用 Import data table;之后就可以在数据搜索(Data Search)中输入 “Sales by Region” 这样的关键词进行搜索。你的角色需要能看到 Tables 菜单,这由管理员分配。

下面的步骤依据 OT Flash r57 用户手册(英文),手册自带的示例导入的是名为 Manual_Sample_Store_Monthly_Sales.csv 的文件。本文使用的样例是一个结构相同的小型假设文件,不是真实公司的数据。

四种导入方式该选哪一种?

点击 Import Table 后,OT Flash 提供四种方式。选哪一种,取决于数据现在放在哪里。

方式 适用场景 通常由谁负责
Import table from local 数据是你电脑上的 CSV、Excel 或 JSON 文件 分析师
Import table from external data source 数据在已连接的数据库里 数据维护人员或管理员
Import from API 数据可以通过 API 获取 数据维护人员
HTTP source 数据通过 HTTP 送达 数据维护人员

本地文件是唯一不需要事先配置任何东西的路径。其余三种依赖别人已经配置好的连接;对于外部数据库,手册建议使用专用的只读账号,并且只授予需要分析的那些表的访问权限。本文讲本地文件这条路径,结尾再回到其他几种。

如何准备文件,才能让各列顺利导入?

大多数导入问题在你点击任何按钮之前就已经决定了。下面是一份简短的检查清单:

  1. 把列名放在第一行。 解析界面会问 “Are the column names already defined in the file header?”,第一行是列名时就勾选。有表头行,之后搜索时的列名也更易读。
  2. 一个文件或一个工作表只放一张表。 一个文件导入后是一张数据表。如果工作簿里有多个标签页,请把每一个单独导出或另存。
  3. 每一列只放一种值。 一列里数字和 “n/a” 之类的文本混在一起,很难被识别为数值类型。要么在文件里清理,要么在类型步骤里决定如何处理。
  4. 删除汇总行和空行。 底部的合计行会在搜索时被再次求和。解析器可以忽略空行和有错误的行,但合计行是有效数据,不会被跳过。
  5. 使用人们会输入的列名。 搜索按列名匹配,所以 “Sales” 比 “Net_Sales_Amt_USD_v2” 好。之后可以改名,但改得越少,意外越少。
  6. 不要超过大小限制。 手册规定文件必须小于 50 MB。
  7. 避免与搜索关键词重名。 如果列名与某个搜索关键词相同,系统在导入时会在后面追加序号(如 _1)来重命名。之后可以在数据表详情里设置显示名。

下面是一个示意文件(假设数据,未在产品中实际运行),列与手册样例相同,共五列:

Store,City,Month,Orders,Sales
Harbor,Rotterdam,2026-01,420,18350.50
Harbor,Rotterdam,2026-02,398,17020.00
Ridge,Denver,2026-01,512,24110.75
Ridge,Denver,2026-02,487,22980.25

如何导入文件并检查数据表?

  1. 在左侧菜单中打开 Tables,然后点击 Import Table。
  2. 选择 Import table from local,弹出 Import locale table 对话框。
  3. 选择文件格式:CSV、EXCEL 或 JSON。点击 Please Select File,选好文件,再点击 Upload。
  4. 设置解析选项。选择分隔符(CSV 通常是 COMMA),确认表头行复选框,并决定是否忽略空行、忽略错误数据,以及是否丢弃最后一列之后的数据。Show/Hide Advanced Parsing Options 可以展开更多选项。点击 Next。
  5. 在列设置界面,检查数据表名称,需要的话添加描述,选择要导入的列,并调整列名和数据类型,例如 string、int 或 double。右侧会显示样例值,Preview 可以预览导入后的数据。
  6. 点击 Submit。

你看到的左侧菜单取决于管理员分配的角色和权限,所以如果看不到 Tables,应该先去问这一点。

JSON 的流程相同,只是在第 3 步选择 JSON 作为文件格式。手册没有说明嵌套 JSON 的展开规则,所以一开始最稳妥的形态是:键一致的扁平记录数组。

导入之后应该检查什么?

打开数据表卡片上的 Detail 按钮。在 Columns 标签页中,检查每一列的类型是否符合预期。有两项设置会影响搜索:

  • Column Type:ATTRIBUTE 列用于分组和筛选,MEASURE 列用于聚合。
  • Aggregation:指标的默认聚合方式,例如 SUM。

在样例中,Store、City 和 Month 应当是属性,Orders 和 Sales 应当是指标。用 Preview data 把几行数据与源文件对照。如果业务上对某一列有别的叫法,就在这里设置它的 Display Name;搜索匹配的正是这个名称。

如何把数据表绑定到本体?

OT Flash 中的本体(Ontology)是围绕一个业务主题组织起来的知识空间,把相关的数据表、业务文档、指标和数据看板放在一起。每个本体有 11 个模块,包括 Data Tables、Data Explore 和 Document Center。

如果你还没有创建本体,创建时只需要填写 Name 并选一个图标。之后在 Data Tables 中导入相关的数据表,在 Document Center 中上传业务文档。

对于你刚导入的新数据表:

  1. 在左侧菜单打开 Ontology(本体管理),进入对应你主题的本体,例如一个关于零售门店业绩的本体。
  2. 打开 Data Tables 模块,它会列出已经绑定到该本体的数据表。
  3. 点击 Import data table,从系统中选择刚导入的数据表。
  4. 如果本体里有不止一张数据表,用 Relationships 标签页设置它们之间的关联,方式与 Tables 章节中相同。

导入数据表和绑定到本体是两个独立的步骤:前者把表放进系统,后者把表加入本体。

如何做第一次搜索?

在 BI Workspace 下打开 Data Search(数据搜索),选择你的数据表,输入列名和关键词。在一张含有 Sales 指标和 Region 属性的表里输入 “Sales by Region”,系统会计算结果并选择图表;指标列默认求和。用上面的样例文件,“Sales by City” 会给出每个城市一个合计值。

如果你输入的是完整的问句而不是关键词,系统会请 FocusGPT(智能问数)把它解析成搜索语句,显示解析后的语句,并提供 Revert 选项。右侧栏会显示结果背后的 SQL 和 FocusGPT 的分析摘要,可以很快核实 Sales 是不是对你预期的那些行求和。把某一个城市的合计与原始表格中的手工求和对一下,是一个不错的首次检查。

什么时候该把一次性上传改成定时导入?

本地上传只是一份快照。如果你每周一都要替换文件,那你做的就是本该由定时任务完成的工作。手册中的 Table Task 标签页用于管理从数据源导入的数据表的定时导入任务,显示每个任务的 Data Source、Import Type、定时导入时间、状态和上次导入时间。从外部数据源导入数据表时,向导的第三步可以设置导入类型和可选的定时计划。

一条实用的判断规则:

  • 保留本地文件:数据是一次性提取、一份问卷,或者很少变化的文件。
  • 改用外部数据源:同一个文件反复从数据库导出。请数据维护人员连接数据源并设置定时导入。
  • 考虑 API 或 HTTP 导入:数据由其他系统产生,而不是来自数据库。

哪些情况不适合?

文件上传无法让两个系统保持同步;含有合并单元格、多行表头,或同一个工作表里放了多张表的电子表格,需要先清理,才能变成一张数据表。50 MB 及以上的文件超出了本地导入的接受范围,应当放进数据库,走外部数据源这条路径。

下一步

OT Flash 免费发行。可以从版本与下载页面或 GitHub 仓库获取,安装镜像、发行说明、系统要求和支持的平台都发布在那里;Tables 和 Ontology 章节请参考 r57 用户手册(英文)。