MaxCompute支持您将MaxCompute项目数据接入Yonghong BI，帮助您轻松完成数据分析和数据可视化工作。本文为您介绍如何连接Yonghong BI和MaxCompute项目，并进行可视化数据分析。
背景信息
Yonghong Desktop是一款桌面智能数据分析工具，基于本机安装，省去繁琐的部署环节，即装即用。提供一站式、敏捷、高效的数据治理、可视化分析及AI深度分析能力，可以帮助每一位用户轻松实现数据分析和数据可视化工作。更多Yonghong BI信息，请参见Yonghong。
前提条件
在执行操作前，请确认您已满足如下条件：
-
已创建MaxCompute项目。
更多创建MaxCompute项目操作，请参见创建MaxCompute项目。
-
已获取可访问MaxCompute项目的AccessKey ID和AccessKey Secret。
您可以进入AccessKey管理页面获取AccessKey ID和AccessKey Secret。
-
已安装内置MaxCompute Connector的Yonghong Desktop（v9.2.2）。
更多Yonghong Desktop安装与启动信息，请参见安装Yonghong Desktop。
本文中的Yonghong Desktop示例版本为v9.2.2。Yonghong Desktop已内置MaxCompute JDBC驱动。
-
如果Yonghong Desktop内置的MaxCompute JDBC驱动无法成功连接MaxCompute项目时，请下载包含完整依赖JAR包
jar-with-dependencies的MaxCompute JDBC驱动（v3.2.8及以上版本）。本文中的MaxCompute JDBC驱动示例版本为v3.2.9。添加驱动操作详情，请参见添加自定义驱动。
使用说明
Yonghong Desktop抽取MaxCompute数据集时，最高行数限制为100W行，如果需要解除该限制，您可以采取下述方法：
在bi.properties文件（本地文件路径：${Yonghong Desktop}\YonghongBI\Yonghong\bihome）中添加参数vendor.limit.rows={17:1000000} 。
-
17：代表MaxCompute。
-
1000000：表示抽取数据集时的最高限制行数，您可以根据需要将其修改为合适的数值，避免给系统带来压力。
修改bi.properties文件后需重启Yonghong Desktop使其生效。
步骤一：连接Yonghong BI和MaxCompute
-
启动Yonghong Desktop，进入Yonghong Desktop界面。
-
在Yonghong Desktop界面的左侧导航栏，单击添加数据源。
-
在添加数据源页面，单击
，在对话框中选择MaxCompute。 -
在数据库页面，配置下表所列参数信息。
参数
说明
连接数据源
目标数据源类型，固定选择MaxCompute。
驱动
用于连接MaxCompute项目的驱动程序。支持如下两种驱动方式：
-
默认驱动：取值为com.aliyun.odps.jdbc.OdpsDriver，通常无需修改。
-
自定义驱动：当默认驱动无法成功连接MaxCompute项目时，需要选择自定义驱动。添加自定义驱动操作请参见添加自定义驱动。
URL
连接MaxCompute项目的URL。格式为
jdbc:odps:<MaxCompute_endpoint>?project=<MaxCompute_project_name>[&interactiveMode={true|false}]。配置时删除<>符号。参数说明如下：-
<MaxCompute_endpoint>：必填。MaxCompute项目所属区域的Endpoint。
各地域的Endpoint信息，请参见Endpoint。
-
<MaxCompute_project_name>：必填。待连接的目标MaxCompute项目名称。
此处为MaxCompute项目名称，非工作空间名称。您可以登录MaxCompute控制台，左上角切换地域后，即可在项目管理页面查看到具体的MaxCompute项目名称。
-
interactiveMode：可选。查询加速功能开关。
如果您需要启用查询加速功能，在URL后追加
&interactiveMode=true配置即可。更多查询加速功能信息，请参见查询加速。
服务器登录
默认为用户名和密码，无需修改。
用户名
具备目标MaxCompute项目访问权限的AccessKey ID。
您可以进入AccessKey管理页面获取AccessKey ID。
密码
AccessKey ID对应的AccessKey Secret。
您可以进入AccessKey管理页面获取AccessKey Secret。
-
-
在数据库页面下方，单击测试连接，连接成功后保存数据连接。
在弹出的保存对话框中，文件名称填写 MaxCompute，单击 确定 完成保存，右侧导航栏的 Demo Data_zhCN 节点下出现 MaxCompute 数据源条目。
步骤二：使用Yonghong BI查询及分析数据
在Yonghong Desktop操作界面，您可以基于新创建的数据连接，查询MaxCompute项目数据及分析数据。您可以执行如下操作，操作详细指导，请参见Yonghong帮助。
-
查看所有表
成功保存数据连接后，Yonghong Desktop界面会自动加载MaxCompute项目的表信息。
-
查看表结构
在Yonghong Desktop操作界面的左侧导航栏，单击创建数据集，选择数据源为MaxCompute后，您可以自定义SQL脚本在元数据页签查看表结构信息并保存数据集。
在表列表中选中bank_data_pt表，输入SQL语句如
select * from bank_data_pt where age=35，单击刷新数据加载数据。元数据标签页中可查看字段包括job（工作类型）、marital（婚否）、education（教育程度）、housing（是否有房贷）、loan（是否有贷款）、contact（联系方式）、duration（持续时间）、poutcome（之前市场活动的结果）等，确认无误后单击保存图标完成数据集保存。 -
查看表数据
在Yonghong Desktop操作界面的左侧导航栏，单击创建数据集，选择数据源为MaxCompute后，您可以自定义SQL脚本在数据详情页签查看表数据信息并保存数据集。
选中 自定义SQL语句 单选按钮，在 SQL 输入区输入查询语句（例如
select * from bank_data_pt where age=35），单击 刷新数据 即可在右侧 数据详情 区域查看查询结果。单击顶部工具栏的保存图标保存数据集。 -
可视化分析数据
在Yonghong Desktop操作界面的左侧导航栏，单击制作报告，新增报告后，选择图表类型并配置参数，即可根据实际业务诉求开展数据分析。
可选择的报告主题模板包括 默认主题、经典蓝、马卡龙、皓月蓝。进入编辑界面后，在右侧数据字段配置区将字段拖放至 列 和 行 区域（例如将 职工人数_总和 拖至列、教育程度 拖至行）即可生成对应图表。
添加自定义驱动
Yonghong Desktop已内置MaxCompute JDBC驱动，如果使用默认驱动无法成功连接MaxCompute项目，您可以按照本步骤流程自定义驱动。
-
启动Yonghong Desktop，进入Yonghong Desktop界面。
-
在左上角单击
图标，添加MaxCompute驱动名称并上传下载的MaxCompute JDBC驱动JAR包，例如odps-jdbc-3.2.9-jar-with-dependencies.jar，单击确定即可成功添加驱动。