Udostępnij za pośrednictwem


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.

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

Ikona usług Integration Services (mała)Bieżąco z usług integracji

Najnowsze pliki do pobrania, artykuły, próbki i wideo firmy Microsoft, jak również wybranych rozwiązań ze Wspólnoty, odwiedź witrynę Integration Services strona na MSDN i TechNet:

Aby otrzymywać automatyczne powiadomienia dotyczące tych aktualizacji, zasubskrybuj źródła danych RSS dostępne na tej stronie.