Kopiera data från Marketo med Azure Data Factory eller Synapse Analytics (förhandsversion)

  • Artikel

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

Dricks

Prova Data Factory i Microsoft Fabric, en allt-i-ett-analyslösning för företag. Microsoft Fabric omfattar allt från dataflytt till datavetenskap, realtidsanalys, business intelligence och rapportering. Lär dig hur du startar en ny utvärderingsversion kostnadsfritt!

Viktigt!

Den här anslutningsappen kommer att vara inaktuell den 31 december 2024. Du rekommenderas att migrera till ODBC-anslutningsprogrammet genom att installera en drivrutin före det datumet.

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

Funktioner som stöds

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

Funktioner som stöds IR
Kopieringsaktivitet (källa/-) (1) (2)
Sökningsaktivitet (1) (2)

(1) Azure Integration Runtime (2) Lokalt installerad integrationskörning

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

För närvarande stöds inte Marketo-instans som är integrerad med extern CRM.

Kommentar

Den här Marketo-anslutningsappen bygger på Marketo REST-API:et. Tänk på att Marketo har en gräns för samtidiga begäranden på tjänstsidan. Om du stöter på fel som säger "Fel vid försök att använda REST API: Maximal hastighetsgräns "100" överskreds med i 20 sekunder (606)" eller "Fel vid försök att använda REST API: Den samtidiga åtkomstgränsen "10" har nåtts (615)", bör du överväga att minska antalet samtidiga kopieringsaktiviteter för att minska antalet begäranden till tjänsten.

Komma igång

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

Skapa en länkad tjänst till Marketo med hjälp av användargränssnittet

Använd följande steg för att skapa en länkad tjänst till Marketo i azure-portalens användargränssnitt.

  1. Bläddra till fliken Hantera i Din Azure Data Factory- eller Synapse-arbetsyta och välj Länkade tjänster och klicka sedan på Ny:

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

    Skärmbild av Marketo-anslutningsappen.

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

    Skärmbild av konfiguration av länkad tjänst för Marketo.

Konfigurationsinformation för anslutningsprogram

Följande avsnitt innehåller information om egenskaper som används för att definiera Data Factory-entiteter som är specifika för Marketo-anslutningsprogram.

Länkade tjänstegenskaper

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

Property Beskrivning Obligatoriskt
type Typegenskapen måste anges till: Marketo Ja
slutpunkt Slutpunkten för Marketo-servern. (d.v.s. 123-ABC-321.mktorest.com) Ja
clientId Klient-ID för din Marketo-tjänst. Ja
clientSecret Klienthemligheten för din Marketo-tjänst. Markera det här fältet som en SecureString för att lagra det på ett säkert sätt eller referera till en hemlighet som lagras i Azure Key Vault. Ja
useEncryptedEndpoints Anger om datakällans slutpunkter krypteras med HTTPS. Standardvärdet är sant. Nej
useHostVerification Anger om värdnamnet i serverns certifikat ska behövas för att matcha serverns värdnamn vid anslutning via TLS. Standardvärdet är sant. Nej
usePeerVerification Anger om serverns identitet ska verifieras vid anslutning via TLS. Standardvärdet är sant. Nej

Exempel:

{
    "name": "MarketoLinkedService",
    "properties": {
        "type": "Marketo",
        "typeProperties": {
            "endpoint" : "123-ABC-321.mktorest.com",
            "clientId" : "<clientId>",
            "clientSecret": {
                "type": "SecureString",
                "value": "<clientSecret>"
            }
        }
    }
}

Egenskaper för datauppsättning

En fullständig lista över avsnitt och egenskaper som är tillgängliga för att definiera datauppsättningar finns i artikeln datauppsättningar . Det här avsnittet innehåller en lista över egenskaper som stöds av Marketo-datamängden.

Om du vill kopiera data från Marketo anger du datamängdens typegenskap till MarketoObject. Följande egenskaper stöds:

Property Beskrivning Obligatoriskt
type Datamängdens typegenskap måste anges till: MarketoObject Ja
tableName Tabellens namn. Nej (om "fråga" i aktivitetskällan har angetts)

Exempel

{
    "name": "MarketoDataset",
    "properties": {
        "type": "MarketoObject",
        "typeProperties": {},
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<Marketo linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

Kopiera egenskaper för aktivitet

En fullständig lista över avsnitt och egenskaper som är tillgängliga för att definiera aktiviteter finns i artikeln Pipelines . Det här avsnittet innehåller en lista över egenskaper som stöds av Marketo-källan.

Marketo som källa

Om du vill kopiera data från Marketo anger du källtypen i kopieringsaktiviteten till MarketoSource. Följande egenskaper stöds i avsnittet kopieringsaktivitetskälla:

Property Beskrivning Obligatoriskt
type Typegenskapen för kopieringsaktivitetskällan måste anges till: MarketoSource Ja
query Använd den anpassade SQL-frågan för att läsa data. Exempel: "SELECT * FROM Activitiy_Types". Nej (om "tableName" i datauppsättningen har angetts)

Exempel:

"activities":[
    {
        "name": "CopyFromMarketo",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<Marketo input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "MarketoSource",
                "query": "SELECT top 1000 * FROM Activitiy_Types"
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

Egenskaper för uppslagsaktivitet

Mer information om egenskaperna finns i Sökningsaktivitet.

Relaterat innehåll

En lista över datalager som stöds som källor och mottagare av kopieringsaktiviteten finns i datalager som stöds.