Kopiera data från en OData-källa med hjälp av Azure Data Factory eller Synapse Analytics

GÄLLER FÖR: Azure Data Factory Azure Synapse Analytics

Den här artikeln beskriver hur du använder kopieringsaktivitet i en Azure Data Factory- eller Synapse Analytics-pipeline för att kopiera data från en OData-källa. Artikeln bygger på kopieringsaktivitet, som visar en allmän översikt över kopieringsaktivitet.

Funktioner som stöds

Den här OData-anslutningsappen stöds för följande funktioner:

(1) Azure integration runtime (2) Lokalt installerad integrationskörning

En lista över datalager som stöds som källor/mottagare finns i Datalager som stöds.

Mer specifikt stöder den här OData-anslutningsappen:

• OData version 2.0, 3.0 och 4.0.
• Kopiera data med någon av följande autentiseringar: Anonymous, Basic, Windows och Microsoft Entra tjänstens huvudnamn.

Förutsättningar

Om ditt datalager finns i ett lokalt nätverk, ett Azure virtuellt nätverk eller Amazon Virtual Private Cloud måste du konfigurera en självhostad integrationskörning för att ansluta till den.

Om ditt datalager är en hanterad molndatatjänst kan du använda Azure Integration Runtime. Om åtkomsten är begränsad till IP-adresser som är godkända i brandväggsreglerna kan du lägga till Azure Integration Runtime IP-adresser i listan över tillåtna.

Du kan också använda funktionen hanterad virtuell nätverksintegrering i Azure Data Factory för att få åtkomst till det lokala nätverket utan att installera och konfigurera en integrationskörning med egen värd.

Mer information om de nätverkssäkerhetsmekanismer och alternativ som stöds av Data Factory finns i Strategier för dataåtkomst.

Kom igång

Om du vill utföra kopieringsaktiviteten med en pipeline kan du använda något av följande verktyg eller SDK:er:

• Kopiera data-verktyget
• Azure Portal
• .NET SDK
• Python SDK
• Azure PowerShell
• REST-API
• mall för Azure Resource Manager

Skapa en länkad tjänst till ett OData-arkiv med hjälp av användargränssnittet

Använd följande steg för att skapa en länkad tjänst till ett OData-arkiv i användargränssnittet för Azure portalen.

1. Bläddra till fliken Hantera i din Azure Data Factory- eller Synapse-arbetsyta och välj Länkade tjänster och välj sedan Nytt:

   • Azure Data Factory
   • Azure Synapse

   

2. Sök efter OData och välj OData-anslutningsappen.

   

3. Konfigurera tjänstinformationen, testa anslutningen och skapa den nya länkade tjänsten.

   

Konfigurationsinformation för anslutning

Följande avsnitt innehåller information om egenskaper som du kan använda för att definiera Data Factory-entiteter som är specifika för en OData-anslutning.

Länkade tjänstegenskaper

Följande egenskaper stöds för en OData-länkad tjänst:

Exempel 1: Använda anonym autentisering

{
    "name": "ODataLinkedService",
    "properties": {
        "type": "OData",
        "typeProperties": {
            "url": "https://services.odata.org/OData/OData.svc",
            "authenticationType": "Anonymous"
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

Exempel 2: Använda grundläggande autentisering

{
    "name": "ODataLinkedService",
    "properties": {
        "type": "OData",
        "typeProperties": {
            "url": "<endpoint of OData source>",
            "authenticationType": "Basic",
            "userName": "<user name>",
            "password": {
                "type": "SecureString",
                "value": "<password>"
            }
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

Exempel 3: Använda Windows-autentisering

{
    "name": "ODataLinkedService",
    "properties": {
        "type": "OData",
        "typeProperties": {
            "url": "<endpoint of OData source>",
            "authenticationType": "Windows",
            "userName": "<domain>\\<user>",
            "password": {
                "type": "SecureString",
                "value": "<password>"
            }
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

Exempel 4: Använda nyckelautentisering för tjänstens huvudnamn

{
    "name": "ODataLinkedService",
    "properties": {
        "type": "OData",
        "typeProperties": {
            "url": "<endpoint of OData source>",
            "authenticationType": "AadServicePrincipal",
            "servicePrincipalId": "<service principal id>",
            "aadServicePrincipalCredentialType": "ServicePrincipalKey",
            "servicePrincipalKey": {
                "type": "SecureString",
                "value": "<service principal key>"
            },
            "tenant": "<tenant info, e.g. microsoft.onmicrosoft.com>",
            "aadResourceId": "<AAD resource URL>"
        }
    },
    "connectVia": {
        "referenceName": "<name of Integration Runtime>",
        "type": "IntegrationRuntimeReference"
    }
}

Exempel 5: Använda certifikatautentisering för tjänstens huvudnamn

{
    "name": "ODataLinkedService",
    "properties": {
        "type": "OData",
        "typeProperties": {
            "url": "<endpoint of OData source>",
            "authenticationType": "AadServicePrincipal",
            "servicePrincipalId": "<service principal id>",
            "aadServicePrincipalCredentialType": "ServicePrincipalCert",
            "servicePrincipalEmbeddedCert": { 
                "type": "SecureString", 
                "value": "<base64 encoded string of (.pfx) certificate data>"
            },
            "servicePrincipalEmbeddedCertPassword": { 
                "type": "SecureString", 
                "value": "<password of your certificate>"
            },
            "tenant": "<tenant info, e.g. microsoft.onmicrosoft.com>",
            "aadResourceId": "<AAD resource e.g. https://tenant.sharepoint.com>"
        }
    },
    "connectVia": {
        "referenceName": "<name of Integration Runtime>",
        "type": "IntegrationRuntimeReference"
    }
}

Exempel 6: Använda API-nyckelautentisering

{
    "name": "ODataLinkedService",
    "properties": {
        "type": "OData",
        "typeProperties": {
            "url": "<endpoint of OData source>",
            "authenticationType": "Anonymous",
            "authHeader": {
                "APIKey": {
                    "type": "SecureString",
                    "value": "<API key>"
                }
            }
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

Egenskaper för datamängd

Det här avsnittet innehåller en lista över egenskaper som OData-datauppsättningen stöder.

En fullständig lista över avsnitt och egenskaper som är tillgängliga för att definiera datauppsättningar finns i Datauppsättningar och länkade tjänster.

Om du vill kopiera data från OData anger du datauppsättningens typegenskap till ODataResource. Följande egenskaper stöds:

Exempel

{
    "name": "ODataDataset",
    "properties":
    {
        "type": "ODataResource",
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<OData linked service name>",
            "type": "LinkedServiceReference"
        },
        "typeProperties":
        {
            "path": "Products"
        }
    }
}

Egenskaper för kopieringsaktivitet

Det här avsnittet innehåller en lista över egenskaper som OData-källan stöder.

En fullständig lista över avsnitt och egenskaper som är tillgängliga för att definiera aktiviteter finns i Pipelines.

OData som källa

För att kopiera data från OData stöds följande egenskaper i avsnittet Kopiera aktivitetskälla:

Exempel

"activities":[
    {
        "name": "CopyFromOData",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<OData input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "ODataSource",
                "query": "$select=Name,Description&$top=5"
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

Om du använde RelationalSource en typad källa, stöds den fortfarande som den är, men det rekommenderas att du använder den nya framöver.

Datatypsmappning för OData

När du kopierar data från OData används följande mappningar mellan OData-datatyper och mellanliggande datatyper som används i tjänsten internt. För att lära dig hur Copy Activity mappar källschemat och datatypen till sinken, se Schema- och datatypmappningar.

Kopiera data från Project Online

Project Online kräver användarbaserad OAuth, vilket inte stöds av Azure Data Factory. Om du vill kopiera data från Project Online kan du använda OData-anslutningsappen och en åtkomsttoken som hämtas från verktyg som Postman.

1. Använd Postman för att hämta åtkomsttoken:

   Kommentar

   Postman används av vissa utvecklare för att testa fjärrwebb-API:er. Det finns dock vissa säkerhets- och sekretessrisker i samband med användningen. Den här artikeln stöder inte användning av Postman för produktionsmiljöer. Använd den på egen risk.

   1. Gå till fliken Auktorisering på Postman-webbplatsen.
   2. I rutan Typ väljer du OAuth 2.0 och i rutan Lägg till auktoriseringsdata till väljer du Begärandehuvuden.
   3. Fyll i följande information på sidan Konfigurera ny token för att hämta en ny åtkomsttoken:
      • Bevilja typ: Välj Auktoriseringskod.
      • Återanrops-URL: Ange https://www.localhost.com/.
      • Autentiserings-URL: Ange https://login.microsoftonline.com/common/oauth2/authorize?resource=https://<your tenant name>.sharepoint.com. Ersätt <your tenant name> med ditt eget klientnamn.
      • Url för åtkomsttoken: Ange https://login.microsoftonline.com/common/oauth2/token.
      • Client ID: Ange ditt Microsoft Entra tjänstens huvudnamns-ID.
      • Klienthemlighet: Ange tjänstens huvudnamnshemlighet.
      • Klientautentisering: Välj Skicka som grundläggande autentiseringshuvud.
   4. Du uppmanas att logga in med ditt användarnamn och lösenord.
   5. När du har hämtat din åtkomsttoken kopierar du och sparar den för nästa steg.

   

2. Skapa den länkade OData-tjänsten:

   • Tjänst-URL: Ange https://<your tenant name>.sharepoint.com/sites/pwa/_api/Projectdata. Ersätt <your tenant name> med ditt eget klientnamn.
   • Autentiseringstyp: Välj Anonym.
   • Auth-rubriker:
     • Egenskapsnamn: Välj Auktorisering.
     • Värde: Ange Bearer <access token from step 1>.
   • Testa den länkade tjänsten.

   

3. Skapa OData-datauppsättningen:

   1. Skapa datauppsättningen med den OData-länkade tjänsten som skapades i steg 2.
   2. Förhandsgranska data.

   

Egenskaper för uppslagsaktivitet

Mer information om egenskaperna finns i Sökningsaktivitet.

Relaterat innehåll

En lista över datalager som kopieringsaktivitet stöder som källor och mottagare finns i Datalager och format som stöds.