Kopírování dat z cloudu SAP pro zákazníka (C4C) pomocí služby Azure Data Factory nebo Synapse Analytics

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.

Tento článek popisuje, jak pomocí aktivity kopírování v kanálu Azure Data Factory nebo Synapse Analytics kopírovat data z/do SAP Cloudu pro zákazníka (C4C). Vychází z článku s přehledem aktivity kopírování, který představuje obecný přehled aktivity kopírování.

Tip

Pokud chcete zjistit celkovou podporu služby ve scénáři integrace dat SAP, přečtěte si článek o integraci dat SAP pomocí dokumentu white paper o službě Azure Data Factory s podrobným úvodem ke každému konektoru SAP, porovnání a doprovodným materiálům.

Podporované funkce

Tento konektor SAP Cloud pro zákazníka je podporovaný pro následující funkce:

Podporované funkce IR
aktivita Copy (zdroj/jímka) ① ②
Aktivita Lookup ① ②

(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 umožňuje službě kopírovat data z/do SAP Cloudu pro zákazníka, včetně řešení SAP Cloud for Sales, SAP Cloud for Service a SAP Cloud for Social Engagement.

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 se SAP Cloudem pro zákazníka pomocí uživatelského rozhraní

Pomocí následujícího postupu vytvořte propojenou službu se SAP Cloudem pro zákazníka 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 SAP a vyberte konektor SAP Cloud for Customer.

    Select the SAP Cloud for Customer connector.

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

    Configure a linked service to SAP Cloud for Customer.

podrobnosti o konfiguraci Připojení oru

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

Vlastnosti propojené služby

Pro propojenou službu SAP Cloud pro zákazníky se podporují následující vlastnosti:

Vlastnost Popis Povinní účastníci
type Vlastnost typu musí být nastavena na: SapCloudForCustomer. Ano
url Adresa URL služby SAP C4C OData. Ano
username Zadejte uživatelské jméno pro připojení k SAP C4C. Ano
Heslo Zadejte heslo pro uživatelský účet, který jste zadali pro uživatelské jméno. 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
connectVia Prostředí Integration Runtime , které se má použít pro připojení k úložišti dat. Pokud není zadaný, použije výchozí prostředí Azure Integration Runtime. No

Příklad:

{
    "name": "SAPC4CLinkedService",
    "properties": {
        "type": "SapCloudForCustomer",
        "typeProperties": {
            "url": "https://<tenantname>.crm.ondemand.com/sap/c4c/odata/v1/c4codata/" ,
            "username": "<username>",
            "password": {
                "type": "SecureString",
                "value": "<password>"
            }
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

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 sap Cloudem pro datovou sadu zákazníků.

Pokud chcete kopírovat data ze sap Cloudu pro zákazníka, nastavte vlastnost typu datové sady na SapCloudForCustomerResource. Podporují se následující vlastnosti:

Vlastnost Popis Povinní účastníci
type Vlastnost typu datové sady musí být nastavená na: SapCloudForCustomerResource. Ano
path Zadejte cestu entity OData SAP C4C. Ano

Příklad:

{
    "name": "SAPC4CDataset",
    "properties": {
        "type": "SapCloudForCustomerResource",
        "typeProperties": {
            "path": "<path e.g. LeadCollection>"
        },
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<SAP C4C linked service>",
            "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 sap Cloudem pro zdroj zákazníka.

SAP C4C jako zdroj

Pokud chcete kopírovat data ze sap Cloudu pro zákazníka, nastavte typ zdroje v aktivitě kopírování na SapCloudForCustomerSource. Ve zdrojové části aktivity kopírování jsou podporovány následující vlastnosti:

Vlastnost Popis Povinní účastníci
type Vlastnost typu musí být nastavena na: SapCloudForCustomerSource Ano
query Zadejte vlastní dotaz OData pro čtení dat. No
httpRequestTimeout Časový limit ( hodnota TimeSpan ) požadavku HTTP pro získání odpovědi. Tato hodnota je časový limit pro získání odpovědi, nikoli časový limit pro čtení dat odpovědi. Pokud není zadána, výchozí hodnota je 00:30:00 (30 minut). No

Ukázkový dotaz pro získání dat pro konkrétní den: "query": "$filter=CreatedOn ge datetimeoffset'2017-07-31T10:02:06.4202620Z' and CreatedOn le datetimeoffset'2017-08-01T10:02:06.4202620Z'"

Příklad:

"activities":[
    {
        "name": "CopyFromSAPC4C",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<SAP C4C input dataset>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "SapCloudForCustomerSource",
                "query": "<custom query e.g. $top=10>"
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

SAP C4C jako jímka

Pokud chcete zkopírovat data do SAP Cloudu pro zákazníka, nastavte typ jímky v aktivitě kopírování na SapCloudForCustomerSink. V části jímky aktivity kopírování jsou podporovány následující vlastnosti:

Vlastnost Popis Povinní účastníci
type Vlastnost typu musí být nastavena na: SapCloudForCustomerSink Ano
writeBehavior Chování zápisu operace. Může se jednat o vložení, aktualizaci.  Ne. Výchozí "Vložit".
writeBatchSize Velikost dávky operace zápisu. Velikost dávky, která dosáhne nejlepšího výkonu, se může lišit pro různé tabulky nebo server. Ne. Výchozí hodnota 10. 
 maxConcurrent Připojení ions Horní limit souběžných připojení vytvořených k úložišti dat během spuštění aktivity. Zadejte hodnotu pouze v případech, kdy chcete omezit souběžná připojení.  Ne

Příklad:

"activities":[
    {
        "name": "CopyToSapC4c",
        "type": "Copy",
        "inputs": [{
            "type": "DatasetReference",
            "referenceName": "<dataset type>"
        }],
        "outputs": [{
            "type": "DatasetReference",
            "referenceName": "SapC4cDataset"
        }],
        "typeProperties": {
            "source": {
                "type": "<source type>"
            },
            "sink": {
                "type": "SapCloudForCustomerSink",
                "writeBehavior": "Insert",
                "writeBatchSize": 30
            },
            "parallelCopies": 10,
            "dataIntegrationUnits": 4,
            "enableSkipIncompatibleRow": true,
            "redirectIncompatibleRowSettings": {
                "linkedServiceName": {
                    "referenceName": "ErrorLogBlobLinkedService",
                    "type": "LinkedServiceReference"
                },
                "path": "incompatiblerows"
            }
        }
    }
]

Mapování datových typů pro SAP Cloud for Customer

Při kopírování dat ze sap Cloudu pro zákazníka se následující mapování používají z datového typu SAP Cloud for Customer k internímu použití datových typů v rámci služby. Informace o tom, jak aktivita kopírování mapuje zdrojové schéma a datový typ na jímku, najdete v mapování schématu schématu a datového typu schématu schématu a datového typu.

Datový typ SAP C4C OData Dočasný datový typ služby
Edm.Binary Bajt[]
Edm.Boolean Bool
Edm.Byte Bajt[]
Edm.DateTime DateTime
Edm.Decimal Desetinné číslo
Edm.Double Hodnota s dvojitou přesností
Edm.Single Jeden
Edm.Guid Identifikátor guid
Edm.Int16 Int16
Edm.Int32 Int32
Edm.Int64 Int64
Edm.SByte Int16
Edm.String String
Edm.Time TimeSpan
Edm.DateTimeOffset DateTimeOffset

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.