设置 Snowflake Connector for SharePoint

备注

Snowflake Connector for SharePoint 受 Connector 条款 的约束。

本主题介绍设置 Snowflake Connector for SharePoint 的步骤。

先决条件

在开始安装和配置连接器之前，您必须执行以下操作：

  1. 确保 `Microsoft Graph<https://learn.microsoft.com/en-us/graph/overview>`_ 应用程序具有以下权限：

    • Sites.Selected (https://learn.microsoft.com/en-us/graph/permissions-reference#sitesselected)：仅限访问指定的站点。

    • Files.SelectedOperations.Selected (https://learn.microsoft.com/en-us/graph/permissions-reference#filesselectedoperationsselected)：仅限访问指定站点中的文件。

    • GroupMember.Read.All (https://learn.microsoft.com/en-us/graph/permissions-reference#groupmemberreadall)：用于解析 SharePoint 组权限。

  2. 按照 获取无用户访问权限 (https://learn.microsoft.com/en-us/graph/auth-v2-service?tabs=http#authentication-and-authorization-steps) 中的说明配置 SharePoint 以启用 OAuth 身份验证。连接器使用以下 Microsoft Graph APIs 从 SharePoint 获取数据：

    • 下载 driveItem 内容 (https://learn.microsoft.com/en-us/graph/api/driveitem-get-content?view=graph-rest-1.0&tabs=http)

    • driveItem: delta (https://learn.microsoft.com/en-us/graph/api/driveitem-delta?view=graph-rest-1.0&tabs=http)

    • 列出有权访问文件的人员 (https://learn.microsoft.com/en-us/graph/api/driveitem-list-permissions?view=graph-rest-1.0&tabs=http)

    • group: delta (https://learn.microsoft.com/en-us/graph/api/group-delta?view=graph-rest-1.0&tabs=http)

    • 列出组成员 (https://learn.microsoft.com/en-us/graph/api/group-list-members?view=graph-rest-1.0&tabs=http)

  3. 从您的 Azure 或 Office 365 账户管理员处获取您的 Microsoft 365 SharePoint 站点的站点 URL（其中包含您要引入到 Snowflake 中的文件或文件夹）和凭据。

安装 Snowflake Connector for SharePoint

连接器是 Snowflake 本地应用程序的实例。要安装 Snowflake Connector for SharePoint，请执行以下操作：

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

  2. 导航到 Data Products » Marketplace。

  3. 搜索 Snowflake Connector for SharePoint 并选择 Get。

  4. 在对话框中，展开 Options 并输入以下信息：

    • 在 Application name 中，输入连接器应用程序的名称。

    • 在 Warehouse used for installation 中，选择用于安装连接器的仓库。

      备注

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

  5. 选择 Get 开始安装过程。这可能需要几分钟才能完成。

  6. 连接器安装成功后，选择 Configure 继续 配置，或选择 Done 关闭对话框并完成安装。

可选：安装 Snowflake Connector for SharePoint 的多个实例

您可以在 Snowflake 账户上安装多个 Snowflake Connector for SharePoint 实例。要安装额外实例，请执行以下操作：

  1. 导航至 Snowflake Marketplace 并选择 Snowflake Connector for SharePoint。此时将显示应用程序详细信息页面。

  2. 点击 Add instance。出现安装对话框。

  3. 提供实例名称并选择要在安装期间使用的仓库。

  4. 选择 Get 开始安装过程。

备注

  • 添加连接器实例可能需要几分钟时间。安装过程完成后，您会收到一封电子邮件通知。

  • 为了避免引入的数据损坏，在配置连接器期间，请始终使用与所有其他原生应用程序不同的数据库架构。

配置 Snowflake Connector for SharePoint

必须配置每个连接器应用程序实例，以便与其关联的 Sharepoint 实例通信。完成 安装过程 后，请执行以下步骤。

  1. 确保完成所有先决条件。 有关更多信息，请参阅 先决条件。

  2. 如有需要，按如下步骤打开配置向导：

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

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

    3. 搜索 Snowflake Connector for SharePoint 并选择它。

配置

  1. 在向导的 Configure 步骤中，在以下字段中输入信息：

备注

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

字段

描述

Warehouse for Ingestion Data

连接器的新的专用虚拟仓库的标识符。此仓库用于计算数据引入和文档处理任务。

为您的账户指定一个唯一的名称。仓库的名称必须是有效的 对象标识符。

或者，您可以选择现有仓库。

备注

不要指定在最初创建连接器时使用的仓库。

Warehouse for Cortex Search：

新的专用 Cortex Search 虚拟仓库的标识符。该仓库用于处理和提供 Cortex Search 查询。

为您的账户指定一个唯一的名称。仓库的名称必须是有效的 对象标识符。

备注

请勿指定您在连接器安装开始时选择的同一仓库。配置过程创建一个具有指定名称的新“X-小”仓库。

Role for Cortex Search

连接器的新自定义角色的标识符。为您的账户指定一个唯一的名称。角色的名称必须是有效的 对象标识符。

授予该角色的用户可使用自己的账户查询 Cortex REST API，查看由应用程序引入的数据。默认情况下，只有您用于安装连接器的账户有权限查询 Cortex。

  1. 点击 Configure 继续。

进行身份验证并连接到 Sharepoint

重要

确保浏览器已启用弹出窗口。

  1. 在向导的 Authentication 步骤中，输入以下信息和凭据，以完成 OAuth2 身份验证并连接到 SharePoint。

    请联系您的 Azure 或 Office 365 账户管理员以获取这些信息。

    字段

    描述

    SharePoint site URL

    连接器将从中获取内容的 URL 或 Sharepoint 站点。

    对于顶级站点，仅使用域名，例如：sitename.sharepoint.com。对于子站点，使用带有站点路径的域名，例如：sitename.sharepoint.com/sites/SubSite。

    Client ID

    输入您的客户端 ID。要了解客户端 ID 以及如何在 Microsoft Entra 中找到它，请参阅 `应用程序 ID（客户端 ID）<https://learn.microsoft.com/en-us/azure/healthcare-apis/register-application#application-id-client-id>`_。

    Client secret

    输入客户端密钥。要了解客户端密钥以及如何在 Microsoft Entra 中找到它，请参阅 证书与密钥 (https://learn.microsoft.com/en-us/azure/healthcare-apis/register-application#certificates--secrets)。

    Tenant ID

    输入您的租户 ID。要了解租户 ID 以及如何在 Microsoft Entra 中找到它，请参阅 查找您的 Microsoft 365 租户ID (https://learn.microsoft.com/en-us/sharepoint/find-your-office-365-tenant-id)。

  2. 点击 Next 开始连接过程，该过程可能需要几分钟才能完成。

验证来源

在向导的 Validate source 步骤中，执行以下操作：

  1. 选择要获取文件的来源：

    • 如果要从通过 进行身份验证并连接到 Sharepoint 中提供的凭据可访问的所有文件夹中获取文件，请选择 All folders。

    • 如果要从通过 进行身份验证并连接到 Sharepoint 中提供的凭据可访问的特定文件夹中获取文件，请选择 Specific folder。

      备注

      此路径是共享文档文件夹的相对路径。例如，要从 Shared%20Documents/user_manuals/cars 文件夹引入文件，请输入 user_manuals/cars。

    备注

    以后要更改获取文件源，必须重新安装连接器。

  2. 点击 Validate 开始验证来源的过程，这可能需要几分钟时间。

  3. 连接器配置成功后，点击 Ingest files 开始数据引入。

后续步骤

设置好连接器后，请继续执行 使用|SharePoint| 查询 Cortex Search 服务。

语言: 中文