Megosztás:


OLE DB-parancsátalakítás

A következőkre vonatkozik:SQL Server SSIS integrációs futtatókörnyezet az Azure Data Factory-ban

Az OLE DB-parancsátalakítás egy SQL-utasítást futtat az adatfolyam minden sorához. Futtathat például egy SQL-utasítást, amely sorokat szúr be, frissít vagy töröl egy adatbázistáblában.

Az OLE DB-parancsátalakítást a következő módokon konfigurálhatja:

  • Adja meg azt az SQL-utasítást, amely szerint az átalakítás minden sorhoz fut.

  • Adja meg az SQL-utasítás időtúllépése előtti másodpercek számát.

  • Adja meg az alapértelmezett kódlapot.

Az SQL-utasítás általában paramétereket tartalmaz. A paraméterértékek az átalakítási bemenet külső oszlopaiban vannak tárolva, és egy bemeneti oszlop külső oszlophoz való leképezése egy bemeneti oszlopot egy paraméterhez rendel. Ha például a DimProduct táblában a ProductKey oszlopban lévő érték alapján szeretné megkeresni a sorokat, majd törölni szeretné őket, a Param_0 nevű külső oszlopot leképezheti a ProductKey nevű bemeneti oszlopra, majd futtathatja az SQL-utasítást DELETE FROM DimProduct WHERE ProductKey = ?. Az OLE DB parancsátalakítása megadja a paraméterneveket, és nem módosíthatja őket. A paraméternevek Param_0, Param_1 stb.

Ha az OLE DB-parancsátalakítást a Speciális szerkesztő párbeszédpanel használatával konfigurálja, az SQL-utasítás paraméterei automatikusan leképezhetők az átalakítási bemenet külső oszlopaira, valamint az egyes paraméterek jellemzőire a Frissítés gombra kattintva. Ha azonban az OLE DB-parancsátalakítás által használt OLE DB-szolgáltató nem támogatja a paraméter paraméteradatainak származtatását, manuálisan kell konfigurálnia a külső oszlopokat. Ez azt jelenti, hogy minden paraméterhez hozzá kell adnia egy oszlopot az átalakítás külső bemenetéhez, frissítenie kell az oszlopneveket a Param_0 nevet használva, meg kell adnia a DBParamInfoFlags tulajdonság értékét, és le kell képeznie a paraméterértékeket tartalmazó bemeneti oszlopokat a külső oszlopokra.

A DBParamInfoFlags értéke a paraméter jellemzőit jelöli. Az 1 érték például azt adja meg, hogy a paraméter bemeneti paraméter, a 65-ös érték pedig azt határozza meg, hogy a paraméter bemeneti paraméter, és null értéket tartalmazhat. Az értékeknek meg kell egyeznie az OLE DBPARAMFLAGSENUM enumerálásban szereplő értékekkel. További információkért tekintse meg az OLE DB referenciadokumentációját.

Az OLE DB-parancsátalakítás tartalmazza az SQLCommand egyéni tulajdonságot . Ezt a tulajdonságot egy tulajdonságkifejezés frissítheti a csomag betöltésekor. További információt az Integration Services (SSIS) kifejezései, a tulajdonságkifejezések használata a csomagokban és az egyéni tulajdonságok átalakítása című témakörben talál.

Ez az átalakítás egy bemenettel, egy normál kimenettel és egy hibakimenettel rendelkezik.

Logging

Naplózhatja azokat a hívásokat, amelyeket az OLE DB-parancs transzformációja külső adatszolgáltatók felé indít. Ezzel a naplózási funkcióval hibaelhárítás céljából használhatja az OLE DB parancs transzformáció által végrehajtott kapcsolatok és parancsok vizsgálatát a külső adatforrásokkal. Az OLE DB-parancsok külső adatszolgáltatók felé irányuló hívásainak naplózásához engedélyezze a csomagnaplózást, és válassza ki a diagnosztikai eseményt a csomag szintjén. További információ: A csomagvégrehajtás hibaelhárítási eszközei.

Az átalakítást az SSIS Designer vagy az objektummodell használatával konfigurálhatja. Az átalakítás programozott konfigurálásával kapcsolatos részletekért tekintse meg a fejlesztői útmutatót.

Az OLE DB parancsátalakításának konfigurálása

Az OLE DB-parancsok átalakításának hozzáadásához és konfigurálásához a csomagnak már tartalmaznia kell legalább egy adatfolyam-feladatot és egy forrást, például egy lapos fájlforrást vagy egy OLE DB-forrást. Ezt az átalakítást általában paraméteres lekérdezések futtatására használják.

Az OLE DB-parancs átalakításának konfigurálása

  1. Az SQL Server Data Tools (SSDT) alkalmazásban nyissa meg a kívánt csomagot tartalmazó Integration Services-projektet.

  2. A Megoldáskezelőben kattintson duplán a csomagra a megnyitásához.

  3. Kattintson az Adatfolyam fülre, majd az Eszközkészletből húzza az OLE DB Command átalakítást a tervezőfelületre.

  4. Csatlakoztassa az OLE DB-parancs transzformációt az adatfolyamhoz úgy, hogy egy összekötőt húz-e zöld vagy piros nyíllal egy adatforrásból vagy egy korábbi átalakításból az OLE DB-parancs transzformáció felé.

  5. Kattintson a jobb gombbal az összetevőre, és válassza a Szerkesztés vagy a Speciális szerkesztő megjelenítése lehetőséget.

  6. A Kapcsolatkezelők lapon válasszon egy OLE DB kapcsolatkezelőt a Kapcsolatkezelő listában. További információ: OLE DB Connection Manager.

  7. Kattintson az Összetevő tulajdonságai fülre, és kattintson a három pontra (...) az SqlCommand mezőben.

  8. A Sztringérték-szerkesztőbe írja be a paraméteres SQL-utasítást egy kérdőjel (?) használatával az egyes paraméterek paraméterjelölőjeként.

  9. Kattintson a Frissítés gombra. A Frissítés gombra kattintva az átalakítás létrehoz egy oszlopot a Külső oszlopok gyűjtemény minden paraméteréhez, és beállítja a DBParamInfoFlags tulajdonságot.

  10. Kattintson a Bemeneti és kimeneti tulajdonságok fülre.

  11. Bontsa ki az OLE DB parancs bemenetét, majd bontsa ki a külső oszlopokat.

  12. Ellenőrizze, hogy a külső oszlopok listáznak-e egy oszlopot az SQL-utasítás minden paraméteréhez. Az oszlopnevek Param_0, Param_1 stb.

    Az oszlopneveket nem szabad módosítani. Ha módosítja az oszlopneveket, az Integration Services érvényesítési hibát okoz az OLE DB-parancsok átalakításához.

    Emellett ne módosítsa az adattípust. Az egyes oszlopok DataType tulajdonsága a megfelelő adattípusra van állítva.

  13. Ha a külső oszlopok nem sorolnak fel oszlopokat, manuálisan kell hozzáadnia őket.

    • Kattintson egyszer az Oszlop hozzáadása elemre az SQL-utasítás minden paraméteréhez.

    • Frissítse az oszlopneveket Param_0, Param_1 stb.

    • Adjon meg egy értéket a DBParamInfoFlags tulajdonságban. Az értéknek meg kell egyeznie az OLE DBPARAMFLAGSENUM enumerálásban szereplő értékkel. További információkért tekintse meg az OLE DB referenciadokumentációját.

    • Adja meg az oszlop adattípusát, és az adattípustól függően adja meg az oszlop kódlapját, hosszát, pontosságát és skálázását.

    • Egy nem használt paraméter törléséhez jelölje ki a paramétert a külső oszlopokban, majd kattintson az Oszlop eltávolítása parancsra.

    • A Rendelkezésre álló céloszlopok listában kattintson az Oszlopleképezések elemre, és képezheti le az oszlopokat az Elérhető bemeneti oszlopok listában lévő paraméterekhez.

  14. Kattintson az OK gombra.

  15. A frissített csomag mentéséhez kattintson a Fájl menü Mentés parancsára.

Lásd még:

Adatfolyam
Integrációs szolgáltatások átalakításai