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: Uso dell'autenticazione tramite 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 il permesso di utilizzare il certificato di principale di servizio

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

1. Genera un certificato autofirmato ed esporta sia il certificato pubblico che il certificato, inclusa la sua chiave privata. Per saperne come procedere, consulta Crea un certificato pubblico autofirmato per autenticare la tua domanda.

2. Registrare un'applicazione con il Microsoft Identity Platform. Per saperne come funzionare, consulta Registra un'applicazione con la Microsoft Identity Platform. Prendere nota di questi valori che si usano per definire il servizio collegato:

   • ID dell'applicazione
   • ID del locatario

3. Carica il certificato pubblico nella sezione Certificati e segreti.

4. Seleziona Aggiungi permesso per i permessi API.

5. Seleziona SharePoint per selezionare un'API.

6. Seleziona Autorizzazioni applicazione.

7. Seleziona Sites.Read.All per i permessi di selezione. Per scoprire i dettagli sui permessi, consulta il riferimento ai permessi di Microsoft Graph.

8. Seleziona Aggiungi autorizzazioni.

9. Selezionare Concedi il consenso di amministratore per.

10. Seleziona Sì per la conferma del consenso amministrativo della concessione.

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

Puoi copiare un file da SharePoint Online utilizzando Web Activity per autenticarti e ottenere un token di accesso da Microsoft Entra ID. Poi, passa il token alla successiva attività Copy per copiare i dati usando il connettore HTTP come sorgente.

1. Fai riferimento alla sezione Concedere l'autorizzazione per usare il certificato dell'entità servizio per creare un'applicazione Microsoft Entra e concedere le autorizzazioni a Microsoft Graph, non a SharePoint.

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

   • URL: https://login.microsoftonline.com/[tenant-ID]/oauth2/v2.0/token. Sostituire l'ID tenant.
   • Metodo: POST
   • Headers:
     • Tipo di contenuto: application/x-www-form-urlencoded
   • Corpo: client_id=[Client-ID]&scope=https%3A%2F%2Fgraph.microsoft.com%2F.default&client_secret=[Client-Secret]&grant_type=client_credentials. Sostituisci l'ID client (ID applicazione) e il client secret (chiave applicativa).

   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://graph.microsoft.com/v1.0/sites/{Your-Site-ID}/drives/{Drive-ID}/root:/{path to file}:/content. Sostituisci l'ID del sito, l'ID del disco e il percorso relativo al file. Per imparare come ottenere l'ID del disco, consulta Elenco dei dischi disponibili. In alternativa, puoi recuperare un URL di download diretto @microsoft.graph.downloadUrl dalla proprietà dell'oggetto DriveItem e usare quell'URL invece.
     • 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.