Kopírování dat z DB2 pomocí Azure Data Factory nebo Synapse Analytics

VZTAHUJE SE NA: Azure Data Factory Azure Synapse Analytics

Tip

Data Factory v Microsoft Fabric je nová generace Azure Data Factory s jednodušší architekturou, integrovanou AI a novými funkcemi. Pokud s integrací dat začínáte, začněte Fabric Data Factory. Stávající úlohy ADF lze upgradovat na Fabric pro přístup k novým funkcím v oblastech datové vědy, analýz v reálném čase a vytváření sestav.

• Začněte bezplatnou zkušební verzi Fabric.
• Upgrade z Azure Data Factory na Data Factory v Microsoft Fabric.

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 DB2. Vychází z článku přehled kopírovací aktivita, který představuje obecný přehled kopírovací aktivity.

Note

Tento konektor je také k dispozici ve službě Data Factory v Microsoft Fabric. Informace o konfiguraci a funkcích specifických pro Fabric najdete v dokumentaci ke konektoru Fabric IBM DB2.

Podporované funkce

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

Podporované funkce	IR
aktivita Copy (zdroj/-)	(1) (2)
Vyhledávací aktivita	(1) (2)

(1) Azure Integration Runtime (2) Lokálně hostované 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 DB2 podporuje následující platformy a verze IBM DB2 s distribuovanou architekturou relační databáze (DRDA) SQL Access Manager (SQLAM) verze 9, 10 a 11. Využívá protokol DDM/DRDA.

• IBM DB2 pro z/OS 12.1
• IBM DB2 pro z/OS 11.1
• IBM DB2 pro i 7.3
• IBM DB2 pro i 7.2
• IBM DB2 pro i 7.1
• IBM DB2 pro LUW 11
• IBM DB2 pro LUW 10.5
• IBM DB2 pro LUW 10.1

Požadavky

Pokud se vaše úložiště dat nachází uvnitř místní sítě, Azure virtuální sítě, nebo Amazon Virtual Private Cloud, musíte pro připojení nakonfigurovat self-hosted Integration Runtime.

Pokud je vaše úložiště dat spravovanou cloudovou datovou službou, můžete použít Azure Integration Runtime. Pokud je přístup omezený na IP adresy schválené v pravidlech brány firewall, můžete do seznamu povolených přidat ip adresy Azure Integration Runtime.

Funkci managed virtual network Integration Runtime můžete také použít v Azure Data Factory pro přístup k místní síti bez nutnosti instalace a konfigurace místního prostředí Integration Runtime.

Další informace o mechanismech zabezpečení sítě a možnostech podporovaných službou Data Factory najdete v tématu Strategie přístupu k datům.

Integration Runtime poskytuje integrovaný ovladač DB2, takže při kopírování dat z DB2 nemusíte ručně instalovat žádný ovladač.

Začínáme

K provedení aktivity kopírování pomocí datového kanálu můžete použít jeden z následujících nástrojů nebo sad SDK:

• Nástroj pro kopírování dat
• portál Azure
• .NET SDK
• Python SDK
• Azure PowerShell
• REST API
• šablona Azure Resource Manager

Vytvoření propojené služby s DB2 pomocí uživatelského rozhraní

Pomocí následujícího postupu vytvořte propojenou službu db2 v uživatelském rozhraní portálu Azure.

1. Přejděte na kartu Spravovat v pracovním prostoru Azure Data Factory nebo Synapse a vyberte Propojené služby a potom klikněte na Nový:

   Azure Data Factory

   

   Azure Synapse

   

2. Vyhledejte db2 a vyberte konektor DB2.

   

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

Vlastnosti propojené služby

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

Vlastnost	Popis	Povinné
typ	Vlastnost typu musí být nastavena na: Db2.	Ano
připojovací řetězec	Zadejte informace potřebné pro připojení k instanci DB2. Můžete také vložit heslo do Azure Key Vault a oddělit konfiguraci password z připojovacího řetězce. Podrobnosti naleznete v následujících ukázkách a v článku o uložení přihlašovacích údajů do Azure Key Vault.	Ano
connectVia	Integration Runtime pro připojení k úložišti dat. Další informace najdete v části Požadavky . Pokud není zadaný, použije výchozí Azure Integration Runtime.	Ne

Typické vlastnosti uvnitř připojovací řetězec:

Vlastnost	Popis	Povinné
server	Název serveru DB2. Číslo portu můžete zadat za názvem serveru odděleným dvojtečku, například server:port. Konektor DB2 využívá protokol DDM/DRDA a ve výchozím nastavení používá port 50000, pokud není zadaný. Port, který používá vaše konkrétní databáze DB2, se může lišit v závislosti na verzi a nastavení, například pro LUW DB2 je výchozí port 50000, pro AS400 je výchozí port 446 nebo 448, pokud je povolený protokol TLS. Informace o tom, jak se port konfiguruje obvykle, najdete v následujících dokumentech DB2 z/OS, DB2 iSeries a DB2 LUW.	Ano
databáze	Název databáze DB2.	Ano
typ autentizace	Typ ověřování sloužící k připojení k databázi DB2. Povolená hodnota je: Basic.	Ano
uživatelské jméno	Zadejte uživatelské jméno pro připojení k databázi DB2.	Ano
heslo	Zadejte heslo pro uživatelský účet, který jste zadali pro uživatelské jméno. Označte toto pole jako SecureString pro jeho bezpečné uložení, nebo odkazujte na tajemství uložené v Azure Key Vault.	Ano
sbírka balíčků	Určete, kde se požadované balíčky automaticky vytvářejí službou při dotazování databáze. Pokud toto nastavení není nastavené, služba jako výchozí hodnotu použije {username}.	Ne
certificateSpolečnýNázev	Pokud používáte šifrování SSL (Secure Sockets Layer) nebo TLS (Transport Layer Security), musíte zadat hodnotu pro běžný název certifikátu.	Ne

Tip

Pokud se zobrazí chybová zpráva s informacemi The package corresponding to an SQL statement execution request was not found. SQLSTATE=51002 SQLCODE=-805, je to proto, že potřebný balíček pro uživatele není vytvořen. Ve výchozím nastavení se služba pokusí vytvořit balíček v kolekci s názvem uživatel, který jste použili pro připojení k databázi DB2. Zadejte vlastnost kolekce balíčků, která určuje, kde má služba při dotazování databáze vytvořit potřebné balíčky. Pokud nemůžete určit název kolekce balíčků, zkuste nastavit packageCollection=NULLID.

Příklad:

{
    "name": "Db2LinkedService",
    "properties": {
        "type": "Db2",
        "typeProperties": {
            "connectionString": "server=<server:port>;database=<database>;authenticationType=Basic;username=<username>;password=<password>;packageCollection=<packagecollection>;certificateCommonName=<certname>;"
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

Example: uložení hesla do Azure Key Vault

{
    "name": "Db2LinkedService",
    "properties": {
        "type": "Db2",
        "typeProperties": {
            "connectionString": "server=<server:port>;database=<database>;authenticationType=Basic;username=<username>;packageCollection=<packagecollection>;certificateCommonName=<certname>;",
            "password": { 
                "type": "AzureKeyVaultSecret", 
                "store": { 
                    "referenceName": "<Azure Key Vault linked service name>", 
                    "type": "LinkedServiceReference" 
                }, 
                "secretName": "<secretName>" 
            }
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

Pokud jste používali propojenou službu DB2 s následující datovou částí, je stále podporována tak, jak je, zatímco se doporučuje, abyste v budoucnu používali novou službu.

Předchozí datová část:

{
    "name": "Db2LinkedService",
    "properties": {
        "type": "Db2",
        "typeProperties": {
            "server": "<servername:port>",
            "database": "<dbname>",
            "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 DB2.

Pokud chcete kopírovat data z DATABÁZE2, podporují se následující vlastnosti:

Vlastnost	Popis	Povinné
typ	Vlastnost typu datové sady musí být nastavená na: Db2Table.	Ano
schéma	Název schématu	Ne (pokud je zadán dotaz ve zdroji aktivity)
tabulka	Název tabulky.	Ne (pokud je zadán dotaz ve zdroji aktivity)
tableName	Název tabulky se schématem Tato vlastnost je podporována pro zpětnou kompatibilitu. Používejte schema a table pro nové úlohy.	Ne (pokud je zadán dotaz ve zdroji aktivity)

Příklad

{
    "name": "DB2Dataset",
    "properties":
    {
        "type": "Db2Table",
        "typeProperties": {},
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<DB2 linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

Pokud jste používali RelationalTable typovanou datovou sadu, je stále podporovaná tak, jak je, ale doporučuje se používat novou datovou sadu.

Vlastnosti kopírovací aktivity

Ú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 DB2.

DB2 jako zdroj

Pro kopírování dat z DB2 jsou v části zdroj aktivity kopírování podporovány následující vlastnosti:

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

Příklad:

"activities":[
    {
        "name": "CopyFromDB2",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<DB2 input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "Db2Source",
                "query": "SELECT * FROM \"DB2ADMIN\".\"Customers\""
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

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

Mapování datových typů pro DB2

Při kopírování dat z DB2 se následující mapování používají z datových typů DB2 na dočasné datové typy používané interně v rámci služby. Podívejte se na mapování schématu a datového typu, kde zjistíte, jak aktivita kopírování mapuje zdrojové schéma a datový typ na cílové úložiště.

Typ databáze DB2	Interimní datový typ služby
BigInt	Int64
Binární	Bajt[]
Blob	Bajt[]
Char	Řetězec
Clob	Řetězec
Datum	Datum a čas
DB2DynArray	Řetězec
DbClob	Řetězec
Desetinné číslo	Desetinné číslo
DecimalFloat	Desetinné číslo
Dvojitá	Dvojitá
Float	Dvojitá
Grafika	Řetězec
Celé číslo	Int32
LongVarBinary	Bajt[]
LongVarChar	Řetězec
LongVarGraphic	Řetězec
Číselný	Desetinné číslo
real	Jeden
SmallInt	Int16
Čas	TimeSpan
Časové razítko	DatumČas
VarBinary	Bajt[]
VarChar	Řetězec
VarGraphic	Řetězec
XML	Bajt[]

Vlastnosti aktivity Lookup

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

Související obsah

Pro seznam úložišť dat podporovaných jako zdroje a výstupy kopírovací aktivitou, vizte podporovaná úložiště dat.