Źródło OLE DB

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

Źródło OLE DB wyodrębnia dane z różnych relacyjnych baz danych zgodnych z ole DB przy użyciu tabeli bazy danych, widoku lub polecenia SQL. Na przykład źródło OLE DB może wyodrębniać dane z tabel w bazach danych programu Microsoft Office Access lub SQL Server.

Źródło OLE DB zapewnia cztery różne tryby dostępu do danych na potrzeby wyodrębniania danych:

• Tabela lub widok.

• Tabela lub widok określony w zmiennej.

• Wyniki instrukcji SQL. Zapytanie może być zapytaniem sparametryzowanym.

• Wyniki instrukcji SQL przechowywanej w zmiennej.

Jeśli używasz zapytania sparametryzowanego, możesz mapować zmienne na parametry, aby określić wartości poszczególnych parametrów w instrukcjach SQL.

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

Projekt usług Integration Services udostępnia również obiekt źródła danych, z którego można utworzyć menedżera połączeń OLE DB, udostępniając źródła danych i widoki źródła danych dla źródła OLE DB.

W zależności od dostawcy OLE DB niektóre ograniczenia dotyczą źródła OLE DB:

• Dostawca microsoft OLE DB dla oracle nie obsługuje typów danych Oracle BLOB, CLOB, NCLOB, BFILE lub UROWID, a źródło OLE DB nie może wyodrębnić danych z tabel zawierających kolumny z tych typów danych.

• Dostawca IBM OLE DB2 i dostawca Microsoft OLE DB2 nie obsługują polecenia SQL, które wywołuje procedurę składowaną. W przypadku użycia tego rodzaju polecenia źródło OLE DB nie może utworzyć metadanych kolumny, a w związku z tym składniki przepływu danych zgodne ze źródłem OLE DB w przepływie danych nie mają dostępnych danych kolumn i wykonanie przepływu danych kończy się niepowodzeniem.

Źródło OLE DB ma jedno regularne wyjście i jedno wyjście błędów.

Używanie sparametryzowanych instrukcji SQL

Źródło OLE DB może używać instrukcji SQL do wyodrębniania danych. Instrukcja może być instrukcją SELECT lub instrukcją EXEC.

Źródło OLE DB używa menedżera połączeń OLE DB do nawiązywania połączenia ze źródłem danych, z którego wyodrębnia dane. W zależności od dostawcy używanego przez menedżera połączeń OLE DB oraz systemu zarządzania relacyjnymi bazami danych (RDBMS), z którymi nawiązuje połączenie menedżer połączeń, różne reguły dotyczą nazewnictwa i wyświetlania listy parametrów. Jeśli nazwy parametrów są zwracane z programu RDBMS, można użyć nazw parametrów do mapowania parametrów na liście parametrów do parametrów w instrukcji SQL; w przeciwnym razie parametry są mapowane na parametr w instrukcji SQL według ich pozycji porządkowej na liście parametrów. Typy nazw parametrów, które są obsługiwane, różnią się w zależności od dostawcy. Na przykład niektórzy dostawcy wymagają używania nazw zmiennych lub kolumn, natomiast niektórzy dostawcy wymagają użycia nazw symbolicznych, takich jak 0 lub Param0. Powinna zostać wyświetlona dokumentacja specyficzna dla dostawcy, aby uzyskać informacje o nazwach parametrów do użycia w instrukcjach SQL.

Jeśli używasz menedżera połączeń OLE DB, nie można użyć sparametryzowanych podzapytania, ponieważ źródło OLE DB nie może uzyskać informacji o parametrach za pośrednictwem dostawcy OLE DB. Można jednak użyć wyrażenia, aby połączyć wartości parametrów w ciąg zapytania i ustawić właściwość SqlCommand źródła. W SSIS Designer skonfiguruj źródło OLE DB przy użyciu okna dialogowego Edytor źródła OLE DB i zamapuj parametry na zmienne w oknie dialogowym Ustaw parametr zapytania.

Określanie parametrów przy użyciu pozycji porządkowych

Jeśli nie są zwracane żadne nazwy parametrów, kolejność, w jakiej parametry są wymienione na liście Parametry w oknie dialogowym Ustawianie parametru zapytania , określa znacznik parametru, do którego są mapowane w czasie wykonywania. Pierwszy parametr na liście odpowiada pierwszemu ? w instrukcji SQL drugi do drugiego ? itd.

Poniższa instrukcja SQL wybiera wiersze z tabeli Product w AdventureWorks2025 bazie danych. Pierwszy parametr na liście Mapowania jest mapowany na pierwszy parametr kolumny Color, a drugi parametr na kolumnę Size.

SELECT * FROM Production.Product WHERE Color = ? AND Size = ?

Nazwy parametrów nie mają wpływu. Jeśli na przykład parametr ma taką samą nazwę jak kolumna, do której ma zastosowanie, ale nie znajduje się w prawidłowej pozycji porządkowej na liście Parametry , mapowanie parametrów, które występuje w czasie wykonywania, będzie używać pozycji porządkowej parametru, a nie nazwy parametru.

Polecenie EXEC zwykle wymaga użycia nazw zmiennych, które dostarczają wartości parametrów w procedurze jako nazwy parametrów.

Określanie parametrów przy użyciu nazw

Jeśli rzeczywiste nazwy parametrów są zwracane z systemu RDBMS, parametry używane przez instrukcję SELECT i EXEC są mapowane według nazwy. Nazwy parametrów muszą być zgodne z nazwami, których oczekuje procedura składowana, uruchamiana przez instrukcję SELECT lub instrukcję EXEC.

Poniższa instrukcja SQL uruchamia składowaną procedurę uspGetWhereUsedProductID, dostępną w AdventureWorks2025 bazie danych.

EXEC uspGetWhereUsedProductID ?, ?

Procedura składowana oczekuje, że zmienne @StartProductID i @CheckDate dostarczą wartości parametrów. Kolejność wyświetlania parametrów na liście Mapowania jest nieistotna. Jedynym wymaganiem jest to, że nazwy parametrów są zgodne z nazwami zmiennych w procedurze składowanej, w tym znakiem @.

Mapowanie parametrów na zmienne

Parametry są mapowane na zmienne, które zapewniają wartości parametrów w czasie wykonywania. Zmienne są zwykle zmiennymi zdefiniowanymi przez użytkownika, chociaż można również używać zmiennych systemowych zapewnianych przez usługi Integration Services. Jeśli używasz zmiennych zdefiniowanych przez użytkownika, upewnij się, że typ danych jest ustawiony na typ zgodny z typem danych kolumny, do której odwołuje się mapowany parametr. Aby uzyskać więcej informacji, zobacz zmienne Integration Services (SSIS).

Rozwiązywanie problemów ze źródłem OLE DB

Możesz rejestrować wywołania, które źródło OLE DB 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 OLE DB. Aby zarejestrować wywołania, które źródło OLE DB 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.

Konfigurowanie źródła OLE DB

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

Okno dialogowe edytora zaawansowanego odzwierciedla właściwości, które można ustawić 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 OLE DB

Powiązane zadania

• Wyodrębnianie danych przy użyciu źródła OLE DB

• Mapowanie parametrów zapytania do zmiennych w elemencie przepływu danych

• ustawianie właściwości składnika przepływu danych

• Sortowanie danych dla przekształceń scalania i scalania sprzężenia

Powiązana zawartość

SSIS z łącznikami Oracle

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

Użyj strony Menedżer połączeń w oknie dialogowym Edytor źródła OLE DB , aby wybrać menedżera połączeń OLE DB dla źródła. Ta strona umożliwia również wybranie tabeli lub widoku z bazy danych.

Otwórz Edytor źródłowy OLE DB (strona Menedżera połączeń)

1. Dodaj źródło OLE DB do pakietu usług Integration Services w narzędziach SQL Server Data Tools (SSDT).

2. Kliknij prawym przyciskiem myszy składnik źródłowy, a następnie kliknij Edytuj.

3. Kliknij pozycję Menedżer połączeń.

Opcje statyczne

Menedżer połączenia OLE DB
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ń OLE DB .

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 = nazwa tabeli lub zmienna nazwy widoku

Nazwa zmiennej
Wybierz zmienną zawierającą nazwę tabeli lub widoku.

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.

Parametry
Jeśli wprowadzono zapytanie sparametryzowane za pomocą ? jako symbol zastępczy parametru w tekście zapytania użyj okna dialogowego Ustawianie parametrów zapytania , aby zamapować parametry wejściowe zapytania na zmienne pakietu.

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.

Analizowanie zapytania
Sprawdź składnię tekstu zapytania.

Tryb dostępu do danych = polecenie SQL ze zmiennej

Nazwa zmiennej
Wybierz zmienną zawierającą tekst zapytania SQL.

Edytor źródłowy OLE DB (strona kolumn)

Użyj strony Kolumny w oknie dialogowym Edytora źródła OLE DB, aby odwzorować kolumnę wyjściową na każdą kolumnę zewnętrzną (źródłową).

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. Tę kolejność można zmienić, usuwając najpierw zaznaczenie wybranych kolumn w tabeli, a następnie wybierając kolumny zewnętrzne z listy w innej kolejności.

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łowy OLE DB (Strona wyjścia błędów)

Użyj strony Dane wyjściowe błędu w oknie dialogowym Edytor źródła OLE DB, aby wybrać opcje obsługi błędów i ustawić właściwości w kolumnach wyjściowych błędów.

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 Edytor źródła OLE DB .

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 OLE DB
Zmienne usług Integration Services (SSIS)
przepływ danych