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 儲存器帳戶。
確認您想要編製索引的 .csv 檔案已上傳至 SharePoint 文檔庫。 您可以使用現有的 SharePoint 網站或建立新的網站。
移至 Azure 入口網站,並使用租用戶的系統管理員認證登入。
從瀏覽窗格流覽至 [Microsoft Entra ID ->Manage ->應用程式註冊],然後選取 [新增註冊]。
提供應用程式的名稱,然後選取 [ 註冊]。
記下應用程式 (用戶端) 識別碼。
從瀏覽窗格開啟 API 許可權,然後選取 [ 新增許可權]。
選取 [SharePoint ],然後選 取 [委派的許可權]。
搜尋下列許可權,然後選取 [新增許可權]。
a. AllSites.Read
b. User.Read.All選 取 [TenantName] 的 [授與系統管理員同意] ,然後選取 [ 是] 來確認。
檢查許可權是否處於「已授與」狀態。
從瀏覽窗格開啟 [驗證 ],然後在 [重新導向 URI] 底下新增下列 (授權回呼 URI) :
- 針對 M365 企業版:
https://gcs.office.com/v1.0/admin/oauth/callback](https://gcs.office.com/v1.0/admin/oauth/callback
- 針對 M365 Government:
https://gcsgcc.office.com/v1.0/admin/oauth/callback](https://gcsgcc.office.com/v1.0/admin/oauth/callback
- 針對 M365 企業版:
移至 Azure 入口網站,並使用租用戶的系統管理員認證登入。
從瀏覽窗格開啟 [應用程式註冊 ],然後移至適當的應用程式。 在 [ 管理] 底下,選 取 [憑證和秘密]。
選 取 [新增客戶端密碼 ],然後選取秘密的到期期間。 複製產生的秘密並儲存它,因為它不會再次顯示。
使用此客戶端密碼和應用程式識別碼來設定連接器。
- 移至
https://Org-Name.sharepoint.com/sites/mysite/_layouts/15/appregnew.aspx
。 - 在 [用戶端識別符] 和 [客戶端密碼] 字段上,選取 [ 產生]。
- 針對 [標題],輸入應用程式名稱。
- 在[應用程式域] 欄位中,輸入
www.gcs.com
。 - 在 [重新導向 URL] 欄位中, 輸入
https://www.gcs.com
。 - 選取 [建立]。
- 複製應用程式設定資訊,包括用戶端識別碼和客戶端密碼。 當您設定 CSV 連接器時,將會需要它。
在 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
。
- 移至
https://Org-Name.sharepoint.com/sites/mysite/_layouts/15/appinv.aspx
。 - 在 [應用程式標識符] 字段中,貼上 SharePoint 應用程式的用戶端識別碼,然後選取 [查閱]。
- 在 [要求 XML 許可權] 字段中,貼上此程式代碼,然後選取 [ 建立]。
<AppPermissionRequests AllowAppOnlyPolicy="true">
<AppPermissionRequest Scope="http://sharepoint/content/sitecollection/web" Right="Read" />
</AppPermissionRequests>
- 選取 [信任]。
如需逐步指引,請參閱 建立記憶體帳戶。 若要允許檔案儲存功能,請在 [進階] 索引標籤上,選取 [ 啟用階層命名空間 ] 和 [建立此網站的容器]。
當您設定 CSV Microsoft Graph 連接器時,您必須提供主要記憶體 連接字串。 若要尋找它,請開啟您建立的記憶體帳戶,然後選 取 [存取密鑰]。 選取 [顯示金鑰],然後複製 Key1 的 連接字串。
請遵循一般 設定指示。
請遵循一般 設定指示。
SharePoint 和 ADLS 的數據源設定不同。
注意
請確定您的 csv 檔案沒有任何格式或空格 (『) 出現在標頭數據列中。
在 [數據源設定] 中,選取 [SharePoint ] 作為您的數據源。
例如,在 SharePoint 網站中,輸入網站 URL
https://Org-Name.sharepoint.com/Site-Name
。在 文檔庫中,輸入儲存 .csv 檔案的文件庫名稱。
在 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 使用者或群組。
- 在 [數據源] 設定中,選取 [Azure Data Lake Storage (ADLS) 作為您的數據源。
- 在 [主要記憶體 連接字串] 中,輸入您複製的 連接字串。
- 輸入 [容器名稱 ] 和 [檔案名]。
- 選 取 [測試連線]。 您應該會收到 連線成功 訊息。
注意
如果您的數據源包含多個具有相同標頭的 .csv 檔案,請選取 [ 在位置包含所有 CSV 檔案]。
若要控制檔案層級的存取權,請輸入 Microsoft Entra 使用者或群組。
如果您的源數據行可以接受多個值,請輸入多專案分隔符、分號 (;例如 ) 。
此頁面會將您 .csv 檔案中的第一個數據列傳回為來源屬性。 若要修改資料類型,請在 [ 唯一標識符 ] 列表中選取至少一個選項。
若要控制專案層級的存取權,請選取對應至允許使用者和允許群組的數據行。 您應該在 .csv 檔案中包含兩個數據行 AllowedUsers 和 AllowedGroups。 每個數據列都應該包含 Microsoft Entra 識別碼。
注意
CSV Microsoft Graph 連接器支援檔案或專案層級訪問控制。 如果兩者都已啟用,則只會套用檔案層級訪問控制。
請遵循一般 設定指示。
注意
IconURL 標籤預設會填入,且無法變更對應。
請遵循一般 設定指示。
- 針對檔案或專案層級訪問控制,選取 [僅限具有此數據源存取權的人員]。
- 選取 [所有人 ] 可讓組織中的每個人查看此數據源的搜尋結果。
請遵循一般 設定指示。
請遵循一般 設定指示。
以下是 CSV Microsoft Graph 連接器的已知限制:
- 目前不支援配置檔擴充案例。
發佈連線之後,您可以在系統管理中心的 [數據源] 索引卷標下檢閱狀態。 若要瞭解如何進行更新和刪除,請參閱 管理您的連接器。
您可以 在這裡找到常見問題的疑難解答步驟。
如果您有問題或想要提供意見反應,請連絡 [Microsoft Graph |支援 (https://developer.microsoft.com/en-us/graph/support).