Kopírování dat ze SAP HANA pomocí Azure Data Factory nebo Synapse Analytics

PLATÍ PRO: Azure Data Factory Azure Synapse Analytics

Tento článek popisuje, jak pomocí aktivity kopírování v kanálech Azure Data Factory a Synapse Analytics kopírovat data z databáze SAP HANA. 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 SAP HANA 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 aktivitou kopírování najdete v tabulce Podporované úložiště dat.

Konkrétně tento konektor SAP HANA podporuje:

• Kopírování dat z libovolné verze databáze SAP HANA
• Kopírování dat z informačních modelů HANA (například zobrazení analýzy a výpočtů) a tabulek řádků a sloupců
• Kopírování dat pomocí základního ověřování nebo ověřování systému Windows
• Paralelní kopírování ze zdroje SAP HANA Podrobnosti najdete v části Paralelní kopírování ze sap HANA .

Požadavky

Pokud chcete použít tento konektor SAP HANA, musíte:

• Nastavte místní prostředí Integration Runtime. Podrobnosti najdete v článku o místním prostředí Integration Runtime .
• Nainstalujte ovladač SAP HANA ODBC na počítač s prostředím Integration Runtime. Ovladač SAP HANA ODBC si můžete stáhnout z webu SAP Software Download Center. Vyhledejte klíčové slovo SAP HANA CLIENT pro Windows.

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 pro SAP HANA pomocí uživatelského rozhraní

Pomocí následujícího postupu vytvořte propojenou službu se SAP HANA 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 SAP a vyberte konektor SAP HANA.

   

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é slouží k definování entit služby Data Factory specifických pro konektor SAP HANA.

Vlastnosti propojené služby

Propojená služba SAP HANA podporuje následující vlastnosti:

Příklad: Použití základního ověřování

{
    "name": "SapHanaLinkedService",
    "properties": {
        "type": "SapHana",
        "typeProperties": {
            "connectionString": "SERVERNODE=<server>:<port (optional)>;UID=<userName>;PWD=<Password>"
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

Příklad: Použití ověřování systému Windows

{
    "name": "SapHanaLinkedService",
    "properties": {
        "type": "SapHana",
        "typeProperties": {
            "connectionString": "SERVERNODE=<server>:<port (optional)>;",
            "userName": "<username>", 
            "password": { 
                "type": "SecureString", 
                "value": "<password>" 
            } 
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

Pokud jste používali propojenou službu SAP HANA s následující datovou částí, je stále podporovaná tak, jak je, zatímco se navrhuje, abyste mohli použít novou.

Příklad:

{
    "name": "SapHanaLinkedService",
    "properties": {
        "type": "SapHana",
        "typeProperties": {
            "server": "<server>:<port (optional)>",
            "authenticationType": "Basic",
            "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 datovou sadou SAP HANA.

Pokud chcete kopírovat data ze SAP HANA, podporují se následující vlastnosti:

Příklad:

{
    "name": "SAPHANADataset",
    "properties": {
        "type": "SapHanaTable",
        "typeProperties": {
            "schema": "<schema name>",
            "table": "<table name>"
        },
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<SAP HANA linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

Pokud jste používali RelationalTable zadaná datová sada, je stále podporovaná tak, jak je, zatímco se navrhuje, abyste mohli použít novou datovou sadu.

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 SAP HANA.

SAP HANA jako zdroj

Pokud chcete kopírovat data ze SAP HANA, podporují se v části zdroje aktivity kopírování následující vlastnosti:

Příklad:

"activities":[
    {
        "name": "CopyFromSAPHANA",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<SAP HANA input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "SapHanaSource",
                "query": "<SQL query for SAP HANA>"
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

Pokud jste používali RelationalSource typovaný zdroj kopírování, je stále podporovaný tak, jak je, zatímco se navrhuje používat nový zdroj.

Paralelní kopírování ze SAP HANA

Konektor SAP HANA poskytuje integrované dělení dat pro paralelní kopírování dat ze SAP HANA. Možnosti dělení dat najdete v tabulce Zdroj aktivity kopírování.

Když povolíte dělené kopírování, služba spustí paralelní dotazy na zdroj SAP HANA, aby načetla data podle oddílů. Paralelní stupeň se řídí parallelCopies nastavením aktivity kopírování. Pokud například nastavíte parallelCopies hodnotu čtyři, služba současně vygeneruje a spouští čtyři dotazy na základě zadané možnosti a nastavení oddílu a každý dotaz načte část dat z vaší SAP HANA.

Doporučujeme povolit paralelní kopírování s dělením dat, zejména pokud ingestujete velké množství dat ze sap HANA. Následující konfigurace jsou navržené pro různé scénáře. Při kopírování dat do souborového úložiště dat se doporučuje zapisovat do složky jako více souborů (zadat pouze název složky), v takovém případě je výkon lepší než zápis do jednoho souboru.

Příklad: Dotaz s fyzickými oddíly tabulky

"source": {
    "type": "SapHanaSource",
    "partitionOption": "PhysicalPartitionsOfTable"
}

Příklad: Dotaz s oddílem dynamického rozsahu

"source": {
    "type": "SapHanaSource",
    "query": "SELECT * FROM <TABLENAME> WHERE ?AdfHanaDynamicRangePartitionCondition AND <your_additional_where_clause>",
    "partitionOption": "SapHanaDynamicRange",
    "partitionSettings": {
        "partitionColumnName": "<Partition_column_name>"
    }
}

Mapování datových typů pro SAP HANA

Při kopírování dat ze SAP HANA se následující mapování používají z datových typů SAP HANA k dočasným datovým typům používaným interně 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.

Jímka SAP HANA

Konektor SAP HANA se v současné době nepodporuje jako jímka, zatímco k zápisu dat do SAP HANA můžete použít obecný konektor ODBC s ovladačem SAP HANA.

Postupujte podle požadavků a nejprve nastavte místní prostředí Integration Runtime a nainstalujte ovladač SAP HANA ODBC. Vytvořte propojenou službu ODBC pro připojení k úložišti dat SAP HANA, jak je znázorněno v následujícím příkladu, a pak vytvořte datovou sadu a jímku aktivity kopírování s typem ODBC. Další informace najdete v článku o konektoru ODBC.

{
    "name": "SAPHANAViaODBCLinkedService",
    "properties": {
        "type": "Odbc",
        "typeProperties": {
            "connectionString": "Driver={HDBODBC};servernode=<HANA server>.clouddatahub-int.net:30015",
            "authenticationType": "Basic",
            "userName": "<username>",
            "password": {
                "type": "SecureString",
                "value": "<password>"
            }
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

Vlastnosti aktivity vyhledávání

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

Související obsah

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