Adatok másolása a DB2-ből az Azure Data Factory vagy a Synapse Analytics használatával

A következőkre vonatkozik: Azure Data Factory Azure Synapse Analytics

Tipp.

Próbálja ki a Data Factoryt a Microsoft Fabricben, amely egy teljes körű elemzési megoldás a nagyvállalatok számára. A Microsoft Fabric az adattovábbítástól az adatelemzésig, a valós idejű elemzésig, az üzleti intelligenciáig és a jelentéskészítésig mindent lefed. Ismerje meg, hogyan indíthat új próbaverziót ingyenesen!

Ez a cikk azt ismerteti, hogyan másolhat adatokat a DB2-adatbázisokból az Azure Data Factory és a Synapse Analytics-folyamatok másolási tevékenységével. A másolási tevékenység áttekintési cikkére épül, amely a másolási tevékenység általános áttekintését mutatja be.

Támogatott képességek

Ez a DB2-összekötő a következő képességekhez támogatott:

Támogatott képességek	IR
Copy tevékenység (forrás/-)	① ②
Keresési tevékenység	① ②

(1) Azure-integrációs modul (2) Saját üzemeltetésű integrációs modul

A másolási tevékenység által forrásként vagy fogadóként támogatott adattárak listáját a Támogatott adattárak táblában találja.

Ez a DB2-összekötő az alábbi IBM DB2-platformokat és -verziókat támogatja az Elosztott relációs adatbázis-architektúra (DRDA) SQL Access Manager (SQLAM) 9-es, 10-es és 11-es verziójával. A DDM/DRDA protokollt használja.

• IBM DB2 for z/OS 12.1
• IBM DB2 for z/OS 11.1
• IBM DB2 i 7.3-hoz
• IBM DB2 i 7.2-hez
• IBM DB2 i 7.1-hez
• IBM DB2 a LUW 11-hez
• IBM DB2 a LUW 10.5-höz
• IBM DB2 a LUW 10.1-hez

Előfeltételek

Ha az adattár helyszíni hálózaton, Azure-beli virtuális hálózaton vagy Amazon Virtual Private Cloudon belül található, konfigurálnia kell egy saját üzemeltetésű integrációs modult a csatlakozáshoz.

Ha az adattár felügyelt felhőalapú adatszolgáltatás, használhatja az Azure Integration Runtime-ot. Ha a hozzáférés a tűzfalszabályokban jóváhagyott IP-címekre korlátozódik, hozzáadhat azure integration runtime IP-eket az engedélyezési listához.

Az Azure Data Factory felügyelt virtuális hálózati integrációs moduljával is elérheti a helyszíni hálózatot anélkül, hogy saját üzemeltetésű integrációs modult telepítene és konfigurálna.

A Data Factory által támogatott hálózati biztonsági mechanizmusokkal és lehetőségekkel kapcsolatos további információkért lásd az adathozzáférési stratégiákat.

Az integrációs modul beépített DB2-illesztőt biztosít, ezért nem kell manuálisan telepítenie az illesztőprogramokat, amikor adatokat másol a DB2-ből.

Első lépések

A Copy tevékenység folyamattal való végrehajtásához használja az alábbi eszközök vagy SDK-k egyikét:

• Az Adatok másolása eszköz
• The Azure portal
• A .NET SDK
• A Python SDK
• Azure PowerShell
• A REST API
• Az Azure Resource Manager-sablon

Csatolt szolgáltatás létrehozása a DB2-hez felhasználói felületen

Az alábbi lépéseket követve hozzon létre csatolt szolgáltatást a DB2-hez az Azure Portal felhasználói felületén.

1. Keresse meg az Azure Data Factory vagy a Synapse-munkaterület Kezelés lapját, és válassza a Társított szolgáltatások lehetőséget, majd kattintson az Új gombra:

   Azure Data Factory

   

   Azure Synapse

   

2. Keresse meg a DB2-t, és válassza ki a DB2-összekötőt.

   

3. Konfigurálja a szolgáltatás részleteit, tesztelje a kapcsolatot, és hozza létre az új társított szolgáltatást.

   

Csatlakozás or konfigurációjának részletei

A következő szakaszok a DB2-összekötőre jellemző Data Factory-entitások meghatározásához használt tulajdonságok részleteit ismertetik.

Társított szolgáltatás tulajdonságai

A DB2 társított szolgáltatás esetében a következő tulajdonságok támogatottak:

Property	Leírás	Required
típus	A típustulajdonságnak a következőnek kell lennie: Db2	Igen
connectionString	Adja meg a DB2-példányhoz való csatlakozáshoz szükséges információkat. Jelszót is elhelyezhet az Azure Key Vaultban, és lekérheti a password konfigurációt a kapcsolati sztring. További részletekért tekintse meg az alábbi példákat és a hitelesítő adatok tárolását az Azure Key Vaultban .	Igen
connectVia	Az adattárhoz való csatlakozáshoz használandó integrációs modul . További információ az Előfeltételek szakaszból. Ha nincs megadva, az alapértelmezett Azure Integration Runtime-t használja.	Nem

A kapcsolati sztring jellemző tulajdonságai:

Property	Leírás	Required
kiszolgáló	A DB2-kiszolgáló neve. Megadhatja a portszámot a kettősponttal tagolt kiszolgálónév alapján, például. server:port A DB2-összekötő a DDM/DRDA protokollt használja, és alapértelmezés szerint az 50000-s portot használja, ha nincs megadva. Az adott DB2-adatbázis által használt port a verziótól és a beállításoktól függően eltérő lehet, például a DB2 LUW esetében az alapértelmezett port 50000, az AS400 esetében az alapértelmezett port a 446-os vagy a 448-as, ha a TLS engedélyezve van. A port konfigurálásáról a következő DB2-dokumentumokban olvashat: DB2 z/OS, DB2 iSeries és DB2 LUW.	Igen
adatbázis	A DB2-adatbázis neve.	Igen
authenticationType	A DB2-adatbázishoz való csatlakozáshoz használt hitelesítés típusa. Az engedélyezett érték: Alapszintű.	Igen
username	Adja meg a DB2-adatbázishoz való csatlakozáshoz használt felhasználónevet.	Igen
jelszó	Adja meg a felhasználónévhez megadott felhasználói fiók jelszavát. Jelölje meg ezt a mezőt SecureStringként, hogy biztonságosan tárolja, vagy hivatkozzon az Azure Key Vaultban tárolt titkos kódra.	Igen
packageCollection	Adja meg, hogy a szolgáltatás hol hozza létre automatikusan a szükséges csomagokat az adatbázis lekérdezése során. Ha ez nincs beállítva, a szolgáltatás a {username} értéket használja alapértelmezett értékként.	Nem
certificateCommonName	A Secure Sockets Layer (SSL) vagy a Transport Layer Security (TLS) titkosítás használatakor meg kell adnia egy általános tanúsítványnevet.	Nem

Tipp.

Ha hibaüzenet jelenik meg, amely azt jelzi The package corresponding to an SQL statement execution request was not found. SQLSTATE=51002 SQLCODE=-805, hogy a szükséges csomag nem jön létre a felhasználó számára. Alapértelmezés szerint a szolgáltatás megpróbálja létrehozni a csomagot a db2-hez való csatlakozáshoz használt felhasználóként elnevezett gyűjtemény alatt. Adja meg azt a csomaggyűjtési tulajdonságot, amely alatt azt jelzi, hogy a szolgáltatás hol hozza létre a szükséges csomagokat az adatbázis lekérdezése során. Ha nem tudja meghatározni a csomaggyűjtemény nevét, próbálkozzon a beállításával packageCollection=NULLID.

Példa

{
    "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élda: jelszó tárolása az Azure Key Vaultban

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

Ha a db2 társított szolgáltatást a következő hasznos adatokkal használta, az továbbra is támogatott, miközben a rendszer azt javasolja, hogy használja az újat.

Korábbi hasznos adatok:

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

Adathalmaz tulajdonságai

Az adathalmazok meghatározásához elérhető szakaszok és tulajdonságok teljes listáját az adathalmazokról szóló cikkben találja. Ez a szakasz a DB2-adathalmaz által támogatott tulajdonságok listáját tartalmazza.

A DB2-ből történő adatmásoláshoz a következő tulajdonságok támogatottak:

Property	Leírás	Required
típus	Az adathalmaz típustulajdonságának a következőnek kell lennie: Db2Table	Igen
schema	A séma neve.	Nem (ha "lekérdezés" van megadva a tevékenységforrásban)
table	A tábla neve.	Nem (ha "lekérdezés" van megadva a tevékenységforrásban)
tableName	A sématáblázat neve. Ez a tulajdonság támogatja a visszamenőleges kompatibilitást. Új számítási feladatok használata és table használataschema.	Nem (ha "lekérdezés" van megadva a tevékenységforrásban)

Példa

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

Ha gépelt adatkészletet használt RelationalTable , az továbbra is támogatott, miközben a rendszer azt javasolja, hogy használja az újat.

Másolási tevékenység tulajdonságai

A tevékenységek meghatározásához elérhető szakaszok és tulajdonságok teljes listáját a Folyamatok című cikkben találja. Ez a szakasz a DB2-forrás által támogatott tulajdonságok listáját tartalmazza.

DB2 forrásként

Az adatok db2-ből való másolásához a másolási tevékenység forrás szakaszában az alábbi tulajdonságok támogatottak:

Property	Leírás	Required
típus	A másolási tevékenység forrásának típustulajdonságának a következőnek kell lennie: Db2Source	Igen
Lekérdezés	Az adatok olvasásához használja az egyéni SQL-lekérdezést. For example: "query": "SELECT * FROM \"DB2ADMIN\".\"Customers\"".	Nem (ha "tableName" van megadva az adathalmazban)

Példa

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

Ha gépelt forrást használt RelationalSource , az továbbra is támogatott, miközben a rendszer azt javasolja, hogy használja az újat.

Adattípus-leképezés a DB2-hez

A DB2-ből való adatmásoláskor a rendszer a következő leképezéseket használja a DB2 adattípusokból a szolgáltatáson belül használt köztes adattípusokra. A séma- és adattípus-leképezések segítségével megtudhatja , hogy a másolási tevékenység hogyan rendeli le a forrásséma és az adattípust a fogadóhoz.

DB2 Adatbázis típusa	Köztes szolgáltatás adattípusa
BigInt	Int64
Bináris	Bájt[]
Blob	Bájt[]
Char	Sztring
Clob	Sztring
Date	Datetime
DB2DynArray	Sztring
DbClob	Sztring
Decimális	Decimális
DecimalFloat	Decimális
Dupla	Dupla
Lebegőpontos értékek	Dupla
Grafikus	Sztring
Egész szám	Int32
LongVarBinary	Bájt[]
LongVarChar	Sztring
LongVarGraphic	Sztring
Numerikus	Decimális
Valós	Egyszeres
SmallInt	Int16
Idő	időtartam
Timestamp	DateTime
VarBinary	Bájt[]
Varchar	Sztring
VarGraphic	Sztring
Xml	Bájt[]

Keresési tevékenység tulajdonságai

A tulajdonságok részleteinek megismeréséhez tekintse meg a keresési tevékenységet.

Kapcsolódó tartalom

A másolási tevékenység által forrásként és fogadóként támogatott adattárak listáját a támogatott adattárakban találja.