应用场景

使用本地文件创建数据源，并与在线数据源进行联合分析。

使用限制

注意事项

上传文件时，需要注意以下几点：

• 支持上传的字段类型包括文本、数值、日期。在配置字段时，您可以选择这些类型或在上传过程中根据数据内容自动识别，同时具备修改字段类型的功能。

• 上传CSV文件时，建议您将CSV文件的格式转换为 UTF-8格式 。

  UTF-8格式的CSV文件可以准确识别编码，GBK、GB2312格式的CSV文件的编码可能不能被智能识别出来，从而导致上传的文件为乱码。

• 上传文件时，建议您使用Chrome浏览器。

• 上传的文件中，列的类型根据前100行确定：

  • 如果前100行均为数字，则系统会识别此列为数值型。

  • 如果有1行为字符串，则系统会识别此列为字符串型。

  数值型字段不兼容字符串类型数据，字符串类型可以兼容数值型数据。

准备工作

1. 确认支持上传文件类型

   • 可上传的文件类型为 CSV、EXCEL两种类型，支持的EXCEL格式为：xls、xlsx 两种格式。

   • 其它请参见上文 注意事项 。

2. 确认上传文件格式与大小满足 使用限制 的标准。

功能入口

请登录 Quick BI控制台 ，并按照以下任意一种方式，进入上传本地数据。

• 在数据源中上传本地文件

  您需要拥有目标数据源的读写权限，并使用支持文件上传功能的数据源。请参见 数据源功能项列表 查看具备文件上传功能的数据源。

• 在数据集编辑页面上传本地文件

• 在数据源列表页，单击 新建数据源 ，选择 本地文件 后新建文件数据源，存储至 探索空间 内。

  

  您可以选中 探索空间 ，单击右侧 上传文件 ，将文件上传至探索空间。

  

  说明

  此种方式建立至探索空间的文件数据源，只有本空间管理员/开发者有权限编辑，其他用户无权限查看编辑或修改此类数据源。具体请参见 探索空间 。

上传文件

在 上传文件 界面中，上传并配置需作为数据源使用的本地文件，支持上传的文件类型包括Excel文件和CSV文件。本例以上传 销售样例数据 Excel文件为例，进行说明。

1. 在 文件上传 页面，点击或将文件拖拽至上传区域，完成后将自动跳转至 预览数据 页面。

2. 预览数据 页面中，您可以预览以下信息，并进行相关调整操作。

   展示内容	配置内容	配置操作
   区域 ① 上传文件的Sheet数量及标题	切换Sheet	单击页签切换Sheet以预览不同Sheet中的数据内容，数据内容（即区域 ④ ）会随着页签的切换而相应调整。
   	重命名Sheet	双击Sheet名称以根据实际业务意义重命名当前Sheet，默认读取本地文件中的Sheet名称。 说明 Sheet名称不允许使用特殊字符，且前后不能包含空格。
   	修改Sheet选中状态	点击Sheet名称前的 图标，调整该Sheet的选中状态。默认为选中，取消勾选后，该Sheet将不会被上传。 说明 至少需要选中一个Sheet，否则将无法完成文件上传操作。
   	Sheet快捷操作	点击页签栏右侧 图标，在下拉列表中可以选择需要对Sheet进行的快捷操作。 仅选择当前Sheet ：仅当前Sheet为选中状态，即文件上传后，仅有当前Sheet的数据内容。 选择全部Sheet ：选中页签栏中展示的所有Sheet，即文件上传后，包含全部Sheet的数据内容。 排除当前Sheet ：取消当前Sheet的选中状态，即文件上传后，将不包含当前Sheet的数据内容。
   区域 ② 上传文件在不同系统中的名称	展示名称	上传文件在Quick BI系统中的展示名称。当上传文件时，系统会自动识别文件名称，并作为该文件在Quick BI系统中的展示名称，您可以根据实际需求自定义修改。 说明 展示名称不允许使用特殊字符，且前后不能包含空格。
   	物理表名称	文件上传至数据库后，在数据库中自动创建的表的名称，您可以根据实际需求自定义物理表名称。 说明 物理表名只能由英文、数字和下划线（_）组成，长度不超过150个字符。 当将文件上传至探索空间时，不需要配置该字段。
   区域 ③ 上传文件的标题行	标题行	您可以在此修改当前Sheet的标题行，点击 刷新 按钮即可生效。 说明 输入的数字需为大于0的整数。 请确保标题行中没有空字段，否则将触发报错。
   区域 ④ 上传文件的数据内容	数据预览	在数据预览页签下预览数据内容，并进行以下操作。 修改字段名称 ：单击字段名称输入框，修改字段名。 修改字段类型 ：点击字段类型图标，在下拉列表中选择合适的字段类型。支持的类型包括文本、数值、日期。
   	字段详情	在字段详情页签下配置 文件字段名 、 数据库字段名称 和 字段类型 。 文件上传至数据库后，会以数据库表的形式存储，数据库字段名称和字段类型为生成数据库表的字段名和类型，而文件列名为上传文件的表头名，会变成数据库表的字段备注。

3. 单击页面底部 确认并上传 按钮，在提示弹窗中可查看每个Sheet页的上传进度。

4. 完成文件上传后即可点击 返回数据源列表 ，查看已上传的文件数据源。

修改上传文件

在完成第一次的业务数据文件上传后，如果由于业务变化，产生了新的业务数据文件，您可以追加、替换新文件，或删除不再需要使用的旧文件，实现对业务数据连贯的、长期的跟踪分析需求。

单击目标文件右侧的 图标，进入 修改文件上传 界面，您可以在此进行以下操作。

本地文件数据源学习示例

• 您可以下载以下CSV文件进行学习： 销售样例数据 。

• 您可以下载以下Excel文件进行学习： 销售样例数据 。

销售数据的结构如下表所示。

常见问题

1. 上传后的CSV文件字段内容为乱码，该如何操作？

目前UTF-8格式的CSV文件可以准确识别编码。GBK、GB2312格式的CSV文件的编码一般也能智能识别出来，但是某些特殊情形下，可能不能被智能识别出来，需要转换编码格式为UTF-8。

1. 用 记事本 工具打开一个CSV文件。

2. 选择 另存为 。

3. 单击 编码 的下拉箭头。

4. 从 编码 列表中，选择 UTF-8 。

   

2. 追加文件报错“字段类型不一致”，该如何操作？

原因1 ：源表和追加表的字段类型存在明显不一致，需要手动修改其中的一个表的数据类型或重新匹配字段；

原因2 ：追加表的Excel字段若存在数据为空的字段，Quick BI则会默认判别将此字段判别为文本型，若原表对应字段为数值型，则会报错字段类型不一致。您可以在追加的Excel表全部为空的字段列下面随意加一个数值，即可上传追加成功。

3. 上传文件不成功，报错“Excel文件解析失败”，或者上传文件后数据不准确？

原因 ：上传的文件格式或者内容不符合上传要求，因此此类问题对照上传文件注意事项进行检查：

解决方案 ：

• 检查1：可上传的文件类型是否为CSV、Excel两种类型，如果是Excel的话，Excel格式是否为xls、xlsx两种格式，以及上传的文件是否满足 注意事项 中提到的内容。

• 检查2：确认上传文件格式与大小是否满足以下 使用限制 中说明的标准。

4. 找不到上传文件的按钮或者按钮为灰色，无法点选？

原因1 ：上传文件需要有新建文件数据源的权限，您的用户类型需要为开发者且需要具备空间开发者及以上权限，或被协同授权了该数据源的使用/编辑权限，才具备上传文件数据源的权限与入口；

原因2 ：无目标数据源的读写权限，请确认用于Quick BI的数据源中的数据库账号具备该数据库的读写权限。无读写权限将导致无法上传。需联系数据库管理员授予相应权限。

5. 追加文件/追加新字段后，新字段在数据集中不显示？

原因 ：原表没有该字段，在新增加字段后，该字段默认在数据集中是没有选择的，需要在数据集编辑页的模型配置界面，手动勾选才可显示。

6. 点击上传文件后，选择文件时无法显示CSV文件？

原因 ：点击上传文件按钮，windows环境在选择文件时当前默认只显示本地xlsx格式的文件，需要您在文件类型的选项中选择所有文件才能找到CSV格式的文件。