Zmienne systemowe
SQL Server Integration Services provides a set of system variables that store information about the running package and its objects.Te zmienne można w wyrażeniach właściwość i wyrażeń dostosować opakowań, kontenerów, zadania i zdarzenie obsługi.
Wszystkie zmienne — system i zdefiniowane przez użytkownika — mogą być używane w parameter bindings, używane do mapowania zmiennych parametrów zadanie wykonanie instrukcji SQL.
Zmienne systemowe dla pakietów
W poniższej tabela opisano zmienne systemowe, Integration Services przewiduje pakietów.
Zmienna systemowa |
Typ danych |
Opis |
---|---|---|
CancelEvent |
Int32 |
Dojście do obiektu zadania sygnału można wskazać zadania należy przerwać, uruchomiony zdarzeń systemu Windows. |
CreationDate |
DateTime |
Data utworzenia pakiet. |
CreatorComputerName |
String |
Komputer, na którym pakiet został utworzony. |
CreatorName |
String |
Nazwa osoby, która zbudowany 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 Projektant, ta właściwość jest zestaw do True.If a package is running using the DTExec command prompt utility, the property is set to False. |
LocaleId |
Int32 |
Ustawienia regionalne używa pakiet. |
MachineName |
String |
Nazwa komputera, na którym jest uruchomiony 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 |
czas Pakiet rozpoczęcia uruchamiania. |
UserName |
String |
Konto użytkownika, który uruchomił pakiet.Nazwa użytkownika jest kwalifikowana nazwa 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 |
Pakiet wersja pomocnicza. |
Zmienne systemowe dla kontenerów
W poniższej tabela opisano zmienne systemowe, Integration Services dla pętli, Foreach pętli i pojemniki sekwencji.
Zmienna systemowa |
Typ danych |
Opis |
Kontener |
---|---|---|---|
LocaleId |
Int32 |
Ustawienia regionalne używa kontener. |
Dla kontener pętli Kontener foreach pętli Kontener sekwencji |
Zmienne systemowe dla zadań
W poniższej tabela opisano zmienne systemowe, Integration Services przewiduje zadania.
Zmienna systemowa |
Typ danych |
Opis |
---|---|---|
CreationName |
String |
Nazwa zadania. |
LocaleId |
Int32 |
Ustawienia regionalne używa zadania. |
TaskID |
String |
Identyfikator unikatowy wystąpienie zadania. |
TaskName |
String |
Nazwa wystąpienie zadania. |
TaskTransactionOption |
Int32 |
Opcja transakcji, która używa zadania. |
Zmienne systemowe dla obsługi zdarzeń
W poniższej tabela opisano zmienne systemowe, Integration Services przewiduje zdarzenie obsługi.Nie wszystkie zmienne są dostępne dla wszystkich zdarzenie obsługi.
Zmienna systemowa |
Typ danych |
Opis |
Obsługa zdarzeń |
---|---|---|---|
Cancel |
Boolean |
Wskazuje, czy obsługa zdarzeń zatrzymane, kiedy błąd, ostrzeżenie lub występuje anulowania kwerendy. |
OnErrorobsługa zdarzeń OnWarningobsługa zdarzeń OnQueryCancelobsługa zdarzeń |
ErrorCode |
Int32 |
Identyfikator błędu. |
OnErrorobsługa zdarzeń OnInformationobsługa zdarzeń OnWarningobsługa zdarzeń |
ErrorDescription |
String |
Opis błędu. |
OnErrorobsługa zdarzeń OnInformationobsługa zdarzeń OnWarningobsługa zdarzeń |
ExecutionStatus |
Boolean |
Bieżący stan wykonania. |
OnExecStatusChangedobsługa zdarzeń |
ExecutionValue |
DBNull |
Wartość wykonanie. |
OnTaskFailedobsługa zdarzeń |
LocaleId |
Int32 |
Ustawienia regionalne, obsługa zdarzeń używa. |
Wszystkie zdarzenie obsługi |
PercentComplete |
Int32 |
Procent wykonanej. |
OnProgressobsługa zdarzeń |
ProgressCountHigh |
Int32 |
Część wysoką wartość 64-bitowa, wskazująca, że całkowita liczba przetworzonych przez zdarzenie OnProgress operacji. |
OnProgressobsługa zdarzeń |
ProgressCountLow |
Int32 |
Część niska wartość 64-bitowa, wskazująca, że całkowita liczba operacji przetwarzania przez zdarzenie OnProgress. |
OnProgressobsługa zdarzeń |
ProgressDescription |
String |
Opis postępu. |
OnProgressobsługa zdarzeń |
Propagate |
Boolean |
Wskazuje, czy zdarzenie jest propagowana do programu obsługa zdarzeń poziom wyższym.
Uwaga:
Wartość Propagate zmienna jest ignorowana podczas sprawdzania poprawności pakiet. Jeśli użytkownik zestaw Propagate do False w pakiecie podrzędność, nie przeszkadza to zdarzenie propagowaniu do pakiet nadrzędnej.Aby zapobiec pakiet nadrzędnym obsługi zdarzeń, zestaw DisableEventHandlers właściwość zadania wykonywania pakiet 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ługa zdarzeń który spowodował zdarzenie. |
Wszystkie zdarzenie obsługi |
VariableDescription |
String |
Opis zmiennej. |
OnVariableValueChangedobsługa zdarzeń |
VariableID |
String |
Identyfikator unikatowy zmiennej. |
OnVariableValueChangedobsługa zdarzeń |
Używanie zmiennych systemowych w Parameter Bindings
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 GUID wystąpienie wykonanie pakietu utworzony tabela kolumna tabela.
Jeśli mapowanie do parametrów w instrukcja języka SQL używający zadanie wykonanie instrukcja języka SQL za pomocą zmiennych systemowych, ważne jest, że zestaw typ danych każdego parametru powiązanie typ danych zmienna systemowa.W przeciwnym wypadku wartości zmiennych systemowych mogą być niepoprawnie tłumaczone.Na przykład jeśli ExecutionInstanceGUID zmienna systemowa, posiada ciąg typ danych i zawiera ciąg, który reprezentuje identyfikator GUID wystąpienie nakaz pakietu, jest używany w powiązaniu parametr GUID typu, GUID wystąpienie pakiet zostanie przetłumaczony nieprawidłowo.
Ta reguła ma zastosowanie do zdefiniowanej przez użytkownika również zmiennych.Ale nie można zmienić typy danych zmiennych systemowych i trzeba dostosować sposób korzystania z tych zmiennych do dopasowanie typy danych zdefiniowane przez użytkownika są bardziej elastyczne.Zmienne zdefiniowane przez użytkownika są używane w parameter bindings są zwykle zdefiniowane z typami danych, które są zgodne z typami danych parametrów, które są mapowane.
|