CSV Microsoft Graph 連接器

CSV Microsoft Graph 連接器可讓您的組織從儲存在 SharePoint 文件庫中的 CSV 檔案擷取內容,並 Azure Data Lake Storage (ADLS) 。 設定連接器並從這些來源編製內容索引之後,終端使用者就可以在搜尋和 Microsoft 365 Copilot Microsoft中找到 CSV 檔案。

本文適用於設定、執行及監視 CSV Microsoft Graph 連接器的任何人。 它會補充一般設定程式,並顯示僅適用於此連接器的指示。

開始之前

  • 確定 CSV 標頭中沒有空格符

  • 針對 SharePoint 數據源,您可以使用兩個 OAuth 提供者的其中一個進行驗證:即將) Microsoft Entra ID (,或 (即將淘汰的 SharePoint 提供者) 。

    • 若要使用 Microsoft Entra ID 進行驗證,您必須在 Microsoft Entra ID 上建立並註冊應用程式。
    • 若要使用 SharePoint 提供者進行驗證,您必須使用 OAuth 組態建立 SharePoint 應用程式。

提示

一旦可用,您就可以將已發佈連線的 OAuth 提供者從 SharePoint 切換至 Microsoft Entra ID

  • 針對 ADLS 數據源,您必須建立 ADLS 儲存器帳戶。

SharePoint 資料來源

上傳 CSV 檔案

確認您想要編製索引的 .csv 檔案已上傳至 SharePoint 文檔庫。 您可以使用現有的 SharePoint 網站或建立新的網站。

在 Microsoft Entra ID 上建立應用程式

  1. 移至 Azure 入口網站,並使用租用戶的系統管理員認證登入。

  2. 從瀏覽窗格流覽至 [Microsoft Entra ID ->Manage ->應用程式註冊],然後選取 [新增註冊]

  3. 提供應用程式的名稱,然後選取 [ 註冊]

  4. 記下應用程式 (用戶端) 識別碼。

  5. 從瀏覽窗格開啟 API 許可權,然後選取 [ 新增許可權]

  6. 選取 [SharePoint ],然後選 取 [委派的許可權]

  7. 搜尋下列許可權,然後選取 [新增許可權]
    a. AllSites.Read
    b. User.Read.All

  8. 取 [TenantName] 的 [授與系統管理員同意] ,然後選取 [ 是] 來確認。

  9. 檢查許可權是否處於「已授與」狀態。

  10. 從瀏覽窗格開啟 [驗證 ],然後在 [重新導向 URI] 底下新增下列 (授權回呼 URI) :

    • 針對 M365 企業版https://gcs.office.com/v1.0/admin/oauth/callback](https://gcs.office.com/v1.0/admin/oauth/callback
    • 針對 M365 Governmenthttps://gcsgcc.office.com/v1.0/admin/oauth/callback](https://gcsgcc.office.com/v1.0/admin/oauth/callback

設定客戶端密碼以進行驗證

  1. 移至 Azure 入口網站,並使用租用戶的系統管理員認證登入。

  2. 從瀏覽窗格開啟 [應用程式註冊 ],然後移至適當的應用程式。 在 [ 管理] 底下,選 取 [憑證和秘密]

  3. 取 [新增客戶端密碼 ],然後選取秘密的到期期間。 複製產生的秘密並儲存它,因為它不會再次顯示。

  4. 使用此客戶端密碼和應用程式識別碼來設定連接器。

使用 OAuth 設定建立 SharePoint 應用程式

  1. 移至https://Org-Name.sharepoint.com/sites/mysite/_layouts/15/appregnew.aspx
  2. 在 [用戶端識別符] 和 [客戶端密碼] 字段上,選取 [ 產生]
  3. 針對 [標題],輸入應用程式名稱。
  4. 在[應用程式域] 欄位中,輸入 www.gcs.com
  5. 在 [重新導向 URL] 欄位中, 輸入 https://www.gcs.com
  6. 選取 [建立]
  7. 複製應用程式設定資訊,包括用戶端識別碼和客戶端密碼。 當您設定 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. 在 [應用程式標識符] 字段中,貼上 SharePoint 應用程式的用戶端識別碼,然後選取 [查閱]
  3. 在 [要求 XML 許可權] 字段中,貼上此程式代碼,然後選取 [ 建立]
<AppPermissionRequests AllowAppOnlyPolicy="true">
    <AppPermissionRequest Scope="http://sharepoint/content/sitecollection/web" Right="Read" />
</AppPermissionRequests>
  1. 選取 [信任]

ADLS 數據源

建立 ADLS 記憶體帳戶

如需逐步指引,請參閱 建立記憶體帳戶。 若要允許檔案儲存功能,請在 [進階] 索引標籤上,選取 [ 啟用階層命名空間 ] 和 [建立此網站的容器]

當您設定 CSV Microsoft Graph 連接器時,您必須提供主要記憶體 連接字串。 若要尋找它,請開啟您建立的記憶體帳戶,然後選 取 [存取密鑰]。 選取 [顯示金鑰],然後複製 Key1 的 連接字串。

步驟 1:在 Microsoft 365 系統管理中心 中新增 Microsoft Graph 連接器

新增 CSV Microsoft Graph 連接器

請遵循一般 設定指示

步驟 2:命名連線

請遵循一般 設定指示

步驟 3:設定連線設定

SharePoint 和 ADLS 的數據源設定不同。

注意

請確定您的 csv 檔案沒有任何格式或空格 (『) 出現在標頭數據列中。

針對 SharePoint 來源

  1. 在 [數據源設定] 中,選取 [SharePoint ] 作為您的數據源。

  2. 例如,在 SharePoint 網站中,輸入網站 URL https://Org-Name.sharepoint.com/Site-Name

  3. 文檔庫中,輸入儲存 .csv 檔案的文件庫名稱。

  4. OAuth 提供者中,您可以選取 [SharePoint 提供者 (即將淘汰) Microsoft Entra ID

    a. 針對即將推出的 Microsoft Entra ID ()
    1. 驗證類型,選 取 [Oauth2.0] (授權碼)
    2.輸入您在建立 Microsoft Entra ID 應用程式時複製的用戶端識別碼和客戶端密碼。
    3.選取 [登入]。 您應該會收到 連線成功 訊息。

    b. 針對 SharePoint 提供者, (即將淘汰)
    1.在 [驗證類型] 中,選 取 [Oauth2.0] (客戶端認證)
    2.輸入您在建立 SharePoint 應用程式時複製的用戶端識別碼和客戶端密碼。
    3.選取 [測試連線]。 您應該會收到 連線成功 訊息。

若要控制檔案層級的存取權,請輸入 Microsoft Entra 使用者或群組。

包含使用者和群組的訪問控制清單。

針對 ADLS 來源

  1. 在 [數據源] 設定中,選取 [Azure Data Lake Storage (ADLS) 作為您的數據源。
  2. [主要記憶體 連接字串] 中,輸入您複製的 連接字串。
  3. 輸入 [容器名稱 ] 和 [檔案名]
  4. 取 [測試連線]。 您應該會收到 連線成功 訊息。

具有 Azure Data Lake Storage 來源之數據源設定的 CSV 連接器。

注意

如果您的數據源包含多個具有相同標頭的 .csv 檔案,請選取 [ 在位置包含所有 CSV 檔案]

若要控制檔案層級的存取權,請輸入 Microsoft Entra 使用者或群組。

包含使用者和群組的訪問控制清單。

步驟 4:多專案分隔符 (選擇性)

如果您的源數據行可以接受多個值,請輸入多專案分隔符、分號 (;例如 ) 。

步驟 5:剖析的屬性設定

此頁面會將您 .csv 檔案中的第一個數據列傳回為來源屬性。 若要修改資料類型,請在 [ 唯一標識符 ] 列表中選取至少一個選項。

若要控制專案層級的存取權,請選取對應至允許使用者和允許群組的數據行。 您應該在 .csv 檔案中包含兩個數據行 AllowedUsers 和 AllowedGroups。 每個數據列都應該包含 Microsoft Entra 識別碼。

專案層級訪問控制設定。

注意

CSV Microsoft Graph 連接器支援檔案或專案層級訪問控制。 如果兩者都已啟用,則只會套用檔案層級訪問控制。

步驟 6:指派屬性標籤

請遵循一般 設定指示

注意

IconURL 標籤預設會填入,且無法變更對應。

步驟 7:管理架構

請遵循一般 設定指示

步驟 8:管理搜尋許可權

  • 針對檔案或專案層級訪問控制,選取 [僅限具有此數據源存取權的人員]
  • 選取 [所有人 ] 可讓組織中的每個人查看此數據源的搜尋結果。

只有已選取此數據源存取權的人員可以進行搜尋許可權設定。

步驟 9:選擇重新整理設定

請遵循一般 設定指示

步驟 10:檢閱連線

請遵循一般 設定指示

限制

以下是 CSV Microsoft Graph 連接器的已知限制:

  • 目前不支援配置檔擴充案例。

疑難排解

發佈連線之後,您可以在系統管理中心的 [數據源] 索引卷標下檢閱狀態。 若要瞭解如何進行更新和刪除,請參閱 管理您的連接器

您可以 在這裡找到常見問題的疑難解答步驟。

如果您有問題或想要提供意見反應,請連絡 [Microsoft Graph |支援 (https://developer.microsoft.com/en-us/graph/support).