Copiare i dati da un elenco di SharePoint Online utilizzando Azure Data Factory o Azure Synapse Analytics.

APPLICABILE A: Azure Data Factory Azure Synapse Analytics

Questo articolo illustra come usare l'attività di copia, Copy Activity, nelle pipeline di Azure Data Factory e Azure Synapse per copiare dati da un elenco di SharePoint Online. L'articolo è basato su Attività Copy, dove viene presentata una panoramica generale dell'attività di copia.

Funzionalità supportate

Questo connettore Elenco online di SharePoint è supportato per le seguenti funzionalità:

① Azure Integration Runtime ② Runtime di integrazione self-hosted

Per un elenco degli archivi dati supportati come origini o sink, vedere la tabella Archivi dati supportati.

In particolare, il connettore Elenco di SharePoint Online usa l'autenticazione basata su entità servizio e recupera i dati tramite il protocollo OData.

Get started

Per eseguire l'attività Copy con una pipeline, è possibile usare uno degli strumenti o degli SDK seguenti:

• Strumento Copia dati
• portale Azure
• .NET SDK
• Python SDK
• Azure PowerShell
• API REST
• modello Azure Resource Manager

Creare un servizio collegato a un elenco online di SharePoint usando l'interfaccia utente

Usare la procedura seguente per creare un servizio collegato a un elenco online SharePoint nell'interfaccia utente del portale di Azure.

1. Passare alla scheda Gestisci nell'area di lavoro Azure Data Factory o Synapse e selezionare Servizi collegati, quindi selezionare Nuovo:

   • Azure Data Factory
   • Azure Synapse

   

2. Cercare SharePoint e selezionare il connettore Elenco di SharePoint Online.

   

3. Configurare i dettagli del servizio, testare la connessione e creare il nuovo servizio collegato.

   

Dettagli di configurazione del connettore

Le sezioni seguenti forniscono informazioni dettagliate sulle proprietà che è possibile usare per definire entità specifiche per SharePoint connettore elenco online.

Proprietà del servizio collegato

Le seguenti proprietà sono supportate per un servizio collegato di elenco di SharePoint Online:

Esempio 1: Uso dell'autenticazione con la chiave dell'entità servizio

{
    "name": "SharePointOnlineList",
    "properties": {
        "type": "SharePointOnlineList",
        "typeProperties": {
            "siteUrl": "<site URL>",
            "servicePrincipalId": "<service principal id>",
            "servicePrincipalCredentialType":  "ServicePrincipalKey",
            "servicePrincipalKey": {
                "type": "SecureString",
                "value": "<service principal key>"
            },
            "tenantId": "<tenant ID>"
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

Esempio 2: Uso dell'autenticazione con il certificato dell'entità servizio

{
    "name": "SharePointOnlineList",
    "properties": {
        "type": "SharePointOnlineList",
        "typeProperties": {
            "siteUrl": "<site URL>",
            "servicePrincipalId": "<service principal id>",
            "servicePrincipalCredentialType": "ServicePrincipalCert",
            "servicePrincipalEmbeddedCert": { 
                "type": "SecureString", 
                "value": "<base64 encoded string of (.pfx) certificate data>"
            },
            "servicePrincipalEmbeddedCertPassword": { 
                "type": "SecureString", 
                "value": "<password of your certificate>"
            },
            "tenantId": "<tenant ID>"
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

Concedere l'autorizzazione per l'uso della chiave dell'entità servizio

Il connettore di SharePoint List Online utilizza l'autenticazione del principale servizio per connettersi a SharePoint. Seguire questi passaggi per configurarlo:

1. Registrare un'applicazione con il Microsoft identity platform. Per informazioni su come, vedere Quickstart: Registrare un'applicazione con il Microsoft identity platform. Prendere nota di questi valori che si usano per definire il servizio collegato:

   • ID dell'applicazione
   • Chiave applicazione
   • ID del locatario

2. Concedere permessi al sito SharePoint Online alla tua applicazione registrata seguendo questi passaggi. A tale scopo, è necessario un ruolo di amministratore del sito.

   1. Apri il link del sito SharePoint Online. Ad esempio, l'URL nel formato https://<your-site-url>/_layouts/15/appinv.aspx in cui il segnaposto <your-site-url> è il sito.

   2. Cercare l'ID applicazione registrato, compilare i campi vuoti e selezionare "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>
        

        

      Note

      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 SharePoint. Il "Dominio app" è il dominio in cui è ospitato il sito SharePoint. Ad esempio, se il sito SharePoint si trova in "https://contoso.sharepoint.com", il "Dominio app" sarà "contoso.sharepoint. com". L'URL di reindirizzamento è l'URL a cui verrà reindirizzata l'app SharePoint dopo che l'utente ha autenticato e concesso le autorizzazioni all'app. Questo URL deve essere una pagina nel sito SharePoint a cui l'app ha l'autorizzazione per accedere. 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.

Proprietà del set di dati

Per un elenco completo delle sezioni e delle proprietà disponibili per la definizione dei set di dati, vedere Set di dati e servizi collegati. La sezione seguente presenta un elenco delle proprietà supportate dal set di dati della tabella SAP.

Example

{
    "name": "SharePointOnlineListDataset",
    "properties":
    {
        "type": "SharePointOnlineListResource",
        "linkedServiceName": {
            "referenceName": "<SharePoint Online List linked service name>",
            "type": "LinkedServiceReference"
        },
        "typeProperties":
        {
            "listName": "<name of the list>"
        }
    }
}

Proprietà dell'attività di copia

Per un elenco completo delle sezioni e delle proprietà disponibili per la definizione delle attività, vedere Pipeline. Nella sezione seguente viene fornito un elenco delle proprietà supportate dall'origine Elenco di SharePoint Online.

Elenco di SharePoint Online come origine

Per copiare dati da SharePoint Elenco online, nella sezione Attività di copia source sono supportate le proprietà seguenti:

Example

"activities":[
    {
        "name": "CopyFromSharePointOnlineList",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<SharePoint Online List input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "SharePointOnlineListSource",
                "query": "<OData query e.g. $top=10&$select=Title,Number>"
            }, 
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

Mapping dei tipi di dati per Elenco di SharePoint Online

Quando si copiano dati da SharePoint Online List, vengono usati i seguenti mapping tra i tipi di dati di SharePoint Online List e i tipi di dati provvisori usati internamente dal servizio.

Copiare il file da SharePoint Online

È possibile copiare il file da SharePoint Online usando AttivitàWeb per autenticare e acquisire il token di accesso da SPO, quindi passare alla successiva Copy activity per copiare i dati con HTTP Connector come origine.

1. Seguire la sezione Concedere l'autorizzazione per l'uso della chiave dell'entità servizio per creare l'applicazione Microsoft Entra e concedere l'autorizzazione a SharePoint Online.

2. Creare un Web Activity per ottenere il token di accesso da SharePoint Online:

   • URL: https://accounts.accesscontrol.windows.net/[Tenant-ID]/tokens/OAuth/2. Sostituire l'ID tenant.
   • Metodo: POST
   • Headers:
     • Tipo di contenuto: application/x-www-form-urlencoded
   • Corpo: grant_type=client_credentials&client_id=[Client-ID]@[Tenant-ID]&client_secret=[Client-Secret]&resource=00000003-0000-0ff1-ce00-000000000000/[Tenant-Name].sharepoint.com@[Tenant-ID]. Sostituire l'ID client (ID applicazione), il segreto client (chiave dell'applicazione), l'ID tenant e il nome del tenant di SharePoint.

   Caution

   Impostare l'opzione Output sicuro su true nell'attività Web per impedire che il valore del token venga registrato come testo normale. In qualsiasi ulteriore attività in cui viene usato questo valore, l'opzione Input sicuro deve essere impostata su true.

3. Catena con un'attività di copia con connettore HTTP come origine per copiare il contenuto dei file di SharePoint Online:

   • Servizio collegato HTTP:
     • URL di base: https://[site-url]/_api/web/GetFileByServerRelativeUrl('[relative-path-to-file]')/$value. Sostituire l'URL del sito e il percorso relativo del file. Assicurarsi di includere l'URL del sito SharePoint insieme al nome di dominio, ad esempio https://[sharepoint-domain-name].sharepoint.com/sites/[sharepoint-site]/_api/web/GetFileByServerRelativeUrl('/sites/[sharepoint-site]/[relative-path-to-file]')/$value.
     • Tipo di autenticazione: Anonimo (per usare il token di connessione configurato nell'origine dell'attività di copia in un secondo momento)
   • Set di dati: scegliere il formato desiderato. Per copiare il file così com'è, selezionare il tipo "Binary".
   • origine dell'attività di copia:
     • Metodo di richiesta: GET
     • Intestazione aggiuntiva: usare l'espressione seguente @{concat('Authorization: Bearer ', activity('<Web-activity-name>').output.access_token)}, che impiega il token di connessione generato dall'attività Web upstream come intestazione di autorizzazione. Sostituire il nome dell'attività Web.
   • Configurare il sink dell'attività di copia per qualsiasi destinazione sink supportata.

Proprietà dell'attività Lookup

Per altre informazioni sulle proprietà, vedere Attività Lookup.

Contenuti correlati

Per un elenco degli archivi dati supportati dall'attività di copia come origini e sink, vedere Archivi dati e formati supportati.