通过

CSV 连接器

  • 项目

CSV Graph 连接器允许组织从 SharePoint 库中存储的 CSV 文件引入内容，并Azure Data Lake Storage (ADLS) 。 配置连接器并索引来自这些源的内容后，最终用户可以在 Microsoft 搜索中找到 CSV 文件。

注意

阅读 Graph 连接器的安装程序 一文，了解一般 Graph 连接器设置说明。

本文适用于配置、运行和监视 CSV 连接器的任何人。 它补充了常规设置过程，并显示仅适用于此连接器的说明。

开始之前

确保 CSV 标头中没有空格。 对于 SharePoint 数据源，你需要使用 Oauth 配置创建 SharePoint 应用。 对于 ADLS 数据源，需要创建 ADLS 存储帐户。

使用 Oauth 配置创建 SharePoint 应用

验证要编制索引的 .csv 文件是否已上传到 SharePoint 文档库。 可以使用现有 SharePoint 网站或创建一个新网站。

创建 SharePoint 应用

  1. 转到 https://Org-Name.sharepoint.com/sites/mysite/_layouts/15/appregnew.aspx。
  2. 在“客户端 ID”和“客户端密码”字段中，选择“ 生成”。
  3. 对于“标题”，请输入应用名称。
  4. 在“应用域”字段中，输入 www.gcs.com。
  5. 在“重定向 URL”字段中，输入 https://www.gcs.com。
  6. 选择“创建”。
  7. 复制应用配置信息，包括客户端 ID 和客户端密码。 设置 CSV 连接器时需要它。

启用应用权限以允许 CustomAppAuthentication

在 PowerShell (SharePoint Online 命令行管理程序) 中，在管理模式下运行这些命令。 使用配置连接器的管理员的电子邮件地址和组织名称。 出现密码弹出窗口时，管理员应输入其密码。

Install-Module -Name Microsoft.Online.SharePoint.PowerShell
$adminUPN=”<admin@contoso.onmicrosoft.com>”
$orgName=“<contoso>”
$userCredential = Get-Credential -UserName $adminUPN -Message "Enter your password."
Connect-SPOService -Url https://$orgName-admin.sharepoint.com -Credential $userCredential
Set-spotenant –DisableCustomAppAuthentication $false

注意

如果使用的是 PowerShell 7，请先使用此命令 Import-Module microsoft.online.sharepoint.powershell -UseWindowsPowerShell

注意

如果使用多重身份验证，请使用 Connect-SPOService -Url https://$orgName-admin.sharepoint.com。

完成应用配置

  1. 转到 https://Org-Name.sharepoint.com/sites/mysite/_layouts/15/appinv.aspx。
  2. 在“应用 ID”字段中，粘贴 SharePoint 应用的“客户端 ID”，然后选择“ 查找”。
  3. 在“权限请求 XML”字段中，粘贴此代码并选择“ 创建”。
<AppPermissionRequests AllowAppOnlyPolicy="true">
    <AppPermissionRequest Scope="http://sharepoint/content/sitecollection/web" Right="Read" />
</AppPermissionRequests>
  1. 选择“信任它”。

创建 ADLS 存储帐户

有关分步指南，请参阅 创建存储帐户。 若要允许文件存储功能，请在“高级”选项卡上，选择“启用分层命名空间”和“为此站点创建容器”。

设置 CSV 连接器时，需要提供主存储连接字符串。 若要找到它，请打开创建的存储帐户，然后选择“ 访问密钥”。 选择“显示密钥”，并复制 Key1 的连接字符串。

步骤 1：在Microsoft 365 管理中心中添加 Graph 连接器

添加 CSV 连接器

按照常规 设置说明进行操作。

步骤 2：选择体验

目前，CSV 连接器仅支持搜索体验。

已选择 Microsoft 搜索体验的 CSV 连接器。

步骤 3：命名连接

按照常规 设置说明进行操作。

步骤 4：配置连接设置

SharePoint 和 ADLS 的数据源设置不同。

注意

确保 csv 文件没有任何格式或空格 (“) 出现在标题行中。

对于 SharePoint 源

  1. 在“数据源设置”中，选择“ SharePoint ”作为数据源。
  2. 在 SharePoint 网站中，输入网站 URL， https://Org-Name.sharepoint.com/Site-Name例如。
  3. 在 “文档库”中，输入存储 .csv 文件的库的名称。
  4. 在 “身份验证类型”中，选择“ Oauth2.0 (客户端凭据”) 。
  5. 输入在创建 SharePoint 应用程序时复制的客户端 ID 和客户端密码。
  6. 选择“ 测试连接”。 应会收到 “连接成功” 消息。

包含 SharePoint 网站的数据源设置的 CSV 连接器。

若要在文件级别控制访问权限，请输入Microsoft Entra用户或组。

包含用户和组的访问控制列表。

对于 ADLS 源

  1. 在“数据源设置”中，选择“Azure Data Lake Storage (ADLS) ”作为数据源。
  2. 在“主存储连接字符串”中，输入复制连接字符串。
  3. 输入“容器名称”和“文件名”。
  4. 选择“ 测试连接”。 应会收到 “连接成功” 消息。

具有Azure Data Lake Storage源的数据源设置的 CSV 连接器。

注意

如果数据源包含多个具有相同标头的 .csv 文件，请选择“ 在位置包含所有 CSV 文件”。

若要在文件级别控制访问权限，请输入Microsoft Entra用户或组。

包含用户和组的访问控制列表。

步骤 5：多项目分隔符 (可选)

如果源列可以采用多个值，请输入多项目分隔符、分号 (;例如 ) 。

步骤 6：分析的属性设置

此页将 .csv 文件中的第一行作为“源属性”返回。 若要修改数据类型，请在 “唯一标识符” 列表中选择至少一个选项。

若要在项级别控制访问权限，请选择映射到“允许的用户”和“允许的组”的列。 应在 .csv 文件中包含两列，即 AllowedUsers 和 AllowedGroups。 每行应包含Microsoft Entra ID。

项级访问控制设置。

注意

CSV 连接器支持文件级或项级访问控制。 如果两者都已启用，则仅应用文件级访问控制。

步骤 7：分配属性标签

按照常规 设置说明进行操作。

注意

IconURL 标签默认填充，无法更改映射。

步骤 8：管理架构

按照常规 设置说明进行操作。

步骤 9：管理搜索权限

  • 对于文件或项级访问控制，请选择“ 仅有权访问此数据源的人员”。
  • 选择“ 所有人 ”可让组织中的每个人查看来自此数据源的搜索结果。

仅选中有权访问此数据源的人员的搜索权限设置。

步骤 10：选择刷新设置

按照常规 设置说明进行操作。

步骤 11：查看连接

按照常规 设置说明进行操作。

限制

以下是 CSV 连接器的已知限制：

  • 目前不支持配置文件扩充方案。