设置 Openflow Connector for Microsoft Dataverse¶

先决条件¶

1. 确保您已查看 Openflow Connector for Microsoft Dataverse。

2. Ensure that you have 设置 Openflow - BYOC or 设置 Openflow - Snowflake 部署 - 任务概述.

获取凭据¶

作为 Microsoft Dataverse 管理员，请执行以下步骤：

1. 确保您有 Dataverse 环境可供使用，并且您可以通过 https://admin.powerplatform.microsoft.com/ (https://admin.powerplatform.microsoft.com/) 访问该环境。

2. 确保您在 portal.azure.com 中采用 Microsoft Entra ID 注册了一个应用程序。该应用程序必须能够访问我们的 Dataverse 环境可用的租户。要注册应用程序，请遵循 `本指南<https://learn.microsoft.com/en-us/power-apps/developer/data-platform/walkthrough-register-app-azure-active-directory>`_。

3. 在该应用程序中生成并存储 ClientID 和客户端密钥。

4. 前往 Power Apps 管理中心，将您的 Dataverse 环境配置为可通过之前注册的应用程序进行访问。为此，请转到 Manage » Environments 并选择要配置的环境。然后转到 Settings » Users & permissions » Application users。必须添加以前创建的应用程序，并授予其从 Microsoft Dataverse 读取数据所需的权限。

5. 从 https://admin.powerplatform.microsoft.com/ (https://admin.powerplatform.microsoft.com/) 复制并保存所选 Dataverse 环境的环境 URL。

设置 Snowflake 账户¶

作为 Snowflake 账户管理员，执行以下任务：

1. 创建一个类型为 SERVICE 的 Snowflake 用户。

   创建数据库和架构来存储复制的数据，并通过授予 USAGE 和 CREATETABLE 权限，为服务用户设置在目标架构中创建表的权限。

   CREATE DATABASE <destination_database>;
   CREATE SCHEMA <destination_database>.<destination_schema>;
   CREATE USER <openflow_user> TYPE=SERVICE COMMENT='Service user for automated access of Openflow';
   CREATE ROLE <openflow_role>;
   GRANT ROLE <openflow_role> TO USER <openflow_user>;
   GRANT USAGE ON DATABASE <destination_database> TO ROLE <openflow_role>;
   GRANT USAGE ON SCHEMA <destination_database>.<destination_schema> TO ROLE <openflow_role>;
   GRANT CREATE TABLE ON SCHEMA <destination_database>.<destination_schema> TO ROLE <openflow_role>;
   CREATE WAREHOUSE <openflow_warehouse>
        WITH
            WAREHOUSE_SIZE = 'SMALL'
            AUTO_SUSPEND = 300
            AUTO_RESUME = TRUE;
   GRANT USAGE, OPERATE ON WAREHOUSE <openflow_warehouse> TO ROLE <openflow_role>;
   

   Copy

   1. 创建安全密钥对（公钥和私钥）。将用户的私钥存储在文件中，以提供给连接器的配置。将公钥分配给 Snowflake 服务用户：

      ALTER USER <openflow_user> SET RSA_PUBLIC_KEY = 'thekey';
      

      Copy

      有关更多信息，请参阅 密钥对。

2. Snowflake 强烈建议执行此步骤。配置 Openflow 支持的密钥管理器（例如 AWS、Azure 和 Hashicorp），并将公钥和私钥存储在密钥存储库中。

   备注

   如果您出于任何原因不希望使用密钥管理器，则您有责任根据组织的安全策略保护用于密钥对身份验证的公钥和私钥文件。

   1. 配置密钥管理器后，确定如何对其进行身份验证。在 AWS 中，建议您使用与 Openflow 关联的 EC2 实例角色，因为这样就无需保留其他密钥。

   2. 在 Openflow 中，从右上角的汉堡菜单中配置与此密钥管理器关联的参数提供商。导航到 Controller Settings » Parameter Provider，然后提取您的参数值。

   3. 此时，可以使用关联的参数路径引用所有凭据，无需在 Openflow 中保留敏感值。

3. 如果任何其他 Snowflake 用户需要访问连接器引入的原始文档和表（例如，在 Snowflake 中进行自定义处理），则授予这些用户在步骤 1 中创建的角色。

4. 指定一个仓库供连接器使用。将仓库的 USAGE 权限授予之前创建的角色。从最小的仓库规模开始，然后根据要复制的表数量和传输的数据量来测试规模。相较于扩大仓库规模，采用 多集群仓库 通常能更有效地应对海量表数量的扩展需求。

设置连接器¶

作为数据工程师，执行以下任务以安装和配置连接器：

运行流¶

1. 右键点击“飞机”图标并选择 Enable all Controller Services。

2. 右键点击导入的进程组并选择 Start。连接器开始数据引入。