Sdílet prostřednictvím

Komponenta skriptu

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

Komponenta Script hostuje skript a umožňuje balíčku zahrnout a spustit kód vlastního skriptu. Komponentu Script můžete použít v balíčcích pro následující účely:

  • Použití více transformací u dat místo použití více transformací v toku dat Skript může například přidat hodnoty do dvou sloupců a pak vypočítat průměr součtu.

  • Přístup k obchodním pravidlům v existujícím sestavení .NET Skript může například použít obchodní pravidlo, které určuje rozsah hodnot, které jsou platné ve sloupci Příjem .

  • Kromě funkcí a operátorů, které poskytuje gramatika výrazů integračních služeb, používejte vlastní vzorce a funkce. Ověřte například čísla platebních karet, která používají vzorec LUHN.

  • Ověřte data sloupce a přeskočte záznamy, které obsahují neplatná data. Skript může například vyhodnotit přiměřenou velikost příspěvku a přeskočit záznamy s extrémně vysokými nebo nízkými částkami.

Komponenta Script poskytuje snadný a rychlý způsob, jak do toku dat zahrnout vlastní funkce. Pokud ale chcete znovu použít kód skriptu ve více balíčcích, měli byste místo použití komponenty Script zvážit programování vlastní komponenty. Další informace naleznete v tématu Vývoj vlastní komponenty toku dat.

Poznámka:

Pokud komponenta Script obsahuje skript, který se pokusí přečíst hodnotu sloupce s hodnotou NULL, komponenta Script selže při spuštění balíčku. Doporučujeme, abyste pomocí IsNull metody určili, zda sloupec má hodnotu NULL, než se pokusíte přečíst hodnotu sloupce.

Komponentu Script lze použít jako zdroj, transformaci nebo cíl. Tato komponenta podporuje jeden vstup a více výstupů. V závislosti na tom, jak se komponenta používá, podporuje vstup nebo výstupy nebo obojí. Skript je vyvolán každým řádkem ve vstupu nebo výstupu.

  • Pokud se používá jako zdroj, komponenta Script podporuje více výstupů.

  • Pokud se používá jako transformace, komponenta Script podporuje jeden vstup a více výstupů.

  • Pokud se používá jako cíl, komponenta Script podporuje jeden vstup.

Komponenta Script nepodporuje výstupy chyb.

Jakmile se rozhodnete, že komponenta Script je vhodnou volbou pro váš balíček, musíte nakonfigurovat vstupy a výstupy, vyvíjet skript, který komponenta používá, a konfigurovat samotnou komponentu.

Principy režimů komponent skriptu

V návrháři SSIS má komponenta Script dva režimy: režim návrhu metadat a režim návrhu kódu. V režimu návrhu metadat můžete přidat a upravit vstupy a výstupy komponent skriptu, ale kód nelze napsat. Po nakonfigurování všech vstupů a výstupů přepnete do režimu návrhu kódu a napíšete skript. Komponenta Script automaticky generuje základní kód z metadat vstupů a výstupů. Pokud změníte metadata po vygenerování základního kódu komponentou Script, nemusí se váš kód zkompilovat, protože aktualizovaný základní kód nemusí být kompatibilní s vaším kódem.

Zápis skriptu, který komponenta používá

Komponenta Skript používá nástroje Microsoft Visual Studio Tools for Applications (VSTA) jako prostředí, ve kterém píšete skripty. Přístup k VSTA z Editoru transformace skriptů.

Komponenta Script poskytuje projekt VSTA, který obsahuje automaticky vygenerovanou třídu s názvem ScriptMain, která představuje metadata komponenty. Pokud se například komponenta Script používá jako transformace, která má tři výstupy, ScriptMain obsahuje metodu pro každý výstup. ScriptMain je vstupním bodem skriptu.

VSTA zahrnuje všechny standardní funkce prostředí sady Visual Studio, jako je barevný editor sady Visual Studio, IntelliSense a Prohlížeč objektů. Skript, který komponenta Script používá, je uložen v definici balíčku. Při návrhu balíčku se kód skriptu dočasně zapíše do souboru projektu.

VSTA podporuje programovací jazyky Microsoft Visual C# a Microsoft Visual Basic.

Informace o tom, jak programovat komponentu Script, naleznete v tématu Rozšíření toku dat pomocí komponenty Script. Konkrétnější informace o tom, jak nakonfigurovat komponentu Script jako zdroj, transformaci nebo cíl, naleznete v tématu Vývoj konkrétních typů komponent skriptů. Další příklady, jako je cíl ODBC, který demonstruje použití komponenty Skript, naleznete v části Další příklady komponent skriptů.

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 komponenty skriptu

Komponentu Script můžete nakonfigurovat následujícími způsoby:

  • Vyberte vstupní sloupce, na které chcete odkazovat.

    Poznámka:

    Při použití návrháře služby SSIS můžete nakonfigurovat pouze jeden vstup.

  • Zadejte skript, který komponenta spouští.

  • Zadejte jazyk skriptu.

  • Zadejte čárkami oddělené seznamy proměnných jen pro čtení a pro čtení a zápis.

  • Přidejte další výstupy a přidejte výstupní sloupce, ke kterým skript přiřadí.

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

Konfigurace komponenty skriptu v Návrháři

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

Nastavení skriptové komponenty programaticky

Další informace o vlastnostech, které můžete nastavit v okně Vlastnosti nebo programově, získáte kliknutím na jedno z následujících témat:

Další informace o tom, jak nastavit vlastnosti, získáte kliknutím na jedno z následujících témat:

Vybrat typ komponenty skriptu

Pomocí dialogového okna Vybrat typ komponenty skriptu určete, zda se má vytvořit transformace skriptu, která je předkonfigurovaná pro použití jako zdroj, transformace nebo cíl.

Další informace o komponentě Skript naleznete v tématu Konfigurace komponenty skriptu v editoru komponent skriptů. Další informace o programování komponenty Script naleznete v tématu Rozšíření toku dat pomocí komponenty Script.

Možnosti

Výběr zdroje, cíle nebo transformace ovlivňuje konfiguraci transformace skriptu a stránek Editoru transformace skriptů.

Editor transformací skriptů (stránka Správci připojení)

Pomocí stránky Správci připojeníeditoru transformace skriptů určete všechna připojení, která bude skript používat.

Další informace o komponentě Skript naleznete v tématu Konfigurace komponenty skriptu v editoru komponent skriptů. Další informace o programování komponenty Script naleznete v tématu Rozšíření toku dat pomocí komponenty Script.

Možnosti

Správci připojení
Prohlédněte si seznam připojení, která jsou k dispozici pro použití skriptem.

název
Zadejte jedinečný a popisný název připojení.

Správce připojení
Vyberte ze seznamu dostupných správců připojení nebo vyberte <Nové připojení> a otevřete dialogové okno Přidat správce připojení SSIS .

Popis
Zadejte popis připojení.

Přidat
Přidejte další připojení do seznamu Správci připojení .

Odstranit
Odeberte vybrané připojení ze seznamu Správci připojení .

Editor transformace skriptů (stránka vstupních sloupců)

Stránka Vstupní sloupce dialogového okna Editor transformace skriptů slouží k nastavení vlastností vstupních sloupců.

Poznámka:

Stránka Vstupní sloupce se nezobrazuje pro zdrojové komponenty, které mají výstupy, ale žádné vstupy.

Další informace o komponentě Skript naleznete v tématu Konfigurace komponenty skriptu v editoru komponent skriptů. Další informace o programování komponenty Script naleznete v tématu Rozšíření toku dat pomocí komponenty Script.

Možnosti

Název vstupu
Vyberte ze seznamu dostupných vstupů.

Dostupných vstupních sloupců
Pomocí zaškrtávacích políček zadejte sloupce, které bude transformace skriptu používat.

vstupní sloupec
Vyberte ze seznamu dostupných vstupních sloupců pro každý řádek. Výběry se projeví ve výběru zaškrtávacího políčka v tabulce Dostupné vstupní sloupce .

Alias výstupu
Zadejte alias pro každý výstupní sloupec. Výchozí hodnota je název vstupního sloupce; můžete ale zvolit libovolný jedinečný popisný název.

Typ použití
Určete, zda transformace skriptu bude považovat každý sloupec za ReadOnly nebo ReadWrite.

Editor transformací skriptů (vstupy a výstupní stránka)

Pomocí stránky Vstupy a výstupy dialogového okna Editor transformace skriptů můžete přidat, odebrat a nakonfigurovat vstupy a výstupy pro transformaci skriptu.

Poznámka:

Zdrojové komponenty mají výstupy a žádné vstupy, zatímco cílové komponenty mají vstupy, ale žádné výstupy. Transformace mají vstupy i výstupy.

Další informace o komponentě Skript naleznete v tématu Konfigurace komponenty skriptu v editoru komponent skriptů. Další informace o programování komponenty Script naleznete v tématu Rozšíření toku dat pomocí komponenty Script.

Možnosti

Vstupy a výstupy
Výběrem vstupu nebo výstupu vlevo zobrazíte jeho vlastnosti v tabulce vpravo. Vlastnosti dostupné pro úpravy se liší podle výběru. Mnoho zobrazených vlastností je jen pro čtení. Další informace o jednotlivých vlastnostech najdete v následujících tématech.

společné vlastnosti

Transformace – vlastní vlastnosti

Přidat výstup
Přidejte do seznamu další výstup.

Přidat sloupec
Vyberte složku, do které chcete umístit nový výstupní sloupec, a potom přidejte sloupec kliknutím na Přidat sloupec.

Odebrat výstup
Vyberte výstup a potom ho odeberte kliknutím na Odebrat výstup.

Odebrat sloupec
Vyberte sloupec a potom ho odeberte kliknutím na Odebrat sloupec.

Editor transformace skriptů (stránka skriptu)

Pomocí karty Skript v dialogovém okně Editor transformace skriptů zadejte skript a související vlastnosti.

Další informace o komponentě Skript naleznete v tématu Konfigurace komponenty skriptu v editoru komponent skriptů. Další informace o programování komponenty Script naleznete v tématu Rozšíření toku dat pomocí komponenty Script.

Možnosti

Vlastnosti
Umožňuje zobrazit a upravit vlastnosti transformace skriptu. Mnoho zobrazených vlastností je jen pro čtení. Můžete upravit následující vlastnosti:

Hodnota Popis
Popis Popište transformaci skriptu z hlediska jejího účelu.
ID národního prostředí Zadejte jazykové prostředí ke specifikaci regionálních informací pro objednávání a převod data a času.
název Zadejte popisný název komponenty.
ValidateExternalMetadata Určuje, zda transformace skriptu ověřuje metadata sloupců vůči externím zdrojům dat v době návrhu. Hodnota false zpozdí ověření až do doby spuštění.
ReadOnlyVariables Zadejte čárkami oddělený seznam proměnných pro přístup jen pro čtení pomocí transformace skriptu.

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 přístup pro čtení a zápis pomocí transformace skriptu.

Poznámka: V názvech proměnných se rozlišují malá a velká písmena.
ScriptLanguage Vyberte jazyk skriptu, který má komponenta Script používat.

Chcete-li nastavit výchozí jazyk skriptů pro součásti skriptů a úlohy skriptů, použijte možnost Skriptování jazyk na stránce Obecné v dialogovém okně Možnosti .
UserComponentTypeName Určuje ScriptComponentHost třídu a sestavení Microsoft.SqlServer.TxScript , které podporuje infrastrukturu SYSTÉMU SQL Server.

Upravit skript
K vytvoření nebo úpravě skriptu použijte nástroje Microsoft Visual Studio Tools for Applications (VSTA).

Související obsah

Transformace integračních služeb

Rozšíření toku dat komponentou skriptu

  • Last updated on