在 複製活動 中設定 SharePoint Online 清單

本文概述如何使用數據管線中的複製活動，從 SharePoint Online 清單複製數據。

必要條件

1. SharePoint 清單線上連接器會使用服務主體驗證來連線到 SharePoint。 請遵循這些步驟進行設定：

2. 在您的 SharePoint 租使用者上，透過 PowerShell 停用 DisableCustomAppAuthentication。

   Install-Module -Name Microsoft.Online.SharePoint.PowerShell`  
   Connect-SPOService -Url https://<your-domain>-admin.sharepoint.com`  
   Set-SPOTenant -DisableCustomAppAuthentication $false`  
   Disconnect-SPOService
   

3. 向 Microsoft 身分識別平台註冊應用程式。 若要瞭解如何，請移至快速入門：向 Microsoft 身分識別平台 註冊應用程式。 請記下這些值，您用來定義連線：

   • Application ID
   • 應用程式金鑰
   • 租用戶識別碼

4. 使用下列步驟，將 SharePoint Online 網站許可權授與已註冊的應用程式。 若要授與許可權，您需要網站管理員角色。

   1. 開啟 SharePoint Online 網站連結，例如 https://[your_site_url]/_layouts/15/appinv.aspx （取代網站 URL）。

   2. 搜尋您註冊的應用程式識別碼、填入空白字段，然後選取 [ 建立]。

      • 應用程式網域：contoso.com

      • 重新導向 URL：https://www.contoso.com

      • 權限要求 XML：

        <AppPermissionRequests AllowAppOnlyPolicy="true">
            <AppPermissionRequest Scope="http://sharepoint/content/sitecollection/web" Right="Read"/>
        </AppPermissionRequests>
        

      

      注意

      在設定 SharePoint 連接器的內容中， 應用程式網域 和 重新導向 URL 是指您已在 Microsoft Entra ID 中註冊的 SharePoint 應用程式，以允許存取 SharePoint 數據。 應用程式 網域 是您 SharePoint 網站裝載所在的網域。 例如，如果您的 SharePoint 網站位於 https://contoso.sharepoint.com，則 應用程式網域 會是 contoso.sharepoint.com。 重新 導向 URL 是在使用者驗證並授與應用程式許可權之後，SharePoint 應用程式重新導向至的 URL。 此 URL 應該是您 SharePoint 網站上應用程式有權存取的頁面。 例如，您可以使用頁面的 URL 來顯示程式庫中的檔案清單，或是顯示文件內容的頁面。

   3. 選取 [信任此 應用程式]。

支援的設定

如需複製活動下每個索引標籤的設定，請分別移至下列各節。

• 一般
• 來源
• 映射
• 設定

一般

針對 [ 一般] 索引標籤組態，移至 [ 一般]。

來源

複製活動之 [來源] 索引標籤下的 SharePoint Online 清單支援下列屬性。

需要下列屬性：

• 數據存放區類型：選取 [外部]。

• 連線：從聯機清單中選取 SharePoint Online 清單連線。 如果沒有連線，請選取 [新增]，以建立新的 HTTP 連線。

• 使用查詢：選擇 [列表名稱] 或 [查詢] 作為您的使用查詢。 每個設定的組態如下：

  • 清單名稱：SharePoint Online 清單的名稱。

    

  • 查詢：OData 查詢，用來篩選 SharePoint Online 清單中的數據。 例如： "$top=1" 。

    

在 [進階] 底下，您可以指定下列欄位：

• 要求逾時：從 SharePoint Online 取得回應的等候時間。 默認值為 5 分鐘（00：05：00）。

• 其他數據行：新增其他數據行以儲存來源檔案的相對路徑或靜態值。 後者支持表達式。

  

對應

針對 [對應] 索引標籤標組態，移至 [對應] 索引卷標底下的 [設定對應]。

設定

如需 設定 索引標籤組態，請移至 [設定] 索引標籤底下的 [設定其他設定]。

數據表摘要

下表包含 SharePoint Online 清單中複製活動的詳細資訊。

來源

名稱	描述:	值	必要	JSON 腳本屬性
數據存放區類型	您的資料存放區類型。	外部	Yes	/
[連接]	您與源資料存放區的連線。	<您的連線>	Yes	connection
使用查詢	您可以選擇 [列表名稱] 或 [查詢] 作為您的使用查詢。	-清單名稱 -查詢	No	type
清單名稱	SharePoint Online 列表的名稱。	<您的連線>	Yes	listName
要求逾時	從 SharePoint Online 取得回應的等候時間。 默認值為 5 分鐘（00：05：00）。	時間範圍	No	requestTimeout
其他數據行	新增其他數據行以儲存來源檔案的相對路徑或靜態值。 後者支持表達式。	•名字 •價值	No	additionalColumns： •名字 •價值

相關內容

• 設定 SharePoint Online 列表連線