Zmienne systemowe
SQL Server Integration Services udostępnia zestaw zmiennych systemowych, które przechowywane są informacje o bieżących pakiet i jej obiektów.Te zmienne mogą być używane w wyrażeniach i wyrażeniach właściwość do dostosowania pakietów, pojemniki, zadań, a zdarzenie obsługi.
Wszystkie zmienne — system i zdefiniowanych przez użytkownika — mogą być używane w powiązań parametrów, które zadanie wykonać instrukcji SQL używany do mapowania zmiennych parametrów.
Zmienne systemowe dla pakietów
W poniższej tabela opisano zmienne systemu, Integration Services zapewnia pakietów.
Zmienna systemowa |
Typ danych |
Description |
---|---|---|
CancelEvent |
Int32 |
Dojście do systemu Windows zdarzenie obiekt, który zadanie może sygnalizować oznacza, że zadanie powinno zostać zatrzymane z systemem. |
CreationDate |
DateTime |
Dzień, w którym został utworzony pakiet. |
CreatorComputerName |
String |
Komputer, na którym został utworzony pakiet. |
CreatorName |
String |
Nazwa osoby, która jest wbudowana do pakiet. |
ExecutionInstanceGUID |
String |
Identyfikator unikatowy wykonującego wystąpienie pakiet. |
InteractiveMode |
Boolean |
Wskazuje, czy pakiet jest uruchamiany w trybie interakcyjnym.Jeśli pakiet jest uruchomiony w SSIS Projektanta, ta właściwość jest zestaw do True. If a package is running using the DTExeccommand prompt utility, the property is set to False. |
LocaleId |
Int32 |
regionalny, które korzysta z pakiet. |
MachineName |
String |
Nazwa komputera, na którym uruchomiony jest pakiet. |
OfflineMode |
Boolean |
Wskazuje, czy pakiet jest w trybie offline.Tryb offline nie nabywa źródłami danych. |
PackageID |
String |
Identyfikator unikatowy pakiet. |
PackageName |
String |
Nazwa pakiet. |
StartTime |
DateTime |
Przy uruchomieniu tego pakiet do uruchomienia. |
UserName |
String |
Konto użytkownika, który uruchomił pakiet.Nazwa użytkownika jest kwalifikowaną nazwę domena. |
VersionBuild |
Int32 |
Wersja pakiet. |
VersionComment |
String |
Komentarze na temat wersja pakiet. |
VersionGUID |
String |
Identyfikator unikatowy wersja. |
VersionMajor |
Int32 |
Główny numer wersja pakiet. |
VersionMinor |
Int32 |
Podrzędny numer wersja pakiet. |
Zmienne systemowe dla kontenerów
W poniższej tabela opisano zmienne systemu, Integration Services przewiduje się pojemniki dla pętli, pętla Foreach i sekwencji.
Zmienna systemowa |
Typ danych |
Description |
Kontener |
---|---|---|---|
LocaleId |
Int32 |
regionalny, korzystającej z kontener. |
Pętla kontener Pętla foreach kontener Kontener sekwencji |
Zmienne systemowe dla zadania
W poniższej tabela opisano zmienne systemu, Integration Services zawiera zadania.
Zmienna systemowa |
Typ danych |
Description |
---|---|---|
CreationName |
String |
Nazwa zadania. |
LocaleId |
Int32 |
regionalny, który używa tego zadania. |
TaskID |
String |
Identyfikator unikatowy wystąpienie zadania. |
TaskName |
String |
Nazwa wystąpienie zadania. |
TaskTransactionOption |
Int32 |
Opcja transakcji, która korzysta z tego zadania. |
Zmienne systemowe w zdarzenie programy obsługi
W poniższej tabela opisano zmienne systemu, Integration Services przewiduje zdarzenie obsługi. Nie wszystkie zmienne są dostępne dla wszystkich zdarzenie obsługi.
Zmienna systemowa |
Typ danych |
Description |
zdarzenie obsługi |
---|---|---|---|
Cancel |
Boolean |
Wskazuje, czy zdarzenie obsługi przerywane, gdy błąd, ostrzeżenie, lub anulowania kwerendy występuje. |
OnError zdarzenie obsługi OnWarning zdarzenie obsługi OnQueryCancel zdarzenie obsługi |
ErrorCode |
Int32 |
Identyfikator błędu. |
OnError zdarzenie obsługi OnInformation zdarzenie obsługi OnWarning zdarzenie obsługi |
ErrorDescription |
String |
Opis błędu. |
OnError zdarzenie obsługi OnInformation zdarzenie obsługi OnWarning zdarzenie obsługi |
ExecutionStatus |
Boolean |
Bieżący stan wykonania. |
OnExecStatusChanged zdarzenie obsługi |
ExecutionValue |
DBNull |
Wartość wykonania. |
OnTaskFailed zdarzenie obsługi |
LocaleId |
Int32 |
regionalny, zdarzenie korzysta z programu obsługi. |
Wszystkie zdarzenie obsługi |
PercentComplete |
Int32 |
Procent Praca wykonana. |
OnProgress zdarzenie obsługi |
ProgressCountHigh |
Int32 |
Część wysoka wartość 64-bitowa, wskazująca, że całkowita liczba przetworzonych przez zdarzenie OnProgress operacji. |
OnProgress zdarzenie obsługi |
ProgressCountLow |
Int32 |
Niskie część wartość 64-bitowa, wskazująca, że całkowita liczba przetworzonych przez zdarzenie OnProgress operacji. |
OnProgress zdarzenie obsługi |
ProgressDescription |
String |
Opis postępu. |
OnProgress zdarzenie obsługi |
Propagate |
Boolean |
Wskazuje, czy zdarzenie jest propagowana na wyższym poziomie obsługa zdarzeń.
Note:
Wartość Propagate Zmienna nie jest uwzględniany podczas sprawdzania poprawności pakiet. Jeśli użytkownik zestaw Propagate Aby False w pakiecie podrzędnym to nie zapobiega zdarzenie propagowania do pakiet nadrzędnej. Do pr zdarzenie pakiet nadrzędny z obsługi zdarzenie, ustaw DisableEventHandlers właściwość pakietu wykonać zadania True.
|
Wszystkie zdarzenie obsługi |
SourceDescription |
String |
Opis pliku wykonywalnego w obsługa zdarzeń który spowodował zdarzenie. |
Wszystkie zdarzenie obsługi |
SourceID |
String |
Identyfikator unikatowy pliku wykonywalnego w obsługa zdarzeń który spowodował zdarzenie. |
Wszystkie zdarzenie obsługi |
SourceName |
String |
Nazwa pliku wykonywalnego w obsłudze zdarzeń, który spowodował zdarzenie. |
Wszystkie zdarzenie obsługi |
VariableDescription |
String |
Opis zmiennej. |
Obsługa zdarzeń OnVariableValueChanged |
VariableID |
String |
Identyfikator unikatowy zmiennej. |
Obsługa zdarzeń OnVariableValueChanged |
W polu powiązania parametru za pomocą zmienne środowiskowe
Warto często zapisywać wartości zmiennych systemowych w tabelach po uruchomieniu tego pakiet.Na przykład pakiet, który dynamicznie tworzy tabela i zapisuje identyfikatora GUID wystąpienie wykonywania pakietu utworzone w tabela kolumna tabela.
Jeśli używasz zmiennych systemowych do mapowania parametrów w instrukcja języka SQL, używanych do zadania wykonać instrukcja języka SQL, ważne jest ustawiony typ danych każdego wiązanie parametru na typ danych zmienna systemowa.W przeciwnym razie wartości zmiennych systemowych mogą być tłumaczone prawidłowo.Na przykład jeśli ExecutionInstanceGUID systemu zmienną, która zawiera ciąg, wpisz dane i zawiera ciąg, który reprezentuje identyfikator GUID obiektu wykonującego pakiet, jest używany w powiązaniu parametr z danych typu GUID, identyfikator GUID wystąpienie pakiet będą tłumaczone niepoprawnie.
Ta reguła ma zastosowanie do zdefiniowanej przez użytkownika jak i zmiennych.Ale nie można zmienić typy danych poszczególnych zmiennych systemowych i trzeba dostosować sposób korzystania z tych zmiennych, aby dopasować typy danych zdefiniowane przez użytkownika są bardziej elastyczne.Zmienne zdefiniowane przez użytkownika są używane w powiązaniach parametr zwykle są definiowane z typami danych, które są zgodne z typami danych parametrów, do którego są mapowane.
|