Sdílet prostřednictvím


Kopírování dat z Marketu pomocí služby Azure Data Factory nebo Synapse Analytics (Preview)

PLATÍ PRO: Azure Data Factory Azure Synapse Analytics

Tip

Vyzkoušejte si službu Data Factory v Microsoft Fabric, řešení pro analýzy typu all-in-one pro podniky. Microsoft Fabric zahrnuje všechno od přesunu dat až po datové vědy, analýzy v reálném čase, business intelligence a vytváření sestav. Přečtěte si, jak začít používat novou zkušební verzi zdarma.

Důležité

Tento konektor bude zastaralý 31. prosince 2024. Doporučujeme migrovat na konektor ODBC instalací ovladače před tímto datem.

Tento článek popisuje, jak pomocí aktivity kopírování v kanálu Azure Data Factory nebo Synapse Analytics kopírovat data z Marketo. Vychází z článku s přehledem aktivity kopírování, který představuje obecný přehled aktivity kopírování.

Podporované funkce

Tento konektor Marketo je podporovaný pro následující funkce:

Podporované funkce IR
aktivita Copy (zdroj/-) (1) (2)
Aktivita Lookup (1) (2)

(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.

V současné době se instance Marketo, která je integrovaná s externím CRM, nepodporuje.

Poznámka:

Tento konektor Marketo je založený na rozhraní Marketo REST API. Mějte na paměti, že Marketo má na straně služby limit souběžných požadavků. Pokud dojde k chybám se zprávou Chyba při pokusu o použití rozhraní REST API: Došlo k překročení maximálního limitu rychlosti 100 v sekundách 20 sekund (606) nebo Chyba při pokusu o použití rozhraní REST API: Dosažení limitu souběžného přístupu 10 (615) zvažte snížení počtu souběžných spuštění aktivity kopírování, abyste snížili počet požadavků na službu.

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:

Vytvoření propojené služby pro Marketo pomocí uživatelského rozhraní

Pomocí následujícího postupu vytvořte propojenou službu pro Marketo 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ý:

  2. Vyhledejte Marketo a vyberte konektor Marketo.

    Snímek obrazovky s konektorem Marketo

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

    Snímek obrazovky s konfigurací propojené služby pro Marketo

Podrobnosti konfigurace konektoru

Následující části obsahují podrobnosti o vlastnostech, které slouží k definování entit služby Data Factory specifických pro konektor Marketo.

Vlastnosti propojené služby

Pro propojenou službu Marketo se podporují následující vlastnosti:

Vlastnost Popis Povinní účastníci
type Vlastnost typu musí být nastavena na: Marketo Ano
endpoint Koncový bod serveru Marketo. (tj. 123-ABC-321.mktorest.com) Ano
clientId ID klienta vaší služby Marketo. Ano
clientSecret Tajný klíč klienta vaší služby Marketo. Označte toto pole jako securestring, abyste ho mohli bezpečně uložit, nebo odkazovat na tajný klíč uložený ve službě Azure Key Vault. Ano
useEncryptedEndpoints Určuje, jestli jsou koncové body zdroje dat šifrované pomocí protokolu HTTPS. Výchozí hodnota je true. No
useHostVerification Určuje, jestli se má při připojování přes protokol TLS vyžadovat název hostitele v certifikátu serveru. Výchozí hodnota je true. No
usePeerVerification Určuje, jestli se má při připojování přes protokol TLS ověřit identita serveru. Výchozí hodnota je true. No

Příklad:

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

Vlastnosti datové sady

Úplný seznam oddílů a vlastností dostupných pro definování datových sad najdete v článku o datových sadách . Tato část obsahuje seznam vlastností podporovaných datovou sadou Marketo.

Chcete-li kopírovat data z Marketo, nastavte vlastnost typu datové sady na MarketoObject. Podporují se následující vlastnosti:

Vlastnost Popis Povinní účastníci
type Vlastnost typu datové sady musí být nastavená na: MarketoObject. Ano
tableName Název tabulky. Ne (pokud je zadán dotaz ve zdroji aktivity)

Příklad

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

Vlastnosti aktivity kopírování

Úplný seznam oddílů a vlastností dostupných pro definování aktivit najdete v článku Pipelines . Tato část obsahuje seznam vlastností podporovaných zdrojem Marketo.

Marketo jako zdroj

Pokud chcete kopírovat data z Marketo, nastavte typ zdroje v aktivitě kopírování na MarketoSource. Ve zdrojové části aktivity kopírování jsou podporovány následující vlastnosti:

Vlastnost Popis Povinní účastníci
type Vlastnost typu zdroje aktivity kopírování musí být nastavena na: MarketoSource Ano
query Ke čtení dat použijte vlastní dotaz SQL. Například: "SELECT * FROM Activitiy_Types". Ne (pokud je v datové sadě zadán název tabulky)

Příklad:

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

Vlastnosti aktivity vyhledávání

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

Seznam úložišť dat podporovaných jako zdroje a jímky aktivitou kopírování najdete v podporovaných úložištích dat.