Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
platí pro:
SQL Server SSIS Integration Runtime ve službě Azure Data Factory
Služba SQL Server Integration Services poskytuje sadu systémových proměnných, které ukládají informace o spuštěném balíčku a jeho objektech. Tyto proměnné lze použít ve výrazech a ve vlastnostech k přizpůsobení balíčků, kontejnerů, úloh a obslužných rutin událostí.
Všechny proměnné systému a uživatelem definované lze použít ve vazbách parametrů, které úloha Execute SQL používá k mapování proměnných na parametry.
Systémové proměnné pro balíčky
Následující tabulka popisuje systémové proměnné, které integrační služby poskytují pro balíčky.
| Systémová proměnná | Datový typ | Description |
|---|---|---|
| CancelEvent | Int32 | Popisovač objektu události Windows, který úkol může použít k signalizaci, že by měl přestat běžet. |
| ContainerStartTime | DateTime | Čas spuštění kontejneru. |
| Datum vytvoření | DateTime | Datum vytvoření balíčku. |
| CreatorComputerName | String | Počítač, na kterém byl balíček vytvořen. |
| CreatorName | String | Jméno osoby, která balíček vytvořila. |
| ExecutionInstanceGUID | String | Jedinečný identifikátor spuštěné instance balíčku. |
| Neúspěšné konfigurace | String | Názvy konfigurací balíčků, které selhaly. |
| IgnoreConfigurationsOnLoad | logický | Určuje, jestli se konfigurace balíčků při načítání balíčku ignorují. |
| InteractiveMode | logický | Určuje, jestli se balíček spouští v interaktivním režimu. Pokud je balíček spuštěn v nástroji SSIS Designer, je tato vlastnost nastavena na hodnotu True. Pokud je balíček spuštěn pomocí nástroje příkazového řádku DTExec , vlastnost je nastavena na False. |
| LocaleId | Int32 | Jazykové prostředí, které balíček používá. |
| Název počítače | String | Název počítače, na kterém je balíček spuštěný. |
| Režim offline | logický | Určuje, jestli je balíček v offline režimu. Offline režim nezíská připojení ke zdrojům dat. |
| PACKAGEID | String | Jedinečný identifikátor balíčku. |
| PackageName | String | Název balíčku. |
| Počáteční čas | DateTime | Čas, kdy se balíček spustil. |
| ServerExecutionID | Int64 | ID spuštění balíčku, který se spouští na serveru integrační služby. Výchozí hodnota je nula. Hodnota se změní pouze v případě, že je balíček spuštěn isServerExec na serveru s integračními službami. Pokud existuje podřízený balíček, předá se hodnota z nadřazeného balíčku do podřízeného balíčku. |
| UserName | String | Účet uživatele, který spustil balíček. Uživatelské jméno je kvalifikované názvem domény. |
| VerzeSestavení | Int32 | Verze balíčku. |
| KomentářVerze | String | Komentáře k verzi balíčku |
| VerzeGUID | String | Jedinečný identifikátor verze. |
| VersionMajor | Int32 | Hlavní verze balíčku. |
| verzeMinor | Int32 | Dílčí verze balíčku. |
Systémové proměnné pro kontejnery
Následující tabulka popisuje systémové proměnné, které integrační služby poskytují pro kontejnery For Loop, Foreach Loop a Sequence.
| Systémová proměnná | Datový typ | Description | Container |
|---|---|---|---|
| LocaleId | Int32 | Lokalizace, kterou kontejner používá. | Kontejner For Loop Kontejner smyčky Foreach Sekvenční kontejner |
Systémové proměnné pro úkoly
Následující tabulka popisuje systémové proměnné, které integrační služby poskytují pro úlohy.
| Systémová proměnná | Datový typ | Description |
|---|---|---|
| CreationName | String | Název úkolu. |
| LocaleId | Int32 | Národní prostředí, které úloha používá. |
| TaskID | String | Jedinečný identifikátor instance úlohy. |
| Název úkolu | String | Název instance úlohy. |
| TaskTransactionOption | Int32 | Možnost transakce, kterou úloha používá. |
Systémové proměnné pro obslužné rutiny událostí
Následující tabulka popisuje systémové proměnné, které integrační služby poskytují obslužným rutinám událostí. Ne všechny proměnné jsou dostupné pro všechny obslužné rutiny událostí.
| Systémová proměnná | Datový typ | Description | Obslužná rutina události |
|---|---|---|---|
| Zrušit | logický | Určuje, jestli obslužná rutina události přestane běžet, když dojde k chybě, upozornění nebo zrušení dotazu. | Zpracovatel události OnError Obslužná rutina události OnWarning Obslužná rutina události OnQueryCancel |
| ErrorCode | Int32 | Identifikátor chyby. | Obslužná rutina události OnError Obslužná rutina události OnInformation Obslužná rutina události OnWarning |
| Popis chyby | String | Popis chyby. | Obslužná rutina události OnError Obslužná rutina události OnInformation Obslužná rutina události OnWarning |
| ExecutionStatus | logický | Aktuální stav provedení. | Obslužná rutina události OnExecStatusChanged |
| Executionvalue | DBNull | Hodnota provedení | Obslužná rutina události OnTaskFailed |
| LocaleId | Int32 | Lokalita, kterou používá obslužné procedury události. | Všechny obslužné rutiny událostí |
| PercentComplete | Int32 | Procento dokončené práce | Obslužná rutina události OnProgress |
| PočetPokrokuVysoký | Int32 | Vysoká část 64bitové hodnoty, která označuje celkový počet operací zpracovaných událostí OnProgress. | Obslužná rutina události OnProgress |
| ProgressCountLow | Int32 | Nízká část 64bitové hodnoty, která označuje celkový počet operací zpracovaných událostí OnProgress. | Obslužná rutina události OnProgress |
| ProgressDescription | String | Popis průběhu | Obslužná rutina události OnProgress |
| Rozšířit | logický | Určuje, zda se událost rozšíří do obslužné rutiny události vyšší úrovně. Poznámka: Hodnota proměnné Šíření je ignorována během ověřování balíčku. Pokud v podřízeném balíčku nastavíte možnost Šíření na hodnotu False , nezabráníte tomu, aby se událost šířila až do nadřazeného balíčku. |
Všechny obslužné rutiny událostí |
| SourceDescription | String | Popis spustitelného souboru v obslužné rutině události, která vyvolala událost. | Všechny obslužné rutiny událostí |
| ID zdroje | String | Jedinečný identifikátor spustitelného souboru v obslužné rutině události, která spustila tuto událost. | Všechny obslužné rutiny událostí |
| SourceName | String | Název spustitelného souboru v obsluze události, která vyvolala událost. | Všechny obslužné rutiny událostí |
| VariableDescription | String | Popis proměnné. | Obslužná rutina události OnVariableValueChanged |
| VariableID | String | Jedinečný identifikátor proměnné. | Obslužná rutina události OnVariableValueChanged |
Systémové proměnné ve vazbách parametrů
Při spuštění balíčku je často užitečné ukládat hodnoty systémových proměnných v tabulkách. Například balíček, který dynamicky vytvoří tabulku a ve sloupci tabulky zapíše identifikátor GUID instance spuštění balíčku, který vytvořil tabulku.
Pokud k mapování na parametry v příkazu SQL použijete systémové proměnné, které používá úloha Execute SQL, je důležité nastavit datový typ každé vazby parametrů na datový typ systémové proměnné. Jinak mohou být hodnoty systémových proměnných nesprávně přeloženy. Pokud je například systémová proměnná ExecutionInstanceGUID, která má datový typ řetězce a obsahuje řetězec představující identifikátor GUID probíhající instance balíčku, použita ve vazbě parametru s datovým typem GUID, identifikátor GUID instance balíčku se nesprávně upraví.
Toto pravidlo platí i pro uživatelem definované proměnné. Ale zatímco datové typy systémových proměnných nelze změnit a musíte přizpůsobit použití těchto proměnných tak, aby odpovídaly datovým typům, uživatelsky definované jsou flexibilnější. Uživatelem definované proměnné, které se používají ve vazbách parametrů, jsou obvykle definovány s datovými typy, které jsou kompatibilní s datovými typy parametrů, na které jsou mapovány.