华为云数据可视化DLV对接使用完全指南：从数据源接入到大屏发布
1. 华为云DLV概述：一站式数据可视化开发平台
数据可视化（Data Lake Visualization，简称DLV）是华为云推出的一站式数据可视化开发平台。它适配云上云下多种数据源，提供丰富多样的2D与3D可视化组件，并采用拖拽式自由布局的设计理念，旨在帮助用户快速定制和部署属于自己的数据大屏。
DLV的最大价值在于它大幅降低了数据可视化的技术门槛。传统的大屏开发往往需要前端工程师、后端工程师和数据分析师多方协作，开发周期长、成本高。而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目前支持接入的数据源类型包括：
数据库类：云数据库MySQL、云数据库PostgreSQL、云数据库SQL Server、云数据库GaussDB、云数据库GaussDB for Influx、数据仓库服务DWS、数据湖探索DLI、MapReduce服务MRS Hive、MapReduce服务MRS SparkSQL、MapReduce服务ClickHouse、分布式数据库中间件DDM、Oracle等。
大数据与存储类：对象存储服务OBS、云搜索服务Elasticsearch。
API与数据服务类：API、华为云API网关、DAYU数据服务。
文件类：CSV文件、静态JSON数据。
需要特别注意的是，不同版本对数据源类型的支持存在差异。基础版仅支持云数据库MySQL、云数据库GaussDB、MySQL、CSV和静态JSON。高级版在此基础上增加了PostgreSQL、SQL Server、DWS、DDM、OBS、DLI、MRS Hive、MRS SparkSQL、API和API网关。专业版则进一步解锁了ClickHouse、Oracle、GaussDB for Influx和Elasticsearch等高级数据源。用户在规划数据源时，应根据自身业务需求选择合适的版本。
4. 静态数据源的使用
静态数据源是DLV中最简单的数据使用方式，不需要创建任何数据连接，用户可以直接在大屏编辑页面的数据编辑框内粘贴JSON格式的静态数据。这种方式非常适合原型验证、演示场景或数据量较小且不需要实时更新的场景。
具体操作步骤如下：
首先登录DLV控制台，进入“我的大屏”页面，找到需要编辑的大屏并进入编辑状态。从左侧组件库中选择一个组件（如柱状图），该组件将出现在画布中。单击该组件，再单击屏幕右侧的“数据”面板。在“数据”面板中，将“数据源类型”设置为“静态数据”。然后将JSON格式的静态数据粘贴在下方的数据编辑区域中。最后配置字段映射，将数据中的字段映射到组件的展示字段上。
静态数据的JSON格式要求为一级JSON数组，示例如下：
[
{
"x": "Type A",
"y": 78,
"s": 1
},
{
"x": "Type B",
"y": 55,
"s": 1
},
{
"x": "Type C",
"y": 68,
"s": 1
},
{
"x": "Type D",
"y": 92,
"s": 2
}
]在上述示例中，“x”字段通常映射为横轴类别，“y”字段映射为数值，“s”字段映射为系列分组。配置字段映射时，用户需要为每个系列值配置不同的显示颜色，以增强图表的可读性。
5. 数据库数据源对接
对于生产环境中的大屏应用，数据通常存储在数据库中。DLV支持对接多种数据库类型，本节以最常用的MySQL数据源为例，详细讲解对接配置流程。
5.1 前提条件
在配置MySQL数据连接之前，需要确保满足以下条件：已获取MySQL数据源的地址、端口、数据库用户名和密码，且该用户必须具备所需数据库的查询权限。同时，需要解决DLV大屏与MySQL数据源之间的网络互通问题。
网络互通是数据库对接中最容易出现问题的环节。DLV提供了两种网络代理方案：
方案一：使用CDM集群作为网络代理。用户需要先在云数据迁移CDM控制台创建一个CDM集群，该集群必须与DLV在相同的区域。如果MySQL数据源不在华为云上，其所在主机必须具备公网IP地址，并且CDM集群需要绑定弹性IP。如果MySQL数据源在华为云上，则数据源所在主机和CDM集群需要在相同的区域、可用区和VPC中。此外，MySQL所在主机的防火墙入方向和出方向规则均需要开放MySQL数据库端口的访问权限，允许CDM集群的地址访问。
方案二：使用VPC连接作为网络代理。通过VPC连接将云上数据源与DLV直接相连。DLV支持的通过VPC连接的数据源包括DWS、ClickHouse、云数据库MySQL、云数据库GaussDB、云数据库PostgreSQL、云数据库GaussDB for Influx、云数据库SQL Server、云搜索服务Elasticsearch以及ECS自建数据源。创建VPC连接需要拥有DLV FullAccess和VPCEndpoint Administrator权限。
5.2 新建MySQL数据连接
完成网络准备后，即可开始创建数据连接：
登录DLV管理控制台，在“我的数据”页面，单击页面最上方的工作空间下拉列表选择所需的工作空间，然后单击“新建数据连接”。在弹出的窗口中，选择数据源类型为“MySQL”，然后配置相关参数。
关键参数说明如下：名称：数据连接的名称，只能包含英文字母、中文、数字、短横线和下划线，长度为1至32个字符。域名：填写数据库的地址，不支持内网域名。端口：填写数据库的端口号。用户名和密码：填写具备数据表读取权限的数据库用户名和密码。连接代理：选择可用的连接代理，可选VPC连接、CDM代理或公有网络。数据库名：单击“获取数据库”按钮，在列表中选择目标数据库。
配置完成后单击“确定”即可完成数据连接的创建。之后在大屏组件的“数据”面板中，就可以选择该数据连接作为数据源，并通过编写SQL语句来查询和展示数据。
5.3 使用数据库数据源
创建好数据连接后，在大屏开发页面中选择一个组件（如饼状图），在“数据”面板中将“数据源类型”设置为“数据库”，然后从“选择已有数据连接”的下拉列表中选择已创建好的数据连接。在下方的SQL语句编辑框中填写查询语句，单击“查看数据响应结果”即可验证数据是否正确返回。最后根据响应数据的属性名称配置字段映射，完成组件的数据绑定。
6. API数据源对接
API数据源是DLV对接外部数据系统的另一重要方式。通过API数据源，用户可以调用第三方REST API来获取源数据，DLV会解析API响应结果中的HTTP Body并将其直接展示在大屏上。这种方式使得DLV能够与任意提供REST API的系统进行数据对接，极大地扩展了数据来源的灵活性。
6.1 使用限制
使用API数据源需要满足以下条件：获取源数据的REST API和华为云网络之间必须能够正常通信。API当前仅支持通过HTTPS协议的GET请求调用。API响应结果的HTTP Body体仅支持JSON格式。DLV的API数据源仅支持解析与静态数据源结构相似的一级JSON数组，不支持多层嵌套的JSON结构。
6.2 配置API数据源
API数据源的配置方式比数据库数据源更加简洁，无需预先创建数据连接：登录DLV控制台，进入“我的大屏”页面并编辑目标大屏。从左侧组件库中选择一个组件，单击该组件后进入“数据”面板。将“数据源类型”设置为“API”。在编辑区域中输入完整的HTTPS URL地址。单击“预览结果”，数据响应成功后可查看返回的数据。根据响应数据的属性名称配置字段映射。
如果遇到跨域问题，需要在API服务端设置响应头信息Access-Control-Allow-Origin，放通DLV的访问权限。
API数据源特别适合对接实时数据接口、第三方SaaS平台数据、企业内部微服务接口等场景，是实现实时数据大屏的关键技术手段。
7. 对象存储服务OBS数据源对接
OBS是华为云的对象存储服务，DLV支持将存储在OBS中的CSV文件作为数据源。这种方式适合数据已经以文件形式存储在OBS中、不需要频繁更新的场景。使用OBS数据源时，需要确保DLV大屏与OBS数据源在相同的区域。
配置OBS数据源的具体步骤为：在“我的数据”页面新建数据连接，选择数据源类型为“对象存储服务OBS”，然后配置OBS桶的相关信息，包括桶名称、文件路径等。配置完成后，在大屏组件的“数据”面板中选择该数据连接，即可将CSV文件中的数据展示在大屏上。
8. 大屏开发：从组件添加到交互配置
完成数据源对接后，进入大屏开发的核心环节。DLV的大屏开发页面提供了完整的可视化设计环境。
8.1 大屏开发页面总览
DLV的大屏开发页面主要包含以下几个功能区：
组件区：位于页面左侧，DLV提供了丰富的可视化组件，包括常规图表（线状图、柱状图、饼状图、散点图、气泡图等）、地理组件（基础平面地图、世界地图、3D地图、地球等）、高级图表（水位图、玫瑰图、热力图、桑基图、旭日图等）、控件组件（Tab列表、时间选择器、地理搜索等）以及装饰组件（边框、标题、文本、图片等）。用户可以从组件区选择所需组件拖拽或单击添加到画布中。
画布区：大屏的主设计区域。用户可以通过鼠标拖拽调整组件的位置和大小，也可以通过画布缩放控制条放大或缩小视图。画布还提供了横向和纵向标尺以及辅助线功能，方便进行精确的页面布局。
图层区：显示大屏中各个图层的名称及缩略图，方便用户快速定位和选择图层。
配置面板：位于页面右侧，当选中大屏或某个组件时，配置面板会显示对应的配置信息。配置面板包含“样式”、“数据”、“交互”三个主要页签。
发布区：位于页面顶部，提供返回首页、预览大屏、发布大屏等核心操作按钮。
8.2 组件样式配置
在“样式”页签中，用户可以配置组件的视觉效果。不同类型的组件提供不同的样式配置项。以柱状图为例，可以配置的内容包括：颜色主题、字体样式、轴标签、图例位置、背景色、边框样式等。用户还可以为大屏整体配置背景色和背景图。
8.3 组件数据绑定
在“数据”页签中，用户完成组件的数据源配置。数据源类型可选静态数据、数据库、API、OBS等。如果使用数据库数据源，还需要编写SQL查询语句并配置字段映射。DLV还提供了“自动更新请求”功能，勾选后并设置更新间隔，数据将根据间隔时间自动轮询刷新。
8.4 数据转换器的使用
数据转换器是DLV中一个非常实用的功能。当原始数据的结构与组件所需的数据结构不一致时，可以通过数据转换器将数据转换为符合展示需求的格式。转换器本质上是一段数据处理代码，用户可以在“数据转换器”页签中新建转换器并编写转换逻辑。例如，如果API返回的数据是嵌套结构，但组件需要的是扁平的一级JSON数组，就可以通过数据转换器进行数据格式的转换和清洗。
8.5 交互配置：联动与下钻
交互功能是大屏从“展示”走向“分析”的关键能力。DLV支持组件间的数据联动以及下钻分析。
交互联动：在DLV中，组件交互配置是指某个组件在响应用户操作或者自动触发更新时，向其他组件传递参数，这个参数可以在其他组件中作为数据查询时的动态变量。具体实现方式为：在源组件的“交互”面板中定义交互变量并启用该变量。在目标组件的数据配置中，按下shift加美元符号键，引用已定义好的交互变量。这样当用户操作源组件时，目标组件会自动根据变量值刷新数据，实现数据联动效果。
下钻分析：下钻功能允许用户在单击组件时打开一个超链接所指定的页面。在超链接中，用户可以指定一个或多个交互变量，系统会将组件上所单击的数据作为变量值传递给超链接，从而实现下钻展示相关详情信息的功能。配置完成后，在大屏预览页面的URL地址末尾添加交互变量即可测试下钻效果。
9. 自定义组件开发
DLV预置了上百种可视化组件，但在某些特殊业务场景下，用户可能需要开发定制化的组件。DLV为此提供了完整的自定义组件开发工具链。
自定义组件的开发流程如下：在DLV控制台的“我的组件”页面，单击右上角的“下载开发者工具”按钮，下载名为“dlv-cli-x.x.x”的开发者工具。新建一个目录（例如newCom），进入该目录后执行“dlv init”命令创建组件，根据提示信息依次输入新建组件的相关信息。按照DLV的组件开发规范完成组件开发。将开发完成的组件导出并上传到DLV的组件包中。组件上传并经技术人员审批通过后，即可在DLV大屏中使用该自定义组件。
自定义组件开发涉及到对DLV组件开发框架和文件结构的理解，适合有一定前端开发经验的技术人员。这项功能极大地扩展了DLV的定制化能力，满足了行业大屏的特殊展示需求。
10. 大屏发布与分享
大屏开发完成后，需要通过发布功能将大屏分享给其他用户。
10.1 发布大屏
在“我的大屏”页面，找到需要发布的大屏，将鼠标移至该大屏图标上，单击发布按钮即可。大屏发布后，系统会生成一个访问链接。其他用户无需登录DLV系统，只需在浏览器中输入该链接即可访问大屏。
10.2 发布方式
不同版本支持不同的发布方式：公开发布：所有版本均支持。大屏发布后生成的访问URL分享后没有任何访问限制。加密发布：高级版和专业版支持。大屏以加密方式发布，访问时需要验证。动态Token鉴权：高级版和专业版支持。通过动态Token进行访问鉴权，安全性更高。
10.3 集成到第三方系统
DLV大屏和组合大屏均可以集成到第三方系统中。集成时，大屏的URL地址需要携带应用的AppKey和密钥。用户也可以通过版本管理功能，设置用户通过分享链接访问大屏时允许查看的大屏版本。
10.4 大屏的导入导出
DLV支持将大屏在不同区域、不同账号之间进行迁移。用户可以将一个区域中导出的大屏导入到另一个区域的DLV中，也可以将其他账号或IAM用户导出的大屏导入到自己的DLV中。需要注意的是，将DLV低版本中导出的大屏导入更高版本时，如需使用最新版本的组件，需要在大屏中重新添加组件。
11. 权限管理与工作空间
DLV的权限管理体系基于工作空间角色进行访问控制。工作空间从系统层面为管理者提供了对DLV用户（成员）权限、资源和底层计算引擎配置的管理能力。
DLV工作空间有四种角色：管理员、开发者、分析师和访客。工作空间创建者默认为管理员角色，具备该工作空间内的最高权限。华为云账号默认具备添加工作空间成员的权限，账号下的子用户如需添加工作空间成员，需要由主账号给子用户赋予相应权限。
拥有DLV FullAccess或Tenant Administrator权限的用户，才具备购买DLV套餐包、创建、删除和修改工作空间以及设置默认工作空间的权限。工作空间作为成员管理和权限分配的基本单元，每个团队都可以拥有独立的工作空间，实现资源隔离和权限分治。
12. 常见问题与解答
问1：DLV支持哪些数据源类型？不同版本有何差异？
答：DLV支持的数据源包括云数据库MySQL、PostgreSQL、SQL Server、GaussDB、DWS、DLI、MRS Hive、MRS SparkSQL、ClickHouse、Oracle、DDM、OBS、Elasticsearch、API、API网关、DAYU数据服务、CSV和静态JSON等。基础版仅支持MySQL、GaussDB、CSV和静态JSON；高级版增加了PostgreSQL、SQL Server、DWS、DDM、OBS、DLI、MRS Hive、MRS SparkSQL、API和API网关；专业版进一步支持ClickHouse、Oracle、GaussDB for Influx和Elasticsearch。
问2：DLV如何与自建MySQL数据库进行网络互通？
答：DLV无法直接与非全托管服务进行连接。用户可以通过两种方式实现网络互通：一是使用CDM集群作为网络代理，CDM集群需与DLV在同一区域；二是使用VPC连接作为网络代理。如果MySQL数据源不在华为云上，其所在主机必须具备公网IP地址。同时需要确保MySQL数据库的防火墙规则和CDM集群所在安全组均开放了数据库端口的访问权限。
问3：API数据源有什么使用限制？遇到跨域问题怎么办？
答：API数据源仅支持通过HTTPS协议的GET请求调用，API响应结果必须为JSON格式，且DLV仅支持解析一级JSON数组，不支持多层嵌套的JSON结构。如果遇到跨域问题，需要在API服务端设置响应头信息Access-Control-Allow-Origin，放通DLV的访问权限。
问4：如何实现大屏组件间的数据联动？
答：在源组件的“交互”面板中定义交互变量并启用该变量。然后在目标组件的“数据”面板中，按下shift加美元符号键引用该交互变量。当用户操作源组件时，目标组件会自动根据变量值刷新数据。
问5：DLV的大屏如何分享给其他用户？有哪几种发布方式？
答：大屏开发完成后，在“我的大屏”页面单击发布按钮即可生成访问链接。其他用户无需登录DLV即可通过该链接访问大屏。发布方式有三种：公开发布（所有版本支持）、加密发布（高级版和专业版支持）和动态Token鉴权（高级版和专业版支持）。
问6：DLV支持自定义组件开发吗？流程是怎样的？
答：DLV支持自定义组件开发。用户需在“我的组件”页面下载开发者工具，新建目录后执行“dlv init”命令创建组件，按照开发规范完成开发后将组件导出并上传到组件包中。组件上传并经审批通过后即可在DLV中使用。
