Pakiet usług Integration Services (SSIS) i parametry projektu

Dotyczy:SQL Server Środowisko SSIS Integration Runtime w usłudze Azure Data Factory

Parametry usług Integration Services (SSIS) umożliwiają przypisywanie wartości do właściwości w pakietach w momencie wykonywania pakietu. Parametry projektu można utworzyć na poziomie projektu i parametrach pakietu na poziomie pakietu. Parametry projektu służą do dostarczania jakichkolwiek zewnętrznych danych wejściowych odbieranych przez projekt do co najmniej jednego pakietu w projekcie. Parametry pakietu umożliwiają modyfikowanie wykonywania pakietu bez konieczności edytowania i ponownego wdrażania pakietu.

W narzędziach SQL Server Data Tools tworzysz, modyfikujesz lub usuwasz parametry projektu przy użyciu okna Project.params . Parametry pakietu można tworzyć, modyfikować i usuwać przy użyciu karty Parametry w projektancie usług SSIS. Nowy lub istniejący parametr należy skojarzyć z właściwością zadania przy użyciu okna dialogowego Parametryzacja .

Parametry i model wdrażania pakietów

Ogólnie rzecz biorąc, jeśli wdrażasz pakiet przy użyciu modelu wdrażania pakietów, należy użyć konfiguracji zamiast parametrów.

Podczas wdrażania pakietu zawierającego parametry przy użyciu modelu wdrażania pakietu, a następnie wykonywania pakietu, parametry nie są wywoływane podczas wykonywania. Jeśli pakiet zawiera parametry pakietu i wyrażenia w pakiecie, użyj parametrów, wartości wynikowe są stosowane w czasie wykonywania. Jeśli pakiet zawiera parametry projektu, wykonanie pakietu może zakończyć się niepowodzeniem.

Parametry i model wdrażania projektu

Podczas wdrażania projektu na serwerze usług Integration Services (SSIS) można używać widoków, procedur składowanych i interfejsu użytkownika programu SQL Server Management Studio do zarządzania parametrami projektu i pakietu. Aby uzyskać więcej informacji, zobacz następujące tematy:

• Widoki (katalog usług Integration Services)

• Procedury składowane (katalog usług Integration Services)

• Konfigurowanie, okno dialogowe

• Okno dialogowe Wykonywanie pakietu

Wartości parametrów

Do parametru można przypisać maksymalnie trzy różne typy wartości. Po uruchomieniu wykonywania pakietu pojedyncza wartość jest używana dla parametru, a parametr jest rozpoznawany jako ostateczna wartość literału.

W poniższej tabeli wymieniono typy wartości.

Można użyć jednego parametru, aby przypisać wartość do wielu właściwości pakietu. Właściwość pojedynczego pakietu może być przypisana tylko z jednego parametru.

Wykonania i wartości parametrów

Wykonanie jest obiektem reprezentującym pojedyncze wystąpienie wykonywania pakietu. Podczas tworzenia wykonywania należy określić wszystkie szczegóły niezbędne do uruchomienia pakietu, takiego jak wartości parametrów wykonywania. Można również zmodyfikować wartości parametrów dla istniejących wykonań.

Po jawnym ustawieniu wartości parametru wykonywania wartość ma zastosowanie tylko do tego konkretnego wystąpienia wykonania. Wartość wykonania jest używana zamiast wartości serwera lub wartości projektowej. Jeśli nie ustawisz jawnie wartości wykonania i określono wartość serwera, zostanie użyta wartość serwera.

Jeśli parametr jest oznaczony jako wymagany, wartość serwera lub wartość wykonania musi być określona dla tego parametru. W przeciwnym razie odpowiedni pakiet nie jest wykonywany. Mimo że parametr ma wartość domyślną w czasie projektowania, nigdy nie będzie używany po wdrożeniu projektu.

Zmienne środowiskowe

Jeśli parametr odwołuje się do zmiennej środowiskowej, wartość literału z tej zmiennej jest rozpoznawana za pośrednictwem określonego odwołania do środowiska i zastosowana do parametru. Końcowa wartość parametru literału, która jest używana do wykonywania pakietu, jest określana jako wartość parametru wykonywania. Należy określić odwołanie środowiska do wykonania przy użyciu okna dialogowego Wykonywanie

Jeśli parametr projektu odwołuje się do zmiennej środowiskowej i nie można rozpoznać wartości literału ze zmiennej podczas wykonywania, używana jest wartość projektu. Wartość serwera nie jest używana.

Aby wyświetlić zmienne środowiskowe przypisane do wartości parametrów, wykonaj zapytanie dotyczące widoku catalog.object_parameters. Aby uzyskać więcej informacji, zobacz catalog.object_parameters (baza danych SSISDB).

Określanie wartości parametrów wykonywania

Następujące widoki Transact-SQL i procedura składowana mogą służyć do wyświetlania i ustawiania wartości parametrów.

catalog.execution_parameter_values (baza danych SSISDB)(widok)
Pokazuje rzeczywiste wartości parametrów w określonym wykonaniu.

catalog.get_parameter_values (baza danych SSISDB) ( procedura składowana)
Rozpoznaje i pokazuje rzeczywiste wartości dla określonego pakietu i odwołania do środowiska.

catalog.object_parameters (baza danych SSISDB) ( widok)
Wyświetla parametry i właściwości wszystkich pakietów i projektów w katalogu usług Integration Services, w tym wartości domyślne projektu i domyślne serwera.

catalog.set_execution_parameter_value (baza danych SSISDB)
Ustawia wartość parametru dla wystąpienia wykonywania w katalogu usług Integration Services.

Możesz również użyć okna dialogowego Wykonywanie pakietu w narzędziach SQL Server Data Tools (SSDT) zmodyfikuj wartość parametru. Aby uzyskać więcej informacji, zobacz Wykonywanie pakietu okno dialogowe.

Możesz również użyć opcji dtexec /Parameter , aby zmodyfikować wartość parametru. Aby uzyskać więcej informacji, zobacz dtexec Utility.

Walidacja parametru

Jeśli nie można rozpoznać wartości parametrów, odpowiednie wykonanie pakietu zakończy się niepowodzeniem. Aby uniknąć błędów, możesz zweryfikować projekty i pakiety przy użyciu okna dialogowego Weryfikowanie w narzędziach SQL Server Data Tools (SSDT). Walidacja umożliwia potwierdzenie, że wszystkie parametry mają niezbędne wartości lub mogą rozpoznać niezbędne wartości przy użyciu określonych odwołań do środowiska. Walidacja sprawdza również inne typowe problemy z pakietem.

Aby uzyskać więcej informacji, zobacz Weryfikowanie okna dialogowego.

Przykład parametru

W tym przykładzie opisano parametr o nazwie pkgOptions używany do określania opcji pakietu, w którym się znajduje.

W czasie projektowania, kiedy parametr został utworzony w narzędziach SQL Server Data Tools, do parametru przypisano domyślną wartość 1. Ta wartość domyślna jest określana jako domyślna nazwa projektu. Jeśli projekt został wdrożony w wykazie SSISDB i żadne inne wartości nie zostały przypisane do tego parametru, właściwość pakietu odpowiadająca parametrowi pkgOptions zostanie przypisana wartość 1 podczas wykonywania pakietu. Domyślna wartość projektu jest utrwalana w projekcie w całym cyklu życia.

Podczas przygotowywania określonego wystąpienia wykonywania pakietu wartość 5 jest przypisywana do parametru pkgOptions . Ta wartość jest określana jako wartość wykonania, ponieważ ma zastosowanie do parametru tylko dla tego konkretnego wystąpienia wykonywania. Po rozpoczęciu wykonywania właściwość pakietu odpowiadająca parametrowi pkgOptions jest przypisywana wartość 5.

Tworzenie parametrów

Narzędzia SQL Server Data Tools (SSDT) służą do tworzenia parametrów projektu i parametrów pakietu. Poniższe procedury zawierają instrukcje krok po kroku dotyczące tworzenia parametrów pakietu/projektu.

Tworzenie parametrów pakietu

1. Otwórz pakiet w narzędziach SQL Server Data Tools, a następnie kliknij kartę Parametry w projektancie usług SSIS.

   

2. Kliknij przycisk Dodaj parametr na pasku narzędzi.

   

3. Wprowadź wartości właściwości Nazwa, Typ danych, Wartość, Poufne i Wymagane na samej liście lub w oknie Właściwości . W poniższej tabeli opisano te właściwości.

   Majątek	Description
   Name	Nazwa parametru.
   Typ danych	Typ danych parametru.
   Wartość domyślna	Wartość domyślna parametru przypisanego w czasie projektowania. Jest to również nazywane ustawieniem domyślnym projektu.
   Czuły	Poufne wartości parametrów są szyfrowane w wykazie i są wyświetlane jako wartość NULL w przypadku wyświetlania za pomocą programu Transact-SQL lub PROGRAMU SQL Server Management Studio.
   Wymagane	Wymaga, aby wartość inna niż wartość domyślna projektu została określona przed wykonaniem pakietu.
   Description	Opis parametru w celu utrzymania. W narzędziu SQL Server Data Tools (SSDT) ustaw opis parametru w oknie Właściwości programu Visual Studio po wybraniu parametru w odpowiednim oknie parametrów.

   Uwaga / Notatka

   Podczas wdrażania projektu w wykazie kilka kolejnych właściwości zostanie skojarzonych z projektem. Aby wyświetlić wszystkie właściwości wszystkich parametrów w wykazie, użyj widoku catalog.object_parameters (baza danych SSISDB).

4. Zapisz projekt, aby zapisać zmiany w parametrach. Wartości parametrów są przechowywane w pliku projektu.

   Ostrzeżenie

   Możesz edytować w miejscu na liście lub użyć okna Właściwości , aby zmodyfikować wartości właściwości parametru. Parametr można usunąć za pomocą przycisku paska narzędzi Usuń (X). Za pomocą ostatniego przycisku paska narzędzi można określić wartość parametru, który jest używany tylko podczas wykonywania pakietu w narzędziach SQL Server Data Tools.

   Uwaga / Notatka

   Jeśli ponownie otworzysz plik pakietu bez otwierania projektu w narzędziach SQL Server Data Tools, karta Parametry będzie pusta i wyłączona.

Tworzenie parametrów projektu

1. Otwórz projekt w narzędziach SQL Server Data Tools.

2. Kliknij prawym przyciskiem myszy plik Project.params w Eksploratorze rozwiązań, a następnie kliknij dwukrotnie otwórz plik Project.params , aby go otworzyć.

   

3. Kliknij przycisk Dodaj parametr na pasku narzędzi.

   

4. Wprowadź wartości właściwości Name( Nazwa), Data Type (Typ danych), Value (Wartość), Sensitive ( Poufne) i Required (Wymagane ).

   Majątek	Description
   Name	Nazwa parametru.
   Typ danych	Typ danych parametru.
   Wartość domyślna	Wartość domyślna parametru przypisanego w czasie projektowania. Jest to również nazywane ustawieniem domyślnym projektu.
   Czuły	Poufne wartości parametrów są szyfrowane w wykazie i są wyświetlane jako wartość NULL w przypadku wyświetlania za pomocą programu Transact-SQL lub PROGRAMU SQL Server Management Studio.
   Wymagane	Wymaga, aby wartość inna niż wartość domyślna projektu została określona przed wykonaniem pakietu.
   Description	Opis parametru w celu utrzymania. W narzędziach SQL Server Data Tools ustaw opis parametru w oknie Właściwości programu Visual Studio po wybraniu parametru w odpowiednim oknie parametrów.

5. Zapisz projekt, aby zapisać zmiany w parametrach. Wartości parametrów są przechowywane w konfiguracjach w pliku projektu. Zapisz plik projektu, aby zatwierdzić na dysku wszelkie zmiany w wartościach parametrów.

   Ostrzeżenie

   Możesz edytować w miejscu na liście lub użyć okna Właściwości , aby zmodyfikować wartości właściwości parametru. Parametr można usunąć za pomocą przycisku paska narzędzi Usuń (X). Za pomocą ostatniego przycisku paska narzędzi, aby otworzyć okno dialogowe Zarządzanie wartościami parametrów , można określić wartość parametru, który jest używany tylko podczas wykonywania pakietu w narzędziach SQL Server Data Tools.

Sparametryzowanie, okno dialogowe

Okno dialogowe Parametryzacja umożliwia skojarzenie nowego lub istniejącego parametru z właściwością zadania. Okno dialogowe można otworzyć, klikając prawym przyciskiem myszy zadanie lub kartę Przepływ sterowania w projektancie usług SSIS, a następnie klikając pozycję Parametryzacja. Poniższa lista zawiera opis elementów interfejsu użytkownika w oknie dialogowym.

Opcje

Property
Wybierz właściwość zadania, które chcesz skojarzyć z parametrem. Ta lista jest wypełniana wszystkimi właściwościami, które można sparametryzować.

Użyj istniejącego parametru
Wybierz tę opcję, aby skojarzyć właściwość zadania z istniejącym parametrem, a następnie wybierz parametr z listy rozwijanej.

Nie używaj parametru
Wybierz tę opcję, aby usunąć odwołanie do parametru. Parametr nie jest usuwany.

Utwórz nowy parametr
Wybierz tę opcję, aby utworzyć nowy parametr, który chcesz skojarzyć z właściwością zadania.

Nazwa
Określ nazwę parametru, który chcesz utworzyć.

Opis
Określ opis parametru.

Wartość
Określ wartość domyślną parametru. Jest to również nazywane wartością domyślną projektu, którą można przesłonić później w czasie wdrażania.

Scope
Określ zakres parametru, wybierając opcję Projekt lub Pakiet . Parametry projektu służą do dostarczania jakichkolwiek zewnętrznych danych wejściowych odbieranych przez projekt do co najmniej jednego pakietu w projekcie. Parametry pakietu umożliwiają modyfikowanie wykonywania pakietu bez konieczności edytowania i ponownego wdrażania pakietu.

Czuły
Określ, czy parametr jest poufny, zaznaczając lub usuwając zaznaczenie pola wyboru. Poufne wartości parametrów są szyfrowane w wykazie i są wyświetlane jako wartość NULL w przypadku wyświetlania za pomocą programu Transact-SQL lub PROGRAMU SQL Server Management Studio.

Wymagane
Określ, czy parametr wymaga, aby wartość inna niż wartość domyślna projektu została określona przed wykonaniem pakietu.

Ustawianie wartości parametrów po wdrożeniu projektu

Kreator wdrażania umożliwia ustawienie domyślnych wartości parametrów serwera podczas wdrażania projektu w katalogu. Gdy projekt znajduje się w katalogu, możesz użyć Eksploratora obiektów programu SQL Server Management Studio (SSMS) lub Transact-SQL, aby ustawić wartości domyślne serwera.

Ustawianie wartości domyślnych serwera za pomocą Eksploratora obiektów programu SSMS

1. Wybierz i kliknij prawym przyciskiem myszy projekt w węźle Integration Services .

2. Kliknij pozycję Właściwości , aby otworzyć okno dialogowe Właściwości projektu .

3. Otwórz stronę parametrów, klikając pozycję Parametry w obszarze Wybierz stronę.

4. Wybierz żądany parametr na liście Parametry . Uwaga: kolumna Kontener pomaga odróżnić parametry projektu od parametrów pakietu.

5. W kolumnie Wartość określ wartość parametru domyślnego żądanego serwera.

Ustawianie wartości domyślnych serwera za pomocą Transact-SQL

Aby ustawić wartości domyślne serwera w języku Transact-SQL, użyj procedury składowanej catalog.set_object_parameter_value (baza danych SSISDB). Aby wyświetlić bieżące wartości domyślne serwera, wykonaj zapytanie dotyczące widoku catalog.object_parameters (baza danych SSISDB). Aby wyczyścić wartość domyślną serwera, użyj procedury składowanej catalog.clear_object_parameter_value (baza danych SSISDB).