适用于传统 SQL 连接的 Google BigQuery

连接要求

您用来连接到 Google Big Query 的服务帐户必须具有标准角色“BigQuery 数据查看器”和具有这些权限的自定义角色。

• bigquery.jobs.create
• bigquery.jobs.get
• bigquery.jobs.list
• bigquery.jobs.listAll
• bigquery.jobs.update
• bigquery.tables.create
• bigquery.tables.delete
• bigquery.tables.update
• bigquery.tables.updateData
• storage.buckets.list

帐户创建功能可生成帐户属性的 JSON 文件。大多数必要的连接设置都在该文件中。有关查看和下载服务帐户详细信息的更多信息，请查看 Google 的创建和管理服务帐户密钥文档。

创建连接

1. 在“数据管理器连接”选项卡中单击新建连接。
2. 单击连接器的名称，然后单击下一步。
3. 输入连接器设置。
4. 要验证您的设置并尝试连接到源，请单击保存并测试。如果连接失败，CRM Analytics 会显示可能原因。

除非另行说明，否则所有设置需要值。

筛选同步到 CRM Analytics 的数据

在同步到 CRM Analytics 时，使用数据同步筛选器将不必要或敏感的数据排除。筛选器在源对象上运行，并通过仅将您需要的数据拉入 CRM Analytics 来加快数据同步。

备注 如果将来可能使用排除的数据，请使用模式筛选器来限制写入数据集的数据，而不是数据同步筛选器。

1. 在数据管理器中，单击连接选项卡。
2. 选择与要筛选的对象相关联的连接。
3. 单击要筛选的对象的名称。
4. 单击数据同步筛选器。
5. 输入筛选器。
6. 单击保存。

对于 Google BigQuery 连接器，按照 Google BigQuery 帮助中描述的语法输入筛选器。

Google BigQuery 连接器注意事项

在使用 Google BigQuery 连接器时，请谨记这些行为。

• 连接的对象名称必须以字母开头，并且只包含字母、数字或下划线。对象名不能以下划线结尾。
• 仅支持包含字母数字、点、下划线或破折号字符组合的字段名称。如果连接器中存在含有其他字符（例如空格或括号）的字段名称，则同步会失败。
• 连接器最多可以同步 1 亿行或每个对象 50 GB，以先达到的限制为准。
• 如果 BigQuery 表使用的数据集成自 Google Drive，则不支持。Google Drive 数据必须移动到 BigQuery 中。

嵌入和重复字段

连接器会平展嵌入字段，并将其作为单独字段同步。此外，连接器会为重复字段生成新行。我们来看一个示例。此 JSON 文件中的联系人数据包含每个联系人的当前和以前的地址。地址字段嵌入状态、街道、城市和州/省字段。这些嵌入字段会针对每个联系人显示两次：第一次是当前地址，然后是以前的地址。

{"id":"1","name":"James Park","addresses":[{"status":"current","street":"1 Harper Alley","city":"Toledo","state":"OH"},{"status":"previous","street":"392 Parkside Street","city":"Seattle","state":"WA"}]}
{"id":"2","name":"Lori Carr","addresses":[{"status":"current","street":"7501 Talisman Court","city":"Fort Worth","state":"TX"},{"status":"previous","street":"3368 Anderson Lane","city":"Moreno Valley","state":"CA"}]}

如果您包含要同步的地址字段，每个嵌入字段会在已同步连接的对象的每个行中显示为单独字段。重复地址字段会为每个联系人生成两个行：一个行适合当前地址，另一个行适合以前的地址。

id	名称	addresses.status	addresses.street	addresses.city	addresses.state
1	James Park	当前	1 Harper Alley	Toledo	俄亥俄
1	James Park	以前	392 Parkside Street	西雅图	华盛顿州
2	Lori Carr	当前	7501 Talisman Court	Fort Worth	德克萨斯州
2	Lori Carr	以前	3368 Anderson Lane	Moreno Valley	CA

临时目标表

在为客户端提供前，连接器会在 BigQuery 中创建临时目标表，以暂存数据。连接器会按格式 EA_TEMP_<5-character random string>_<objectName> 对这些表格命名。通常，表格会自动删除。为避免 Google BigQuery 产生额外数据存储费用，请确认所有临时表已删除，并手动删除未删除的任何表。

表支持

Google BigQuery for Legacy SQL 连接器支持标准 SQL 表、传统 SQL 表和传统 SQL 视图，但不支持标准 SQL 视图。