Konfigurowanie składnik skryptów w programie Script Editor składnika
Przed napisać kod niestandardowy skrypt składnika, należy wybrać typ składnik przepływ danych , którą chcesz utworzyć — źródło, przetwarzania lub obiekt docelowy — a następnie skonfiguruj metadane i właściwości składnika Script Editor transformacja.
Wybieranie typu składnika do utworzenia
Po dodaniu składnika skryptów do okienka przepływu danych SSIS Projektant, Wybieranie typu składnika skryptu pojawi się okno dialogowe.Składnik wstępnie skonfigurować jako źródło, transformacja, lub obiekt docelowy.Po dokonaniu tego wyboru wstępnego można kontynuować konfigurowania składnika w Script Editor transformacji.
Aby zestaw domyślny język skryptów dla składnika skryptów, użyj języka skryptów opcji na Ogólne strona Opcje okno dialogowe.Aby uzyskać więcej informacji, zobacz Strony głównej.
Opis dwóch trybów czasu projektowania
W SSIS Projektant składnika skryptów ma dwa tryby: Tryb projektowania metadane i kodu tryb projektowania.
Po otwarciu Script Editor transformacji, składnik przejdzie w tryb projektowania metadane.W tym trybie można wybrać kolumny danych wejściowych i dodać lub skonfigurować wyjść i kolumn wyjściowych, ale nie można zapisać kod.Po skonfigurowaniu metadane składnika można przełączyć do trybu projektowania kod, aby napisać skrypt.
Podczas przełączania do trybu projektowania kodu klikając Edytowanie skryptu, składnik skryptów blokuje metadane w celu zapobieżenia dodatkowe zmiany, a następnie automatycznie generuje kod podstawowego z metadanych wejść i wyjść.Po zakończeniu automatycznie wygenerowany kod można wprowadzić niestandardowy kod.Kod używa automatycznie generowanej klasy podstawowej do wprowadzania wierszy buforów dostępu i kolumny w bufory, przetwarzania i pobrać zmiennych i menedżerowie połączenia z pakiet, wszystkie jako obiekty jednoznacznie określony.
Po wprowadzeniu kodu niestandardowego w trybie projektowania kodu, można przełączyć ponownie do trybu projektowania metadane.Nie usuwa dowolny kod wprowadzony; Jednak późniejsze zmiany metadane powodować klasy podstawowej należy ponownie wygenerować.Składnik może później, niepowodzenie sprawdzania poprawności, ponieważ odwołuje się niestandardowy kod obiekty już nie istnieją lub zostały zmodyfikowane.W takim przypadek należy samodzielnie kodu ręcznie, dzięki czemu może zostać skompilowany w pomyślnie przeciwko regenerowanej klasy podstawowej.
Konfigurowanie składnika w trybie projektowania metadanych
W trybie projektowania metadane można zaznaczyć kolumny danych wejściowych i dodać i skonfigurować wyjść i kolumn wyjściowych, ale nie można zapisać kod.Po skonfigurowaniu metadane składnika Przełącz kod tryb projektowania, aby napisać skrypt.
Właściwości, które należy skonfigurować w edytorze niestandardowe zależą od użycia składnika skryptów.Składnik skryptów można skonfigurować jako źródło, transformacja lub obiekt docelowy.W zależności od sposobu używania składnika obsługuje wejście lub wyjście lub oba.Niestandardowy kod, który będzie zapisywać przetwarza wejściowe i wyjściowe wierszy i kolumn.
Strony kolumny danych wejściowych Script Editor transformacji
Kolumny wprowadzania strona Script Editor transformacji jest wyświetlany dla przekształcenia i miejsc docelowych, ale nie dla źródeł.W tym strona, wybierz dostępne kolumny wejściowych, które chcesz udostępnić niestandardowy skrypt i określ tylko do odczytu lub zapisu i odczytu dostępu do nich.
W projekcie kodu, który zostanie wygenerowany, oparte na metadane element projektu BufferWrapper zawiera klasy dla każdego wejścia, a tej klasy maszynowy metoda dostępu właściwości dla każdej kolumna wprowadzania zaznaczone.Na przykład, jeśli wybierzesz całkowitą IDklienta kolumna i ciąg wybrać pola NazwaKlienta kolumna z obraz wejściowy o nazwie CustomerInput, będzie zawierać element projektu BufferWrapper CustomerInput klasy, która wynika z ScriptBufferoraz CustomerInput klasy ujawniany właściwość integer o nazwie IDklienta i właściwość ciągu o nazwie wybrać pola NazwaKlienta.Niniejsza Konwencja umożliwia wpisywanie kodu przy użyciu typu sprawdzania następującego:
Dim currentCustomerID as Integer = CustomerInput.CustomerID
Dim currentCustomerName as String = CustomerInput.CustomerName
Aby uzyskać więcej informacji dotyczących sposobu konfigurowania kolumny danych wejściowych dla określonego typu składnik przepływ danych, zobacz przykład właściwe pod Rozwijanie określonych typów składników skryptów.
Wejść i wyjść strony Script Editor transformacji
Wejście i wyjście strona Script Editor transformacji jest wyświetlany dla źródeł, transformacje i miejsc docelowych.W tym strona, dodawania, usuwania i konfigurowania nakładów, wyników oraz kolumn wyjściowych, które chcesz użyć skryptu niestandardowego, w ramach następujących ograniczeń:
Gdy używany jako źródło, składnik skryptów ma Brak danych wejściowych i obsługuje wiele wyjść.
Składnik skryptów używanych jako transformacja, obsługuje jedno wejście i wiele wyjść.
Gdy używana jako obiekt obiekt docelowy, składnik skryptów obsługuje jedno wejście i wyjście nie ma.
W projekcie kodu, który zostanie wygenerowany, oparte na metadane element projektu BufferWrapper zawiera klasy dla każdego wejścia i wyjścia.Na przykład utworzyć wolumin o nazwie CustomerOutput, będzie zawierać element projektu BufferWrapper CustomerOutput klasy, która wynika z ScriptBufferoraz CustomerOutput klasy będzie zawierać maszynowy metoda dostępu właściwości dla każdego wyjścia kolumna utworzony.
Kolumn wyjściowych można skonfigurować tylko na dane wejściowe i wyjściowe strona.Można wybrać kolumny wejściowe dla przekształcenia i miejsc docelowych na Wprowadzania kolumn strona.Właściwości maszynowy metoda dostępu utworzona w programie BufferWrapper element projektu będą tylko do zapisu dla kolumn wyjściowych.metoda dostępu właściwości kolumn wejściowe będą tylko do odczytu lub zapisu/odczytu w zależności od typu użycia wybranego dla każdej kolumna na Wprowadzania kolumn strona.
Aby uzyskać więcej informacji o konfigurowaniu wejść i wyjść dla określonego typu składnik przepływu danych Zobacz przykład właściwe pod Rozwijanie określonych typów składników skryptów.
Ostrzeżenie
Chociaż wyjściowe nie można bezpośrednio konfigurować jako komunikaty o błędach wyświetlane w składniku skrypt automatycznej obsługi wierszy błędów, można odtworzyć funkcji błąd wyjściowych, tworząc dodatkowe dane wyjściowe i przy użyciu skryptu do bezpośredniego wierszy do tej wyjścia, w stosownych przypadkach.Aby uzyskać więcej informacji, zobacz Symulowanie wyjściowe błąd składnika skryptów.
ExclusionGroup i SynchronousInputID właściwości wyjść
ExclusionGroup Właściwość ma wartość niezerową, tylko w przypadku przekształceń synchroniczne wyjść, gdzie wykonuje filtrowania lub rozgałęzianie kodu i kieruje każdego wiersza do jednego z wyjść, które same zera udziału ExclusionGroup wartości.Na przykład transformacja można kierować wiersze domyślne dane wyjściowe lub dane wyjściowe błąd.Po utworzeniu dodatkowych wyjść w tym scenariuszu, upewnij się, że zestaw wartość SynchronousInputID Właściwość Liczba całkowita, która odpowiada ID wprowadzania składnika.
SynchronousInputID Właściwość ma wartość niezerową, tylko w przypadku przekształceń synchroniczne wyjść.Jeśli wartość tej właściwość jest równa zero, oznacza to, że produkcja jest asynchroniczne.Synchroniczne wyjściowych, gdy wiersze są przekazywane do wybranego wyjściowego lub wyjść bez dodawania żadnych nowych wierszy, ta właściwość powinna zawierać ID wprowadzania składnika.
Ostrzeżenie
Po Script Editor transformacji tworzy pierwsze dane wyjściowe zestawy edytora SynchronousInputID Właściwość dane wyjściowe do ID wprowadzania składnika.Jednakże gdy Edytor tworzy kolejnych wyjść, ustawia edytora SynchronousInputID Właściwości tych wyjść do zera.
Jeśli tworzysz składnika z synchronicznej wyjść każdego wyjściowy musi mieć jego SynchronousInputID Właściwość zestaw do ID wprowadzania składnika.Dlatego każdego wyjścia, że edytor tworzy po pierwsze Wyjście musi mieć jego SynchronousInputID zmieniona wartość od 0 do ID wprowadzania składnika.
Jeśli tworzysz składnika z wyjść asynchronicznego każdego wyjściowy musi mieć swoją SynchronousInputID właściwości zestaw do zera.Pierwszy wyjściowy musi więc jego SynchronousInputID zmieniona wartość z ID danych wejściowych składnika do zera.
Zobacz przykład kierowanie wierszy do jednego z dwóch synchroniczne wyjść w składniku skryptu Tworzenie synchroniczne transformacji przy użyciu składnik skryptów.
Nazwy obiektów w skrypcie wygenerowanym
Generuje skrypt składnika nazwy wejść i wyjść, analizuje i przeanalizować nazwy kolumn wejść i wyjść i na podstawie tych nazw klas i właściwości w projekcie BufferWrapper element.Jeśli znalezione nazwy zawierają znaki, które nie należą do kategorii Unicode UppercaseLetter, LowercaseLetter, TitlecaseLetter, ModifierLetter, OtherLetter, lub DecimalDigitLetter, nieprawidłowe znaki są usuwane w generowanej nazwy.Na przykład spacji są opuszczane, dlatego wprowadzania dwie kolumna, które mają nazwy Imię iImięinterpretowane są jako mające nazwa kolumna Imię, wyniki będą błędne.Aby uniknąć tej sytuacji, nazwy wejść i wyjść i wejściowe i wyjściowe kolumny używane przez składnik skrypt powinien zawierać tylko znaki wymienione w tej sekcji kategorii Unicode.
Skrypt strony Script Editor transformacji
Na skryptu strona Script Editor zadania, przypisz unikatową nazwę i opis dla zadania skryptu.Można również przypisać wartości dla następujących właściwości.
Ostrzeżenie
W SQL Server 2008 Integration Services (SSIS), wszystkie skrypty są wstępnie skompilowana.W poprzednich wersjach określono czy skrypty zostały wstępnie skompilowana przez ustawienie Precompile właściwość dla zadania.
Właściwość ValidateExternalMetadata
Wartość logiczna ValidateExternalMetadata właściwość określa, czy składnik powinien wykonać sprawdzanie poprawności przed zewnętrznymi źródłami danych w projekcie czas, lub czy należy odroczyć sprawdzania poprawności, dopóki Uruchom czas.Domyślnie wartość tej właściwość jest True; sprawdzone metadane zewnętrznych jednocześnie projekt czas i uruchom czas.Możesz ustawić wartość tej właściwość, aby False podczas zewnętrznego źródło danych nie jest dostępny na projekt czas: na przykład, gdy pakiet pobiera źródła lub tworzy miejsce docelowe tylko przy uruchomieniu czas.
Właściwości ReadWriteVariables i ReadOnlyVariables
Rozdzielany przecinkami listę istniejących zmiennych można wprowadzić jako wartości tych właściwości, aby udostępnić zmienne tylko do odczytu lub zapisu i odczytu dostępu kodem skryptu składnika.Zmienne są dostępne w kodzie za pomocą ReadOnlyVariables i ReadWriteVariables Właściwości klasy bazowej automatycznie wygenerowanyAby uzyskać więcej informacji, zobacz Korzystanie ze zmiennych składnik skryptów.
Ostrzeżenie
Nazwy zmiennych są przypadek-poufne.
ScriptLanguage
You can select either Microsoft Visual Basic 2008 or Microsoft Visual C# 2008 as the programming language for the Script component.
Edytuj skrypt, przycisk
The Edit Script button opens the Microsoft Visual Studio Tools for Applications (VSTA) IDE in which you write your custom script.Aby uzyskać więcej informacji, zobacz Kodowanie i debugowanie składnika skryptów.
Strona menedżerów połączenie Script Editor transformacji
Na Menedżerowie połączenia strona Script Editor transformacji, dodawanie i usuwanie menedżerów połączenia, które chcesz użyć niestandardowego skryptu.Zwykle potrzebne odwołanie menedżerów połączenia podczas tworzenia źródło lub obiekt docelowy składnika.
Kod projektu, który zostanie wygenerowany oparte na metadane, ComponentWrapper element projektu zawiera Connections Klasa kolekcja, którego właściwość akcesora wpisane dla każdego zaznaczonego menedżer połączeń.Każdy wpisany metoda dostępu właściwość ma taką samą nazwę jak menedżer połączeń, sam i zwraca odwołanie do menedżer połączeń jako wystąpienie IDTSConnectionManager100.Na przykład jeśli dodano menedżer połączeń o nazwie MyADONETConnection na Menedżerowie połączenia strona edytora, można uzyskać odniesienie do menedżer połączeń w skrypcie przy użyciu następującego kodu:
Dim myADONETConnectionManager As IDTSConnectionManager100 = _
Me.Connections.MyADONETConnection
Aby uzyskać więcej informacji, zobacz Połączenia ze źródłami danych w składniku skryptów.
|
.gif "Ikona usług Integration Services (mała)")
Bieżąco z usług integracjiZobacz także