Megosztás:

Szkriptfeladat

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

A szkriptfeladat kódot biztosít az SQL Server Integration Services által biztosított beépített feladatokban és átalakításokban nem elérhető függvények végrehajtásához. A szkriptfeladat több feladat és átalakítás használata helyett egy szkriptben is kombinálhat függvényeket. A Szkript feladatot olyan feladatokhoz használja, amelyeket egy csomagban (vagy számba vehető objektumonként egyszer) kell elvégezni, nem pedig adatsoronként egyszer.

A szkriptfeladatot a következő célokra használhatja:

  • Adatok elérése más, a beépített kapcsolattípusok által nem támogatott technológiák használatával. Egy szkript például az Active Directory szolgáltatásfelületek (ADSI) használatával érheti el és nyerheti ki a felhasználóneveket az Active Directoryból.

  • Hozzon létre egy csomagspecifikus teljesítményszámlálót. A szkriptek például létrehozhatnak egy teljesítményszámlálót, amely frissül, miközben egy összetett vagy rosszul teljesítő feladat fut.

  • Határozza meg, hogy a megadott fájlok üresek-e, vagy hány sort tartalmaznak, majd ezek alapján befolyásolja a csomag vezérlőfolyamatát. Ha például egy fájl nulla sort tartalmaz, akkor a változó értéke 0, az értéket kiértékelő elsőbbségi kényszer pedig megakadályozza, hogy a fájlrendszerbeli feladat másolja a fájlt.

Ha a szkripttel ugyanazt a munkát kell elvégeznie egy készlet minden adatsorához, akkor a Szkript feladat helyett a Szkript összetevőt kell használnia. Ha például egy postázandó mennyiség ésszerűségét szeretné felmérni, és kihagyni a nagyon nagy vagy alacsony mennyiségű adatsorokat, akkor egy szkriptösszetevőt használna. További információ: Szkriptösszetevő.

Ha egynél több csomag használ szkriptet, érdemes lehet egyéni feladatot írni a szkriptfeladat használata helyett. További információ: Egyéni feladatfejlesztése.

Miután úgy döntött, hogy a szkriptfeladat a megfelelő választás a csomaghoz, mindkettőnek ki kell dolgoznia a feladat által használt szkriptet, és magát a feladatot kell konfigurálnia.

A feladat által használt szkript írása és futtatása

A szkriptfeladat a Microsoft Visual Studio Tools for Applications (VSTA) környezetet használja, amelyben a szkripteket és a szkripteket futtató motort írja.

A VSTA a Visual Studio-környezet összes szabványos funkcióját biztosítja, például a színkódolt Visual Studio-szerkesztőt, az IntelliSense-t és az Object Explorert. A VSTA ugyanazt a hibakeresőt használja, amelyet más Microsoft fejlesztői eszközök is használnak. A szkript töréspontjai zökkenőmentesen működnek az Integration Services-feladatok és -tárolók töréspontjaival. A VSTA a Microsoft Visual Basic és a Microsoft Visual C# programozási nyelveket is támogatja.

Szkript futtatásához telepítve kell lennie a VSTA-nak azon a számítógépen, amelyen a csomag fut. A csomag futtatásakor a feladat betölti a szkriptmotort, és futtatja a szkriptet. A külső .NET-szerelvények szkriptekben való eléréséhez a projektben lévő szerelvényekre mutató hivatkozásokat adhat hozzá. Jelenleg nem támogatjuk a .NET Core és a .NET standard szerelvényhivatkozásokat.

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 szkriptfeladat konfigurálása

A szkriptfeladatot a következő módokon konfigurálhatja:

  • Adja meg a feladat által futtatott egyéni szkriptet.

  • Adja meg azt a MÓDSZERT a VSTA-projektben, amelyet az Integration Services-futtatókörnyezet a szkript feladatkódjának belépési pontjaként hív meg.

  • Adja meg a szkript nyelvét.

  • Igény szerint adja meg az írásvédett és az írási/olvasási változók listáját a szkriptben való használatra.

Ezeket a tulajdonságokat az SSIS Designerrel vagy programozott módon állíthatja be.

A szkriptfeladat konfigurálása a Tervezőben

Az alábbi táblázat a Szkriptfeladathoz naplózható ScriptTaskLogEntry eseményt ismerteti. A ScriptTaskLogEntry esemény van kiválasztva az SSIS-naplók konfigurálása párbeszédpanel Részletek lapján való naplózáshoz. További információkért lásd a Integration Services (SSIS) naplózásrészt.

Naplóbejegyzés Leírás
ScriptTaskLogEntry A szkriptben történő naplózás implementálásának eredményeit jelenti. A feladat naplóbejegyzést ír a Dts objektum naplómetódusának minden egyes hívásához. A feladat ezeket a bejegyzéseket a kód futtatásakor írja. További információ: Naplózás a szkriptfeladatban.

Az SSIS Designerben beállítható tulajdonságokról az alábbi témakörökben talál további információt:

A tulajdonságok SSIS Designerben való beállításával kapcsolatos további információkért tekintse meg az alábbi témakört:

A szkriptfeladat programozott konfigurálása

A tulajdonságok programozott beállításával kapcsolatos további információkért tekintse meg az alábbi témakört:

Szkriptfeladat-szerkesztő (általános oldal)

A Szkriptfeladat-szerkesztőpárbeszédpanel Általános lapjának használatával nevezze el és írja le a szkriptfeladatot.

A szkriptfeladatról további információt a Szkriptfeladat és a Szkriptfeladat konfigurálása a Szkriptfeladat-szerkesztőben című témakörben talál. A szkriptfeladat programozásáról további információt a Csomag kiterjesztése a szkriptfeladattal című témakörben talál.

Beállítások

Név
Adjon meg egy egyedi nevet a szkriptfeladatnak. Ezt a nevet használja a feladatikon címkeként.

Megjegyzés:

A feladatneveknek egyedinek kell lenniük egy csomagon belül.

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

Szkriptfeladat-szerkesztő (szkriptoldal)

A szkript tulajdonságainak beállításához és a szkript által elérhető változók megadásához használja a Szkriptfeladat-szerkesztőSzkript lapját.

Megjegyzés:

Az SQL Server 2008 Integration Services (SSIS) és újabb verzióiban az összes szkript előre le van fordítva. A korábbi verziókban egy PrecompileScriptIntoBinaryCode tulajdonságot állított be annak megadásához, hogy a szkript előre lett-e lefordítva.

A szkriptfeladatról további információt a Szkriptfeladat és a Szkriptfeladat konfigurálása a Szkriptfeladat-szerkesztőben című témakörben talál. A szkriptfeladat programozásáról további információt a Csomag kiterjesztése a szkriptfeladattal című témakörben talál.

Beállítások

ScriptLanguage
Válassza ki a feladat szkriptnyelvét a Microsoft Visual Basic vagy a Microsoft Visual C# használatával.

Miután létrehozott egy szkriptet a feladathoz, nem módosíthatja a ScriptLanguage tulajdonság értékét.

A Szkriptfeladat alapértelmezett szkriptnyelvének beállításához használja a Beállítások párbeszédpanel Általános lapján található Szkriptnyelv beállítást. .

EntryPoint
Adja meg azt a metódust, amelyet az Integration Services futtatókörnyezet a szkriptfeladat kódjának belépési pontjaként hív meg. A megadott metódusnak a Microsoft Visual Studio Tools for Applications (VSTA) projekt ScriptMain osztályában kell lennie. A SzkriptMain osztály a szkriptsablonok által létrehozott alapértelmezett osztály.

Ha módosítja a metódus nevét a VSTA-projektben, módosítania kell a EntryPoint tulajdonság értékét.

ReadOnlyVariables
Írja be a szkript számára elérhető írásvédett változók vesszővel tagolt listáját, vagy kattintson a három pontra (...), és válassza ki a változókat a Változók kiválasztása párbeszédpanelen.

Megjegyzés:

A változónevek érzékenyek a kis- és nagybetűkre.

ReadWriteVariables
Írja be a szkript számára elérhető olvasási/írási változók vesszővel tagolt listáját, vagy kattintson a három pontra (...) és válassza ki a változókat a Változók kiválasztása párbeszédpanelen.

Megjegyzés:

A változónevek érzékenyek a kis- és nagybetűkre.

Szkript szerkesztése
Megnyitja a VSTA IDE-t, ahol létrehozhatja vagy módosíthatja a szkriptet.

Kapcsolódó tartalom

  • Last updated on