Adatok másolása ODBC-adattárakba az Azure Data Factory vagy a Synapse Analytics használatával

Cikk
11/16/2023

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 az Azure Data Factory másolási tevékenységével egy ODBC-adattárból és egy ODBC-adattárba. 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 az ODBC-összekötő a következő képességeket támogatja:

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

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

A forrásként/fogadóként támogatott adattárak listáját a Támogatott adattárak táblában találja.

Ez az ODBC-összekötő támogatja az adatok másolását bármely ODBC-kompatibilis adattárba alapszintű vagy névtelen hitelesítéssel. 64 bites ODBC-illesztő szükséges. Az ODBC-fogadó esetében a szolgáltatás támogatja az ODBC 2.0-s verzióját.

Előfeltételek

Az ODBC-összekötő használatához a következőkre van szükség:

Saját üzemeltetésű integrációs modul beállítása. A részletekért tekintse meg a saját üzemeltetésű integrációs modulról szóló cikket.
Telepítse az adattár 64 bites ODBC-illesztőprogramját az integrációs futtatókörnyezeti gépen.

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:

Társított szolgáltatás létrehozása ODBC-adattárhoz felhasználói felületen

Az alábbi lépésekkel létrehozhat egy társított szolgáltatást egy ODBC-adattárhoz az Azure Portal felhasználói felületén.

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
Keresse meg az ODBC-t, és válassza ki az ODBC-összekötőt.
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

Az alábbi szakaszok az ODBC-ö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

Az ODBC 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őre kell állítania: Odbc	Igen
connectionString	A kapcsolati sztring a hitelesítő adatok kivételével. Megadhatja a kapcsolati sztring például `Driver={SQL Server};Server=Server.database.windows.net; Database=TestDatabase;`mintával, vagy használhatja azt a rendszer DSN-t (adatforrásnevet), amellyel `DSN=<name of the DSN on IR machine>;` az integrációs futtatókörnyezeti gépen beállította (ennek megfelelően meg kell adnia a hitelesítő adatokat a társított szolgáltatásban). 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 Azure Key Vaultban tárolt hitelesítő adatokat.	Igen
authenticationType	Az ODBC-adattárhoz való csatlakozáshoz használt hitelesítés típusa. Az engedélyezett értékek a következők: Alapszintű és Névtelen.	Igen
Felhasználónév	Adja meg a felhasználónevet, ha alapszintű hitelesítést használ.	Nem
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.	Nem
hitelesítő adat	Az illesztőprogram-specifikus tulajdonság-érték formátumban megadott kapcsolati sztring hozzáférési hitelesítő adatrésze. Example: `"RefreshToken=<secret refresh token>;"`. Jelölje meg ezt a mezőt SecureStringként.	Nem
connectVia	Az adattárhoz való csatlakozáshoz használandó integrációs modul . Az előfeltételekben leírtaknak megfelelően szükség van egy saját üzemeltetésű integrációs modulra.	Igen

1. példa: alapszintű hitelesítés használata

{
    "name": "ODBCLinkedService",
    "properties": {
        "type": "Odbc",
        "typeProperties": {
            "connectionString": "<connection string>",
            "authenticationType": "Basic",
            "userName": "<username>",
            "password": {
                "type": "SecureString",
                "value": "<password>"
            }
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

2. példa: névtelen hitelesítés használata

{
    "name": "ODBCLinkedService",
    "properties": {
        "type": "Odbc",
        "typeProperties": {
            "connectionString": "<connection string>",
            "authenticationType": "Anonymous",
            "credential": {
                "type": "SecureString",
                "value": "RefreshToken=<secret refresh token>;"
            }
        },
        "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 az ODBC-adatkészlet által támogatott tulajdonságok listáját tartalmazza.

Az ODBC-kompatibilis adattárból/odbc-kompatibilis adattárba 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: OdbcTable	Igen
tableName	A tábla neve az ODBC-adattárban.	Nem a forrás (ha a tevékenység forrásában "lekérdezés" van megadva); Igen a fogadóhoz

Példa

{
    "name": "ODBCDataset",
    "properties": {
        "type": "OdbcTable",
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<ODBC linked service name>",
            "type": "LinkedServiceReference"
        },
        "typeProperties": {
            "tableName": "<table name>"
        }
    }
}

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 az ODBC-forrás által támogatott tulajdonságok listáját tartalmazza.

ODBC forrásként

Ha ODBC-kompatibilis adattárból szeretne adatokat másolni, 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: OdbcSource	Igen
Lekérdezés	Az adatok olvasásához használja az egyéni SQL-lekérdezést. For example: `"SELECT * FROM MyTable"`.	Nem (ha "tableName" van megadva az adathalmazban)

Példa

"activities":[
    {
        "name": "CopyFromODBC",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<ODBC input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "OdbcSource",
                "query": "SELECT * FROM MyTable"
            },
            "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.

ODBC mint fogadó

Ha odbc-kompatibilis adattárba szeretne adatokat másolni, állítsa be a fogadó típusát a másolási tevékenységben az OdbcSinkre. A másolási tevékenység fogadó szakasza a következő tulajdonságokat támogatja:

Property	Leírás	Required
típus	A másolási tevékenység fogadójának típustulajdonságának a következőnek kell lennie: OdbcSink	Igen
writeBatchTimeout	Várakozási idő, amíg a kötegbeszúrási művelet befejeződik, mielőtt túllépi az időkorlátot. Az engedélyezett értékek a következők: időbélyeg. Példa: "00:30:00" (30 perc).	Nem
writeBatchSize	Adatokat szúr be az SQL-táblába, amikor a puffer mérete eléri a writeBatchSize értéket. Az engedélyezett értékek a következők: egész szám (sorok száma).	Nem (az alapértelmezett érték 0 – automatikusan észlelhető)
preCopyScript	Adjon meg egy SQL-lekérdezést a másolási tevékenységhez, mielőtt adatokat írna az adattárba minden futtatás során. Ezzel a tulajdonságkal törölheti az előre betöltött adatokat.	Nem

Megjegyzés:

A "writeBatchSize" esetében, ha nincs beállítva (automatikusan észlelve), a másolási tevékenység először észleli, hogy az illesztőprogram támogatja-e a kötegműveleteket, és 10000-re állítja, ha igen, vagy állítsa 1-re, ha nem. Ha nem 0 értéket állít be, a másolási tevékenység tiszteletben tartja az értéket, és futásidőben meghiúsul, ha az illesztőprogram nem támogatja a kötegműveleteket.

Példa

"activities":[
    {
        "name": "CopyToODBC",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<ODBC output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "<source type>"
            },
            "sink": {
                "type": "OdbcSink",
                "writeBatchSize": 100000
            }
        }
    }
]

Keresési tevékenység tulajdonságai

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

Troubleshoot connectivity issues

A csatlakozási problémák elhárításához használja az Integration Runtime Configuration Manager Diagnosztikai lapját.

Indítsa el az Integration Runtime Configuration Managert.
Váltson a Diagnosztika lapra.
A "Tesztelés Csatlakozás ion" szakaszban válassza ki az adattár típusát (társított szolgáltatás).
Adja meg az adattárhoz való csatlakozáshoz használt kapcsolati sztring, válassza ki a hitelesítést, és adja meg a felhasználónevet, a jelszót és/vagy a hitelesítő adatokat.
Kattintson a Kapcsolat tesztelése gombra az adattárhoz való kapcsolat teszteléséhez.

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.

Adatok másolása ODBC-adattárakba az Azure Data Factory vagy a Synapse Analytics használatával

Támogatott képességek

Előfeltételek

Első lépések

Társított szolgáltatás létrehozása ODBC-adattárhoz felhasználói felületen

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

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

Adathalmaz tulajdonságai

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

ODBC forrásként

ODBC mint fogadó

Keresési tevékenység tulajdonságai

Troubleshoot connectivity issues

Kapcsolódó tartalom

További források