Condividi tramite

Configurare l'elenco di SharePoint Online in un'attività Copy

  • Articolo

Questo articolo descrive come usare l'attività Copia in Azure Data Factory per copiare i dati da un elenco di SharePoint Online.

Prerequisiti

  1. Il connettore Elenco di SharePoint Online usa l'autenticazione basata su entità servizio per connettersi a SharePoint. Seguire questi passaggi per configurarlo:

  2. Nel tenant di SharePoint disabilitare DisableCustomAppAuthentication tramite PowerShell.

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

  3. Registrare un'applicazione con Microsoft Identity Platform. Per informazioni sulla procedura, vedere Guida introduttiva: Registrare un'applicazione con Microsoft Identity Platform. Prendere nota di questi valori che si usano per definire il collegamento:

    • ID applicazione
    • Chiave applicazione
    • ID tenant

  4. Procedere come indicato di seguito per concedere l'autorizzazione a livello di sito SharePoint Online all'applicazione registrata. Per concedere l'autorizzazione, è necessario disporre di un ruolo di amministratore del sito.

    1. Aprire il collegamento di sito SharePoint Online, ad esempio https://[your_site_url]/_layouts/15/appinv.aspx (sostituire l'URL del sito).

    2. Cercare l'ID applicazione registrato, compilare i campi vuoti e fare clic su Crea.

      • Dominio applicazione: contoso.com

      • URL di reindirizzamento: https://www.contoso.com

      • XML richiesta autorizzazione:

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

      Screenshot che mostra il codice XML della richiesta.

      Nota

      Nel contesto della configurazione del connettore SharePoint, il Dominio app e URL di reindirizzamento fanno riferimento all'app SharePoint registrata in Microsoft Entra ID per consentire l'accesso ai dati di SharePoint. Dominio app è il dominio in cui è ospitato il sito di SharePoint. Ad esempio, se il sito di SharePoint si trova in https://contoso.sharepoint.com, il Dominio app sarà contoso.sharepoint.com. L'URL di reindirizzamento è l'URL a cui l'app SharePoint reindirizza dopo che l'utente ha autenticato e concesso le autorizzazioni all'app. Questo URL deve essere una pagina nel sito di SharePoint a cui l'app dispone dell'autorizzazione per l'accesso. Ad esempio, è possibile usare l'URL di una pagina che visualizza un elenco di file in una raccolta o una pagina che visualizza il contenuto di un documento.

    3. Selezionare Considera attendibile per questa app.

Configurazione supportata

Per la configurazione di ogni scheda in un'attività Copia, passare rispettivamente alle sezioni seguenti.

Generali

Per la configurazione della scheda Generale, vedere Generale.

Origine

Le proprietà seguenti sono supportate per l'elenco di SharePoint Online nella scheda Origine di un'attività attività Copy.

Screenshot che mostra la scheda Origine e l'elenco delle proprietà.

Sono richieste le seguenti proprietà:

  • Tipo di archivio dati: selezionare Esterno.

  • Connessione: selezionare una connessione Elenco SharePoint Online dall'elenco di connessioni. Se non esiste alcuna connessione, creare una nuova connessione HTTP selezionando Nuovo.

  • Usare query: scegliere Nome elenco o Query come query di utilizzo. La configurazione di ogni impostazione è:

    • Nome elenco: il nome dell'elenco di SharePoint Online.

      Screenshot che mostra il nome dell'elenco.

    • Query: query OData per filtrare i dati nell'elenco di SharePoint Online. Ad esempio: "$top=1".

      Screenshot che mostra la query.

In Avanzate, è possibile specificare i campi seguenti:

  • Timeout richiesta: tempo di attesa per ottenere una risposta da SharePoint Online. Il valore predefinito è 5 minuti (00:05:00).

  • Colonne aggiuntive: aggiungere altre colonne di dati per archiviare il percorso relativo o il valore statico dei file di origine. L'espressione è supportata per la seconda opzione.

    Screenshot che mostra colonne aggiuntive.

Mapping

Per la configurazione della scheda Mapping, accedere a Configurare i mapping nella scheda Mapping.

Impostazione

Per la configurazione della scheda Impostazioni, vedere Configurare le altre impostazioni nella scheda Impostazioni.

Tabella di riepilogo

La tabella seguente contiene ulteriori informazioni su un'attività Copy nell'elenco di SharePoint Online.

Origine

Nome Descrizione valore Richiesto Proprietà script JSON
Tipo di archivio dati Tipo di archivio dati in uso. Esterno Sì /
Connessione Collegamento all'archivio dati di origine. <Collegamento personale> Sì connection
Usa query È possibile scegliere Nome elenco o Query come query di utilizzo. -Nome elenco
-Query		 No type
Nome elenco Il nome dell'elenco di SharePoint Online. <Collegamento personale> Sì listName
Timeout richiesta Tempo di attesa per ottenere una risposta da SharePoint Online. Il valore predefinito è 5 minuti (00:05:00). timespan No requestTimeout
Colonne aggiuntive Aggiungere altre colonne di dati per archiviare il percorso relativo o il valore statico dei file di origine. L'espressione è supportata per la seconda opzione. • Name
• Valore		 No additionalColumns:
• name
• valore

Contenuto correlato