Adatok átalakítása a SQL Server Tárolt eljárás tevékenység használatával a Azure Data Factory vagy a Synapse Analyticsben

Vonatkozik: Azure Data Factory Azure Synapse Analytics

Tipp.

Data Factory a Microsoft Fabric a Azure Data Factory következő generációja, egyszerűbb architektúrával, beépített AI-vel és új funkciókkal. Ha még nem ismerkedik az adatintegrációval, kezdje a Fabric Data Factoryvel. A meglévő ADF-számítási feladatok frissíthetők Fabric használatával, hogy elérjék az adatkutatás, a valós idejű elemzés és a jelentéskészítés új képességeit.

A Data Factory-ben vagy a Synapse adatcsatornában adatátalakítási tevékenységeket használva alakíthatja át és dolgozhatja fel a nyers adatokat predikciókká és elemzésekké. A tárolt eljárástevékenység az egyik olyan transzformációs tevékenység, amelyet az adatcsatornák támogatnak. Ez a cikk az adatátalakításról szóló cikkre épül, amely általános áttekintést nyújt az adatátalakításról és a támogatott átalakítási tevékenységekről.

Feljegyzés

Ha még nem ismerkedik a Azure Data Factory, olvassa el a Bevezetést Azure Data Factory és a cikk elolvasása előtt végezze el a következő oktatóanyagot: Tutorial: adatátalakítás. A Synapse Analyticsről további információt Az Azure Synapse Analytics című cikkben olvashat.

A Tárolt eljárás tevékenység használatával meghívhat egy tárolt eljárást a vállalat vagy egy Azure virtuális gépen található alábbi adattárak egyikében:

  • Azure SQL Database
  • Azure Synapse Analytics
  • SQL Server adatbázis. Ha SQL Server használ, telepítse a saját üzemeltetésű integrációs modult ugyanazon a gépen, amely az adatbázist üzemelteti, vagy egy külön, az adatbázishoz hozzáféréssel rendelkező gépre. Self-Hosted integration runtime egy olyan összetevő, amely a helyszíni vagy Azure virtuális gépen található adatforrásokat biztonságos és felügyelt módon csatlakoztatja a felhőszolgáltatásokhoz. Részletekért lásd a saját üzemeltetésű integrációs modulról szóló cikket.

Fontos

Amikor adatokat másol az Azure SQL Database-be vagy az SQL Serverbe, a másolási tevékenység során konfigurálhatja a SqlSink-et a sqlWriterStoredProcedureName tulajdonság használatával a tárolt eljárás meghívásához. A tulajdonságról a következő összekötő cikkekben talál további információt: Azure SQL Database, SQL Server. Nem támogatott a tárolt eljárás meghívása az adatok másolása közben egy Azure Synapse Analytics másolási tevékenység használatával. A tárolt eljárástevékenység használatával azonban meghívhat egy tárolt eljárást a Azure Synapse Analytics.

Az adatok Azure SQL Database, SQL Server vagy Azure Synapse Analytics másolásakor konfigurálhatja a SqlSource másolási tevékenységben, hogy egy tárolt eljárást hívjon meg a forrásadatbázis adatainak beolvasásához a sqlReaderStoredProcedureName tulajdonság használatával. Az alábbi csatlakozó cikkek részleteit lásd: Azure SQL Database, SQL Server, Azure Synapse Analytics

Ha a tárolt eljárás kimeneti paraméterekkel rendelkezik, a tárolt eljárástevékenység helyett használjon keresési tevékenységet és szkripttevékenységet. A tárolt eljárástevékenység még nem támogatja a kimeneti paraméterrel rendelkező SP-k meghívását.

Ha tárolt eljárást hív meg a kimeneti paraméterekkel tárolt eljárástevékenység használatával, a következő hiba történik.

A végrehajtás sikertelen az SQL Serveren. Ha további segítségre van szüksége, forduljon SQL Server csapatához. SQL-hibaszám: 201. Hibaüzenet: Az "sp_name" eljárás vagy függvény a "@output_param_name" paramétert várja, amely nem lett megadva.

Tárolt eljárás létrehozása felhasználói felülettel

Ha tárolt eljárás tevékenységet szeretne használni egy folyamatban, hajtsa végre a következő lépéseket:

  1. Keresse meg a tárolt eljárást a folyamattevékenységek panelen, és húzzon egy Tárolt eljárás tevékenységet a folyamatvászonra.

  2. Válassza ki a vásznon az új Tárolt eljárás tevékenységet, ha még nincs kijelölve, és a Beállítások fület a részletek szerkesztéséhez.

    Egy tárolt eljárás tevékenység felhasználói felületét jeleníti meg.

  3. Válasszon ki egy meglévőt, vagy hozzon létre egy új társított szolgáltatást egy Azure SQL Database, Azure Synapse Analytics vagy SQL Server.

  4. Válasszon egy tárolt eljárást, és adja meg a végrehajtáshoz szükséges paramétereket.

Szintaxis részletei

A tárolt eljárástevékenységek definiálása az alábbi JSON-formátumot használja:

{
    "name": "Stored Procedure Activity",
    "description":"Description",
    "type": "SqlServerStoredProcedure",
    "linkedServiceName": {
        "referenceName": "AzureSqlLinkedService",
        "type": "LinkedServiceReference"
    },
    "typeProperties": {
        "storedProcedureName": "usp_sample",
        "storedProcedureParameters": {
            "identifier": { "value": "1", "type": "Int" },
            "stringData": { "value": "str1" }

        }
    }
}

Az alábbi táblázat az alábbi JSON-tulajdonságokat ismerteti:

Tulajdonság Leírás Szükséges
név A tevékenység neve Igen
leírás A tevékenység használatát leíró szöveg Nem
típus Tárolt eljárástevékenység esetén a tevékenység típusa SqlServerStoredProcedure Igen
KapcsoltSzolgáltatásNév Hivatkozás azokra az Azure SQL Database vagy Azure Synapse Analytics vagy SQL Server példányokra, amelyek a Data Factory-ban társított szolgáltatásként vannak regisztrálva. A társított szolgáltatással kapcsolatos további információkért tekintse meg a társított számítási szolgáltatásokról szóló cikket. Igen
tároltEljárásNeve Adja meg a meghívandó tárolt eljárás nevét. Igen
tárolt eljárás paraméterei Adja meg a tárolt eljárásparaméterek értékeit. Paraméterértékek és azok adatforrás által támogatott típusának átadására használható "param1": { "value": "param1Value","type":"param1Type" } . Ha null értéket kell megadnia egy paraméter esetén, használja a "param1": { "value": null }(kisbetűs) formátumot. Nem

Paraméter adattípus-leképezése

A paraméterhez megadott adattípus az a belső szolgáltatástípus, amely megfelel a használt adatforrás adattípusának. Az adatforrás adattípus-leképezéseit az összekötők dokumentációjában találja. Példa:

Tekintse meg az alábbi cikkeket, amelyekből megtudhatja, hogyan alakíthat át adatokat más módokon: