Sdílet prostřednictvím

skriptová úloha

platí pro:SQL Server SSIS Integration Runtime ve službě Azure Data Factory

Úloha Skript poskytuje kód pro provádění funkcí, které nejsou k dispozici v předdefinovaných úlohách a transformacích, které služba SQL Server Integration Services poskytuje. Úloha Skript může také kombinovat funkce v jednom skriptu místo použití více úkolů a transformací. Úlohu skriptu použijete pro práci, která musí být provedena jednou v balíčku (nebo jednou pro jednotlivý výčtový objekt), namísto toho, aby byla provedena jednou na datový řádek.

Úlohu Skript můžete použít pro následující účely:

  • Přístup k datům pomocí jiných technologií, které nejsou podporovány integrovanými typy připojení. Skript může například použít rozhraní ADSI (Active Directory Service Interfaces) pro přístup ke službě Active Directory a extrahování uživatelských jmen ze služby Active Directory.

  • Vytvořte čítač výkonu specifický pro balíček. Skript může například vytvořit čítač výkonu, který se aktualizuje, když se spustí složitá nebo špatně výkonná úloha.

  • Určete, jestli jsou zadané soubory prázdné nebo kolik řádků obsahují, a pak na základě informací ovlivňují tok řízení v balíčku. Pokud například soubor obsahuje nula řádků, hodnota proměnné nastavená na hodnotu 0 a omezení priority, které hodnotu vyhodnotí, zabrání úlohu systému souborů v kopírování souboru.

Pokud musíte skript použít ke stejné práci pro každý řádek dat v sadě, měli byste místo úlohy Script použít komponentu Script. Pokud například chcete vyhodnotit přiměřenou velikost příspěvku a přeskočit řádky dat, které mají velmi vysoké nebo nízké částky, použijete komponentu Script. Další informace naleznete v tématu Komponenta skriptu.

Pokud skript používá více než jeden balíček, zvažte vytvoření vlastní úlohy místo použití úlohy Skript. Další informace naleznete v tématu Vývoj vlastníhoúloh .

Jakmile se rozhodnete, že úloha Skript je vhodnou volbou pro váš balíček, musíte vyvinout skript, který úloha používá, a nakonfigurovat samotný úkol.

Zápis a spuštění skriptu, který úloha používá

Úloha Skript používá nástroje Microsoft Visual Studio Tools for Applications (VSTA) jako prostředí, ve kterém píšete skripty a modul, který tyto skripty spouští.

VSTA poskytuje všechny standardní funkce prostředí sady Visual Studio, jako je barevný editor sady Visual Studio, IntelliSense a Průzkumník objektů. VSTA také používá stejný ladicí program, který používají jiné vývojové nástroje Microsoftu. Zarážky ve skriptu plynule fungují se zarážkami u úloh a kontejnerů Integračních služeb. VSTA podporuje programovací jazyky Microsoft Visual Basic i Microsoft Visual C#.

Pokud chcete spustit skript, musíte mít v počítači, na kterém se balíček spouští, nainstalovaný VSTA. Při spuštění balíčku úloha načte skriptovací modul a spustí skript. K externím sestavením .NET můžete přistupovat ve skriptech přidáním odkazů na sestavení v projektu. V současné době nepodporujeme odkazování na sestavení .NET Core a .NET Standard.

Poznámka:

Na rozdíl od dřívějších verzí, kde můžete označit, zda byly skripty předkompilovány, jsou všechny skripty předkompilovány v SYSTÉMU SQL Server 2008 Integration Services (SSIS) a novějších verzích. Při předkompilování skriptu se modul jazyka nenačte za běhu a balíček se spustí rychleji. Předkompilované binární soubory však spotřebovávají značné místo na disku.

Konfigurace úlohy skriptu

Úlohu Skript můžete nakonfigurovat následujícími způsoby:

  • Zadejte vlastní skript, který úloha spustí.

  • Zadejte metodu v projektu VSTA, kterou modul runtime integračních služeb volá jako vstupní bod do kódu skriptového úkolu.

  • Zadejte jazyk skriptu.

  • Volitelně můžete zadat seznamy proměnných jen pro čtení a pro čtení a zápis pro použití ve skriptu.

Tyto vlastnosti můžete nastavit prostřednictvím návrháře SSIS nebo programově.

Konfigurace úlohy skriptu v Návrháři

Následující tabulka popisuje událost ScriptTaskLogEntry , kterou lze protokolovat pro úlohu Script. Událost ScriptTaskLogEntry je vybrána pro záznam na kartě Podrobnosti v dialogovém okně Konfigurace SSIS protokolů. Další informace naleznete v tématu Integrace služeb (SSIS) protokolování.

Položka protokolu Popis
ScriptTaskLogEntry Zaznamenává výsledky implementace protokolování ve skriptu. Úloha zapíše položku protokolu pro každé volání metody Log objektu Dts . Úloha zapíše tyto položky při spuštění kódu. Další informace naleznete v tématu Zaznamenávání v skriptovacím úkolu.

Další informace o vlastnostech, které můžete nastavit v nástroji SSIS Designer, najdete v následujících tématech:

Další informace o tom, jak nastavit tyto vlastnosti v nástroji SSIS Designer, najdete v následujícím tématu:

Programová konfigurace úlohy skriptu

Další informace o programovém nastavení těchto vlastností najdete v následujícím tématu:

Editor úloh skriptu (obecná stránka)

Pomocí stránky Obecné v dialogovém okně Editor úloh skriptu pojmenujte a popište úlohu skriptu.

Další informace o úloze Skript najdete v tématu Úloha skriptu a Konfigurace úlohy skriptu v Editoru úloh skriptů. Další informace o programování úlohy Skript naleznete v tématu Rozšíření balíčku pomocí úlohy skriptu.

Možnosti

název
Zadejte jedinečný název úlohy Skript. Tento název se používá jako popisek v ikoně úkolu.

Poznámka:

Názvy úkolů musí být v rámci balíčku jedinečné.

Popis
Zadejte popis úlohy skriptu.

Editor úloh skriptů (stránka skriptu)

Stránka Skript v dialogovém okně Editor úloh skriptů slouží k nastavení vlastností skriptu a zadání proměnných, ke kterým má skript přístup.

Poznámka:

V SYSTÉMU SQL Server 2008 Integration Services (SSIS) a novějších verzích jsou všechny skripty předkompilovány. V dřívějších verzích nastavíte PrecompileScriptIntoBinaryCode vlastnost, která určuje, že skript byl předkompilován.

Další informace o úloze Skript najdete v tématu Úloha skriptu a Konfigurace úlohy skriptu v Editoru úloh skriptů. Další informace o programování úlohy Skript naleznete v tématu Rozšíření balíčku pomocí úlohy skriptu.

Možnosti

ScriptLanguage
Vyberte jazyk skriptování pro úlohu, a to buď Microsoft Visual Basic, nebo Microsoft Visual C#.

Po vytvoření skriptu pro úlohu nelze změnit hodnotu ScriptLanguage vlastnost.

Chcete-li nastavit výchozí skriptovací jazyk pro úlohu Skript, použijte možnost Skriptování jazyk na stránce Obecné v dialogovém okně Možnosti . .

Vstupní bod
Zadejte metodu, kterou modul runtime integračních služeb volá jako vstupní bod do kódu úlohy Script. Zadaná metoda musí být ve třídě ScriptMain projektu Microsoft Visual Studio Tools for Applications (VSTA) Třída ScriptMain je výchozí třída vygenerovaná šablonami skriptů.

Pokud změníte název metody v projektu VSTA, musíte změnit hodnotu EntryPoint vlastnost.

ReadOnlyVariables
Zadejte čárkami oddělený seznam proměnných jen pro čtení, které jsou pro skript k dispozici, nebo klikněte na tlačítko se třemi tečkami (...) a vyberte proměnné v dialogovém okně Vybrat proměnné .

Poznámka:

V názvech proměnných se rozlišují malá a velká písmena.

ReadWriteVariables
Zadejte čárkami oddělený seznam proměnných pro čtení a zápis, které jsou k dispozici pro skript, nebo klikněte na tlačítko se třemi tečkami (...) a vyberte proměnné v dialogovém okně Vybrat proměnné .

Poznámka:

V názvech proměnných se rozlišují malá a velká písmena.

Upravit skript
Otevře integrované vývojové prostředí VSTA, kde můžete vytvořit nebo upravit skript.

Související obsah

  • Last updated on