Miejsce docelowe ODBC

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

Miejsce docelowe ODBC zbiorczo ładuje dane do tabel baz danych obsługiwanych przez odBC. Miejsce docelowe ODBC używa menedżera połączeń ODBC do nawiązywania połączenia ze źródłem danych.

Miejsce docelowe ODBC zawiera mapowania między kolumnami wejściowymi i kolumnami w docelowym źródle danych. Nie trzeba mapować kolumn wejściowych na wszystkie kolumny docelowe, ale w zależności od właściwości kolumn docelowych błędy mogą wystąpić, jeśli kolumny wejściowe nie są mapowane na kolumny docelowe. Jeśli na przykład kolumna docelowa nie zezwala na wartości null, kolumna wejściowa musi zostać zamapowana na tej kolumnie. Ponadto kolumny różnych typów można mapować, jednak jeśli dane wejściowe nie są zgodne z typem kolumny docelowej, w czasie wykonywania wystąpi błąd. W zależności od ustawienia zachowania błędu błąd zostanie zignorowany, spowoduje błąd lub wiersz zostanie wysłany do danych wyjściowych błędu.

Miejsce docelowe ODBC ma jedno regularne dane wyjściowe i jedno dane wyjściowe błędu.

Opcje ładowania

Miejsce docelowe ODBC może używać jednego z dwóch modułów ładowania dostępu. Tryb można ustawić w Edytorze źródłowym ODBC (strona Menedżera połączeń). Dwa tryby to:

• Batch: w tym trybie miejsce docelowe ODBC próbuje użyć najbardziej wydajnej metody wstawiania na podstawie postrzeganych możliwości dostawcy ODBC. W przypadku większości nowoczesnych dostawców ODBC oznaczałoby to przygotowanie instrukcji INSERT z parametrami, a następnie użycie powiązania parametrów tablicy mądrej wierszami (gdzie rozmiar tablicy jest kontrolowany przez właściwość BatchSize ). Jeśli wybierzesz usługę Batch , a dostawca nie obsługuje tej metody, miejsce docelowe ODBC automatycznie przełącza się do trybu Wiersz po wierszu .

• Wiersz po wierszu: W tym trybie miejsce docelowe ODBC przygotowuje instrukcję INSERT z parametrami i używa funkcji SQL Execute do wstawiania wierszy pojedynczo.

Obsługa błędów

Miejsce docelowe ODBC zawiera dane wyjściowe błędu. Dane wyjściowe błędu składnika zawierają następujące kolumny wyjściowe:

• Kod błędu: liczba odpowiadająca bieżącemu błędowi. Zapoznaj się z dokumentacją źródłowej bazy danych, aby uzyskać listę błędów. Aby uzyskać listę kodów błędów usług SSIS, zobacz kod błędu usługi SSIS i odwołanie do komunikatów.

• Kolumna błędu: kolumna źródłowa powodująca błąd (w przypadku błędów konwersji).

• Standardowe kolumny danych wyjściowych.

W zależności od ustawienia zachowania błędu miejsce docelowe ODBC obsługuje zwracanie błędów (konwersja danych, obcinanie), które występują podczas procesu wyodrębniania w danych wyjściowych błędu. Aby uzyskać więcej informacji, zobacz Edytor źródła ODBC (strona danych wyjściowych błędu).

Równoległości prostych

Nie ma żadnych ograniczeń dotyczących liczby składników docelowych ODBC, które mogą być uruchamiane równolegle względem tej samej tabeli lub różnych tabel na tym samym komputerze lub na różnych maszynach (innych niż normalne limity sesji globalnych).

Jednak ograniczenia używanego dostawcy ODBC mogą ograniczać liczbę połączeń współbieżnych za pośrednictwem dostawcy. Ograniczenia te ograniczają liczbę obsługiwanych wystąpień równoległych możliwych dla miejsca docelowego ODBC. Deweloper usług SSIS musi pamiętać o ograniczeniach używanego dostawcy ODBC i wziąć pod uwagę je podczas tworzenia pakietów SSIS.

Należy również pamiętać, że równoczesne ładowanie do tej samej tabeli może zmniejszyć wydajność ze względu na standardowe blokowanie rekordów. Zależy to od ładowanych danych i organizacji tabel.

Rozwiązywanie problemów z miejscem docelowym ODBC

Możesz rejestrować wywołania, które źródło ODBC wykonuje dla zewnętrznych dostawców danych. Za pomocą tej funkcji rejestrowania można rozwiązywać problemy z zapisywaniem danych w zewnętrznych źródłach danych, które wykonuje miejsce docelowe ODBC. Aby zarejestrować wywołania, które obiekt docelowy ODBC wykonuje dla zewnętrznych dostawców danych, włącz śledzenie menedżera sterowników ODBC. Aby uzyskać więcej informacji, zobacz dokumentację firmy Microsoft dotyczącą sposobu generowania śledzenia ODBC za pomocą odBC administratora źródła danych.

Konfigurowanie miejsca docelowego ODBC

Miejsce docelowe ODBC można skonfigurować programowo lub za pomocą projektanta usług SSIS

Aby uzyskać więcej informacji, zobacz jeden z następujących tematów:

Okno dialogowe Edytor zaawansowany zawiera właściwości, które można ustawić programowo.

Aby otworzyć okno dialogowe Edytor zaawansowany :

• Na ekranie Przepływ danych projektu usług SQL Server 2019 Integration Services (SSIS) kliknij prawym przyciskiem myszy miejsce docelowe ODBC i wybierz polecenie Pokaż edytor zaawansowany.

Aby uzyskać więcej informacji o właściwościach, które można ustawić w oknie dialogowym Edytor zaawansowany, zobacz Właściwości niestandardowe miejsca docelowego ODBC.

W tej sekcji

• Ładowanie danych przy użyciu miejsca docelowego ODBC

• Właściwości niestandardowe miejsca docelowego ODBC

Edytor docelowy ODBC (strona Menedżera połączeń)

Użyj strony Menedżer połączeń w oknie dialogowym Edytora docelowego ODBC , aby wybrać menedżera połączeń ODBC dla miejsca docelowego. Ta strona umożliwia również wybranie tabeli lub widoku z bazy danych

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

Lista zadań

• W narzędziach SQL Server Data Tools otwórz pakiet usług SQL Server 2019 Integration Services (SSIS), który ma miejsce docelowe ODBC.

• Na karcie Przepływ danych kliknij dwukrotnie miejsce docelowe ODBC.

• W Edytorze docelowym ODBC kliknij pozycję Menedżer połączeń.

Opcje

Menedżer połączeń

Wybierz istniejącego menedżera połączeń ODBC z listy lub kliknij pozycję Nowy, aby utworzyć nowe połączenie. Połączenie może być z dowolną bazą danych obsługiwaną przez odBC.

Nowy

Kliknij przycisk Nowy. Zostanie otwarte okno dialogowe Konfigurowanie Menedżera połączeń ODBC , w którym można utworzyć nowego menedżera połączeń.

Tryb dostępu do danych

Wybierz metodę ładowania danych do miejsca docelowego. Opcje przedstawiono w poniższej tabeli:

Option	Description
Nazwa tabeli — batch	Wybierz tę opcję, aby skonfigurować miejsce docelowe ODBC do pracy w trybie wsadowym. Po wybraniu tej opcji dostępne są następujące opcje:
	Nazwa tabeli lub widoku: Wybierz dostępną tabelę lub widok z listy. Ta lista zawiera tylko 1000 pierwszych tabel. Jeśli baza danych zawiera więcej niż 1000 tabel, możesz wpisać początek nazwy tabeli lub użyć symbolu wieloznacznego (*) , aby wprowadzić dowolną część nazwy, aby wyświetlić tabelę lub tabele, których chcesz użyć. Rozmiar partii: wpisz rozmiar partii na potrzeby ładowania zbiorczego. Jest to liczba wierszy załadowanych jako partia
Nazwa tabeli — wiersz według wiersza	Wybierz tę opcję, aby skonfigurować miejsce docelowe ODBC, aby wstawić poszczególne wiersze do tabeli docelowej pojedynczo. Po wybraniu tej opcji dostępna jest następująca opcja:
	Nazwa tabeli lub widoku: Wybierz dostępną tabelę lub widok z bazy danych z listy. Ta lista zawiera tylko 1000 pierwszych tabel. Jeśli baza danych zawiera więcej niż 1000 tabel, możesz wpisać początek nazwy tabeli lub użyć symbolu wieloznacznego (*) , aby wprowadzić dowolną część nazwy, aby wyświetlić tabelę lub tabele, których chcesz użyć.

Preview

Kliknij pozycję Podgląd , aby wyświetlić maksymalnie 200 wierszy danych dla wybranej tabeli.

Edytor docelowy ODBC (strona mapowań)

Użyj strony Mapowania okna dialogowego Edytora docelowego ODBC , aby mapować kolumny wejściowe na kolumny docelowe.

Opcje

Dostępne kolumny wejściowe

Lista dostępnych kolumn wejściowych. Przeciągnij i upuść kolumnę wejściową do dostępnej kolumny docelowej, aby zamapować kolumny.

Dostępne kolumny docelowe

Lista dostępnych kolumn docelowych. Przeciągnij i upuść kolumnę docelową do dostępnej kolumny wejściowej, aby zamapować kolumny.

Kolumna wejściowa

Wyświetl wybrane kolumny wejściowe. Mapowania można usunąć, wybierając pozycję Ignoruj<>, aby wykluczyć kolumny z danych wyjściowych.

Kolumna docelowa

Wyświetl wszystkie dostępne kolumny docelowe, zarówno zamapowane, jak i niezamapowane.

Edytor docelowy ODBC (strona danych wyjściowych błędu)

Użyj strony Dane wyjściowe błędu okna dialogowego Edytora docelowego ODBC , aby wybrać opcje obsługi błędów.

Aby otworzyć stronę danych wyjściowych edytora docelowego ODBC

Lista zadań

• W narzędziach SQL Server Data Tools otwórz pakiet usług SQL Server 2019 Integration Services (SSIS), który ma miejsce docelowe ODBC.

• Na karcie Przepływ danych kliknij dwukrotnie miejsce docelowe ODBC.

• W Edytorze docelowym ODBC kliknij pozycję Dane wyjściowe błędu.

Opcje

Dane wejściowe/wyjściowe

Wyświetl nazwę źródła danych.

Kolumna

Nieużytne.

Error

Wybierz sposób obsługi błędów w przepływie przez miejsce docelowe ODBC: ignoruj błąd, przekierowuj wiersz lub kończy się niepowodzeniem składnika.

Obcinania

Wybierz sposób obsługi obcinania miejsca docelowego ODBC w przepływie: ignoruj błąd, przekieruj wiersz lub nie powiedzie się składnikowi.

Description

Wyświetl opis błędu.

Ustaw tę wartość na zaznaczone komórki

Wybierz sposób obsługi wszystkich zaznaczonych komórek przez miejsce docelowe ODBC po wystąpieniu błędu lub obcinania: ignoruj błąd, przekierowuj wiersz lub nie powiedzie się składnikowi.

Apply

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

Opcje obsługi błędów

Poniższe opcje umożliwiają skonfigurowanie sposobu obsługi błędów i obcinania przez miejsce docelowe ODBC.

Składnik niepowodzenia

Zadanie przepływu danych kończy się niepowodzeniem, gdy wystąpi błąd lub obcięcie. Jest to zachowanie domyślne.

Ignoruj błąd

Błąd lub obcięcie jest ignorowane.

Przepływ przekierowania

Wiersz powodujący błąd lub obcięcie jest kierowany do danych wyjściowych błędu miejsca docelowego ODBC. Aby uzyskać więcej informacji, zobacz OdBC Destination (Miejsce docelowe ODBC).