BigQuery 是 Google 推出的全代管式、PB 级、低成本分析数据仓库。借助数据洞察 BigQuery 连接器，您可以直接在数据洞察中访问和直观呈现 BigQuery 表、视图和自定义 SQL 查询中的数据。
准备工作
如需在数据洞察中访问 BigQuery 数据，您必须提供一个 Google Cloud 具有关联 Google Cloud Billing 账号的项目。
BigQuery 是一个付费分析平台。通过数据洞察报告访问 BigQuery 数据时，您可能会产生查询处理或存储费用。如需详细了解查询和容量价格，请参阅 BigQuery 价格。
所需的角色
如需在数据洞察中查询 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 图，您可以通过基于现有表定义节点和边来对数据中的关系进行建模。
如需连接到表、视图或图，请指定以下连接参数：
- BigQuery 项目
- 数据集
- 特定表、视图或图表。数据洞察还支持连接到按日期分区的表和多天表。
选择项目
项目可整理您的 Google Cloud 资源，并在报告超出 BigQuery 的免费限额时确定查询费用的结算位置。您可以查询一个项目中的数据，同时将费用计入另一个项目。详细了解 Google Cloud 项目。
在连接器配置面板中选择以下选项之一：
- RECENT PROJECTS：显示您最近在 Google Cloud 控制台中打开的项目。您也可以手动输入项目 ID。所选项目将用于结算和数据访问。
- 我的项目：显示您有权访问的所有项目。如果列表中缺少某个项目，请在输入字段中输入确切的项目 ID。
- 共享项目：显示跨部门或组织共享的项目。您可以指定不同的项目来执行数据选择和结算。
选择数据集
数据集用于组织和控制对表和视图组的访问权限。从列表中选择数据集，或按数据集 ID 搜索。
BigQuery 公共数据集是 Google 在全球范围内共享的免费示例数据集。如需查询公开数据，您必须选择一个结算项目来支付查询处理费用。
连接到日期分区表
数据洞察支持 BigQuery 日期分区表（DATE、DATETIME 或 TIMESTAMP）。当您选择按 DATE、DATETIME 或 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 导出：当数据洞察遇到由 Google Analytics BigQuery 导出生成的表时，该表旁边会显示一个 Google Analytics 图标。连接表格后，数据洞察会自动将 Google Analytics 中的许多标准指标创建为计算字段。
“记录数”指标
每个 BigQuery 数据源都会在字段列表中自动包含记录数指标。在图表中使用 Record Count 可统计记录数或验证查询返回的总行数。
直观呈现 BigQuery GEOGRAPHY 多边形
您可以在报告中使用 Google 地图显示 BigQuery 中的地理空间边界（GEOGRAPHY 多边形空间数据）。如需查看使用公共人口普查区数据的分步教程，请参阅使用数据洞察直观呈现 BigQuery GEOGRAPHY 多边形。
排查错误并查看限制
如果图表无法加载或返回配置警告，请参阅排查 BigQuery 连接器错误和限制指南。