访问 Snowflake Connector for Google Analytics Raw Data 引入的数据

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

本主题介绍如何从 Snowflake 账户访问 Google Analytics 中的原始数据。

本主题内容：

对于 BigQuery 中为同步配置的每个属性，Snowflake Connector for Google Analytics Raw Data 会创建：

  • 与属性名同名的 ANALYTICS_propertyId 表。此表包含原始每日数据。表中的每个记录都存储在单独的行中，并且 Google Analytics 事件数据保存在 VARIANT 类型的单列中。

  • 将上表中的事件数据映射到单独列的 ANALYTICS_propertyId__VIEW 视图。

  • 与属性名同名的 ANALYTICS_INTRADAY_propertyId 表。此表包含原始日内数据。

  • 将上表中的日内事件数据映射到单独列的 ANALYTICS_INTRADAY_propertyId__VIEW 视图。

上述表和视图的临时所有者是 Snowflake Connector for Google Analytics Raw Data。所有权应在连接器卸载期间转移，有关详细信息，请参阅 卸载并重新安装 Snowflake Connector for Google Analytics Raw Data。

以下部分说明如何授予访问此数据的权限以及如何访问这些表和视图中的数据。

授予在 Snowflake 中访问 Google Analytics 数据的权限

在 Snowflake Connector for Google Analytics Raw Data 与 Snowflake 同步数据之后，您可以使用 data_owner_role 访问数据，也可以使用满足以下两个条件的任何其他角色：

  • 对包含 Snowflake Connector for Google Analytics Raw Data 引入的数据的数据库和架构具有 USAGE 权限。

  • 被授予 DATA_READER 应用程序角色（具有对此架构中的表或视图的 SELECT 权限）。

例如，如果您配置 Snowflake Connector for Google Analytics Raw Data 以将数据存储在 dest_db 数据库和 dest_schema 架构中，则可以创建 google_analytics_raw_data_reader_role 角色，并向该角色授予数据的访问权限。

以下示例显示如何授予这些权限：

CREATE ROLE google_analytics_raw_data_reader_role;
GRANT USAGE ON DATABASE dest_db TO ROLE google_analytics_raw_data_reader_role;
GRANT USAGE ON SCHEMA dest_db.dest_schema TO ROLE google_analytics_raw_data_reader_role;
GRANT APPLICATION ROLE SNOWFLAKE_CONNECTOR_FOR_GOOGLE_ANALYTICS_RAW_DATA.DATA_READER TO ROLE google_analytics_raw_data_reader_role;
Copy

访问原始数据

对于您同步的每个 BigQuery 表，Snowflake Connector for Google Analytics Raw Data 会在用于存储 Snowflake Connector for Google Analytics Raw Data 的 Snowflake 数据库和架构中创建一个具有相同名称的新表。

例如，如果您配置连接器，以将数据存储在 dest_db 数据库和 dest_schema 架构中，并通过角色 my_role 访问数据，而且还将连接器配置为同步 BigQuery 中的 analytics_12345 表，则连接器将创建名为 dest_db.dest_schema.analytics_12345 的表。

此表包含从 BigQuery 引入的原始数据。此表包含以下列：

列名称

数据类型

描述

raw

VARIANT

以原始形式记录的数据。

run_id

VARIANT

引入了数据的异步过程的 ID。

source_table_date

DATE

连接器从中将数据引入到表中的每日表的名称。

ingestion_complete

BOOLEAN

如果连接器从每日表中引入了所有数据，则为 true；如果部分数据仍在下载中，则为 false。

以下是检索 dest_db.dest_schema.analytics_12345 表数据的 SELECT 语句的输出示例：

SELECT * FROM DEST_DB.DEST_SCHEMA.ANALYTICS_12345 LIMIT 5;

+---------------------------+--------------------------------------+--------------------+--------------------+
| RAW                       | RUN_ID                               |  SOURCE_TABLE_DATE | INGESTION_COMPLETE |
+---------------------------+--------------------------------------+--------------------+--------------------+
| { "app_info": null, ... } | f8edbf0e-1d0d-4ff5-9e5c-0e114b1fc44a |  2023-06-13        |  TRUE              |
| { "app_info": null, ... } | f8edbf0e-1d0d-4ff5-9e5c-0e114b1fc44a |  2023-06-13        |  TRUE              |
| { "app_info": null, ... } | f8edbf0e-1d0d-4ff5-9e5c-0e114b1fc44a |  2023-06-13        |  TRUE              |
| { "app_info": null, ... } | d949ab70-6a7e-47a5-b876-d7e33d701b0d |  2023-06-14        |  FALSE             |
| { "app_info": null, ... } | d949ab70-6a7e-47a5-b876-d7e33d701b0d |  2023-06-14        |  FALSE             |
+---------------------------+--------------------------------------+--------------------+--------------------+
Copy

访问扁平化数据

对于每个包含数据的表，连接器都会创建原始数据的扁平化视图。视图的名称是表的名称加上后缀 __view。例如，对于名为 analytics_12345 的表，连接器会创建 dest_db.dest_schema.analytics_12345__view 视图。

备注

对于 ingestion_complete 为 FALSE 的行，不存在相应视图。

以下是从 dest_db.dest_schema.analytics_12345__view 视图检索数据的 SELECT 语句的输出示例。在此示例中，analytics_12345 表包含 VARIANT 列 raw，其值名为 EVENT_DATE、EVENT_TIMESTAMP、EVENT_NAME 和 EVENT_PREVIOUS_TIMESTAMP。

USE ROLE MY_ROLE;
SELECT EVENT_DATE, EVENT_TIMESTAMP, EVENT_NAME, EVENT_PREVIOUS_TIMESTAMP
FROM DEST_DB.DEST_SCHEMA.ANALYTICS_12345__VIEW LIMIT 5;

+------------+--------------------------+-------------------+--------------------------+
| EVENT_DATE | EVENT_TIMESTAMP          | EVENT_NAME        | EVENT_PREVIOUS_TIMESTAMP |
+------------+--------------------------+-------------------+--------------------------+
| 2023-06-13 | 2023-06-13 18:27:20.775  | "page_view"       | null                     |
| 2023-06-13 | 2023-06-13 18:27:25.960  | "user_engagement" | null                     |
| 2023-06-13 | 2023-06-13 19:26:49.130  | "scroll"          | null                     |
| 2023-06-13 | 2023-06-13 18:27:51.135  | "page_view"       | null                     |
| 2023-06-13 | 2023-06-13 18:27:56.343  | "user_engagement" | null                     |
+------------+--------------------------+-------------------+--------------------------+
Copy
语言: 中文