腾讯云BI从入门到精通：一站式对接使用与实战指南
1. 腾讯云BI产品概述
腾讯云BI（Business Intelligence）是一款敏捷自助式数据分析平台，为用户提供从数据源接入、数据建模到数据可视化分析的全流程BI能力。使用者仅需通过简单拖拽即可完成复杂的报表开发，并支持报表分享、推送等企业协作场景。
产品的核心特性包括：智能助手ChatBI（基于大语言模型的智能分析Agent，支持通过自然语言对话完成数据分析、可视化呈现和数据洞察）、丰富的可视化组件（柱图、线图、饼图、雷达图、散点图、词云等图表，以及多种过滤组件和全局联动分析）、数据简报模块（支持搭建可视化大屏、领导驾驶舱、数据报告等），以及多数据源无缝对接能力（MySQL、SQLServer、PostgreSQL、Oracle、ClickHouse等数据库，同时支持API数据源和Excel/Csv/腾讯文档数据表）。
在企业协作方面，腾讯云BI支持邮件等多种方式定期推送数据分析报告，满足日周月报等数据汇报场景；支持生成图片或在线链接的方式进行报表分享；支持移动端布局编辑和查看。
权限管控方面，腾讯云BI支持对数据表进行不同用户的行列权限管控，嵌出页面传参鉴权；支持资源对象级权限管控和模块级权限管控。
应用场景主要覆盖对话式智能分析Agent、可视化数据简报、数据门户看板搭建和自助式数据分析四大方向。
需要先登录华为云控制台，点击：华为云控制台，还没有账号，点击：注册并关联，已有账号点击：登录后关联
2. 开通服务与创建项目
2.1 开通腾讯云BI服务
使用腾讯云BI之前，需要先开通服务。开通方式有两种：一是前往腾讯云BI特惠活动页，以9.9元/年的优惠价格购买开通（原价550元/年）；二是前往腾讯云BI控制台申请1个月的专业版免费体验资格。免费试用期间可以体验包括ChatBI智能分析、多数据源接入、高级可视化等全部功能。
2.2 创建项目
开通服务后，进入腾讯云BI产品控制台，选择左侧的“项目管理”菜单，单击“创建项目”按钮。在创建项目窗口中输入项目名称，单击“创建并进入管理”即可完成项目创建。
项目是整个数据分析工作的组织单元，后续的数据源配置、数据表建模、仪表盘制作等工作都将在项目空间内完成。
3. 数据源接入配置
数据源接入是数据分析的第一步。腾讯云BI支持多种数据源类型，根据数据源的部署位置和类型，接入方式分为云数据源接入和自有数据源接入。
3.1 云数据源接入
如果数据源是在腾讯云上购买的服务（如云数据库MySQL、TDSQL-C MySQL版、分布式数据库TDSQL MySQL版、云数据库MariaDB、云数据库PostgreSQL、云数据库SQL Server等），建议使用云数据源方式进行接入。
操作步骤如下：
- 在项目空间中，单击左侧菜单的“数据”标签页，选择“数据源”选项，单击“新建数据源”。
- 选择要连接的数据源类型。目前支持的云数据库类型包括：云数据库MySQL、云数据库TDSQL-C MySQL版、分布式数据库TDSQL MySQL版、云数据库MariaDB、云数据库PostgreSQL、云数据库SQL Server、数据湖计算DLC、云数据仓库Apache Doris、云数据仓库PostgreSQL、云数据仓库ClickHouse等。注意：云数据库SQL Server基础版暂时不支持连接，仅支持“双机高可用”和“集群版”的连接。
- 根据选择的数据库类型填写连接参数。以云数据库MySQL为例，需要填写以下信息：
- 数据源显示名：在BI平台上展示的名称，最大不超过45个字符。
- 地域：该数据源所属的地域，请正确选择，后续实例的选择只会拉取该地域下的实例。
- 实例：根据所选地域自动拉取出该地域下购买的实例，支持实例名称模糊搜索和实例ID精确搜索。
- 编码：数据库的编码格式，支持"utf8"、"gbk"、"latin1"三种。
- 数据库名称：数据库的名称。
- 用户名&密码：数据库对应的用户名和密码。
- 填写完信息后，单击“一键测试”按钮进行连通性测试，显示“数据库连接成功”后单击“确认”即可完成数据源创建。
常见报错处理：如果使用子账号登录时遇到拉取实例列表失败的错误，可能是因为主账号未在CAM权限管理系统中分配该云数据源查询实例列表的权限。解决方案是使用主账号，在访问管理的策略模块中，分配对应云数据源的查询实例列表权限（如DescribeDBInstances）给子账号。
对于云数据仓库Doris、PostgreSQL、ClickHouse，可以通过私有连接进行腾讯云内网的安全访问，有效避免公网访问带来的潜在风险。
3.2 自有数据源接入
如果数据源是自建的（非云上购买的数据库），或者云上购买的数据库不在BI已支持的列表范围内，建议使用自有数据源方式进行接入。
操作步骤如下：
- 进入项目空间后，单击“数据源”，选择“新建数据源”。
- 选择需要连接的自有数据源类型，目前支持MySQL、PostgreSQL、SQLServer、Oracle、ClickHouse、Hive等多种数据库类型。
- 填写连接参数，以MySQL类型为例，需要填写以下信息：
- 数据源显示名：在BI上展示的名称，最大不超过45个字符。
- 数据源地址：数据库的IP地址或域名（如cdb-2dhmvx6s.bj.tencentcdb.com格式的外网地址）。不支持内网地址格式（如49.232.129.87）。
- 端口：数据库的端口号，如3306。
- 编码：支持"utf8"、"gbk"、"latin1"三种编码格式。
- 数据库名称：数据库的名称。
- 用户名&密码：数据库对应的用户名和密码。
- 填写完成后单击“一键测试”进行连通性测试。如果提示“数据源连通性异常”，首先检查用户名、密码等连接信息是否正确；如果无误，可能是数据源有安全相关设置拦截了BI的出口IP，需要在数据库所在服务器开通BI的出口IP白名单。
3.3 API数据源与文件数据源
除了数据库数据源，腾讯云BI还支持API数据源和文件数据源：
- API数据源：可通过HTTP接口获取数据，支持GET和POST请求方式，支持直连和抽取两种连接方式。
- Excel/CSV上传：可直接上传本地Excel或CSV文件作为数据源。
- 腾讯文档：支持接入腾讯文档作为数据源。首次使用需要进行授权，扫码授权后可通过输入URL或在“我的文档”中选择要接入的腾讯文档。
4. 数据表建模
数据源配置完成后，需要创建数据表。腾讯云BI提供了三种数据表创建方式：数据源建表、SQL建表和API建表。
4.1 数据源建表
数据源建表是最基础的建表方式，直接从已连接的数据源中选择数据表，拉取其所有字段。操作步骤如下：
- 单击“数据表”，选择“新建数据表”。
- 选择“数据源建表”。
- 选择数据源和具体的数据表。
- 勾选需要使用的字段（支持全选）。
- 单击确认完成建表。
4.2 SQL建表
SQL建表通过编写SQL查询语句来生成数据表，适用于需要多表关联、字段计算、数据筛选等灵活复杂查询的场景。
操作步骤如下：
- 在“数据表”模块中，单击“新建数据表”，选择“SQL建表”。
- 输入显示名称（数据表在BI中的展示名称）。
- 选择已连接的数据源。
- 在SQL语句框中编写SELECT查询语句（仅限SELECT查询）。
- 单击“立即解析”，系统会自动解析SQL语句并加载所有字段。
- 勾选需要的字段，进行字段配置（字段中文名、字段类型、备注等）。
- 单击完成即可建表。
SQL建表示例：
-- 示例：创建月度销售汇总表
SELECT
DATE_FORMAT(order_date, '%Y-%m') AS month,
region,
SUM(amount) AS total_sales,
COUNT(DISTINCT customer_id) AS customer_count
FROM sales_detail
WHERE order_date >= '2024-01-01'
GROUP BY DATE_FORMAT(order_date, '%Y-%m'), region
ORDER BY month DESC, total_sales DESC4.3 API建表
API建表方式可调用API接口返回数据表，将其生成为腾讯云BI的数据表。该功能仅支持专业版用户使用。
操作步骤如下：
- 进入项目管理页面，单击“数据”切换至数据标签页。
- 单击“新建数据表”，选择“API建表”。
- 配置API基础认证信息：
- 显示名称：API数据源表在数据表列表中的显示名称。
- URL地址：API接口的地址。
- 请求方式：选择GET或POST。
- 连接方式：直连（实时请求API接口显示，不保存在本地）或抽取（数据抽取至本地保存，可指定频率更新）。
- 配置参数设置（选填）：
- Params：普通参数，格式为url?key1=value1&key2=value2。支持动态分页参数${Startpage}。
- Headers：请求头参数。
- Body：请求体，仅支持JSON格式输入。
- Authorization：鉴权方式，可选择无权限或基础权限。
- 单击“测试连接”，成功后单击“下一步”。
- 在解析结果中选择所需字段，单击完成即可建表。
分页参数说明：${Startpage}代表起始页码（默认为1），${Startpage:num}代表起始页码指定为num。单页行数参数固定名称为pageSize，单页数据最大1000行，最大支持100页。
4.4 多表关联
当需要将多张数据表进行关联分析时，可以创建多表关联。例如将“地区维度表”的省份信息与“销售明细表”的销售额数据进行左右合并分析。
腾讯云BI还提供了便捷的数据加工处理能力，包括多表关联、字段计算、数据聚合、字典表等。
5. 仪表盘创建与可视化设计
数据准备完毕后，即可进入仪表盘创建环节，通过拖拽图表组件完成可视化界面的设计。
5.1 创建仪表盘页面
- 在项目空间中，单击左侧菜单的“仪表盘”选项，进入页面列表。
- 单击“创建页面”按钮，输入仪表盘名称，单击“确认”进入画布编辑界面。
- 画布编辑界面支持页面布局设置、组件拖拽、样式配置等操作。
5.2 图表组件介绍
腾讯云BI提供了丰富的数据可视化组件，主要分为以下几类：
- 指标类图表：指标卡、仪表盘，主要用于完成进度、指标及趋势统计，重点突出业务指标，可通过指标变化快速判断是否有经营异常。
- 比较类图表：柱状图、条形图、折线图、柱线组合图、面积图、堆叠图等。
- 占比类图表：饼图、环形图、旭日图、矩形树图。
- 关系类图表：散点图、雷达图、词云图、桑基图。
- 分布类图表：色彩地图、气泡地图、GIS点地图。
- 表格类组件：明细表、交叉表、表格。
- 过滤组件：时间筛选器、文本筛选器、级联筛选器、数值筛选器、筛选按钮。
- 辅助组件：图片、文本、Web组件（可嵌入外部网页）。
5.3 创建图表组件的操作流程
以创建一个销售数据仪表盘为例，实际开发流程如下：
- 从左侧组件库中将需要的图表组件拖拽到右侧画布中。
- 在数据配置面板中，选择已建好的数据表。
- 将字段拖拽到“维度”框和“数值”框中。例如分析省份销售额分布，将“省份”字段拖入维度，“销售额”字段拖入数值。
- 根据需要配置图表的样式（颜色、字体、标题位置、图例等）。
- 配置图表交互能力（筛选联动、下钻分析、跳转等）。
- 逐个完成每个图表组件的配置，最终形成完整的仪表盘。可以将仪表盘发布供其他用户查看使用。
以互联网企业销售数据分析看板为例，具体需求包括销售指标总览（产品销售总额、销售总数量、平均客单价用指标卡展示）、月度销售额和销量走势（用柱线图展示）、各省份销售额分布（用色彩地图展示）、各品类销售额分布（饼图联动产品销量排名条形图）、销售数据明细（明细表）以及按时间区间筛选采购时间（时间筛选器控制所有图表组件）。
通过组件筛选器配置不同参数，图表会根据筛选条件自动从数据表中获取不同数据并改变图表展示，实现全局联动分析的效果。
6. 权限管控与数据安全
腾讯云BI提供了企业级的数据安全权限管理体系，支持按用户/角色进行数据源、数据表行列权限、报表页面权限等多层级管控。
6.1 行列权限管理
行级权限和列级权限是腾讯云BI的核心安全功能，可实现不同用户在查看同一张数据表时，只能查看指定的数据行或者数据列。
应用场景示例：假设公司有总经理用户A、北京大区经理用户B和上海大区经理用户C。通过行列权限管理可以实现：用户A看到公司全部销售数据（包括毛利数据），用户B只看到北京大区的销售数据（看不到毛利数据），用户C只看到上海大区的销售数据（看不到毛利数据）。
行级权限配置步骤：
- 进入项目管理模块，找到对应项目的数据标签页。
- 在需要设置权限的数据表右侧操作中，单击“权限”按钮。
- 在弹出的抽屉窗口中，切换到“行级权限”标签页。
- 单击“启用权限”开关开启行权限生效状态。
- 选择授权方式：按项目角色授权或按标签授权。
- 设置可见规则。支持三种规则类型：
- 条件筛选：用户可查看所选字段的字段值满足特定条件的行数据，例如只查看“状态”字段值为“已注册”的数据行。
- 字段值枚举：用户可查看所选字段的字段值与右侧勾选的枚举值相匹配的行数据。
- 关联标签：用户可查看所选字段的字段值与该用户标签值相匹配的行数据。
- 保存配置。
列级权限配置步骤：
- 在行列权限配置抽屉中，切换到“列级权限”标签页。
- 单击“启用权限”开关开启列权限生效状态。
- 选择项目角色进行列权限条件设置。
- 勾选允许该角色可见的列字段（未勾选的列对用户不可见）。
- 保存配置。
版本功能限制：行列权限功能仅支持专业版用户使用。
6.2 数据表权限管理
除了行列级别的精细权限控制，腾讯云BI还支持数据表级别的权限管理，包括对数据表/字典表/数据源的可访问性控制，支持企业管理员和项目管理员进行统一授权。
通过多层级的权限体系，企业可以有效控制数据访问范围，防止敏感数据泄露，满足数据安全合规要求。特别是对于集团型组织、多层级跨区域管理场景，行列权限管控能力尤为重要。
7. 报表嵌入与二次开发（API集成）
腾讯云BI支持将报表页面无缝嵌入到第三方业务系统中，实现企业级的数据分析集成。报表嵌入分为强鉴权嵌出和弱鉴权嵌出两种模式。
7.1 强鉴权嵌出（推荐）
强鉴权嵌出要求在嵌出操作时开启嵌出校验，必须使用API接口生成带有效期的Token，然后拼接完整的嵌出URL进行访问。这种方式安全性更高，适用于生产环境。
操作流程如下：
- 进入腾讯云API Explorer工具（console.cloud.tencent.com/api/explorer）。
- 调用CreateEmbedToken接口创建强鉴权Token。
- 根据接口文档入参说明，填写入参（包括项目ID、页面ID、用户ID等）。
- 接口返回强鉴权Token。
- 结合看板页面的嵌出配置弹框中生成的URL前缀，拼接完整的嵌出URL，然后将该URL嵌入到业务系统的iframe中即可正常访问报表页面。
7.2 Python代码示例：生成强鉴权Token并构造嵌出URL
# -*- coding: utf-8 -*-
import json
import time
from tencentcloud.common import credential
from tencentcloud.common.profile.client_profile import ClientProfile
from tencentcloud.common.profile.http_profile import HttpProfile
from tencentcloud.bi.v20220105 import bi_client, models
# 配置腾讯云API密钥（从控制台获取）
SECRET_ID = "YOUR_SECRET_ID"
SECRET_KEY = "YOUR_SECRET_KEY"
# 项目配置
PROJECT_ID = "your_project_id" # BI项目ID
PAGE_ID = "your_page_id" # 要嵌入的报表页面ID
USER_ID = "embed_user_001" # 嵌入用户的唯一标识
TOKEN_TTL = 3600 # Token有效时间（秒），建议设置为3600或更短
def create_embed_token(project_id, page_id, user_id, ttl):
"""
创建BI报表嵌入Token
"""
try:
# 创建认证对象
cred = credential.Credential(SECRET_ID, SECRET_KEY)
# 配置HTTP选项
http_profile = HttpProfile()
http_profile.endpoint = "bi.tencentcloudapi.com"
client_profile = ClientProfile()
client_profile.httpProfile = http_profile
# 创建BI客户端
client = bi_client.BiClient(cred, "ap-guangzhou", client_profile)
# 构造请求
req = models.CreateEmbedTokenRequest()
req.ProjectId = project_id
req.PageId = page_id
req.UserId = user_id
req.TokenTtl = ttl
# 调用API
resp = client.CreateEmbedToken(req)
# 解析返回结果
resp_dict = json.loads(resp.to_json_string())
if "Response" in resp_dict and "Token" in resp_dict["Response"]:
return resp_dict["Response"]["Token"]
else:
print(f"创建Token失败: {resp_dict}")
return None
except Exception as e:
print(f"API调用异常: {e}")
return None
def build_embed_url(token, base_url, project_id, page_id):
"""
构造完整的嵌出URL
base_url格式示例: https://bi.tencentcloud.com/embed/
"""
# 拼接完整URL
embed_url = f"{base_url}{project_id}/{page_id}?token={token}"
return embed_url
# 主函数示例
if __name__ == "__main__":
# 步骤1: 生成Token
token = create_embed_token(PROJECT_ID, PAGE_ID, USER_ID, TOKEN_TTL)
if token:
print(f"生成Token成功: {token}")
# 步骤2: 构造嵌出URL（base_url需要从BI控制台的嵌出配置中获取）
base_url = "https://bi.example.com/embed/" # 替换为实际的嵌出域名
embed_url = build_embed_url(token, base_url, PROJECT_ID, PAGE_ID)
print(f"嵌出URL: {embed_url}")
# 步骤3: 生成HTML iframe代码
iframe_html = f'''<iframe
src="{embed_url}"
width="100%"
height="800px"
frameborder="0"
allow="fullscreen"
></iframe>'''
print(f"\niframe嵌入代码:\n{ifm_html}")
else:
print("Token生成失败，请检查API密钥和参数配置")代码说明：
- 使用腾讯云官方Python SDK调用bi.tencentcloudapi.com的CreateEmbedToken接口。
- 需要传入ProjectId（项目ID）、PageId（页面ID）、UserId（嵌入用户的唯一标识）和TokenTtl（Token有效时间）。
- Token有效期内，拥有该Token的任何人都可以访问对应的报表页面，因此建议Token有效期设置不超过1小时，并由业务系统独立控制用户鉴权。
- SDK安装方式：pip install tencentcloud-sdk-python
7.3 弱鉴权嵌出
弱鉴权嵌出适用于开发测试或内部低安全要求场景，在嵌出操作时关闭嵌出校验，系统自动生成带Token的嵌出链接，无需调用API接口。
操作方式：在BI控制台中打开报表页面的嵌出配置弹框，关闭嵌出校验开关，系统自动生成嵌出链接，直接复制链接即可使用。
7.4 二次开发能力概览
腾讯云BI通过开放集成能力支持多种二次开发场景：
- 标准API接口：支持调用API对腾讯云BI进行操作，如创建用户、修改用户信息、创建项目、修改项目信息、创建数据源等。
- 嵌出传参鉴权：支持将分析页面无缝集成到第三方系统，并支持传参鉴权确保数据安全。
- 私有化部署与BI SDK：对于有更高定制化需求的金融、政务、能源等对数据安全要求极高的行业，腾讯云BI提供私有化部署版本，支持基于BI SDK的深度二次开发，量身定制BI系统。
不同版本的二次开发能力有所差异：个人版支持基础API支持，基础版提供标准API接口，专业版提供完整API+嵌出传参鉴权能力，私有化版提供BI SDK全量二次开发能力。
8. 版本介绍与计费模式
腾讯云BI提供个人版、基础版、专业版三个版本的订阅购买付费模式，同时支持本地化部署。
8.1 个人版
适用个人用户。刊例价550元/年（享受新老用户9.9元/年优惠价）。操作账户数为1人，企业空间最大1GB，最多5个报表页面。支持常见的数据源类型接入、快速建表、常用图表组件和报表页面制作。
8.2 基础版
适用中小型企业，有组织级别多人协同需求。以每10个账户递进，最大50个用户，刊例价为8,500元/年/10用户（享受新人优惠价4675元/年/10用户）。企业空间最大10GB。覆盖个人版所有功能，提供更丰富的数据源、图表类型、主题样式支持，新增邮件推送、组织级别多人协同管理等能力。
8.3 专业版
适用大中型企业，助力企业数字化转型。按通用用户/编辑用户/查看用户分角色购买，支持50至30000用户。刊例价120,000元/年（默认赠送50个通用用户+10GB抽取加速引擎容量）。超出部分：每个通用用户2000元/年；编辑用户不超过100人时每个1000元/年，超出后每人600元/年；查看用户不超过200人时每个500元/年，超出后每人300元/年。抽取加速引擎容量超出10GB后，后续每5GB需5000元/年。企业空间最大100GB。
专业版相比基础版新增的核心能力包括：数据源增强能力（云数据仓库Doris、PostgreSQL、ClickHouse、数据湖DLC等）、大数据高性能能力、数据表行列权限精细化管控能力、开放集成（嵌出传参鉴权）、移动协同能力以及更多高级图表组件（雷达图、词云图、桑基图、气泡地图、GIS点地图等）。
8.4 版本选择建议
- 个人学习或测试：选择个人版，9.9元/年的低成本投入即可体验BI核心功能。
- 中小型企业基础数据分析需求：基础版性价比最高，4675元/年/10用户即可满足组织协同和数据分析需求。
- 大中型企业/复杂数据分析/多层级组织/二次开发需求：专业版提供完整功能集，特别是行列权限管控和嵌出传参鉴权能力对于企业级应用至关重要。
- 金融、政务等数据敏感行业：推荐私有化部署版本，满足数据不出域的安全合规要求。
8.5 免费试用
腾讯云BI提供专业版免费试用1个月的活动，企业可在零风险环境下全面体验产品功能。免费试用期间可以体验包括ChatBI智能分析、多数据源接入、高级可视化等全部功能，为采购决策提供充分依据。
9. 常见问题与解答
问：腾讯云BI支持哪些数据源类型？
答：支持多种数据源类型，包括云数据库MySQL、TDSQL-C MySQL版、云数据库PostgreSQL、云数据库SQL Server等腾讯云数据源；自有数据源方面支持MySQL、PostgreSQL、SQLServer、Oracle、ClickHouse、Hive等；特色数据源方面支持API数据源、Excel/CSV上传和腾讯文档接入。
问：如何将腾讯云BI的报表嵌入到自己的业务系统中？
答：推荐使用强鉴权嵌出方式。首先在BI控制台打开报表页面的嵌出配置，开启嵌出校验，然后调用CreateEmbedToken API接口生成带有效期的Token，最后拼接完整的嵌出URL嵌入到业务系统的iframe中即可访问。文中提供了Python SDK的完整代码示例可供参考。
问：腾讯云BI的行列权限功能怎么使用？
答：在项目管理模块的数据标签页中，找到需要设置权限的数据表，单击操作列中的“权限”按钮。在弹出抽屉中，行级权限和列级权限分别设置。行级权限可以配置条件筛选、字段值枚举、关联标签三种规则，控制不同角色用户可查看的数据行；列级权限控制不同角色用户可查看的列字段。注意该功能仅限专业版用户使用。
问：SQL建表时支持的SQL语法有哪些限制？
答：SQL建表仅支持SELECT查询语句，不支持INSERT、UPDATE、DELETE等数据变更语句。可以编写多表关联、聚合查询、子查询等复杂SQL来实现数据加工。SQL语句编写完成后单击“立即解析”即可加载字段并进行字段类型配置。
问：腾讯云BI的计费方式是怎样的？各个版本有什么区别？
答：采用按年预付费模式，提供个人版（1用户，9.9元/年）、基础版（10用户起，4675元/年/10用户）和专业版（50通用用户起，含10GB抽取加速容量）。主要区别在于数据源类型支持广度、用户数上限、报表页面数、行列权限能力、嵌出传参鉴权等方面。个人版适合个人学习，基础版适合中小团队协同，专业版适合企业级大数据分析和二次开发需求。
问：如何获取腾讯云BI的API密钥用于二次开发？
答：登录腾讯云控制台，进入“访问管理”（CAM）中的“API密钥管理”模块，可以创建和查看SecretId和SecretKey。注意保护好密钥，不要泄露在公开代码中。API接口请求域名为bi.tencentcloudapi.com，所有接口均为API 3.0接口。
