Udostępnij za pośrednictwem


Za pomocą właściwości wyrażenia w opakowaniach

Wyrażenie właściwość jest wyrażenie jest przypisany do właściwości, aby włączyć dynamiczne aktualizowanie właściwości przy uruchomieniu czas.Na przykład wyrażenie właściwość można zaktualizować wiersza do zadań wysyłania poczty używa wstawiając adresu e-mail, która jest przechowywana w zmiennej.

wyrażenie mogą być dodawane do pakiet, zadanie sekwencji Foreach pętli dla pętli, numeratora Foreach 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 więzów kolejności nie obsługują właściwość wyrażenia, ale 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 można w konfiguracji pakiet a aktualizowane podczas wdrażania pakiet.Przy uruchomieniu czas, jest obliczane wyrażenie właściwość za pomocą 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ść.

  • Data i czas funkcje są oceniane przy uruchomieniu czas i zawierają zaktualizowane wartości do właściwość wyrażenia.

  • Zmienne w wyrażeniach mogą być aktualizowane przez skrypty uruchamiane zadanie skryptu i składnik skryptów.

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

Ostrzeżenie

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

Aby uzyskać więcej informacji, zobacz Odwołanie do wyrażeń w usługach Integration Services.

Ważne użycie właściwość wyrażenia jest dostosowanie 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 zmiennej parametry połączenia menedżer połączeń i następnie zaktualizować zmiennej po wdrożeniu pakiet zapewnia, że parametry połączenia jest poprawna przy uruchomieniu czas.Konfiguracji pakietu są załadowane przed właściwość wyrażenia są przetwarzane.

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

Niektóre właściwości są zestaw przy użyciu wartości ze moduły wyliczające.Gdy odwołanie do modułu wyliczającego element członkowski w wyrażeniu właściwość, należy użyć wartość liczbową odpowiadającą przyjazna nazwa modułu wyliczającego element członkowski.Na przykład wyrażenie właściwość ustawia LoggingMode właściwość, która używa wartości z DTSLoggingMode wyliczenia, właściwości wyrażenia należy użyć zamiast przyjaznych nazw 0, 1 lub 2 Enabled, Disabled, lub UseParentSetting.Aby uzyskać więcej informacji, zobacz W wyrażeniach właściwości przy użyciu stałych wyliczeniowych.

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

Integration Services zawiera zestaw narzędzi do budowania i zarządzania właściwość wyrażenia.

  • Wyrażeń strona znalezione w niestandardowych edytorów zadań, kontener dla pętli i pojemniki Foreach.Wyrażeń strona umożliwia edytowanie wyrażeń i wyświetlanie listy wyrażeń właściwość używanych zadania, pętla Foreach lub dla pętli.

  • właściwość okno edycji wyrażenia oraz wyświetlanie listy wyrażeń właściwość pakiet lub pakiet obiektów użycia.

  • Edytor wyrażeń właściwość okno dialogowe, tworzenie, aktualizowanie i usuwanie właściwość wyrażenia.

  • Konstruktor wyrażeń dialogowe budowanie wyrażenie używające narzędzia graficzne.Konstruktor wyrażeń okno dialogowe można oszacować wyrażenia recenzji bez przypisywania wynik oceny właściwość.

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

Interfejs użytkownika wyrażeń właściwości

W Właściwości okna i wyrażeń strona, kliknij przycisk przeglądania, (…) na wyrażeń poziom kolekcja, aby otworzyć Edytor wyrażeń właściwości okno dialogowe.Edytor wyrażeń właściwości umożliwia mapowania właściwości do wyrażenia i wpisz wyrażenie właściwość.Jeśli chcesz użyć narzędzia graficzne wyrażenie do tworzenia i sprawdzania poprawności wyrażenia, kliknij przycisk przeglądania, (…) poziom wyrażenie, aby otworzyć Konstruktor wyrażeń okno dialogowe pole i następnie utworzyć lub zmodyfikować i opcjonalnie sprawdzania poprawności wyrażenia.

Można również otworzyć Konstruktor wyrażeń okno dialogowe z Edytor wyrażeń właściwości okno dialogowe.

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

Ustawienie właściwości wyrażenia danych przepływu składników

Jeśli skonstruować pakiet w Business Intelligence Development Studio, właściwości składników przepływ danych obsługujących właściwość wyrażeń są narażone na zadanie przepływ danych, do której należą.Dodać, zmienić i usunąć wyrażeń właściwość składników przepływ danych, kliknięciu prawym przyciskiem myszy zadanie przepływ danych dla przepływ danych, do której należą składników przepływ danych i kliknij przycisk właściwość.Okno właściwość zawiera listę właściwość składników przepływ danych, których można używać wyrażeń właściwość.Na przykład, aby utworzyć lub zmodyfikować wyrażenie właściwość dla SamplingValue właściwość transformacja wiersza pobierania próbek w przepływie danych o nazwie SampleCustomer, kliknij prawym przyciskiem myszy zadanie przepływ danych dla przepływ danych, do którego należy transformacja pobierania wierszy i kliknij przycisk właściwość.SamplingValue właściwość wymienione w oknie dialogowym właściwość i ma format [SampleCustomer]. [SamplingValue].

W oknie właściwość można dodać, zmienić i usunąć wyrażeń właściwość dla składników przepływ danych w taki sam sposób jak właściwość wyrażenia dla innych Integration Services typów obiektów.Okno właściwość udostępnia również dostęp do różnych oknach dialogowych i producentów, które służy do dodawania, 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 źródła, Właściwości niestandardowe transformacji, i Właściwości niestandardowe miejsce docelowe.

Ładowanie właściwości wyrażenia

Nie można określić lub kontrolować, kiedy są ładowane właściwość wyrażenia.właściwość wyrażenia są oceniane i ładowany podczas sprawdzania poprawności pakiet i obiekty pakietu.Sprawdzanie poprawności jest wykonywane podczas zapisywania pakietu, Otwórz pakiet w SSIS Projektant i uruchom pakiet.

Dlatego nie będzie wyświetlany zaktualizowane wartości właściwość obiektów pakietu, które używają wyrażeń właściwość w SSIS Projektant, dopóki nie zapiszesz pakietu, należy uruchomić pakiet, lub ponownie otworzyć pakiet po dodaniu właściwość wyrażenia.

Wyrażenia właściwość skojarzone z różnymi typami obiektów — połączenie menedżerów, włączeni i moduły wyliczające — również są ładowane, gdy są nazywane metod danemu typowi obiektu.Na przykład właściwości połączenia menedżerowie są załadowane przed Integration Services tworzy wystąpienie połączenia.

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

Ostrzeżenie

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

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

Typ obiektu

Ładowanie i ocena

Pakiet, pętla Foreach pętli dla sekwencji, zadań, i przepływ danych składników

Po załadowaniu konfiguracje

Przed sprawdzania poprawności

Przed wykonaniem

Menedżer połączeń

Po załadowaniu konfiguracje

Przed sprawdzania poprawności

Przed wykonaniem

Przed utworzeniem połączeniawystąpienie

Włączeni

Po załadowaniu konfiguracje

Przed sprawdzania poprawności

Przed wykonaniem

Przed zalogowaniem otwarcia

Moduły wyliczające foreach

Po załadowaniu konfiguracje

Przed sprawdzania poprawności

Przed wykonaniem

Przed wyliczeń pętli

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

Często użyteczne implementować właściwość wyrażenie jest zestaw wartość ConnectionString Właściwość menedżerów połączenie używane wewnątrz kontener Foreach pętli.Po modułu wyliczającego mapuje bieżącą wartość zmiennej w każdej iteracji pętli, wyrażenie właściwość można użyć wartość tej zmiennej zaktualizować wartość ConnectionString właściwość dynamicznie.

Jeśli chcesz używać wyrażeń właściwość z ConnectionString korzysta z właściwość pliku, wiele plików, plików płaskich i wiele plików płaskich menedżerów połączenia, które Foreach pętli, istnieją pewne elementy, które należy rozważyć.Pakiet może być skonfigurowana do uruchomienia wielu plików wykonywalnych równocześnie przez ustawienie MaxConcurrentExecutables właściwość na wartość większą niż 1 lub wartość -1.Wartość -1 umożliwia maksymalną liczbę uruchomionych jednocześnie równa liczbie procesorów plus dwa plików wykonywalnych.Aby uniknąć negatywne konsekwencje z równoległego pliki wykonywalne, wartość MaxConcurrentExecutables powinien być zestaw 1.Jeśli MaxConcurrentExecutables nie jest zestaw 1, a następnie wartość ConnectionString właściwość nie można zagwarantować, a wyniki są nieprzewidywalna.

Rozważmy na przykład pętli Foreach, który wylicza pliki w folderze, pobiera nazwy plików, a następnie używa zadanie wykonanie instrukcji SQL wstawić nazwę każdego pliku do tabela.Jeśli MaxConcurrentExecutables nie jest ustawiona na 1, a następnie zapisu konfliktów może wystąpić, jeśli dwa wystąpienia zadania wykonanie instrukcji SQL próbował zapisać tabelę w tym samym czas.

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

Następujące przykładowe wyrażenia przedstawiono sposoby używania zmiennych systemowych, operatorów, funkcji i ciąg literały w wyrażeniach właściwość.

Wyrażenia właściwości dla właściwości LoggingMode pakietu

Następujące wyrażenie właściwość 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śli jest dzień 1 lub 15, rejestrowanie jest włączone; w przeciwnym razie rejestrowanie jest wyłączone.Wartość 1 jest odpowiednikiem całkowitą LoggingMode Członkowskie modułu wyliczającego Enabled, i wartość 2 jest liczbą całkowitą równoważne element członkowski Disabled.Należy użyć wartości liczbowe zamiast modułu wyliczającego element członkowski w wyrażeniu nazwa.

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

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

Następujące wyrażenie właściwości zestaw Subject Właściwość Wyślij pocztę zadań i zapewnia użyteczne e-mail podmiotu.Wyrażenie jest kombinacją ciąg literały, zmienne systemowe, konkatenacji (+) i oddanych operatorów i funkcji DATEDIFF i GETDATE.Zmienne systemowe są PackageName i StartTime zmiennych.

"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 2005 r. 3/4 i czas trwania uruchomienia był sekundach 9, wynikiem wyrażenie jest następujący ciąg.

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

Wyrażenia właściwości wiadomości wiadomości E-mail

Następujące wyrażenie właściwość zestaw MessageSource właściwość zadania Wyślij pocztę.Wyrażenie jest kombinacją ciąg literały, zmienne zdefiniowane przez użytkownika i operatora konkatenacji (+).Zmienne zdefiniowane przez użytkownika są nazywane nasdaqrawrows, nyserawrows, i 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, i amexrawrows jest 1102, wyrażenie ma następujący ciąg.

Przetwarzanych wierszy:

NOTOWANIA: 7058

NYSE: 3528

AMEX: 1102

Wyrażenie właściwość właściwości pliku wykonywalnego wykonać zadania procesu

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

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

Jeśli jest to drugi dzień tygodnia, wykonanie procesu zadanie jest uruchamiane notepad.exe, w przeciwnym razie mspaint.exe uruchamia zadanie.

Wyrażenie właściwości dla właściwości ConnectionString płaskiego pliku Menedżera połączeń

Następujące wyrażenie właściwość zestaw ConnectionString właściwość menedżer połączeń pliku prostego.Wyrażenie używa pojedynczej zmiennej użytkownika, myfilenamefull, który zawiera ścieżka do pliku tekstowego.

@[User::myfilenamefull]

Ostrzeżenie

Właściwość wyrażenia dla menedżerów połączenia jest możliwy tylko za pomocą okna właściwości.Aby wyświetlić właściwości dla menedżer połączeń, należy wybrać menedżer połączeń w Menedżerowie połączenia obszar SSIS Projektant, gdy okno właściwości jest otwarte, lub kliknij prawym przyciskiem myszy menedżer połączeń i zaznacz Właściwości.

Wyrażenia właściwości dla właściwości Ciąg_konfiguracji dostawcy tekst pliku dziennika

Następujące wyrażenie właściwość zestaw ConfigString właściwość tekstu pliku dostawca dziennika.Wyrażenie używa pojedynczej zmiennej użytkownika, varConfigString, który zawiera nazwę menedżer połączeń pliku do użytku.Menedżer połączeń plik Określa ścieżka pliku tekstowego, do którego wpisy dziennika są zapisywane.

@[User::varConfigString]

Ostrzeżenie

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 na Explorer pakietu karcie SSIS Projektant, gdy okno właściwości jest otwarte, lub kliknij dostawca dziennika w Eksploratorze pakiet prawym przyciskiem myszy i kliknij Właściwości.

Zasoby zewnętrzne

Wyrażenie i wyróżnienia konfiguracji dla Business Intelligence Development Studio (projekt witrynie CodePlex)

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.