Megosztás:


Szkriptösszetevő

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

A Szkript összetevő szkriptet üzemeltet, és lehetővé teszi, hogy egy csomag egyéni szkriptkódot tartalmazzon és futtasson. A Szkript összetevőt a következő célokra használhatja csomagokban:

  • Több átalakítás alkalmazása az adatokra ahelyett, hogy több átalakítást használ az adatfolyamban. Egy szkript például hozzáadhatja az értékeket két oszlopban, majd kiszámíthatja az összeg átlagát.

  • Üzleti szabályok elérése egy meglévő .NET-szerelvényben. A szkriptek például alkalmazhatnak olyan üzleti szabályt, amely meghatározza a Jövedelem oszlopban érvényes értékek tartományát.

  • Az Integration Services kifejezés nyelvtani funkcióin és operátoraion kívül egyéni képleteket és függvényeket is használhat. Ellenőrizze például a LUHN képletet használó hitelkártyaszámokat.

  • Ellenőrizze az oszlopadatokat, és ugorja át az érvénytelen adatokat tartalmazó rekordokat. A szkriptek például felmérhetik a postaköltség ésszerűségét, és kihagyhatják a rendkívül magas vagy alacsony mennyiségű rekordokat.

A Szkript összetevő egyszerű és gyors módot kínál az egyéni függvények adatfolyamba való belefoglalására. Ha azonban több csomagban szeretné újra felhasználni a szkriptkódot, érdemes megfontolnia egy egyéni összetevő programozását a Szkript összetevő használata helyett. További információ: Egyéni adatfolyam-összetevő fejlesztése.

Megjegyzés:

Ha a Szkript összetevő olyan szkriptet tartalmaz, amely megpróbálja beolvasni egy NULL értékű oszlop értékét, a szkript összetevő sikertelen lesz a csomag futtatásakor. Javasoljuk, hogy a IsNull szkriptje a metódus használatával állapítsa meg, hogy az oszlop NULL értékű-e, mielőtt megpróbálná beolvasni az oszlop értékét.

A Szkript összetevő forrásként, átalakításként vagy célként is használható. Ez az összetevő egy bemenetet és több kimenetet támogat. Az összetevő használatától függően támogatja a bemeneteket, kimeneteket vagy mindkettőt. A szkriptet a bemenet vagy kimenet minden sora meghívja.

  • Ha forrásként használják, a Szkript összetevő több kimenetet is támogat.

  • Ha átalakításként használják, a Szkript összetevő egy bemenetet és több kimenetet támogat.

  • Ha célhelyként használják, a Szkript összetevő egy bemenetet támogat.

A szkript összetevő nem támogatja a hibakimeneteket.

Miután úgy döntött, hogy a szkript összetevő a megfelelő választás a csomaghoz, konfigurálnia kell a bemeneteket és kimeneteket, ki kell alakítania az összetevő által használt szkriptet, és magát az összetevőt kell konfigurálnia.

A szkriptösszetevő-módok ismertetése

Az SSIS Designerben a Szkript összetevőnek két módja van: metaadat-tervezési mód és kódtervezési mód. Metaadat-tervezési módban hozzáadhatja és módosíthatja a Szkript összetevő bemeneteit és kimeneteit, de nem írhat kódot. Miután az összes bemenet és kimenet konfigurálva van, a szkript írásához váltson kódtervezési módra. A Szkript összetevő automatikusan létrehozza az alapkódot a bemenetek és kimenetek metaadataiból. Ha módosítja a metaadatokat, miután a Szkript összetevő létrehozta az alapkódot, előfordulhat, hogy a kód már nem fordítható le, mert a frissített alapkód nem kompatibilis a kóddal.

Az összetevő által használt szkript írása

A szkriptösszetevő a Microsoft Visual Studio Tools for Applications (VSTA) alkalmazást használja a szkriptek írási környezeteként. A VSTA-t a szkriptátalakítási szerkesztőből érheti el.

A Szkript összetevő egy VSTA-projektet biztosít, amely egy automatikusan létrehozott, ScriptMain nevű osztályt tartalmaz, amely az összetevő metaadatait jelöli. Ha például a Szkript összetevőt három kimenettel rendelkező átalakításként használják, a ScriptMain minden kimenethez tartalmaz egy metódust. A ScriptMain a szkript belépési pontja.

A VSTA tartalmazza a Visual Studio-környezet összes szabványos funkcióját, például a színkódolt Visual Studio-szerkesztőt, az IntelliSense-t és az Object Browsert. A szkript összetevő által használt szkriptet a csomagdefiníció tárolja. A csomag tervezésekor a szkriptkód ideiglenesen egy projektfájlba lesz írva.

A VSTA támogatja a Microsoft Visual C# és a Microsoft Visual Basic programozási nyelveket.

A szkript összetevő programjáról további információt az Adatfolyam kiterjesztése a szkriptösszetevővel című témakörben talál. A szkriptösszetevő forrásként, átalakításként vagy célként való konfigurálásáról további információt a Szkriptösszetevők adott típusainak fejlesztése című témakörben talál. További példák, például egy ODBC-célhely, amely bemutatja a szkriptösszetevő használatát, tekintse meg a további szkriptösszetevő-példákat.

Megjegyzés:

A korábbi verzióktól eltérően, ahol jelezheti, hogy a szkriptek előre lettek-e lefordítva, az összes szkript előre le van fordítva az SQL Server 2008 Integration Services (SSIS) és a későbbi verziókban. Egy szkript előre lefordításakor a nyelvi motor nem töltődik be futásidőben, és a csomag gyorsabban fut. Az előre összeállított bináris fájlok azonban jelentős lemezterületet használnak fel.

A szkriptösszetevő konfigurálása

A Szkript összetevőt a következő módokon konfigurálhatja:

  • Jelölje ki a hivatkozni kívánt bemeneti oszlopokat.

    Megjegyzés:

    Az SSIS Designer használatakor csak egy bemenetet konfigurálhat.

  • Adja meg az összetevő által futtatott szkriptet.

  • Adja meg a szkript nyelvét.

  • Adjon meg vesszővel tagolt listákat az írásvédett és az olvasási/írási változókról.

  • Adjon hozzá további kimeneteket, és adjon hozzá kimeneti oszlopokat, amelyeket a szkript hozzárendel.

A tulajdonságokat az SSIS Designer használatával vagy programozott módon állíthatja be.

A szkriptösszetevő konfigurálása a Tervezőben

A tulajdonságok SSIS Designerben való beállításával kapcsolatos további információkért kattintson a következő témakörre:

A szkriptösszetevő programozott konfigurálása

A Tulajdonságok ablakban vagy programozott módon beállítható tulajdonságokról az alábbi témakörök egyikére kattintva talál további információt:

A tulajdonságok beállításával kapcsolatos további információkért kattintson az alábbi témakörök egyikére:

Szkriptösszetevő típusának kiválasztása

A Parancsfájl-összetevőtípus kiválasztása párbeszédpanelen megadhatja, hogy forrásként, átalakításként vagy célként előre konfigurált szkriptátalakítást szeretne-e létrehozni.

A szkriptösszetevőről további információt a Szkriptösszetevő konfigurálása a szkriptösszetevő-szerkesztőben című témakörben talál. A szkriptösszetevő programozásával kapcsolatos további információkért lásd: Adatfolyam kiterjesztése a szkriptösszetevővel.

Beállítások

A forrás, cél vagy átalakítás kiválasztása hatással van a szkriptátalakítás konfigurációjára és a Szkriptátalakítási szerkesztő lapjaira.

Szkriptátalakítási szerkesztő (Kapcsolatkezelők lap)

A Szkriptátalakítási szerkesztőKapcsolatkezelő lapján adja meg a szkript által használni kívánt kapcsolatokat.

A szkriptösszetevőről további információt a Szkriptösszetevő konfigurálása a szkriptösszetevő-szerkesztőben című témakörben talál. A szkriptösszetevő programozásával kapcsolatos további információkért lásd: Adatfolyam kiterjesztése a szkriptösszetevővel.

Beállítások

Kapcsolatkezelők
Tekintse meg a szkript által használható kapcsolatok listáját.

Név
Adjon meg egy egyedi és leíró nevet a kapcsolatnak.

Kapcsolatkezelő
Válasszon az elérhető kapcsolatkezelők listájából, vagy válassza <az Új kapcsolat> lehetőséget az SSIS-kapcsolatkezelő hozzáadása párbeszédpanel megnyitásához.

Leírás
Írja be a kapcsolat leírását.

Adj hozzá
Adjon hozzá egy másik kapcsolatot a Kapcsolatkezelők listájához.

távolítsa el
Távolítsa el a kijelölt kapcsolatot a Kapcsolatkezelők listájából.

Szkriptátalakító szerkesztő (Bemeneti oszlopok oldal)

A Parancsfájl-átalakítási szerkesztő párbeszédpanel Beviteli oszlopok lapján állíthatja be a bemeneti oszlopok tulajdonságait.

Megjegyzés:

A Bemeneti oszlopok lap nem jelenik meg a forrásösszetevők esetében, amelyek kimenetekkel rendelkeznek, de nincsenek bemenetek.

A szkriptösszetevőről további információt a Szkriptösszetevő konfigurálása a szkriptösszetevő-szerkesztőben című témakörben talál. A szkriptösszetevő programozásával kapcsolatos további információkért lásd: Adatfolyam kiterjesztése a szkriptösszetevővel.

Beállítások

Bemeneti név
Válasszon az elérhető bemenetek listájából.

Elérhető bemeneti oszlopok
A jelölőnégyzetek használatával adja meg azokat az oszlopokat, amelyeket a szkriptátalakítás használni fog.

bemeneti oszlop
Válasszon az egyes sorokhoz elérhető bemeneti oszlopok listájából. A kijelölt elemek megjelennek az Elérhető beviteli oszlopok tábla jelölőnégyzetében.

Kimeneti alias
Minden kimeneti oszlophoz írjon be egy aliast. Az alapértelmezett érték a bemeneti oszlop neve; azonban bármilyen egyedi, leíró nevet választhat.

Használati típus
Adja meg, hogy a szkriptátalakítás az egyes oszlopokat ReadOnly vagy ReadWrite néven fogja-e kezelni.

Szkriptátalakítási szerkesztő (Bemenetek és kimenetek lap)

A Szkriptátalakítás-szerkesztő párbeszédpanel Bemenetek és kimenetek lapján adhat hozzá, távolíthat el és konfigurálhat bemeneteket és kimeneteket a szkriptátalakításhoz.

Megjegyzés:

A forrásösszetevőknek vannak kimeneteik, de nincsenek bemeneteik, míg a célösszetevőknek vannak bemeneteik, de nincsenek kimeneteik. Az átalakítások bemenetekkel és kimenetekkel is rendelkeznek.

A szkriptösszetevőről további információt a Szkriptösszetevő konfigurálása a szkriptösszetevő-szerkesztőben című témakörben talál. A szkriptösszetevő programozásával kapcsolatos további információkért lásd: Adatfolyam kiterjesztése a szkriptösszetevővel.

Beállítások

Bemenetek és kimenetek
Válasszon ki egy bemenetet vagy kimenetet a bal oldalon a jobb oldali táblázatban lévő tulajdonságok megtekintéséhez. A szerkesztésre rendelkezésre álló tulajdonságok a kijelöléstől függően változnak. A megjelenített tulajdonságok többsége csak olvasható. Az egyes tulajdonságokról az alábbi témakörökben olvashat bővebben.

Gyakori tulajdonságok

Speciális átalakítási tulajdonságok

Kimenet hozzáadása
Adjon hozzá egy további kimenetet a listához.

Oszlop hozzáadása
Jelölje ki azt a mappát, amelyben az új kimeneti oszlopot szeretné elhelyezni, majd az Oszlop hozzáadása gombra kattintva adja hozzá az oszlopot.

Kimenet eltávolítása
Válasszon ki egy kimenetet, majd távolítsa el a Kimenet eltávolítása gombra kattintva.

Oszlop eltávolítása
Jelöljön ki egy oszlopot, majd távolítsa el az Oszlop eltávolítása gombra kattintva.

Szkriptátalakítási szerkesztő (szkriptoldal)

Szkript és kapcsolódó tulajdonságok megadásához használja a Parancsfájl-átalakítási szerkesztő párbeszédpanel Szkript lapját.

A szkriptösszetevőről további információt a Szkriptösszetevő konfigurálása a szkriptösszetevő-szerkesztőben című témakörben talál. A szkriptösszetevő programozásával kapcsolatos további információkért lásd: Adatfolyam kiterjesztése a szkriptösszetevővel.

Beállítások

Tulajdonságok
A szkriptátalakítás tulajdonságainak megtekintése és módosítása. A megjelenített tulajdonságok többsége csak olvasható. A következő tulajdonságokat módosíthatja:

Érték Leírás
Leírás Írja le a szkriptátalakítást a céljának megfelelően.
Területi azonosító Adja meg a területi beállításokat a rendelés régióspecifikus adatainak megadásához, valamint a dátum- és időátalakításhoz.
Név Írja be az összetevő leíró nevét.
ValidateExternalMetadata Annak jelzése, hogy a szkriptátalakítás a tervezéskor érvényesíti-e az oszlop metaadatait külső adatforrásokkal. A false érték késlelteti a validálást a végrehajtás időpontjáig.
ReadOnlyVariables Írjon be egy vesszővel elválasztott listát a csak olvasásra szánt változókról a Script átalakításhoz.

Megjegyzés: A változónevek megkülönböztetik a kis- és nagybetűket.
ReadWriteVariables Írja be az írási/olvasási hozzáféréshez szükséges változók vesszővel tagolt listáját a Szkript átalakításával.

Megjegyzés: A változónevek megkülönböztetik a kis- és nagybetűket.
ScriptLanguage Válassza ki a Szkript összetevő által használni kívánt szkriptnyelvet.

A Szkriptösszetevők és a Szkriptfeladatok alapértelmezett szkriptnyelvének beállításához használja a Parancsfájlnyelv beállítást a Beállítások párbeszédpanel Általános lapján.
UserComponentTypeName Megadja az ScriptComponentHost SQL Server-infrastruktúrát támogató osztályt és a Microsoft.SqlServer.TxScript szerelvényt.

Szkript szerkesztése
Szkriptek létrehozása vagy módosítása a Microsoft Visual Studio Tools for Applications (VSTA) használatával.

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

Az adatfolyam kiterjesztése a szkriptösszetevővel