BigQuery 是 Google 推出的全代管式低成本分析型数据仓库,可支持 PB 级数据规模。利用数据洞察 BigQuery 连接器,您可以在数据洞察内直接访问 BigQuery 表、视图和自定义 SQL 查询中的数据并将其可视化。
准备工作
如需在 Data Studio 中访问 BigQuery 数据,您必须提供一个 Google Cloud 与 Google Cloud 结算账号相关联的项目。
BigQuery 是一款付费分析平台。通过数据洞察报告访问 BigQuery 数据时,您可能需要支付查询处理或存储费用。如需详细了解查询和容量价格,请参阅 BigQuery 价格。
所需角色
如需在 Data Studio 中查询 BigQuery 数据,您需要拥有读取数据和运行查询作业的权限。请在您的 Google Cloud 项目或数据集上授予以下 IAM 角色:
- BigQuery Data Viewer (
roles/bigquery.dataViewer):允许从表或视图中读取数据和元数据。 - BigQuery Job User (
roles/bigquery.jobUser):允许在结算项目中运行查询作业。
谁需要这些角色取决于您为数据源选择的数据凭证模式:
- 所有者的凭据(默认):只有数据源所有者需要这些角色。报告查看者无需拥有自己的 BigQuery 访问权限即可查看图表。
- 查看者的凭据:每位报告查看者都必须拥有这些角色才能查看报告中的数据。
- 服务账号凭据 :只有服务帐号需要这些角色。如需配置服务帐号,请参阅为数据洞察 Google Cloud 设置服务账号。
如何连接到 BigQuery
请按照以下步骤将 BigQuery 数据连接到数据洞察报告:
连接步骤
- 登录数据洞察。
- 点击
创建 ,然后选择报告 。 - 报告编辑器随即打开,同时打开的还有将数据添加到报告 面板。
- 如需创建新的嵌入式 数据源,请选择 BigQuery 连接器。
- 替代方案: 如需使用现有的可重复使用的数据源,请点击我的数据源 标签页,然后选择您之前创建的或与您共享的任何类型的数据源。
- 使用其中一个 连接选项配置对数据库的访问权限。
- 点击 Add (添加)。
片刻之后,与数据源关联的表会显示在报告画布上。
连接选项
BigQuery 数据源可以从 表或视图中提取数据,也可以从 自定义 SQL 查询中提取数据。
连接到 BigQuery 表或视图
BigQuery 表以行和列(字段)的形式存储数据。BigQuery 视图是由 SQL 查询定义的虚拟表,该查询在 BigQuery 控制台中动态运行,也可以使用 BigQuery API 运行。
如需连接到表或视图,请指定以下连接参数:
- BigQuery 项目
- 数据集
- 特定表或视图。数据洞察还支持连接到按日期分区和多日表。
选择项目
项目用于整理您的 Google Cloud 资源,并确定报告超出 BigQuery 的免费限制时查询费用的结算对象。您可以在一个项目中查询数据,同时将费用结算到另一个项目。详细了解Google Cloud 项目。
在连接器配置面板中,选择以下选项之一:
- 最近使用的项目 :显示您最近在 Google Cloud 控制台中打开的项目。您也可以手动输入项目 ID。所选项目将用于结算和数据访问权限。
- 我的项目 :显示您有权访问的所有项目。如果列表中缺少某个项目,请在输入字段中输入确切的项目 ID。
- 共享项目 :显示跨部门或组织共享的项目。您可以为数据选择和结算执行指定不同的项目。
选择数据集
数据集用于整理和控制对表和视图组的访问权限。从列表中选择一个数据集,或按数据集 ID 进行搜索。
BigQuery 公共数据集是免费的示例数据集,可在 Google 全球范围内共享。如需查询公共数据,您必须选择一个结算项目来支付查询处理费用。
连接到按日期分区表
数据洞察 supports BigQuery date-partitioned tables (DATE, DATETIME, or TIMESTAMP)。选择按 DATE, DATETIME, or TIMESTAMP 分区的表时,您可以将分区列设置为图表的主要日期过滤条件。使用分区表有助于图表更快呈现,同时最大限度地降低查询费用。
连接到多日表(YYYYMMDD 前缀)
BigQuery 支持 跨多个分片表进行查询,其中每个表存储单日数据,并以 YYYYMMDD 结尾(例如 [prefix]_YYYYMMDD)。
当数据洞察在表选择期间遇到以 YYYYMMDD 后缀格式化的表时,它会将每日表分组到干净的前缀名称 ([prefix]_YYYYMMDD) 下。当您从多日表中创建图表时,数据洞察会自动仅查询最近 28 天的数据。您可以随时更改此日期窗口,方法是在图表的设置 标签页中修改日期范围 属性。
使用自定义 SQL 查询连接到 BigQuery
借助自定义查询 选项,您可以通过编写 SQL 连接到数据。自定义查询语法遵循 标准 SQL 方言。如需使用旧版 SQL 语法,请选择使用旧版 SQL 。
我们建议您先直接在 BigQuery 控制台 中编写和测试查询,然后将经过验证的 SQL 脚本复制并粘贴到数据洞察自定义查询编辑器框中。
替换结算项目
借助结算项目 设置,您可以指定哪个 Google Cloud 项目支付自定义查询执行费用。如果您的组织跨多个项目运营,您可以在该字段中手动输入结算项目 ID。
如需在一个项目中查询数据,同时将费用结算到另一个项目,请在此字段中指定结算项目,并在查询的 FROM 子句中明确引用数据项目 (FROM project_id.dataset_id.table_id)。

使用查询参数
借助参数,您可以构建响应速度更快、可自定义的报告。您可以在 BigQuery 数据源中将参数传递回底层查询。如需在自定义查询中使用参数,请遵循在 BigQuery 中运行参数化查询 的语法准则。
如需了解完整设置说明、参数语法规则以及如何使用参数(@DS_START_DATE、@DS_END_DATE、@DS_USER_EMAIL)配置行级安全性,请参阅在自定义查询中使用参数。
注意事项和提示
以下是一些注意事项和提示,可帮助您充分利用 BigQuery 数据源。
刚开始使用数据洞察?
如需详细了解数据洞察中的核心报告功能,请尝试以下资源:
集成了 BigQuery
某些 Google 产品和外部工具可将数据直接导出到 BigQuery 表中。将数据洞察连接到 BigQuery 时,数据洞察会自动计算标准指标并设置字段名称格式:
- 在数据洞察中探索 BigQuery 数据 :数据分析师可以直接从 BigQuery 控制台中通过数据洞察探索 BigQuery 数据。运行查询或选择一个表,然后选择在数据洞察中探索 ,以在互动式报告中直观呈现数据。如需了解详情,请参阅使用数据洞察分析数据。
- Google Analytics BigQuery 导出:当 Data Studio 遇到由 Google Analytics BigQuery 导出 生成的表时,该表旁边会显示一个 Google Analytics 图标。连接表时,数据洞察会自动创建 Google Analytics 中许多标准指标,并将其作为计算字段。
记录数指标
每个 BigQuery 数据源都会自动在字段列表中添加记录数 指标。在图表中使用 Record Count 来统计记录数或验证查询返回的总行数。
直观呈现 BigQuery GEOGRAPHY 多边形
您可以在报告中使用 Google 地图显示 BigQuery 中的地理空间边界(GEOGRAPHY 多边形空间数据)。如需查看使用公共人口普查区数据的分步教程,请参阅使用数据洞察直观呈现 BigQuery GEOGRAPHY 多边形。
排查错误并查看限制
如果图表加载失败或返回配置警告,请参阅排查 BigQuery 连接器错误和限制指南。