Adatok átalakítása az SQL Server tárolt eljárásának tevékenységével az Azure Data Factoryben vagy a Synapse Analyticsben

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!

A Data Factoryben vagy a Synapse-folyamatban adatátalakítási tevékenységeket használva alakíthatja át és dolgozhatja fel a nyers adatokat előrejelzésekké és elemzésekké. A tárolt eljárástevékenység az egyik olyan átalakítási tevékenység, amelyet a folyamatok 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 az Azure Data Factory szolgáltatással, olvassa el az Azure Data Factory bemutatása című oktatóanyagot, és végezze el az oktatóanyagot: Adatok átalakítása a cikk elolvasása előtt. Ha többet szeretne megtudni a Synapse Analyticsről, olvassa el az Azure Synapse Analytics ismertetéseit.

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

  • Azure SQL Database
  • Azure Synapse Analytics
  • SQL Server Database. Ha SQL Servert 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. A saját üzemeltetésű integrációs modul olyan összetevő, amely biztonságos és felügyelt módon csatlakoztatja a helyszíni/Azure-beli virtuális gépek adatforrásait 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, konfigurálhatja a másolási tevékenységben lévő SqlSinket egy tárolt eljárás meghívására az sqlWriterStoredProcedureName tulajdonság használatával. A tulajdonság részleteiért tekintse meg az alábbi összekötő cikkeket: Azure SQL Database, SQL Server. Nem támogatott a tárolt eljárás meghívása, miközben adatokat másol az Azure Synapse Analyticsbe 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 az Azure Synapse Analyticsben.

Amikor adatokat másol az Azure SQL Database-ből, az SQL Serverből vagy az Azure Synapse Analyticsből, konfigurálhatja az SqlSource-t másolási tevékenységben, hogy egy tárolt eljárást hívjon meg, amely adatokat olvas be a forrásadatbázisból az sqlReaderStoredProcedureName tulajdonság használatával. További információkért tekintse meg az alábbi összekötő cikkeket: 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 acitivitás é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 támogatásra van szüksége, forduljon az 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 az új tárolt eljárás tevékenységet a vásznon, ha még nincs kijelölve, és a Gépház lapot a részletek szerkesztéséhez.

    Shows the UI for a Stored Procedure activity.

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

  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
linkedServiceName Hivatkozás a Data Factoryben társított szolgáltatásként regisztrált Azure SQL Database-re vagy Azure Synapse Analyticsre vagy SQL Serverre . 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
storedProcedureName Adja meg a meghívandó tárolt eljárás nevét. Igen
storedProcedureParameters 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éterhez, használja "param1": { "value": null } a (kisbetűs) értéket. 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: