添加CSV文件数据源

CSV文件格式说明

CSV文件数据源支持的CSV文件格式如下：

• CSV文件分隔符目前只支持英文逗号，编码格式为UTF-8格式。
• 大屏在使用CSV数据源时，默认将CSV文件的第一行解析为表头。

  如果所需上传的CSV文件没有表头，您可以加上表头后再上传。或者，您也可以在大屏的数据源设置中勾选“添加默认表头”为CSV文件添加默认表头。

• CSV文件中，如果字段的值用双引号引起来，双引号也会被解析为字段值的一部分，并且在大屏显示时，双引号会被转义的显示为“\"”，如果字段带有单引号则不影响。

  例如，CSV文件中的记录如下，其中的"abc"，将显示为"\"abc\""。

  1,"abc",2

• 一个CSV文件数据连接只能上传一个CSV文件，且文件大小不能超过10MB。当CSV文件大小超过10MB时，只能通过OBS客户端进行上传。

添加CSV文件数据源

1. 单击“我的数据 > 新建数据连接” 。
2. 在“新建数据连接”页面左侧的数据库类型中，选择“CSV文件”。
3. 填写数据库相关参数信息，如下图所示：
   图1 新建CSV数据连接
   
   连接CSV文件时，相关参数如 表1所示。

   表1 CSV文件数据连接参数

   参数名	说明
   名称	数据连接的名称，只能包含英文字母、中文、数字、“-”、“_”，且长度为1~32个字符。
   Access Key	填写访问密钥Access Key的值。
   Secret Access Key	填写访问密钥Secret Access Key的值。
   文件来源	支持本地文件和OBS文件两种方式。
   文件路径	填写或选择CSV文件上传至OBS的具体路径。请确保您已具有该指定的OBS桶的读、写权限。
   文件	选择需要上传的本地CSV文件。CSV文件的格式要求，请参见CSV文件格式说明。

   • “文件来源”选择为“本地文件”时：
     1. 输入“名称”、“Access Key”、“Secret Access Key”、单击“OBS”按钮，在打开的OBS桶列表中选择CSV文件保存的目录，然后单击“确定”按钮。
        图2 选择CSV文件保存路径
        
     2. 单击“添加文件”按钮上传CSV文件，再单击“确定”即可完成CSV文件数据连接的添加。
   • “文件来源”为“OBS文件”时：

     输入“名称”、“Access Key”、“Secret Access Key”、单击“OBS”按钮，在打开的OBS桶列表中选择CSV文件，然后单击“确定”按钮。

     图3 选择CSV文件
     

使用CSV文件数据源

1. 登录DLV控制台，单击“我的大屏”。
2. 选择一个您已创建的大屏，单击“编辑”按钮，进入大屏编辑页面。
3. 从左侧组件库中选择一个“柱状图”组件，单击“数据”面板，设置“数据源类型”为“CSV文件”。
4. 在“选择已有数据连接”的下拉选项中，选择一个您已创建好的CSV文件数据连接。
   图4 选择CSV文件数据连接
   

5. 单击“查看数据响应结果”，数据响应成功后可查看结果。
   图5 查看数据响应结果
   

6. 根据响应数据的属性名称配置字段映射。配置“x”为“department”，“y”为“number”,，“s”为“company”。单击“s”右侧的增加两个系列值shanghai和beijing，并配置不同的显示颜色。
   图6 配置映射关系
   

7. 配置完成后的大屏组件效果如下图所示。
   图7 大屏效果图