Integration Services Variables

Variables store values that a SQL Server Integration Services package and its containers, tasks, and event handlers can use at run time.Skrypty w zadań skryptów i składników skryptów można również używać zmiennych.Ograniczenia pierwszeństwo sekwencji zadań i pojemników do przepływu pracy można używać zmiennych podczas ich definicje ograniczenie zawierają wyrażenia.

Można używać zmiennych w Integration Services pakiety do następujących celów:

  • Aktualizowanie właściwości elementów pakiet przy uruchomieniu czas.Na przykład zestaw dynamicznie liczbę równoczesnych plików wykonywalnych, które umożliwia kontener Foreach pętli.

  • W tym już tabela odnośników w pamięci.Na przykład pakiet można uruchomić zadania programu wykonać instrukcji SQL, który ładuje zmienna o wartości danych.

  • Załadowanie zmiennych o wartości danych, a następnie użyć ich do określenia warunek wyszukiwania w klauzula WHERE.Na przykład skrypt w zadaniu skrypt może zaktualizować wartości zmiennej, która jest używana przez instrukcja języka Transact-SQL, w sprawie zadania wykonać instrukcja języka SQL.

  • Ładowanie zmiennej z liczbą całkowitą, a następnie korzystając z wartości do formantu zapętlenie w ramach pakiet przepływ sterowania.Na przykład służy do zmiennej w wyrażeniu oceny kontener pętli for do kontrolowania iteracji.

  • Podczas wypełniania wartości parametrów dla instrukcji języka Transact-SQL, w czasie wykonywania.Na przykład pakiet można uruchomić zadanie wykonać instrukcja języka SQL, a następnie użyć zmiennych, które dynamicznie zestaw parametrów w instrukcja języka Transact-SQL.

  • Budowanie wyrażenia, które zawierają wartości zmiennych.Na przykład transformacja pochodnego kolumna można wypełnić kolumna w wyniku, mnożąc wartość zmiennej jest przez wartość kolumna.

Integration Services obsługuje dwa typy zmiennych: zmienne zdefiniowane przez użytkownika i zmienne systemowe. Zmienne zdefiniowane przez użytkownika są definiowane przez deweloperów pakiet i zmienne systemowe są definiowane przez Integration Services. Można utworzyć dowolną liczbę zmiennych użytkownika wymaga pakiet, ale nie można utworzyć dodatkowe systemowe zmienne.

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 w instrukcji SQL.Aby uzyskać więcej informacji zobacz wykonać zadań SQL i Praca z parametry i Zwróć kody w wykonać zadań SQL.

Uwaga

Nazwy użytkownika i zmiennych systemowych jest uwzględniana wielkość liter.

Zmienne zdefiniowane przez użytkownika można tworzyć dla wszystkich Integration Services typy kontener: pakiety, pętla Foreach kontenerów, pętli dla kontenerów, kontenery sekwencji, zadań, a zdarzenie obsługi. Zmienne zdefiniowane przez użytkownika są członkami kolekcja zmienne kontener.

Po utworzeniu pakietu przy użyciu SSIS Projektanta, można wyświetlić członków kolekcji zmienne w Zmienne folderówPakiet Eksploratora tab of SSIS Projektant. Foldery na liście zmiennych systemowych i zmienne zdefiniowane przez użytkownika.

Zmienne zdefiniowane przez użytkownika można skonfigurować w następujący sposób:

  • Podaj nazwę i opis dla zmiennej.

  • Określić obszar nazw dla zmiennej.

  • Wskazuje, czy zmienna wywołuje zdarzenie, gdy jej wartość.

  • Wskazuje, czy zmienna jest tylko do odczytu lub zapisu i odczytu.

  • Wynik oceny wyrażenie należy użyć, aby ustawić wartość zmiennej.

  • Tworzenie zmiennej w zakres obiektu pakietu, takich jak zadania lub pakiet.

  • Określ wartość i dane typu zmiennej.

Tylko można konfigurować opcji w zmiennych systemowych jest określająca, czy ich pozyskiwania zdarzenie, kiedy zmieniają się wartości.

Zestaw zmiennych systemowych jest dostępna na różne typy kontener.Aby uzyskać więcej informacji na temat zmiennych systemowych, pakietów i ich elementów Zobacz Zmienne systemowe.

Aby uzyskać więcej informacji na temat scenariuszy odzwierciedlających rzeczywistym dla zmiennych zobacz Za pomocą zmiennych w pakietach.

Obszar nazw

Integration Services zawiera dwa obszary nazw, Użytkownik and System.Domyślnie, zmienne niestandardowe są w Użytkownik nazw i zmienne systemowe znajdują się w System obszar nazw.Można tworzyć dodatkowe obszary nazw zmiennych zdefiniowanej przez użytkownika i zmienić nazwę Użytkownik obszaru nazw, ale nie można zmienić nazwy System nazw dodać zmiennychSystem obszaru nazw lub zmienne systemu przypisz do innego obszaru nazw.

Zakres

Zmienna jest tworzony w ramach pakiet w zakresie kontener, zadanie lub obsługa zdarzeń w pakiecie.Ponieważ kontener pakietu znajduje się na najwyższym poziomie w hierarchii kontener, zmienne pakiet zakres funkcja takich jak zmienne globalne i mogą być używane przez wszystkich pojemników w pakiecie.Podobnie, zmienne zdefiniowane w zakres kontener, na przykład pętli dla kontener mogą być używane przez wszystkich zadań lub kontenerów znajdujących się wewnątrz kontener pętli for.

Jeśli pakiet uruchomi inne pakiety przy użyciu pakietu wykonać zadań, zmiennych określonych w zakresie pakiet wywołanie lub pakiet wykonać zadań można udostępnić do pakietu wywoływanego przy użyciu typ nadrzędny pakiet zmienne konfiguracja.Aby uzyskać więcej informacji zobaczPackage Configurations.

Wartość

Wartość zmiennej użytkownika może być literał, lub wyrażenie.Zmienna zawiera opcje dotyczące określania wartości zmiennej i typ danych wartości.Dwie właściwości muszą być zgodne: na przykład korzystanie z ciąg znaków wraz z danych typu Liczba całkowita jest nieprawidłowa.

Jeśli zmienna jest skonfigurowany do oceny jako wyrażenie, musisz podać wyrażenie.Przy uruchomieniu czas jest obliczane wyrażenie i zmiennej jest równa wynik oceny.Na przykład, jeśli zmienna używane jest wyrażenie DATEPART("month", GETDATE()) wartość zmiennej jest odpowiednikiem numer miesiąca do data bieżącej. Wyrażenie musi być prawidłowe wyrażenie, które używa SSIS Składnia wyrażeń gramatyki. Wyrażenie jest używana w zmiennych, wyrażenie można użyć literałów i operatory i funkcje, które zawiera gramatyki wyrażenie, ale wyrażenie nie może odwoływać się do kolumn z przepływ danych w pakiecie.Maksymalna długość wyrażenie wynosi 4000 znaków.Aby uzyskać więcej informacji zobaczIntegracja usług wyrażenie odwołania.

Konfigurowanie zmienne

zestaw właściwości za pomocą SSIS Projektant lub programowo.

Aby uzyskać więcej informacji na temat właściwości, które zestaw w SSIS Projektanta, zobacz temat Okno zmiennych.

Konfigurowanie zmienne programowe

Aby dowiedzieć się więcej o zmiennej właściwości oraz aby uzyskać więcej informacji na temat programowego ustawianiu tych właściwości, zobacz Variable.

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.