为 Snowflake Connector for Google Analytics Raw Data 设置数据引入

使用 Snowflake Connector for Google Analytics Raw Data 需遵守 连接器条款。

本主题介绍如何在 Snowflake 账户中访问 Snowflake Connector for Google Analytics Raw Data。

备注

一次只能从一个 GCP 项目中引入任何单个属性。目前，为以前配置的属性更改项目需要重新安装连接器。未来将取消此限制。

如果您更改属性的导出设置，然后开始将其导出到其他 GCP 项目，则还应手动移动先前 BigQuery 实例中的数据，并将其合并到新配置的实例中。

使用 Snowsight 设置数据引入

要使用 Snowsight 设置数据引入，请执行以下步骤：

  1. 以具有 ACCOUNTADMIN 角色的用户身份登录 Snowsight。

  2. 在导航菜单中，选择 Data Products » Apps。

  3. 搜索 Snowflake Connector for Google Analytics Raw Data，然后选择连接器的磁贴。

  4. 在 Snowflake Connector for Google Analytics Raw Data 的页面中，导航到 Data Sync 部分。

    此部分将显示所有 Google Analytics 属性的列表。

  5. 选择要引入的属性：

    1. 搜索要引入的属性。

    2. 选中要选择的属性旁边的 Status 列中的复选框。

    3. 对要引入 Snowflake 的每个属性重复这些步骤。

  6. 选择 Status 列的标题，以查看您当前已选择的属性。

  7. 选择 Start sync 可开始将数据引入 Snowflake 账户。

所选属性显示在属性列表中。

Data Ingestion 状态将显示在 Manage data synchronization 部分的右上角。

每个属性的数据同步将从初始加载开始，这会引入一个属性的所有历史数据，然后继续进行当前同步。如果您只想同步当前数据，则可以通过工作表这样做。

使用 Snowsight 修改数据引入

若要修改要引入的 Google Analytics 表或表的同步计划，请执行以下步骤：

  1. 以具有 ACCOUNTADMIN 角色的用户身份登录 Snowsight。

  2. 在导航菜单中，选择 Data Products » Apps。

  3. 搜索 Snowflake Connector for Google Analytics Raw Data，然后选择连接器的磁贴。

  4. 在 Snowflake Connector for Google Analytics Raw Data 的页面中，导航到 Data Sync 部分。

  5. 选择 Edit properties。

  6. 修改要引入的表：

    1. 搜索要引入的表。

    2. 在要选择或取消选择的表旁边，选中 Status 列中的复选框。

  7. 选择 Update data sync。

使用 SQL 语句设置数据引入

要使用 SQL 语句设置数据引入，请执行以下操作：

备注

要配置这些设置，请使用在用作连接器安装数据库实例的数据库的 PUBLIC 架构中定义的存储过程。

在调用这些存储过程之前，选择该数据库作为会话使用的数据库。

例如，如果该数据库名为 snowflake_connector_for_google_analytics_raw_data，请运行以下命令：

USE DATABASE snowflake_connector_for_google_analytics_raw_data;
Copy

列出可供引入的属性

要列出给定 GCP 项目中的所有可用属性，请调用以下存储过程：

CALL LIST_GA_PROPERTIES();
Copy

结果显示了所有可供授权账户引入的项目和属性。如果未返回任何结果，请检查：

  • 是否已配置从 Google Analytics 到 BigQuery 的数据导出。

  • 导出的数据在 BigQuery 中是否可见。

  • 是否向使用的服务账户/经过身份验证的用户分配了适当的角色。

请注意，从设置数据导出到将数据存储在 BigQuery 中最多可能需要 24 小时。此延迟可能是 LIST_GA_PROPERTIES 过程没有产生任何结果的原因。

关闭 Google Analytics 导出并不意味着该属性已被 LIST_GA_PROPERTIES 忽略。即使导出已关闭，数据仍然可以保留在 BigQuery 中，并可由连接器同步。

准备目标数据库

在启用引入之前，您需要向连接器授予在目标数据库和架构内创建表和视图的权限。

GRANT USAGE ON DATABASE <destination database> TO APPLICATION <application name>;

GRANT USAGE ON SCHEMA <destination database>.<destination schema> TO APPLICATION <application name>;

GRANT CREATE TABLE ON SCHEMA <destination database>.<destination schema> TO APPLICATION <application name>;

GRANT CREATE VIEW ON SCHEMA <destination database>.<destination schema> TO APPLICATION <application name>;
Copy

启用或禁用属性的引入

要在 Google Analytics 中启用或禁用特定属性的数据同步，请使用以下实参调用 ENABLE_PROPERTIES 存储过程：

CALL ENABLE_PROPERTIES('<gcp_project>', ['<properties_to_configure>'], <enable_initial_load>);
Copy

其中：

gcp_project

指定已启用属性的 GCP 项目。

properties_to_configure

使用单引号指定以逗号分隔的 Google Analytics 属性名称列表。

使用不带 analytics_ 前缀的属性名称。

enable_initial_load

一个布尔值，表示是启用还是禁用初始数据加载，该加载会引入属性的所有历史数据，然后继续进行当前同步。

这是可选的实参，其默认值为 true。

例如，要启用项目 gcp_example_project 中名为 property1、property2 和 property3 的属性的同步，请运行以下命令：

CALL ENABLE_PROPERTIES('gcp_example_project', ['property1','property2','property3']);
Copy

要禁用初始数据加载，请使用类似以下所示的 ENABLE_PROPERITES 查询：

CALL ENABLE_PROPERTIES('gcp_example_project', ['property1','property2','property3'], false);
Copy

要阻止引入这些属性，请运行以下命令：

CALL DISABLE_PROPERTIES('gcp_example_project', ['property1','property2','property3']);
Copy

禁用该属性会停止其同步。禁用属性同步后，已启动的整个引入将从目标数据库中移除。

ENABLE_PROPERTIES 过程将指定的属性名称添加到 ENABLED_PROPERTIES 视图中。

初始加载

启用新属性后，连接器进入初始加载模式。这意味着，在收集新事件之前将引入在 BigQuery 中找到的所有历史数据。

将 Google Analytics 导出切换到其他项目。

只要连接器可以访问存储新数据的项目，连接器就会保持定期运行并下载数据。无需执行其他步骤。

语言: 中文