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

Článek
12/09/2023

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álech Azure Data Factory a Synapse Analytics kopírovat data z databáze DB2. 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 DB2 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 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ě, virtuální sítě Azure nebo amazonového privátního cloudu, musíte nakonfigurovat místní prostředí Integration Runtime pro připojení k němu.

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 prostředí Azure Integration Runtime.

K přístupu k místní síti bez nutnosti instalace a konfigurace místního prostředí Integration Runtime můžete také použít funkci Runtime integrace spravované virtuální sítě ve službě Azure Data Factory.

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.

Prostředí 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í 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 s DB2 pomocí uživatelského rozhraní

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

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
Vyhledejte db2 a vyberte konektor DB2.
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í účastníci
type	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é zadat heslo do služby Azure Key Vault a vytáhnout `password` konfiguraci z připojovací řetězec. Další podrobnosti najdete v následujících ukázkách a ukládání přihlašovacích údajů 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. Další informace najdete v části Požadavky . Pokud není zadaný, použije výchozí prostředí Azure Integration Runtime.	No

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

Vlastnost	Popis	Povinní účastníci
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
database	Název databáze DB2.	Ano
authenticationType	Typ ověřování sloužící k připojení k databázi DB2. Povolená hodnota je: Basic.	Ano
username	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, abyste ho mohli bezpečně uložit, nebo odkazovat na tajný klíč uložený ve službě Azure Key Vault.	Ano
packageCollection	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}.	No
certificateCommonName	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.	No

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, že důvod je potřebný balíček není pro uživatele 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"
        }
    }
}

Příklad: Uložení hesla ve službě 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 podporovaná tak, jak je, zatímco se navrhuje, abyste použili novou datovou část.

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í účastníci
type	Vlastnost typu datové sady musí být nastavená na: Db2Table.	Ano
schema	Název schématu	Ne (pokud je zadán dotaz ve zdroji aktivity)
table	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 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 DB2.

DB2 jako zdroj

Pokud chcete kopírovat data z DATABÁZE2, podporují se ve zdrojové části aktivity kopírování následující vlastnosti:

Vlastnost	Popis	Povinní účastníci
type	Vlastnost typu zdroje aktivity kopírování musí být nastavena na: Db2Source.	Ano
query	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. 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.

Typ databáze DB2	Dočasný datový typ služby
BigInt	Int64
Binární	Bajt[]
Objekt blob	Bajt[]
Char	String
Clob	Řetězcové
Date	Datum a čas
DB2DynArray	String
DbClob	String
Desetinné číslo	Desetinné číslo
DecimalFloat	Desetinné
Hodnota s dvojitou přesností	Hodnota s dvojitou přesností
Float	Hodnota s dvojitou přesností
Grafický	String
Celé číslo	Int32
LongVarBinary	Bajt[]
LongVarChar	String
LongVarGraphic	String
Číslo	Desetinné číslo
Reálné	Jeden
SmallInt	Int16
Čas	TimeSpan
Časové razítko	DateTime
VarBinary	Bajt[]
VarChar	String
VarGraphic	String
XML	Bajt[]

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.

Sdílet prostřednictvím

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

Podporované funkce

Požadavky

Začínáme

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

Podrobnosti konfigurace konektoru

Vlastnosti propojené služby

Vlastnosti datové sady

Vlastnosti aktivity kopírování

DB2 jako zdroj

Mapování datových typů pro DB2

Vlastnosti aktivity vyhledávání

Váš názor

Další materiály

Sdílet prostřednictvím

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

Podporované funkce

Požadavky

Začínáme

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

Podrobnosti konfigurace konektoru

Vlastnosti propojené služby

Vlastnosti datové sady

Vlastnosti aktivity kopírování

DB2 jako zdroj

Mapování datových typů pro DB2

Vlastnosti aktivity vyhledávání

Související obsah

Váš názor

Další materiály