华为云数据可视化DLV对接使用全攻略：从入门到实战
1. 华为云DLV数据可视化概述
数据可视化（Data Lake Visualization，简称DLV）是华为云推出的一站式数据可视化开发平台。它适配云上云下多种数据源，提供丰富多样的2D与3D可视化组件，并采用拖拽式自由布局的设计理念，旨在帮助用户快速定制和部署属于自己的数据大屏。DLV的最大价值在于它大幅降低了数据可视化的技术门槛。传统的大屏开发往往需要前端工程师、后端工程师和数据分析师多方协作，开发周期长、成本高。而DLV通过图形化界面、丰富的组件库和预置模板，让非技术人员也能在数小时内搭建出专业级的数据监控大屏。
DLV提供了基础版、高级版和专业版三种版本供用户选择。基础版适合个人或小型团队试用与入门，支持2个工作空间、5个大屏、3个场景模板，覆盖云数据库MySQL、静态JSON、CSV等基础数据源类型。高级版将工作空间扩展至10个、大屏数量提升至20个，并解锁API、DWS、DLI、MRS Hive等更多数据源，同时支持加密发布和动态Token鉴权。专业版则提供20个工作空间、50个大屏以及全部模板和数据源类型，包括ClickHouse、PostgreSQL、Oracle、Elasticsearch等专业数据源，并包含三维地图组件、桑基图、旭日图等高级图表。华为云还为每个用户提供一次为期30天的DLV基础版免费试用机会。
需要先登录华为云控制台，点击：华为云控制台，还没有账号，点击：注册并关联，已有账号点击：登录后关联
2. DLV使用流程概览
在深入具体操作之前，有必要先了解DLV的完整使用流程。整个流程全部可以在DLV控制台内完成，主要包括五个步骤：
- 建数据连接：连接数据大屏所需的数据源。用户需要根据数据存储的位置，在DLV的“我的数据”模块中创建指向数据源的连接配置。如果使用静态数据，则可以跳过此步骤。
- 建数据大屏：在“我的大屏”页面中，用户可以从左侧的场景模板中选择一个模板来创建大屏，也可以选择空白模板从零开始搭建。DLV提供了安全态势感知、销售驾驶舱、智慧旅游、能源化工管理看板等多种行业模板。
- 编辑数据大屏：这是最核心的环节。用户在大屏开发页面中完成组件的添加、样式配置、数据绑定、交互配置以及图层管理等操作。
- 预览数据大屏：在开发过程中，用户可以随时通过预览功能查看大屏的显示效果，确保各项配置符合预期。
- 发布数据大屏：大屏开发完成后，通过发布功能生成访问链接，即可向其他用户分享大屏。
3. DLV控制台登录与工作空间管理
登录DLV服务管理控制台后，用户首先需要关注工作空间的概念。工作空间是DLV中管理资源和权限的基本单元，不同版本支持的工作空间数量不同。在“我的数据”页面，单击页面最上方的工作空间下拉列表并选择所需访问的工作空间，然后单击“新建数据连接”即可开始配置数据源。在“我的大屏”页面，用户可以完成大屏的新建、编辑、预览、发布、复制、删除、重命名等操作。
4. 数据源对接：DLV支持的数据源类型
DLV支持丰富的数据源类型，覆盖了华为云上主流的数据库与大数据服务。基础版支持云数据库MySQL、云数据库GaussDB、MySQL、CSV和静态JSON数据源。高级版在此基础上增加了云数据库PostgreSQL、云数据库SQL Server、数据仓库服务DWS、分布式数据库中间件DDM、对象存储服务OBS、数据湖探索DLI、MapReduce服务MRS Hive与MRS SparkSQL、API以及华为云API网关和DAYU数据服务。专业版则进一步支持MapReduce服务ClickHouse、PostgreSQL、Oracle、SQL Server、云数据库GaussDB for Influx、云搜索服务Elasticsearch等。此外，DLV还支持本地CSV文件作为数据源。
4.1 静态数据源
使用静态数据源时不需要创建数据连接，用户可以直接在大屏编辑页面的数据编辑框内粘贴JSON格式的静态数据。这种方式适合快速原型验证或数据量较小的展示场景。静态数据的JSON结构需要符合DLV的解析规范，通常为一维JSON数组格式。
4.2 MySQL数据源连接
连接自建的MySQL数据库是DLV最常见的应用场景之一。在新建MySQL数据连接前，用户需要准备好MySQL数据源的地址、端口、数据库用户名和密码，且该用户必须具备所需连接的数据库的查询（SELECT）权限。
由于MySQL为非全托管服务，DLV无法直接与非全托管服务进行连接。用户可以通过云数据迁移（CDM）集群作为网络代理，或者通过公有网络作为连接代理来实现DLV与MySQL的网络互通。
如果选择CDM集群作为连接代理，需要满足以下要求：
- 用户需要先前往CDM控制台创建一个CDM集群，CDM集群必须和DLV在相同的区域。
- 如果MySQL数据源不在华为云上，其所在的主机必须具有公网IP地址，并且CDM集群也必须绑定弹性IP（EIP）。
- 如果MySQL数据源在华为云上，MySQL数据源所在的主机必须和CDM集群在相同的区域、可用区和VPC。
- 如果MySQL数据源所在的主机开启了防火墙，其防火墙入方向和出方向规则均需要开放MySQL数据库端口的访问权限，允许CDM集群的地址访问。
- CDM集群所在的安全组，入方向和出方向规则需允许MySQL数据库地址和端口访问。
如果使用公有网络作为连接代理，自建MySQL数据库所在的弹性云服务器需要绑定弹性公网IP，且该弹性云服务器所在区域及VPC要和DLV的所在区域及VPC相同，网络能相通。
新建MySQL数据连接的具体步骤如下：
- 登录DLV管理控制台。
- 在“我的数据”页面，单击页面最上方的工作空间下拉列表并选择所需访问的工作空间，然后单击“新建数据连接”。
- 在“新建数据连接”窗口中，选择数据源类型“MySQL”，然后配置相关参数。参数包括：名称（1~32个字符，只能包含英文字母、中文、数字、-、_）、域名（数据库地址，不支持内网域名）、端口、用户名、密码、连接代理（VPC连接、CDM代理或公有网络）。
- 单击“获取数据库”，在列表框中选择数据库。
- 填写完数据源信息后，单击“确定”即可完成MySQL数据连接的添加。
4.3 RDS MySQL数据源连接
对于华为云关系型数据库服务RDS MySQL，连接方式与自建MySQL类似。用户同样需要已获取RDS MySQL数据源的地址、端口、用户名和密码。为了使DLV大屏与RDS MySQL实例网络互通，同样需要使用云数据迁移（CDM）集群作为网络代理，并确保在CDM中已有可用的集群。在新建数据连接时，选择数据源类型为“云数据库 MySQL”，然后配置相应的连接参数即可。
4.4 DWS数据源连接
数据仓库服务DWS是华为云的企业级数据仓库，DLV同样支持与其建立数据连接。新建DWS数据连接的入口与MySQL一致：在“我的数据”页面选择工作空间后单击“新建数据连接”，然后选择数据源类型“数据仓库服务 DWS”。配置时需要填写DWS集群的地址、端口、数据库名称、用户名和密码等信息。DWS作为华为云的全托管服务，网络连通性相对简单，通常不需要额外的CDM代理配置。
4.5 OBS数据源连接
对象存储服务OBS是华为云提供的海量、安全、高可靠的云存储服务。DLV支持将大屏与OBS服务建立数据连接，在大屏上展示存储在OBS中的CSV文件的数据。连接OBS数据源之前，需要满足以下条件：
- DLV大屏与所需连接的OBS数据源必须在相同区域。
- 已获取访问密钥Access Key（AK）和Secret Access Key（SK）。
- 已获取OBS的终端节点（Endpoint）。
新建OBS数据连接时，在“新建数据连接”窗口中选择数据源类型为“对象存储服务 OBS”，然后配置相关参数。参数包括名称、Access Key、Secret Access Key和终端节点。配置完成后，在大屏编辑页面从左侧组件库中选择一个组件，在“数据”面板中设置数据源类型为“对象存储服务（OBS）”，然后选择已创建好的OBS数据连接，再在弹出的页面中选择所需的OBS桶及CSV文件即可。
4.6 DLI数据源连接
数据湖探索DLI是华为云提供的大数据计算服务。DLV与DLI的连接同样在“新建数据连接”中完成，选择数据源类型“数据湖探索 DLI”。配置时需要指定DLI的队列名称、数据库名称等信息。DLI作为华为云的全托管大数据服务，网络连通性通常不需要额外的代理配置。
4.7 API数据源
DLV支持通过API方式连接外部数据源。用户可以通过调用一个第三方的REST API获取源数据，该REST API响应结果中的HTTP body体就是源数据，DLV可以解析响应结果中的源数据并将其直接展示在大屏上。使用API数据源无需创建数据连接，可以直接在大屏编辑页面的数据面板中配置API数据源的URL。
使用API数据源需要满足以下条件：
- 获取源数据的REST API和华为云网络之间能够正常通信。
- 获取源数据的REST API当前仅支持通过HTTPS协议的GET请求调用，且API响应结果的HTTP body体仅支持JSON格式。
- DLV的API数据源仅支持解析与静态数据源的JSON结构相似的一级JSON数组，不支持多层嵌套的JSON结构。
在配置API数据源时，用户可以在“数据”面板中设置“数据源类型”为“API”，然后在编辑区域中输入完整的URL地址。当“由服务器发起请求（仅支持HTTPS）”设为关闭时，由DLV页面直接发送Ajax请求访问URL，这种使用方式存在跨域问题。当该选项设为开启时，由DLV的后台服务器代理转发URL请求并返回数据，这种方式可以解决跨域问题。单击“预览结果”可以查看数据响应结果，然后根据响应数据的属性名称配置字段映射。
4.8 API网关数据源
API网关是华为云提供的高性能、高可用、高安全的API托管服务。DLV支持直接连接API网关作为数据源。新建API网关数据连接时，选择数据源类型为“API网关”，需要配置名称、AppKey和AppSecret。当API网关的认证方式是APP认证时，需要填写准确的AppKey和AppSecret值。配置完成后，在大屏编辑页面设置数据源类型为“API网关”，选择已创建的数据连接，填写请求方式和URL即可。
5. 大屏开发实战
5.1 创建大屏
登录DLV控制台后，单击“我的大屏”，在页面中单击“新建大屏”。DLV提供了两种创建方式：一种是使用系统提供的场景模板，包括安全态势感知、销售驾驶舱、智慧旅游、能源化工管理看板、新冠疫情态势大屏等；另一种是使用空白模板从零开始搭建。选择模板后，即可进入大屏开发页面。
5.2 添加与配置组件
DLV提供了丰富的可视化组件库。常规图表组件包括线状图、柱状图、饼状图、雷达图、散点图、气泡图、区域排行、折线柱图、水平柱状图、双轴线状图等。基础平面地图子组件包括地图飞线、地图下钻、地图热力层、悬浮文本等。高级图表组件包括水位图、玫瑰图、热力图、台阶图、矩形树图、仪表盘、漏斗图等。专业版还提供了WT折线瀑布图、旭日图、径向树图、桑基图等专业图表。三维地图组件包括3D世界地图、3D中国地图、地球、高级地球等。
在开发页面中，用户从左侧组件中心选择所需组件，拖拽至画布中。然后可以在“样式”面板中配置组件的样式属性，包括字体、颜色、背景、边框等。在“数据”面板中，用户需要为组件绑定数据源。数据源类型可以是之前创建好的数据连接，也可以是静态数据或API数据源。在“交互”面板中，用户可以配置组件的事件交互，实现组件之间的数据联动。
5.3 交互配置与数据联动
DLV的组件交互配置是指某个组件在响应用户操作或者自动触发更新时，向其他组件传递参数，这个参数可以在其他组件中作为数据查询时的动态变量。以Tab列表和线状图配合使用为例，当用户点击Tab列表中的不同选项时，线状图可以根据选中的参数动态刷新展示对应的数据。
实现下钻功能时，可以打开表格轮播组件的交互面板，勾选“链接”开启超链接交互事件。用户可以设置所有系列的“超链接”和“链接方式”，若数据面板中各个系列单独设置了“超链接”和“链接方式”，则以数据面板中的设置优先。通过地理搜索组件与柱状图的配合，可以实现地图区域选择后的数据联动展示。
6. 大屏的预览、发布与分享
在开发过程中，用户可以随时通过预览功能查看大屏的显示效果。预览可以展示数据大屏的即时数据，帮助用户及时了解呈现效果。大屏开发完成后，通过发布功能生成访问链接，即可向其他用户分享大屏。DLV支持公开发布和加密发布两种方式。公开发布指构建好大屏后生成的访问URL，分享后没有访问限制。高级版和专业版还支持加密发布和动态Token鉴权，以增强大屏访问的安全性。此外，DLV大屏还可以集成到第三方系统中。用户可以参考发布大屏章节开启Token验证方式，并获取大屏链接进行集成。
7. DLV权限管理
DLV的权限管理依托于华为云的统一身份认证服务IAM。通过IAM，用户可以：根据企业的业务组织在华为云账号中为不同职能部门的员工创建IAM用户；根据企业用户的职能设置不同的访问权限以实现权限隔离；将DLV资源委托给其他华为云账号或云服务进行代运维。
华为云账号或拥有DLV FullAccess权限的用户默认具有DLV服务的所有执行权限。拥有DLV FullAccess或Tenant Administrator权限的用户才具有购买DLV套餐包、创建/删除/修改工作空间、设置默认工作空间的权限。给用户授权DLV权限的方式有两种：通过IAM控制台创建用户组并授予DLV FullAccess策略，然后将用户添加至用户组中；或者在DLV控制台中将用户添加为工作空间的成员并分配角色。DLV工作空间支持不同的角色权限，如访客角色等。验证权限时，新创建的用户登录控制台后，在“服务列表”中选择数据可视化，切换至授权的工作空间，尝试新建大屏，如果无法创建则表示角色权限已生效。
8. 网络代理与VPC连接
对于非全托管的数据源（如自建MySQL、PostgreSQL等），DLV需要通过代理来实现网络互通。云数据迁移CDM集群是DLV最常用的网络代理方案。用户需要在CDM控制台创建与DLV同区域的CDM集群。对于不在华为云上的数据源，CDM集群需要绑定弹性IP。对于在华为云上的数据源，需要确保数据源所在主机与CDM集群在同一区域、可用区和VPC。
DLV还支持VPC连接方式。通过VPC连接将云上数据源与DLV相连，用于大屏数据的展示。DLV支持的通过VPC连接的数据源包括数据仓库服务DWS等。用户可以在DLV控制台的“管理中心 > 管理VPC连接”中创建VPC连接。
9. 常见问题与排查思路
在使用DLV过程中，可能会遇到一些常见问题。例如，利用SQL语句查询时仅能传回50条数据，这通常是由于数据源端的查询限制或DLV的预览数据量限制所致。解决方案包括调整SQL查询语句、在数据源端取消数据量限制或使用数据转换器处理数据。
跨域问题是API数据源使用中常见的问题。当“由服务器发起请求”选项关闭时，由DLV页面直接发送Ajax请求访问URL，这种使用方式存在跨域问题。解决方案有两种：开启“由服务器发起请求”选项，由DLV后台服务器代理转发请求；或者在对端API服务中设置响应头Access-Control-Allow-Origin，放通权限。
数据转换器功能异常也是部分用户遇到过的问题。这可能是由于浏览器兼容性导致的，建议更换浏览器或检查浏览器版本。
10. 代码示例
10.1 静态JSON数据格式示例
[
{\"x\": \"2024-01\", \"y\": 120, \"s\": \"产品A\"},
{\"x\": \"2024-02\", \"y\": 150, \"s\": \"产品A\"},
{\"x\": \"2024-01\", \"y\": 80, \"s\": \"产品B\"},
{\"x\": \"2024-02\", \"y\": 110, \"s\": \"产品B\"}
]10.2 API数据源响应JSON格式示例
[
{\"city\": \"北京\", \"sales\": 3200, \"growth\": 0.12},
{\"city\": \"上海\", \"sales\": 2800, \"growth\": 0.08},
{\"city\": \"广州\", \"sales\": 2100, \"growth\": 0.15},
{\"city\": \"深圳\", \"sales\": 1900, \"growth\": 0.10}
]DLV的API数据源仅支持解析一级JSON数组，不支持多层嵌套的JSON结构。用户在编写API接口时需要注意响应数据的格式设计。
10.3 MySQL数据连接配置参数
名称：my_mysql_conn
域名：192.168.1.100
端口：3306
用户名：dlv_user
密码：********
连接代理：CDM代理
数据库名：sales_db10.4 OBS数据连接配置参数
名称：my_obs_conn
Access Key：AK值
Secret Access Key：SK值
终端节点：obs.cn-north-4.myhuaweicloud.com11. 总结
华为云DLV作为一站式数据可视化开发平台，凭借其丰富的数据源适配能力、强大的可视化组件库和便捷的拖拽式操作，极大地降低了数据大屏的开发门槛。无论是企业运营监控、业务数据分析，还是智慧城市、工业互联网等场景，DLV都能提供强有力的可视化支撑。通过本文的详细讲解，读者应当已经掌握了从DLV控制台登录、数据源对接、大屏开发到发布分享的完整流程。在实际使用中，建议用户根据自身业务需求选择合适的版本，充分利用DLV提供的各种数据源连接能力和交互配置功能，构建出专业、美观、高效的数据可视化大屏。
问答环节
问1：DLV支持哪些数据源类型？
答：DLV基础版支持云数据库MySQL、云数据库GaussDB、MySQL、CSV和静态JSON数据源。高级版在此基础上增加了PostgreSQL、SQL Server、DWS、DDM、OBS、DLI、MRS Hive、MRS SparkSQL、API和API网关等。专业版进一步支持ClickHouse、Oracle、Elasticsearch等更多数据源。
问2：DLV如何连接自建的MySQL数据库？
答：由于MySQL为非全托管服务，DLV需要通过CDM集群作为网络代理或通过公有网络连接。用户需要先在CDM控制台创建与DLV同区域的CDM集群，然后在DLV的“我的数据”页面新建MySQL数据连接，填写数据库地址、端口、用户名、密码等信息，并选择合适的连接代理。
问3：DLV的API数据源有什么使用限制？
答：API数据源仅支持HTTPS协议的GET请求，响应结果必须为JSON格式，且仅支持解析一级JSON数组，不支持多层嵌套结构。如果遇到跨域问题，可以开启“由服务器发起请求”选项由DLV后台代理转发。
问4：如何给团队成员授权使用DLV？
答：可以通过IAM服务创建IAM用户，然后将用户添加为DLV工作空间的成员并分配相应角色。拥有DLV FullAccess权限的用户具有DLV服务的所有执行权限。也可以将用户加入已授予DLV FullAccess策略的用户组中。
问5：DLV大屏如何实现组件间的数据联动？
答：在组件的“交互”面板中配置交互事件，当某个组件响应用户操作时向其他组件传递参数，该参数可作为其他组件数据查询时的动态变量。例如，通过地理搜索组件与柱状图的配合可以实现区域选择后的数据联动展示。
问6：DLV大屏开发完成后如何分享给其他人？
答：大屏开发完成后，通过发布功能生成访问链接即可分享。DLV支持公开发布（无访问限制）和加密发布（需Token鉴权）两种方式。高级版和专业版还支持动态Token鉴权以增强安全性。
