Kopieren von Daten aus SharePoint Onlineliste mithilfe von Azure Data Factory oder Azure Synapse Analytics

Gilt für: Azure Data Factory Azure Synapse Analytics

In diesem Artikel wird beschrieben, wie Sie die "Copy Activity" in Azure Data Factory und Azure Synapse Pipelines verwenden, um Daten aus einer SharePoint Online List zu kopieren. Dieser Artikel baut auf dem Artikel zur Kopieraktivität auf, der eine allgemeine Übersicht über die Kopieraktivität enthält.

Unterstützte Funktionen

Dieser SharePoint Online-Listen-Connector wird für die folgenden Fähigkeiten unterstützt:

(1) Azure Integrationslaufzeit (2) Selbst gehostete Integrationslaufzeit

Eine Liste der Datenspeicher, die als Quellen oder Senken unterstützt werden, finden Sie in der Tabelle der unterstützten Datenspeicher.

Insbesondere verwendet dieser SharePoint List Online-Connector die Dienstprinzipalauthentifizierung und ruft Daten über das OData-Protokoll ab.

Get started

Zum Ausführen der Kopieraktivität mit einer Pipeline können Sie eines der folgenden Tools oder SDKs verwenden:

• Datenkopier-Werkzeug
• Azure Portal
• .NET SDK
• Python SDK
• Azure PowerShell
• REST-API
• Azure Resource Manager Vorlage

Erstellen eines verknüpften Diensts mit einer SharePoint Onlineliste mithilfe der Benutzeroberfläche

Führen Sie die folgenden Schritte aus, um einen verknüpften Dienst mit einer SharePoint Onlineliste in der benutzeroberfläche des Azure Portals zu erstellen.

1. Navigieren Sie in Ihrem Azure Data Factory- oder Synapse-Arbeitsbereich zur Registerkarte "Verwalten", und wählen Sie "Verknüpfte Dienste" und dann "Neu" aus:

   • Azure Data Factory
   • Azure Synapse

   

2. Suchen Sie nach SharePoint und wählen Sie den SharePoint Online-Listen-Connector aus.

   

3. Konfigurieren Sie die Dienstdetails, testen Sie die Verbindung, und erstellen Sie den neuen verknüpften Dienst.

   

Details zur Connectorkonfiguration

Die folgenden Abschnitte enthalten Details zu Eigenschaften, mit denen Sie Entitäten definieren können, die spezifisch für SharePoint Onlinelistenconnector sind.

Eigenschaften des verknüpften Diensts

Die folgenden Eigenschaften werden für einen SharePoint verknüpften Onlinelistendienst unterstützt:

Beispiel: Verwendung der Service Principal Certificate Authentication

{
    "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"
        }
    }
}

Erteile die Erlaubnis zur Nutzung des Service Principal Certificate

Der SharePoint List Online Connector verwendet die Dienstprinzipalauthentifizierung, um eine Verbindung mit SharePoint herzustellen. Führen Sie die folgenden Schritte aus, um sie einzurichten:

1. Erstellen Sie ein selbstsigniertes Zertifikat und exportieren Sie sowohl das öffentliche Zertifikat als auch das Zertifikat einschließlich seines privaten Schlüssels. Um zu erfahren, wie das geht, siehe Erstellt ein selbstsigniertes öffentliches Zertifikat zur Authentifizierung Ihrer Anwendung.

2. Registrieren Sie eine Anwendung mit dem Microsoft Identity Platform. Um das zu erfahren, siehe Registrieren einer Anwendung bei der Microsoft Identity Platform. Notieren Sie sich die folgenden Werte, die Sie zum Definieren des verknüpften Diensts verwenden können:

   • Anwendungs-ID
   • Mieter-ID

3. Laden Sie das öffentliche Zertifikat in den Zertifikaten & Geheimnissen hoch.

4. Wählen Sie unter API-Berechtigungen die Option Berechtigung hinzufügen aus.

5. Wählen Sie SharePoint aus, um eine API auszuwählen.

6. Wählen Sie Anwendungsberechtigungen.

7. Wählen Sie Sites.Read.All für Berechtigungen auswählen aus. Um Details zu den Berechtigungen zu erfahren, schauen Sie in die Microsoft Graph-Berechtigungsreferenz.

8. Wählen Sie "Berechtigungen hinzufügen" aus.

9. Wählen Sie Administratorzustimmung erteilen für aus.

10. Wählen Sie Ja für die Bestätigung für die Erteilung der Administratoreinwilligung aus.

Dataseteigenschaften

Eine vollständige Liste mit den Abschnitten und Eigenschaften, die zum Definieren von Datasets zur Verfügung stehen, finden Sie unter Datasets und verknüpfte Dienste. Der folgende Abschnitt enthält eine Liste der Eigenschaften, die vom SAP-Tabellen-Dataset unterstützt werden.

Example

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

Eigenschaften der Kopieraktivität

Eine vollständige Liste mit den verfügbaren Abschnitten und Eigenschaften zum Definieren von Aktivitäten finden Sie unter Pipelines. Der folgende Abschnitt enthält eine Liste der Eigenschaften, die von der SharePoint Onlinelistenquelle unterstützt werden.

SharePoint Onlineliste als Quelle

Zum Kopieren von Daten aus einer SharePoint Online-Liste werden die folgenden Eigenschaften im Copy Activity source-Abschnitt unterstützt:

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>"
            }
        }
    }
]

Datentypzuordnung für SharePoint Onlineliste

Wenn Sie Daten aus SharePoint Onlineliste kopieren, werden die folgenden Zuordnungen zwischen SharePoint Onlinelisten-Datentypen und Zwischendatentypen verwendet, die intern vom Dienst verwendet werden.

Datei aus SharePoint Online kopieren

Sie können eine Datei von SharePoint Online kopieren, indem Sie Webaktivitäten zur Authentifizierung nutzen und ein Zugriffstoken von Microsoft Entra ID erhalten. Dann wird das Token an die nächste Copy-Aktivität weitergegeben, um Daten zu kopieren, indem man den HTTP-Connector als Quelle verwendet.

1. Befolgen Sie den Abschnitt "Gewähren der Berechtigung zur Nutzung des Service Principal Certificate", um eine Microsoft Entra-Anwendung zu erstellen und Microsoft Graph eine Berechtigung zu erteilen, nicht SharePoint.

2. Erstellen Sie eine Webaktivität, um das Zugriffstoken von SharePoint Online abzurufen:

   • URL:https://login.microsoftonline.com/[tenant-ID]/oauth2/v2.0/token. Ersetzen Sie die Mandanten-ID.
   • Methode: POST
   • Headers:
     • Inhaltstyp: application/x-www-form-urlencoded
   • Text:client_id=[Client-ID]&scope=https%3A%2F%2Fgraph.microsoft.com%2F.default&client_secret=[Client-Secret]&grant_type=client_credentials. Ersetzen Sie die Client-ID (Anwendungs-ID) und das Client-Geheimnis (Anwendungsschlüssel).

   Caution

   Legen Sie die Option „Secure Output“ (Sichere Ausgabe) in der Webaktivität auf TRUE fest, um zu verhindern, dass der Tokenwert als Klartext protokolliert wird. Für alle weiteren Aktivitäten, die diesen Wert verwenden, sollte die Option „Sichere Eingabe“ auf „True“ festgelegt werden.

3. Kette mit einer Kopieraktivität mit HTTP-Connector als Quelle zum Kopieren von SharePoint Online-Dateiinhalten:

   • Verknüpfter HTTP-Dienst:
     • Basis-URL:https://graph.microsoft.com/v1.0/sites/{Your-Site-ID}/drives/{Drive-ID}/root:/{path to file}:/content. Ersetze die Site-ID, die Laufwerks-ID und den entsprechenden Dateipfad. Um zu erfahren, wie man die Laufwerks-ID erhält, siehe Liste verfügbarer Laufwerke. Alternativ können Sie eine Direct-Download-URL aus der @microsoft.graph.downloadUrl Eigenschaft des DriveItem-Objekts abrufen und stattdessen diese URL verwenden.
     • Authentifizierungstyp: Anonym (zum Verwenden des später in der Quelle der Kopieraktivität konfigurierten Bearertokens)
   • Dataset: Wählen Sie das gewünschte Format aus. Um die Datei unverändert zu kopieren, wählen Sie den Typ „Binär“ aus.
   • Datenquelle der Kopieraktivität
     • Anforderungsmethode: GET
     • Zusätzliche Header: Verwenden Sie den Ausdruck @{concat('Authorization: Bearer ', activity('<Web-activity-name>').output.access_token)}, der das von der Upstreamwebaktivität generierte Bearertoken als Autorisierungsheader verwendet. Ersetzen Sie den Namen der Webaktivität.
   • Konfigurieren Sie die Kopieraktivitätssenke für jedes unterstützte Senkenziel.

Eigenschaften der Lookup-Aktivität

Ausführliche Informationen zu den Eigenschaften finden Sie unter Lookup-Aktivität.

Verwandte Inhalte

Eine Liste der Datenspeicher, die die Kopieraktivität als Quellen und Senken unterstützt, finden Sie unter Unterstützte Datenspeicher und Formate.