更新时间:2024-06-20 GMT+08:00

新建CSV文件数据连接

通过CSV文件数据源,您可以将本地的CSV文件上传至OBS服务后与大屏建立数据连接,或者将存储在OBS服务中的CSV文件与大屏建立数据连接,在大屏上展示CSV文件的数据。

连接CSV文件前,需要满足以下条件:

  • 已获取访问密钥Access Key(访问密钥ID,AK)、Secret Access Key(私有访问密钥,SK),SK是和AK结合使用的密钥。

    获取访问密钥的具体步骤,请参见获取访问密钥(AK和SK)

  • 在OBS中已有可用的桶。

CSV文件格式说明

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

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

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

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

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

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

添加CSV文件数据源

  1. 登录DLV管理控制台。
  2. “我的数据”页面,单击页面最上方的工作空间下拉列表并选择所需访问的工作空间,然后单击“新建数据连接”

    图1 新建连接

  3. “新建数据连接”窗口中,选择数据源类型为“CSV文件”,并配置如下参数,然后单击“确定”

    图2 新建CSV数据连接
    连接CSV文件时,相关参数如表1所示。
    表1 CSV文件数据连接参数

    参数名

    说明

    名称

    数据连接的名称,只能包含英文字母、中文、数字、“-”“_”,且长度为1~32个字符。

    Access Key

    填写访问密钥Access Key的值。请参见获取访问密钥(AK和SK)进行获取。

    Secret Access Key

    填写访问密钥Secret Access Key的值。请参见获取访问密钥(AK和SK)进行获取。

    文件来源

    支持本地文件和OBS文件两种方式。

    文件路径

    • “文件来源”选择“本地文件”时,单击“OBS”按钮,在弹出框中选择一个OBS目录,本地文件将会先被上传到该OBS目录中。配置示例如图3所示。
    • “文件来源”选择“OBS文件”时,单击“OBS”按钮,在弹出框中选择存储在OBS桶中的CSV文件。配置示例如图4所示。

      CSV文件的格式要求,请参见CSV文件格式说明

    请确保您已具有该配置项所指定的OBS桶的读、写权限。

    文件

    “文件来源”选择“本地文件”时,单击“添加文件”,在弹出框中选择需要上传的本地CSV文件,当单击“确定”按钮时开始上传。CSV文件的格式要求,请参见CSV文件格式说明

    • “文件来源”选择为“本地文件”时,配置示例如下:
      图3 本地文件
    • “文件来源”“OBS文件”时,配置示例如下:
      图4 OBS文件

使用CSV文件数据源

  1. 登录DLV控制台,单击“我的大屏”
  2. “我的大屏”页面,找到需要编辑的大屏,将鼠标移至该大屏图标上,然后单击编辑按钮进入大屏开发页面。

    图5 编辑大屏

  3. 从左侧组件库中选择一个组件,例如“柱状图”,该组件将出现在画布中。单击该组件,再单击屏幕右侧的“数据”面板。
  4. “数据”面板中,配置如下相关参数。

    • 数据源类型:设置为“CSV文件”
    • 选择已有数据连接:选择一个您已创建好的CSV文件数据连接。
    图6 选择CSV文件数据连接

  5. 单击“预览结果”,数据响应成功后可查看结果。

    图7 查看数据响应结果

  6. 根据响应数据的属性名称配置字段映射。本示例中配置“x”“name”“y”“age”,,“s”为留空或任意填写。

    图8 配置映射关系

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

    图9 大屏效果图