共用方式為


設定複製活動中的 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 (取代網站網址)。

    2. 搜尋您註冊的應用程式 ID、填入空白欄位,然後選取 [建立]

      • 應用程式網域:contoso.com

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

      • 權限要求 XML:

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

      螢幕擷取畫面,其中顯示了要求 XML。

      注意

      在設定 SharePoint 連接器的內容中,應用程式網域重新導向 URL 是指您已在 Microsoft Entra ID 中註冊以允許存取 SharePoint 資料的 SharePoint 應用程式。 應用程式網域是您 SharePoint 網站託管所在的網域。 例如,如果您的 SharePoint 網站位於 https://contoso.sharepoint.com,則應用程式網域會是 contoso.sharepoint.com重新導向 URL 是 SharePoint 應用程式在使用者驗證並授與權限給應用程式之後,會重新導向的目標網址。 此 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:
• 名稱
• 值