Źródło ADO NET

Dotyczy:SQL Server SSIS Integration Runtime w ramach usługi Azure Data Factory

Źródło ADO NET zużywa dane od dostawcy platformy .NET i udostępnia dane przepływowi danych.

Źródło ADO NET umożliwia nawiązanie połączenia z usługą Microsoft Azure SQL Database. Nawiązywanie połączenia z usługą SQL Database przy użyciu ole DB nie jest obsługiwane. Aby uzyskać więcej informacji na temat usługi SQL Database, zobacz Ogólne wytyczne i ograniczenia (Azure SQL Database).

Obsługa typów danych

Źródło konwertuje dowolny typ danych, który nie jest przypisany do określonego typu danych w usługach Integration Services, na typ danych DT_NTEXT w usługach Integration Services. Ta konwersja występuje nawet wtedy, gdy typ danych to System.Object.

Możesz zmienić typ danych DT_NTEXT na typ danych DT_WSTR lub zmienić DT_WSTR na DT_NTEXT. Typy danych można zmienić, ustawiając właściwość DataType w oknie dialogowym Edytor zaawansowany źródła ADO NET. Aby uzyskać więcej informacji, zobacz Typowe właściwości.

Typ danych DT_NTEXT można również przekonwertować na typ danych DT_BYTES lub DT_STR przy użyciu przekształcenia konwersji danych po źródle ADO NET. Aby uzyskać więcej informacji, zobacz Konwersja danych.

W usługach Integration Services typy danych daty, takie jak DT_DBDATE, DT_DBTIME2, DT_DBTIMESTAMP2 i DT_DBTIMESTAMPOFFSET, mapują się na określone typy danych dat w programie SQL Server. Źródło ADO NET można skonfigurować tak, aby przekonwertować typy danych daty z tych, które są używane przez program SQL Server do tych, z których korzystają usługi Integration Services. Aby skonfigurować źródło ADO NET w celu przekonwertowania tych typów danych daty, ustaw właściwość Type System Version menedżera połączeń ADO.NET na Latest. (Właściwość Type System Version znajduje się na stronie Wszystkie okna dialogowego Menedżer połączeń . Aby otworzyć okno dialogowe Menedżer połączeń , kliknij prawym przyciskiem myszy menedżera połączeń ADO.NET, a następnie kliknij przycisk Edytuj.

System przekształca zdefiniowane przez użytkownika typy danych (UDT) na obiekty binarne BLOB usługi Integration Services, gdy menedżer połączeń ADO.NET określa dostawcę jako .NET Data Provider for SQL Server (SqlClient). System stosuje następujące reguły podczas konwertowania typu danych UDT:

• Jeśli dane nie jest dużym UDT, system konwertuje dane na DT_BYTES.

• Jeśli dane są inne niż duże UDT, a właściwość kolumny Length w bazie danych jest ustawiona na -1 lub wartość większą niż 8000 bajtów, system konwertuje dane na DT_IMAGE.

• Jeśli dane są dużym UDT, system konwertuje dane na DT_IMAGE.

  Uwaga / Notatka

  Jeśli źródło ADO NET nie jest skonfigurowane do używania wyjściowych danych błędów, system przesyła strumieniowo dane do kolumny DT_IMAGE po kawałkach 8 000 bajtów. Jeśli źródło ADO NET jest skonfigurowane do używania wyniku błędu, system przekazuje całą tablicę bajtów do kolumny DT_IMAGE. Aby uzyskać więcej informacji na temat konfigurowania składników do używania wyjścia błędów, zobacz Obsługa błędów w danych.

Aby uzyskać więcej informacji na temat typów danych usług Integration Services, obsługiwanych konwersji typów danych i mapowania typów danych w niektórych bazach danych, w tym programu SQL Server, zobacz Typy danych usług Integration Services.

Aby uzyskać informacje na temat mapowania typów danych usług Integration Services na typy danych zarządzanych, zobacz Praca z typami danych w przepływie danych.

Rozwiązywanie problemów ze źródłem ADO NET

Możesz zarejestrować wywołania, które źródło ADO NET wykonuje dla zewnętrznych dostawców danych. Za pomocą tej funkcji rejestrowania można rozwiązywać problemy z ładowaniem danych z zewnętrznych źródeł danych, które wykonuje źródło ADO NET. Aby zarejestrować wywołania, które źródło ADO NET wykonuje dla zewnętrznych dostawców danych, włącz rejestrowanie pakietów i wybierz zdarzenie diagnostyczne na poziomie pakietu. Aby uzyskać więcej informacji, zobacz Rozwiązywanie problemów z narzędziami do wykonywania pakietów.

Konfiguracja źródła ADO NET

Źródło ADO NET można skonfigurować, podając instrukcję SQL definiującą zestaw wyników. Na przykład źródło ADO NET, które łączy się z AdventureWorks2025 bazą danych i używa instrukcji SELECT * FROM Production.Product SQL, wyodrębnia wszystkie wiersze z tabeli Production.Product i udostępnia zestaw danych do składnika podrzędnego.

Źródło ADO NET używa menedżera połączeń ADO.NET do nawiązywania połączenia ze źródłem danych, a menedżer połączeń określa dostawcę platformy .NET. Aby uzyskać więcej informacji, zobacz ADO.NET Menedżer połączeń.

Źródło ADO NET ma jedno regularne wyjście i jedno wyjście do błędów.

Właściwości można ustawić za pomocą projektanta usług SSIS lub programowo.

Aby uzyskać więcej informacji o właściwościach, które można ustawić w oknie dialogowym edytora zaawansowanego lub programowo, kliknij jeden z następujących tematów:

• typowe właściwości

• Właściwości niestandardowe ADO NET

Aby uzyskać więcej informacji na temat ustawiania właściwości, zobacz Ustawianie właściwości składnika przepływu danych.

Edytor źródłowy ADO NET (strona Menedżera połączeń)

Użyj strony Menedżer połączeń okna dialogowego Edytora źródłowego ADO NET , aby wybrać menedżera połączeń ADO.NET dla źródła. Ta strona umożliwia również wybranie tabeli lub widoku z bazy danych.

Aby dowiedzieć się więcej o źródle ADO NET, zobacz ADO NET Source (Źródło ADO NET).

Aby otworzyć stronę Menedżera połączeń

1. W narzędziu SQL Server Data Tools (SSDT) otwórz pakiet usług Integration Services, który ma źródło ADO NET.

2. Na karcie Przepływ danych kliknij dwukrotnie źródło ADO NET.

3. W Edytorze źródłowym ADO NET kliknij pozycję Menedżer połączeń.

Opcje statyczne

Menedżer połączeń ADO.NET
Wybierz istniejącego menedżera połączeń z listy lub utwórz nowe połączenie, klikając pozycję Nowy.

Nowy
Utwórz nowego menedżera połączeń przy użyciu okna dialogowego Konfigurowanie menedżera połączeń ADO.NET .

tryb dostępu do danych
Określ metodę wybierania danych ze źródła.

Prapremiera
Podejrzyj wyniki, korzystając z okna dialogowego widoku danych. Podgląd może wyświetlać maksymalnie 200 wierszy.

Opcje dynamiczne trybu dostępu do danych

Tryb dostępu do danych = Tabela lub widok

Nazwa tabeli lub widoku
Wybierz nazwę tabeli lub widoku z listy dostępnych w źródle danych.

Tryb dostępu do danych = polecenie SQL

Tekst polecenia SQL
Wprowadź tekst zapytania SQL, skompiluj zapytanie, klikając pozycję Zapytanie kompilacji lub znajdź plik zawierający tekst zapytania, klikając przycisk Przeglądaj.

Kompilowanie zapytania
Użyj okna dialogowego Konstruktora zapytań , aby wizualnie skonstruować zapytanie SQL.

Przeglądaj
Użyj okna dialogowego Otwórz , aby zlokalizować plik zawierający tekst zapytania SQL.

Edytor źródłowy ADO NET (strona kolumn)

Użyj strony Kolumny okna dialogowego Edytora źródłowego ADO NET , aby zamapować kolumnę wyjściową na każdą kolumnę zewnętrzną (źródłową).

Aby dowiedzieć się więcej o źródle ADO NET, zobacz ADO NET Source (Źródło ADO NET).

Aby otworzyć stronę Kolumny

1. W narzędziu SQL Server Data Tools (SSDT) otwórz pakiet usług Integration Services, który ma źródło ADO NET.

2. Na karcie Przepływ danych kliknij dwukrotnie źródło ADO NET.

3. W edytorze źródłowym ADO NET kliknij pozycję Kolumny.

Opcje

Dostępne kolumny zewnętrzne
Wyświetl listę dostępnych kolumn zewnętrznych w źródle danych. Nie można użyć tej tabeli do dodawania lub usuwania kolumn.

Kolumna zewnętrzna
Wyświetl kolumny zewnętrzne (źródłowe) w kolejności, w której będą widoczne podczas konfigurowania składników korzystających z danych z tego źródła.

kolumna wyjściowa
Podaj unikatową nazwę dla każdej kolumny danych wyjściowych. Wartość domyślna to nazwa wybranej kolumny zewnętrznej (źródłowej). można jednak wybrać dowolną unikatową, opisową nazwę. Podana nazwa zostanie wyświetlona w projektancie usług SSIS.

Edytor źródła ADO NET (strona wyjścia błędów)

Użyj strony Wyjście błędów okna dialogowego Edytora źródłowego ADO NET, aby wybrać opcje obsługi błędów i ustawić właściwości kolumn wyjściowych błędów.

Aby dowiedzieć się więcej o źródle ADO NET, zobacz ADO NET Source (Źródło ADO NET).

Aby otworzyć stronę błędów wyjściowych

1. W narzędziu SQL Server Data Tools (SSDT) otwórz pakiet usług Integration Services, który ma źródło ADO NET.

2. Na karcie Przepływ danych kliknij dwukrotnie źródło ADO NET.

3. W Edytorze źródłowym ADO NET kliknij pozycję Dane wyjściowe błędu.

Opcje

wejściowe/wyjściowe
Wyświetl nazwę źródła danych.

Kolumna
Wyświetl kolumny zewnętrzne (źródłowe) wybrane na stronie Menedżer połączeń okna dialogowego Edytora źródłowego ADO NET .

Błąd
Określ, co powinno się stać, gdy wystąpi błąd: zignoruj go, przekieruj wiersz lub spowoduj awarię składnika.

Tematy związane:Obsługa błędów w danych

Obcinania
Określ, co powinno się zdarzyć, gdy wystąpi skrócenie: zignoruj błąd związany ze skróceniem, przekieruj wiersz lub spowoduj awarię składnika.

Opis
Wyświetl opis błędu.

Przypisz tę wartość do zaznaczonych komórek
Wskaż, co powinno się zdarzyć z wszystkimi zaznaczonymi komórkami, gdy wystąpi błąd lub obcięcie: zignoruj usterkę, przekieruj wiersz lub spowoduj niepowodzenie komponentu.

Zastosuj
Zastosuj opcję obsługi błędów do zaznaczonych komórek.

Zobacz też

Miejsce docelowe elementu DataReader
Miejsce docelowe platformy ADO NET
przepływ danych