Udostępnij za pośrednictwem


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ń.

NoteNote:
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.

Integration Services icon (small) Konfiguracja w aktualizacji z usług integracja Services pobytu

Najnowsze pliki do pobrania, artykuły, próbki, i pliki wideo firmy Microsoft, jak również wybranego rozwiązania od Wspólnoty, odwiedź witrynę Integration Services strona w witrynie MSDN lub TechNet:

Automatycznego powiadomienie tych aktualizacji należy subskrybować źródła danych RSS, które jest dostępne strona.