Udostępnij za pośrednictwem


Za pomocą wyrażenia właściwość w pakietach

Wyrażenie właściwość jest wyrażenie, które jest przypisana do właściwość, aby włączyć dynamiczne aktualizowanie właściwość przy uruchomieniu czas.Na przykład wyrażenie właściwość można aktualizować wierszu do, używanych przez wprowadzenie adresu e-mail, który jest przechowywany w zmiennej zadania Wyślij pocztę.

wyrażenie mogą być dodawane do pakiet, zadania, pętla Foreach, pętli for, sekwencja, Foreach moduł wyliczający, obsługa zdarzeń, Menedżer połączeń lub dostawca dziennika.Any property of these objects that is read/write can implement a property expression.Integration Services also supports the use of property expressions in some custom properties of data flow components.Zmienne i ograniczeń pierwszeństwo nie obsługują właściwość wyrażenia, lecz zawierają specjalne właściwość, w których można używać wyrażeń.

Właściwość wyrażenia mogą być aktualizowane na różne sposoby:

  • Zmienne zdefiniowane przez użytkownika mogą być uwzględnione w konfiguracji pakietu i następnie aktualizowany, gdy jest rozmieszczany pakiet.Przy uruchomieniu czas, jest obliczane wyrażenie właściwość przy użyciu zaktualizowanych wartości zmiennej.

  • Zmienne systemowe, które znajdują się w wyrażeniach są aktualizowane przy uruchomieniu czas, które zmiany wyniki oceny właściwość.

  • Funkcje data i godziny są oceniane w czasie wykonywania i zawierają zaktualizowane wartości do właściwość wyrażeń.

  • Zmienne w wyrażeniach mogą być aktualizowane przez skryptów, które mają być wykonywane zadanie skryptów i składników skryptów.

The expressions are built using the Microsoft Integration Services expression language.wyrażenie można używać systemu lub zmienne zdefiniowane przez użytkownika, wraz z operatorów, funkcji i wpisz poświaty zapewniający wyrażenie języka.

Uwaga

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

Aby uzyskać więcej informacji zobaczIntegracja usług wyrażenie odwołania.

Jest ważne stosowania wyrażeń właściwość do dostosowania konfiguracji dla każdego wystąpienie rozmieszczanego pakiet.Dzięki temu można dynamicznie zaktualizować właściwości pakiet dla różnych środowisk.Na przykład, można utworzyć wyrażenie właściwość, który przypisuje do zmiennej ciągu połączenia menedżer połączeń i następnie zaktualizować zmiennej po wdrożeniu pakiet zapewnia, że ciąg połączenia jest poprawna przy uruchomieniu czas.Pakiet konfiguracje są załadowane przed wyrażeniami właściwość.

Właściwości można użyć tylko jednej właściwości wyrażenie, a właściwość wyrażenie można zastosować tylko do jednej właściwości.Można jednak tworzyć wiele wyrażeń identyczne właściwość i przypisać je do różnych właściwość.

Niektóre właściwości są zestaw przy użyciu wartości ze moduły wyliczające.Kiedy odwołać element członkowski członkowski moduł wyliczający we właściwość wyrażenie, należy użyć wartość liczbową, odpowiadającą przyjazną nazwę element członkowski członkowski, moduł wyliczający.Na przykład, jeśli wyrażenie właściwości ustawia LoggingMode Właściwość, która używa wartości z DTSLoggingMode Wyliczanie, wyrażenie właściwości muszą używać 0, 1 lub 2 zamiast przyjaznych nazw Enabled, Disabled, lub UseParentSetting. Aby uzyskać więcej informacji zobaczPrzy użyciu stałych wyliczeniowych w wyrażeniach właściwość.

właściwość interfejs użytkownika wyrażenie

Integration Services zawiera zestaw narzędzi do tworzenia i zarządzania nimi właściwość wyrażeń.

  • The Expressions strona, found in the custom editors for tasks, the For Loop kontener, and the Foreach containers.The Expressions strona lets you edit expressions and view a list of the właściwość expressions that a task, Foreach Loop, or For Loop uses.

  • The Properties window, for editing expressions and viewing a list of the właściwość expressions that a pakiet or pakiet objects use.

  • The właściwość Expressions Editor dialog box, for creating, updating, and deleting właściwość expressions.

  • The wyrażenie Builder dialog box, for building an wyrażenie using graphical tools.The wyrażenie Builder dialog box can evaluate expressions for your review without assigning the evaluation result to the właściwość.

Poniższy diagram przedstawia interfejsów użytkownika, które umożliwia dodawanie, zmienianie i usuwanie właściwość wyrażeń.

The user interface for property expressions

W właściwość i okna Wyrażenia strona, kliknij przycisk przeglądania (…) at the Wyrażenia poziom kolekcja otworzyćEdytor wyrażeń właściwość -okno dialogowe.Edytor wyrażeń właściwość pozwala mapowania właściwość do wyrażenia i wpisz wyrażenie właściwość.Jeśli użytkownik chce użyć narzędzi graficznych wyrażenie do tworzenia i następnie sprawdzania poprawności wyrażenie, kliknij przycisk przeglądania (…) otworzyć poziom wyrażenieKonstruktor wyrażenie okna dialogowego pole i następnie utworzyć lub zmodyfikować i opcjonalnie sprawdzania poprawności wyrażenie.

Można również otworzyć Konstruktor wyrażenie dialogowym Edytor wyrażenie właściwość -okno dialogowe.

Aby pracować z wyrażenia właściwość

Ustawienie właściwość wyrażenia składników przepływ danych

Jeśli skonstruować pakiet w Business Intelligence Development Studio, właściwości składników przepływ danych, które obsługuje właściwość wyrażenia są narażone na zadanie przepływ danych do których należą. Dodać, zmienić lub usunąć wyrażenia właściwość danych składników przepływu, kliknięciu prawym przyciskiem myszy zadanie przepływ danych danych przepływu, do którego dane przepływu składników należą i kliknij przycisk właściwość.W oknie właściwość wyświetlana jest lista właściwość składników przepływ danych, z których można używać wyrażeń właściwość.Na przykład, aby utworzyć lub zmodyfikować wyrażenie właściwości dla SamplingValue Właściwość transformacja próbkowanie wiersz do przepływ danych o nazwie SampleCustomer, kliknij prawym przyciskiem myszy zadanie przepływ danych dla przepływ danych, do której należy transformacja próbkowanie wiersz i kliknij przycisk Właściwości.The SamplingValue właściwość is listed in the Properties window, and has the format [SampleCustomer].[SamplingValue].

W oknie właściwości można dodać, zmienić i usunąć wyrażenia właściwości dla składników przepływ danych w taki sam sposób, jak właściwość wyrażenia dla pozostałych Integration Services typy obiektów. Okno właściwość udostępnia również dostęp do różnych oknach dialogowych i konstruktorzy, które umożliwia dodawanie, zmienianie lub usuwanie wyrażenia właściwość dla składników przepływ danych.Aby uzyskać więcej informacji o właściwościach składników przepływ danych, które mogą być aktualizowane przez właściwość wyrażeń zobacz Właściwości niestandardowe urządzenie źródłowe, Właściwości niestandardowe transformacja, a Właściwości niestandardowe obiekt obiekt docelowy.

Wyrażenia właściwość załadunku

Nie można określić ani kontrolować, kiedy są ładowane właściwość wyrażeń.Wyrażenia właściwość są oceniane i ładowane podczas sprawdzania poprawności pakiet i obiekty pakietu.Sprawdzanie poprawności jest wykonywane podczas zapisywania pakietu, należy otworzyć pakiet w SSIS Projektant i wykonywania pakietu.

Z tego powodu nie będzie wyświetlany zaktualizowane wartości właściwość obiektów pakietu, należy użyć wyrażenia właściwość w SSIS Projektant do momentu, aż zostanie zapisana pakietu, należy uruchomić pakiet lub ponownie po dodaniu wyrażenia właściwość pakietu.

Wyrażenia właściwość skojarzone z różnymi typami obiektów — Menedżera połączeń, dostawców dzienników i moduły wyliczające — również są ładowane, gdy są nazywane są specyficzne dla obiektu danego typu metody.Na przykład właściwości Menedżera połączeń są załadowane przed Integration Services tworzy wystąpienie połączenia.

Właściwość wyrażeń zostaną załadowane po załadowaniu konfiguracji pakiet.Na przykład zmienne są aktualizowane najpierw według ich konfiguracji, a następnie wyrażenia właściwość, które używać zmiennych są oceniane i załadowane.Oznacza to, że wyrażenia właściwość należy zawsze używać wartości zmiennych, które są zestaw przez konfiguracji.

Uwaga

Nie można używać Set Opcja dtexec narzędzie do wypełniania wyrażenie właściwość.

W następującej tabela podsumowano, gdy właściwość wyrażenia Integration Services są oceniane i załadowane.

Typ obiektu

Ładowanie i oceny

Składniki przepływu pakiet, pętla Foreach, pętli for, sekwencja, zadań i danych

Po załadowaniu konfiguracje

Przed sprawdzania poprawności

Przed wykonaniem

Menedżerowie połączenia

Po załadowaniu konfiguracje

Przed sprawdzania poprawności

Przed wykonaniem

Przed utworzeniem wystąpienie połączenia

Włączeni

Po załadowaniu konfiguracje

Przed sprawdzania poprawności

Przed wykonaniem

Przed otwarcia dzienników

Moduły wyliczające foreach

Po załadowaniu konfiguracje

Przed sprawdzania poprawności

Przed wykonaniem

Przed wyliczeń w pętli

Za pomocą wyrażenia właściwość w pętli Foreach

Warto często implementować właściwość wyrażenie zestaw wartość ConnectionString Właściwość menedżerów połączenia, które są używane wewnątrz kontener Foreach pętli. Po moduł wyliczający jest mapowany bieżącą wartość zmiennej w każdej iteracji pętli, wyrażenie właściwości za pomocą wartość tej zmiennej wartości ConnectionString Właściwość dynamicznie.

Aby użyć wyrażenia właściwość z ConnectionString korzysta z właściwość pliku, wiele plików, pliki płaski i wiele plików płaski menedżerów połączenia Foreach pętli, istnieje kilka kwestii, które należy wziąć pod uwagę. Pakiet można skonfigurować w taki sposób, aby jednocześnie uruchamiać wielu plików wykonywalnych ustawiając MaxConcurrentExecutables Właściwość wartość większą niż 1 lub wartość -1. Wartość -1 umożliwia maksymalną liczbę jednocześnie uruchomionych programów wykonywalnych do równa liczbie procesorów plus dwa.Aby uniknąć negatywne skutki z wykonywanie równoległe plików wykonywalnych, wartość MaxConcurrentExecutables powinny być zestaw na 1. Jeśli MaxConcurrentExecutables nie jest zestaw 1, a następnie wartość ConnectionString Nie można zagwarantować właściwość, a wyniki są nieprzewidywalne.

Na przykład należy wziąć pod uwagę pętlę Foreach wylicza pliki w folderze, pobiera nazwy plików, a następnie wstawianie każdej nazwy pliku do tabela przy użyciu zadania programu wykonać instrukcji SQL.Jeśli MaxConcurrentExecutables nie jest zestaw na 1, następnie napisać konflikt może wystąpić, jeśli próba zapisu w tabela, w tym samym czasie dwóch wystąpień zadania wykonać instrukcji SQL.

Przykładowe wyrażenia właściwość

Następujące wyrażenie przykładowe pokazują, jak używać zmiennych systemowych, operatorów, funkcji i literały ciągów znaków w wyrażeniach właściwość.

Wyrażenie właściwość dla właściwość LoggingMode pakiet

Następujące wyrażenie właściwość mogą być używane do zestaw LoggingMode właściwość pakiet. Wyrażenie używa funkcji dzień i GETDATE uzyskać całkowitą reprezentującą dzień w parametrze datepart data.Jeżeli ten dzień jest pierwszy lub 15, rejestrowanie jest włączone; w przeciwnym razie, rejestrowanie jest wyłączone.Wartość 1 jest odpowiednikiem całkowitą LoggingMode Moduł wyliczający element członkowski członkowski Enabled, a wartość 2 jest liczbą całkowitą równorzędne elementu członkowskiego Disabled. Wartość liczbowa, należy użyć zamiast nazwy element członkowski członkowski moduł wyliczający w wyrażeniu.

DAY((DT_DBTIMESTAMP)GETDATE())==1||DAY((DT_DBTIMESTAMP)GETDATE())==15?1:2

Właściwość wyrażenie tematu wiadomości E-mail

Następujące wyrażenie właściwości może być używane do ustawiania Subject Właściwość Wyślij pocztę zadania i podać temat użytecznych wiadomości e-mail. Wyrażenie używa kombinacji ciąg literały, zmienne systemowe, łączenie (+) i rzutowania operatorów i funkcji tekst DATEDIFF i GETDATE.Zmienne systemowe są PackageName i StartTime zmienne.

"PExpression-->Package: (" + @[System::PackageName] + ") Started:"+ (DT_WSTR, 30) @[System::StartTime] + " Duration:" + (DT_WSTR,10) (DATEDIFF( "ss", @[System::StartTime] , GETDATE() )) + " seconds"

Nazwa pakiet jest EmailRowCountPP, było uruchamiać na 3/4/2005 i czas trwania uruchomienia został 9 sekund, wyrażenie zostanie oszacowane jako następujący ciąg znaków.

PExpression-->Pakiet: (EmailRowCountPP) Uruchomiono: 3/4/2005 11: 06: 18 AM sekund czas trwania: 9.

Wyrażenie właściwość wiadomości, wiadomości E-mail

Następujące wyrażenie właściwości mogą być używane do zestaw MessageSource Właściwość zadania Wyślij pocztę. Wyrażenie używa kombinacji ciąg literały i zmienne zdefiniowane przez użytkownika operator łączenie (+).Zmienne zdefiniowane przez użytkownika noszą nazwy nasdaqrawrows, nyserawrows, a amexrawrows. Ciąg "\n" wskazuje znak powrotu karetki.

"Rows Processed: " + "\n" +" NASDAQ: " + (dt_wstr,9)@[nasdaqrawrows] + "\n" + " NYSE: " + (dt_wstr,9)@[nyserawrows] + "\n" + " Amex: " + (dt_wstr,9)@[amexrawrows]

Jeśli nasdaqrawrows jest 7058, nyserawrows jest 3528, a amexrawrows jest 1102, wyrażenie zostanie oszacowane jako następujący ciąg znaków.

Przetworzonych wierszy:

NASDAQ: 7058

NYSE: 3528

AMEX: 1102

Właściwość wyrażenie wykonywalna właściwości wykonać zadania procesu

Następujące wyrażenie właściwości mogą być używane do zestaw Executable Właściwość zadania wykonywania procesu. Wyrażenie używa kombinacji ciąg literałów, operatorów i funkcji.Wyrażenie używane funkcje w parametrze DATEPART i GETDATE i operator warunkowy.

DATEPART("weekday", GETDATE()) ==2?"notepad.exe":"mspaint.exe"

Jeśli jest to drugi dzień w tygodniu, wykonać procesu zadanie jest uruchamiane notepad.exe, w przeciwnym razie mspaint.exe uruchomienia zadania.

Wyrażenie właściwość dla właściwość ConnectionString z płaskim menedżer połączeń pliku

Następujące wyrażenie właściwości mogą być używane do zestaw ConnectionString Właściwość plik prosty menedżer połączeń. Wyrażenie używane na jedną zmienną użytkownika, myfilenamefull, który zawiera ścieżka do pliku tekstowego.

@[User::myfilenamefull]

Uwaga

Właściwość wyrażenia dla Menedżera połączeń jest możliwy tylko za pomocą okna właściwości.Aby wyświetlić właściwości dla Menedżera połączeń, należy wybrać menedżera połączeń w Menedżer połączeń area of SSIS Projektant, gdy okno właściwości jest otwarty, lub kliknij prawym przyciskiem myszy Menedżer połączeń i wybierz polecenie Właściwości.

Właściwość wyrażenie właściwości Ciąg_konfiguracji dostawca tekst pliku dziennika

Następujące wyrażenie właściwości mogą być używane do zestaw ConfigString Właściwość dostawca dziennika do pliku tekstowego. Wyrażenie używane na jedną zmienną użytkownika, varConfigString, który zawiera nazwę menedżer połączeń pliku do używania. Menedżer połączeń plik Określa ścieżka do pliku tekstowego, do której wpisy dziennika są zapisywane.

@[User::varConfigString]

Uwaga

Właściwość wyrażenia dla dostawców dzienników jest możliwy tylko za pomocą okna właściwości.Aby wyświetlić właściwości dostawca dziennika, należy wybrać dostawca dziennika w Pakiet Eksploratora tab of SSIS Projektant po otwarciu okna właściwości lub dostawca dziennika w Eksploratorze pakiet i kliknij prawym przyciskiem myszy Właściwości.

Zasoby zewnętrzne

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.