安装并配置 Snowflake Connector for Google Analytics Aggregate Data¶

安装 Snowflake Connector for Google Analytics Aggregate Data¶

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

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

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

4. 在 Snowflake Connector for Google Analytics Aggregate Data 页面上，选择 Get。

   系统将显示一个对话框。

5. 在 Options 下，对于 Application name，输入要用于连接器实例的数据库的名称。

   该数据库是自动为您创建的。

6. 对于 Warehouse used for installation，选择用于安装连接器的仓库。

   备注

   此仓库与连接器用于同步来自 Google Analytics 的数据的仓库不同。在后续过程中，您将为此目的创建一个单独的仓库。

配置 Snowflake Connector for Google Analytics Aggregate Data¶

1. 以具有 ACCOUNTADMIN 角色或任何其他符合以下要求的角色的用户身份登录 Snowsight：

   • 您必须具有以下账户级别权限：

     • 具有授权选项的 EXECUTE TASK

     • 具有授权选项的 EXECUTE MANAGED TASK

   • 必须在账户上启用 EVENT_TABLE。

   • 要访问仓库，您必须至少具有以下权限之一：

     • 账户的 CREATE WAREHOUSE 权限

     • 对仓库的 OWNERSHIP 权限

     • 对仓库的 USAGE 权限（具有授权选项）

   • 要访问数据库，您必须至少具有以下权限之一：

     • 账户的 CREATE DATABASE 权限

     • 对数据库的 OWNERSHIP 权限

     • 对数据库的 USAGE 权限（具有授权选项）

   • 要访问架构，您必须至少具有以下权限之一：

     • 账户的 CREATE DATABASE 权限

     • 对数据库的 OWNERSHIP 权限

     • 对数据库的 USAGE 权限（具有授权选项）

     • 对数据库的 CREATE SCHEMA 权限

     • 对架构的 USAGE、CREATE TABLE、CREATE VIEW 权限（具有授权选项）

   • 可选：要访问角色，您可以创建新的角色或选择将被分配 DATA_READER 应用程序角色的现有角色。如果您想创建一个新角色，那么需要账户的 CREATE ROLE 权限。但是，这不是完成配置所必需的。

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

3. 选择 Snowflake Connector for Google Analytics Aggregate Data。

   配置向导启动。

4. 确保满足列表中的所有先决条件，并将其标记为已完成。

5. 点击 Start configuration。

6. 填充以下字段：

   备注

   默认情况下，这些字段设置为配置连接器时创建的对象的名称。Snowflake 建议对这些字段使用新对象。但是，您可以指定现有对象的名称（例如，如果要重新安装连接器）。

   字段	描述
   Warehouse	输入连接器的新专用虚拟仓库的标识符。 为您的账户指定一个唯一的名称。仓库的名称必须是有效的 对象标识符。 配置过程创建一个具有指定名称的新 X-Small 仓库。
   Destination Database	输入新数据库的标识符，该数据库包含 Snowflake 中 Google Analytics 数据的架构和表。从 Google Analytics 下载的数据将存储在此处。 为您的账户指定一个唯一的名称。数据库名称必须是有效的 对象标识符。 配置过程会创建一个具有指定名称的新数据库。
   Destination Schema	输入新架构的标识符，该架构将包含 Snowflake 中的 Google Analytics 数据。 Snowflake Connector for Google Analytics Aggregate Data 将 Google Analytics 数据引入此架构的表中。 架构名称必须是有效的 对象标识符。 配置过程会创建具有指定名称的新架构。
   Role	输入连接器的新自定义角色的标识符。 此角色被授予对包含连接器引入的 Google Analytics 数据的表和视图的读取权限。 角色的名称必须是有效的 对象标识符。 配置过程会创建具有指定名称的新角色。

7. 在屏幕底部选择 Configure。

   配置过程可能需要几分钟时间。完成后，向导将前进到 Authentication。

8. 要指定身份验证，请按照以下选项之一操作：

   备注

   Snowflake Connector for Google Analytics Aggregate Data 支持在 Google Analytics 中使用两种身份验证方法：服务账户 和 OAuth2。每种方法都需要在 Google Cloud 项目中进行额外配置。有关更多信息，请参阅 和 为 Google Cloud 配置 OAuth 身份验证。

   • 对于 服务账户，请填充以下字段：

   字段	描述
   Client email	在 Google Cloud 项目中创建服务账户期间生成的 Google 服务账户电子邮件
   Private key	在 Google Cloud 项目中创建服务账户期间生成的私钥 确保移除 -----BEGIN PRIVATE KEY-----、-----END PRIVATE KEY----- 和 \n 符号。# 编译说明：将密钥列入允许列表

   • 对于 Oauth2，填充以下字段：

   字段	描述
   Client id	在 Google Cloud 项目中生成的客户端 ID
   Client secret	为客户端 ID 生成的客户端密钥

   如果您不是以具有 ACCOUNTADMIN 角色的用户身份登录，请确保您满足以下要求：

   • 您必须拥有 CREATE INTEGRATION 权限。

   • 如果集成以前是由其他角色创建的，那么这些集成的所有权必须转移给您的角色。

   • 如果 CONNECTORS_SECRET 数据库不存在，则您需要 CREATE DATABASE 权限。

   • 如果 CONNECTORS_SECRET 数据库存在，但由其他角色创建，则您需要以下权限：

     • USAGE WITH GRANT OPTION

     • CREATE SCHEMA WITH GRANT OPTION

   • 如果 CONNECTORS_SECRET.APP_NAME 架构存在，但由其他角色创建，则您需要以下权限：

     • USAGE WITH GRANT OPTION

     • CREATE SECRET

     • CREATE NETWORK RULE

   • 如果 CONNECTORS_SECRET.APP_NAME.SECRET 存在，但由其他角色创建，则需要将其所有权转移到您的角色。

   • 如果 CONNECTORS_SECRET.APP_NAME.NETWORK_RULE 存在，但由其他角色创建，则需要将其所有权转移到您的角色。

9. 选择 Connect。

   如果选择了 Oauth2 身份验证，则将打开 Google OAuth 身份验证对话框。

10. 可选：完成 Google OAuth 身份验证对话框。

    成功连接后，连接器将验证其是否可以访问 Google Analytics 数据。如果有任何错误，我们将为您提供其他说明。

成功完成该过程后，可以开始引入配置。有关更多信息，请参阅 为 Snowflake Connector for Google Analytics Aggregate Data 实例设置数据引入。