Udostępnij za pośrednictwem


Integracja usług zmiennych

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

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

  • Trwa 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 tabela odnośników w pamięci.Na przykład pakiet można uruchomić zadanie wykonanie instrukcji SQL, który ładuje zmienna o wartości danych.

  • Ładowanie zmienne z wartościami danych i za ich pomocą określić warunek wyszukiwania w klauzula WHERE.Na przykład skrypt w zadania skryptu można zaktualizować wartość zmiennej używanej przez instrukcji Transact-SQL w zadanie wykonanie instrukcja języka SQL.

  • Zmienna z całkowitą oraz za pomocą wartości do formantu zapętlenie w ramach pakiet przepływ sterowania.Na przykład można użyć zmiennej w ocenie wyrażenie do iteracji formantu kontener dla pętli.

  • Wypełnianie wartości parametrów dla instrukcji Transact-SQL przy uruchomieniu czas.Na przykład pakiet można uruchomić zadanie wykonanie instrukcja języka SQL i dynamicznie używać zmiennych do zestaw parametrów w instrukcji Transact-SQL.

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

Integration Servicesobsł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ć tyle zmienne zdefiniowane przez użytkownika wymaga pakiet, ale nie można utworzyć dodatkowe systemowe zmienne.

Wszystkie zmienne — system i zdefiniowane przez użytkownika — mogą być używane w parameter bindings, używane do mapowania zmiennych parametrów w instrukcji SQL zadanie wykonanie instrukcji SQL.Aby uzyskać więcej informacji, zobacz SSIS wykonać zadanie SQL i Praca z parametrów i zwracanych kodów w wykonywanie zadań SQL.

Ostrzeżenie

Nazwy użytkownika i zmienne systemowe są przypadek poufne.

Można tworzyć zmienne użytkownika dla wszystkich Integration Services typy kontener: pakiety, pojemniki Foreach pętli, pętli dla kontenerów, kontenerów sekwencji, zadania i zdarzenie obsługi.Zmienne zdefiniowane przez użytkownika są członkami kolekcja zmiennych kontener.

Po utworzeniu pakiet za pomocą SSIS Designer, można wyświetlić członków kolekcji zmiennych w zmiennych folderów na Explorer pakiet karcie SSIS projektanta.Foldery listy zmiennych zdefiniowanej przez użytkownika i zmienne systemowe.

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

  • Podaj nazwę i opis dla zmiennej.

  • Określanie nazw dla zmiennej.

  • Wskazuje, czy zmienna wywołuje zdarzenie, w przypadku zmiany jej wartości.

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

  • Użyj wynik oceny wyrażenie do zestaw wartość zmiennej.

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

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

Tylko skonfigurowania opcji w zmiennych systemowych jest określenie, czy podnoszą one zdarzenie po zmianie wartości.

Zestaw zmiennych systemowych jest dostępna dla różne typy kontener.Aby uzyskać więcej informacji o zmiennych systemowych używanych przez opakowań i ich elementów, zobacz Zmienne systemowe.

Aby uzyskać więcej informacji na temat scenariusze użycia rzeczywistym zmiennych, zobacz Korzystanie ze zmiennych w opakowaniach.

Przestrzeń nazw

Integration Serviceszawiera dwa obszary nazw, użytkownika i System.Domyślnie, zmienne niestandardowe są w użytkownika nazw i zmienne systemowe są w System obszaru nazw.Można utworzyć dodatkowe obszary nazw zmiennych zdefiniowanych przez użytkownika i zmienić nazwę użytkownika nazw, ale nie można zmienić nazwy System obszaru nazw, dodawanie zmiennych do System obszaru nazw, lub przypisać inny obszar nazw zmiennych systemowych.

Zakres

Zmienna jest tworzony w zakres pakiet lub w zakres kontener, zadania lub obsługi zdarzeń w pakiecie.Ponieważ kontener pakiet jest u góry hierarchii kontener, zmienne pakiet zakres funkcja jak zmienne globalne i mogą być używane przez wszystkich kontenerów w pakiecie.Podobnie, zmiennych zdefiniowanych w zakres kontenera, takich jak pętli dla kontenera mogą być używane przez wszystkich zadań lub kontenerów znajdujących się wewnątrz kontenera dla pętli.

Jeśli pakiet uruchomi inne pakiety przy użyciu pakietu na wykonanie zadania, zmienne zdefiniowane w zakres wywołującego pakietu lub pakietu wykonanie zadań można udostępniane do pakietu wywoływanego przy użyciu zmiennej pakiet nadrzędny typ konfiguracja.Aby uzyskać więcej informacji, zobacz Konfiguracji pakietu SSIS.

Wartość

Wartość zmiennej użytkownika może być literału lub wyrażenie.Zmienna obejmuje opcje ustawień wartości zmiennej i typ danych wartości.Dwie właściwości muszą być zgodne: na przykład użyj wartości ciąg wraz z danych typu Liczba całkowita nie jest prawidłowy.

Jeśli zmienna jest skonfigurowany do oceny jako wyrażenia, należy podać wyrażenie.Przy uruchomieniu czas, wyrażenie jest sprawdzane i zmienna jest ustawiana na wynik oceny.Na przykład, jeśli zmienna używa 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 gramatyki składni wyrażenia.Wyrażenie jest używany ze zmiennymi, wyrażenie można użyć literałów i operatory i funkcje, które zapewnia gramatyki wyrażenie, ale wyrażenie nie może odwoływać się do kolumn z przepływ danych w pakiet.Maksymalna długość wyrażenie wynosi 4000 znaków.Aby uzyskać więcej informacji, zobacz Odwołanie do wyrażeń w usługach Integration Services.

Konfigurowanie zmiennych

zestaw właściwości poprzez SSIS Projektant lub programowo.

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

Programowo skonfigurować zmiennych

Aby dowiedzieć się więcej o zmiennej, właściwości i uzyskać więcej informacji o programowo ustawianiu tych właściwości, zobacz Variable.

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.