Adatok másolása a MariaDB-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 MariaDB-ből az Azure Data Factory vagy a Synapse Analytics-folyamat 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 MariaDB-összekötő a következő képességeket támogatja:

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

(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/fogadóként támogatott adattárak listáját a Támogatott adattárak táblában találja.

A szolgáltatás egy beépített illesztőprogramot biztosít a kapcsolat engedélyezéséhez, ezért nem kell manuálisan telepítenie egyetlen illesztőprogramot sem ezzel az összekötővel.

Ez az összekötő jelenleg a 10.x, 11.x verziójú MariaDB-t támogatja az ajánlott új 2-es és 10.0-10.5-ös verzióban az örökölt illesztőprogram-verzióhoz.

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.

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
• Az Azure Portal
• A .NET SDK
• A Python SDK
• Azure PowerShell
• A REST API
• Az Azure Resource Manager-sablon

Társított szolgáltatás létrehozása a MariaDB-hez felhasználói felületen

Az alábbi lépésekkel létrehozhat egy társított szolgáltatást a MariaDB-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 Maria-t, és válassza ki a MariaDB-ö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 MariaDB-ö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

Ha az ajánlott illesztőprogram-verziót használja, a MariaDB társított szolgáltatás esetében a következő tulajdonságok támogatottak:

Tulajdonság	Leírás	Kötelező
típus	A típustulajdonságnak a következőnek kell lennie: MariaDB	Igen
driverVersion	Az illesztőprogram verziója az ajánlott illesztőprogram-verzió kiválasztásakor. Az érték v2.	Igen
kiszolgáló	A MariaDB-kiszolgáló neve.	Igen
kikötő	A MariaDB-kiszolgálóhoz való csatlakozáshoz használt portszám.	Nem
adatbázis	A MariaDB-adatbázis neve.	Igen
username	Az Ön felhasználóneve.	Igen
jelszó	A felhasználónév jelszava. Jelölje meg ezt a mezőt SecureStringként a biztonságos tároláshoz. Hivatkozhat az Azure Key Vaultban tárolt titkos kódokra is.	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

Példa:

{
    "name": "MariaDBLinkedService",
    "properties": {
        "type": "MariaDB",
        "typeProperties": {
            "server": "<server>",
            "port": "<port>",
            "database": "<database>",
            "username": "<username>",
            "password": {
                "type": "SecureString",
                "value": "<password>"
            },
            "driverVersion": "v2"
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

Példa: jelszó tárolása az Azure Key Vaultban

{
    "name": "MariaDBLinkedService",
    "properties": {
        "type": "MariaDB",
        "typeProperties": {
            "server": "<server>",
            "port": "<port>",
            "database": "<database>",
            "username": "<username>",
            "password": {
                "type": "AzureKeyVaultSecret",
                "store": {
                    "referenceName": "<Azure Key Vault linked service name>",
                    "type": "LinkedServiceReference"
                },
                "secretName": "<secretName>"
            },
            "driverVersion": "v2"
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

Ha az örökölt illesztőprogram-verziót használja, a következő tulajdonságok támogatottak:

Tulajdonság	Leírás	Kötelező
típus	A típustulajdonságnak a következőnek kell lennie: MariaDB	Igen
connectionString	Egy ODBC kapcsolati sztring a MariaDB-hez való csatlakozáshoz. Jelszót is elhelyezhet az Azure Key Vaultban, és lekérheti a pwd 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

Példa:

{
    "name": "MariaDBLinkedService",
    "properties": {
        "type": "MariaDB",
        "typeProperties": {
            "connectionString": "Server=<host>;Port=<port>;Database=<database>;UID=<user name>;PWD=<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 MariaDB-adatkészlet által támogatott tulajdonságok listáját tartalmazza.

Ha adatokat szeretne másolni a MariaDB-ből, állítsa be az adathalmaz típustulajdonságát MariaDBTable értékre. Ebben az adatkészlettípusban nincs további típusspecifikus tulajdonság.

Példa

{
    "name": "MariaDBDataset",
    "properties": {
        "type": "MariaDBTable",
        "typeProperties": {},
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<MariaDB linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

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

MariaDB mint forrás

Ha adatokat szeretne másolni a MariaDB-ből, állítsa be a másolási tevékenység forrástípusát MariaDBSource-ra. A másolási tevékenység forrás szakaszában a következő tulajdonságok támogatottak:

Tulajdonság	Leírás	Kötelező
típus	A másolási tevékenység forrásának típustulajdonságának a következőnek kell lennie: MariaDBSource	Igen
Lekérdezés	Az adatok olvasásához használja az egyéni SQL-lekérdezést. Például: "SELECT * FROM MyTable"	Nem (ha "tableName" van megadva az adathalmazban)

Példa:

"activities":[
    {
        "name": "CopyFromMariaDB",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<MariaDB input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "MariaDBSource",
                "query": "SELECT * FROM MyTable"
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

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

Ha adatokat másol a MariaDB-ből, a rendszer a következő leképezéseket használja a MariaDB-adattípusokból a szolgáltatás által belsőleg 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.

MariaDB-adattípus	Köztes szolgáltatás adattípusa	Köztes szolgáltatás adattípusa (az örökölt illesztőprogram-verzióhoz)
bigint	Int64	Int64
bigint unsigned	Decimal	Decimal
bit(1)	UInt64	Boolean
bit(M), M>1	UInt64	Byte[]
blob	Byte[]	Byte[]
bool	Boolean (Ha TreatTinyAsBoolean=false, akkor a rendszer a következőképpen van leképezve SByte: . TreatTinyAsBoolean alapértelmezés szerint igaz )	Int16
char	String	String
date	Datetime	Datetime
datetime	Datetime	Datetime
decimal	Decimal	Decimal, String
double	Double	Double
double precision	Double	Double
enum	String	String
float	Single	Single
int	Int32	Int32
int unsigned	Int64	Int64
integer	Int32	Int32
integer unsigned	Int64	Int64
JSON	String	-
long varbinary	Byte[]	Byte[]
long varchar	String	String
longblob	Byte[]	Byte[]
longtext	String	String
mediumblob	Byte[]	Byte[]
mediumint	Int32	Int32
mediumint unsigned	Int64	Int64
mediumtext	String	String
numeric	Decimal	Decimal
real	Double	Double
set	String	String
smallint	Int16	Int16
smallint unsigned	Int32	Int32
text	String	String
time	TimeSpan	TimeSpan
timestamp	Datetime	Datetime
tinyblob	Byte[]	Byte[]
tinyint	SByte	Int16
tinyint unsigned	Int16	Int16
tinytext	String	String
varchar	String	String
year	Int	Int

Keresési tevékenység tulajdonságai

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

A MariaDB-illesztőprogram verziójának frissítése

Az alábbi lépések segítenek a MariaDB-illesztőprogram verziójának frissítésében:

1. A Csatolt szolgáltatás szerkesztése lapon válassza az Ajánlott lehetőséget az Illesztőprogram verzió alatt, és konfigurálja a társított szolgáltatást a csatolt szolgáltatás tulajdonságaira hivatkozva.

2. A legújabb MariaDB társított szolgáltatás adattípus-leképezése eltér az örökölt verzióétól. A legújabb adattípus-megfeleltetés megismeréséhez tekintse meg a MariaDB adattípus-leképezését.

3. A legújabb 2-es verziójú illesztőprogram több MariaDB-verziót támogat. További információ: Támogatott képességek.

Különbségek a MariaDB és az örökölt illesztőprogram-verzió használata között

Az alábbi táblázat a MariaDB-összekötő adattípus-leképezési különbségeit mutatja be az ajánlott illesztőprogram-verzió és az örökölt illesztőprogram-verzió használatával.

MariaDB-adattípus	Köztes szolgáltatás adattípusa (az ajánlott illesztőprogram-verzió használatával)	Köztes szolgáltatás adattípusa (az örökölt illesztőprogram-verzió használatával)
bit(1)	UInt64	Logikai
bit(M), M>1	UInt64	Bájt[]
logikai	Logikai	Int16
JSON	Sztring	Bájt[]

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.