Kopírování dat ze seznamu SharePointu Online pomocí služby Azure Data Factory nebo Azure Synapse Analytics

PLATÍ PRO: Azure Data Factory Azure Synapse Analytics

Tento článek popisuje, jak pomocí aktivity kopírování ve službě Azure Data Factory a kanálech Azure Synapse kopírovat data ze seznamu SharePointu Online. Článek vychází z aktivity kopírování, která představuje obecný přehled aktivity kopírování.

Podporované funkce

Tento konektor seznamu SharePointu Online je podporovaný pro následující funkce:

(1) Prostředí Azure Integration Runtime (2) Místní prostředí Integration Runtime

Seznam úložišť dat podporovaných jako zdroje nebo jímky najdete v tabulce Podporované úložiště dat.

Konkrétně tento konektor SharePoint List Online používá ověřování instančního objektu a načítá data přes protokol OData.

Začínáme

K provedení aktivita Copy s kanálem můžete použít jeden z následujících nástrojů nebo sad SDK:

• Nástroj pro kopírování dat
• Azure Portal
• Sada .NET SDK
• Sada Python SDK
• Azure PowerShell
• Rozhraní REST API
• Šablona Azure Resource Manageru

Vytvoření propojené služby se seznamem SharePointu Online pomocí uživatelského rozhraní

Pomocí následujícího postupu vytvořte propojenou službu se seznamem SharePointu Online v uživatelském rozhraní webu Azure Portal.

1. Přejděte na kartu Správa v pracovním prostoru Azure Data Factory nebo Synapse a vyberte Propojené služby a pak klikněte na Nový:

   • Azure Data Factory
   • Azure Synapse

   

2. Vyhledejte SharePoint a vyberte konektor seznamu SharePointu Online.

   

3. Nakonfigurujte podrobnosti o službě, otestujte připojení a vytvořte novou propojenou službu.

   

Podrobnosti konfigurace konektoru

Následující části obsahují podrobnosti o vlastnostech, které můžete použít k definování entit specifických pro konektor seznamu SharePointu Online.

Vlastnosti propojené služby

Propojená služba seznamu SharePointu Online podporuje následující vlastnosti:

Příklad 1: Použití ověřování instančního klíče

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

Příklad 2: Použití ověřování certifikátů instančního objektu

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

Udělení oprávnění pro použití klíče instančního objektu

Konektor SharePoint List Online používá k připojení k SharePointu ověřování instančního objektu. Pokud ho chcete nastavit, postupujte takto:

1. Zaregistrujte aplikaci na platformě Microsoft Identity Platform. Postup najdete v tématu Rychlý start: Registrace aplikace na platformě Microsoft Identity Platform. Poznamenejte si tyto hodnoty, které použijete k definování propojené služby:

   • ID aplikace
   • Klíč aplikace
   • ID tenanta

2. Následujícím postupem udělte zaregistrované aplikaci oprávnění k webu SharePointu Online. K tomu potřebujete roli správce webu.

   1. Otevřete odkaz na web SharePointu Online. Například adresa URL ve formátu https://<your-site-url>/_layouts/15/appinv.aspx , ve kterém je zástupný symbol <your-site-url> vaším webem.

   2. Vyhledejte ID aplikace, které jste zaregistrovali, vyplňte prázdná pole a klikněte na Vytvořit.

      • Doména aplikace: contoso.com

      • Adresa URL pro přesměrování: https://www.contoso.com

      • Xml žádosti o oprávnění:

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

        

      Poznámka:

      V kontextu konfigurace konektoru SharePointu odkazuje doména aplikace a adresa URL pro přesměrování na sharepointovou aplikaci, kterou jste zaregistrovali v Microsoft Entra ID, abyste povolili přístup k vašim datům SharePointu. Doména aplikace je doména, kde je váš sharepointový web hostovaný. Pokud se například váš sharepointový web nachází nahttps://contoso.sharepoint.com" ";" a "App Domain" (Doména aplikace) by byl "contoso.sharepoint.com". Adresa URL přesměrování je adresa URL, na kterou bude aplikace SharePoint přesměrována po ověření a udělení oprávnění k aplikaci. Tato adresa URL by měla být stránka na sharepointovém webu, ke které má aplikace oprávnění pro přístup. Můžete například použít adresu URL stránky, která zobrazuje seznam souborů v knihovně, nebo stránku, která zobrazuje obsah dokumentu.

   3. U této aplikace klikněte na Důvěřovat.

Vlastnosti datové sady

Úplný seznam oddílů a vlastností, které jsou k dispozici pro definování datových sad, najdete v tématu Datové sady a propojené služby. Následující část obsahuje seznam vlastností podporovaných datovou sadou tabulky SAP.

Příklad

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

Vlastnosti aktivity kopírování

Úplný seznam oddílů a vlastností, které jsou k dispozici pro definování aktivit, najdete v tématu Kanály. Následující část obsahuje seznam vlastností podporovaných zdrojem seznamu SharePointu Online.

Seznam SharePointu Online jako zdroj

Pokud chcete kopírovat data ze seznamu SharePointu Online, podporují se v části Zdroj aktivity kopírování následující vlastnosti:

Příklad

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

Mapování datových typů pro seznam SharePointu Online

Při kopírování dat ze seznamu SharePointu Online se mezi datovými typy seznamu SharePointu Online a dočasnými datovými typy používanými službou interně používají následující mapování.

Kopírování souboru ze SharePointu Online

Soubor ze SharePointu Online můžete zkopírovat pomocí webové aktivity k ověření a získání přístupového tokenu z SPO a následným aktivita Copy ke kopírování dat pomocí konektoru HTTP jako zdroje.

1. Postupujte podle pokynů v části Udělení oprávnění pro použití instančního klíče a vytvořte aplikaci Microsoft Entra a udělte oprávnění k SharePointu Online.

2. Vytvořte webovou aktivitu pro získání přístupového tokenu ze SharePointu Online:

   • Adresa URL: https://accounts.accesscontrol.windows.net/[Tenant-ID]/tokens/OAuth/2. Nahraďte ID tenanta.
   • Metoda: POST
   • Záhlaví:
     • Content-Type: application/x-www-form-urlencoded
   • Tělo: 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]. Nahraďte ID klienta (ID aplikace), tajný klíč klienta (klíč aplikace), ID tenanta a název tenanta (tenanta SharePointu).

   Upozornění

   Nastavte možnost Zabezpečený výstup na hodnotu true ve webové aktivitě, aby se hodnota tokenu nezaprotokolovala v prostém textu. Všechny další aktivity, které tuto hodnotu spotřebovávají, by měly mít možnost Zabezpečené zadání nastavenou na hodnotu true.

3. Zřetězte obsah souboru SharePointu Online pomocí aktivita Copy s konektorem HTTP jako zdrojem:

   • Propojená služba HTTP:
     • Základní adresa URL: https://[site-url]/_api/web/GetFileByServerRelativeUrl('[relative-path-to-file]')/$value. Nahraďte adresu URL webu a relativní cestu k souboru. Nezapomeňte zahrnout adresu URL sharepointového webu spolu s názvem domény, například https://[sharepoint-domain-name].sharepoint.com/sites/[sharepoint-site]/_api/web/GetFileByServerRelativeUrl('/sites/[sharepoint-site]/[relative-path-to-file]')/$value.
     • Typ ověřování: Anonymní (pro pozdější použití nosný token nakonfigurovaný ve zdroji aktivity kopírování)
   • Datová sada: Zvolte požadovaný formát. Pokud chcete zkopírovat soubor tak, jak je, vyberte typ Binární.
   • zdroj aktivita Copy:
     • Metoda požadavku: GET
     • Další hlavička: Použijte následující výraz@{concat('Authorization: Bearer ', activity('<Web-activity-name>').output.access_token)}, který používá nosný token vygenerovaný nadřazenou webovou aktivitou jako autorizační hlavičku. Nahraďte název webové aktivity.
   • Nakonfigurujte jímku aktivity kopírování pro libovolný podporovaný cíl jímky.

Vlastnosti aktivity vyhledávání

Podrobnosti o vlastnostech najdete v aktivitě Vyhledávání.

Související obsah

Seznam úložišť dat, která aktivita kopírování podporuje jako zdroje a jímky, najdete v tématu Podporované úložiště a formáty dat.