Megosztás:

OLE DB-forrás

A következőkre vonatkozik:SQL Server SSIS integrációs futtatókörnyezet az Azure Data Factory-ban

Az OLE DB-forrás különböző OLE DB-kompatibilis relációs adatbázisokból nyer ki adatokat adatbázistábla, nézet vagy SQL-parancs használatával. Az OLE DB-forrás például adatokat nyerhet ki a Microsoft Office Access vagy az SQL Server-adatbázisok tábláiból.

Megjegyzés:

Ha az adatforrás a Microsoft Office Excel 2007, az adatforráshoz az Excel korábbi verzióitól eltérő kapcsolatkezelő szükséges. További információ: Csatlakozás Excel-munkafüzethez.

Az OLE DB-forrás négy különböző adatelérési módot biztosít az adatok kinyeréshez:

  • Táblázat vagy nézet.

  • Egy változóban megadott tábla vagy nézet.

  • Egy SQL-utasítás eredményei. A lekérdezés paraméteres lekérdezés lehet.

  • Egy változóban tárolt SQL-utasítás eredményei.

Megjegyzés:

Ha EGY SQL-utasítással olyan tárolt eljárást hív meg, amely egy ideiglenes táblából származó eredményeket ad vissza, az EREDMÉNYKÉSZLETTEL lehetőséggel definiálhatja az eredményhalmaz metaadatait.

Ha paraméteres lekérdezést használ, a változókat paraméterekre képezheti le, így megadhatja az egyes paraméterek értékeit az SQL-utasításokban.

Ez a forrás egy OLE DB kapcsolatkezelővel csatlakozik egy adatforráshoz, és a kapcsolatkezelő megadja a használni kívánt OLE DB-szolgáltatót. További információ: OLE DB Connection Manager.

Az Integration Services-projektek azt az adatforrás-objektumot is biztosítják, amelyből létrehozhat egy OLE DB kapcsolatkezelőt, így az adatforrások és az adatforrásnézetek elérhetővé válnak az OLE DB-forrás számára.

Az OLE DB-szolgáltatótól függően bizonyos korlátozások vonatkoznak az OLE DB-forrásra:

  • Az Oracle Microsoft OLE DB-szolgáltatója nem támogatja a BLOB, CLOB, NCLOB, BFILE VAGY UROWID oracle adattípusokat, és az OLE DB-forrás nem tud adatokat kinyerni az ilyen adattípusú oszlopokat tartalmazó táblákból.

  • Az IBM OLE DB2 szolgáltató és a Microsoft OLE DB2 szolgáltató nem támogatja a tárolt eljárást meghívó SQL-parancsok használatát. Ilyen típusú parancs használatakor az OLE DB-forrás nem tudja létrehozni az oszlop metaadatait, ezért az adatfolyam OLE DB-forrását követő adatfolyam-összetevők nem rendelkeznek oszlopadatokkal, és az adatfolyam végrehajtása meghiúsul.

Az OLE DB-forrás egy normál kimenettel és egy hibakimenettel rendelkezik.

Paraméteres SQL-utasítások használata

Az OLE DB-forrás egy SQL-utasítással kinyerheti az adatokat. Az utasítás lehet SELECT vagy EXEC utasítás.

Az OLE DB-forrás egy OLE DB kapcsolatkezelővel csatlakozik ahhoz az adatforráshoz, amelyből adatokat nyer ki. Az OLE DB kapcsolatkezelő által használt szolgáltatótól és a kapcsolatkezelő által használt relációsadatbázis-kezelő rendszertől (RDBMS) függően különböző szabályok vonatkoznak a paraméterek elnevezésére és listázására. Ha a paraméternevek az RDBMS-ből származnak, paraméternevek használatával leképezheti a paraméterlistában szereplő paramétereket egy SQL-utasítás paramétereire; ellenkező esetben a paraméterek az SQL-utasításban szereplő paraméterhez vannak leképezve a paraméterlistában elfoglalt sorrendi pozíciójuk alapján. A támogatott paraméternevek típusai szolgáltatónként eltérőek. Egyes szolgáltatók például megkövetelik, hogy a változó- vagy oszlopneveket használja, míg egyes szolgáltatóknak szimbolikus neveket kell használniuk, például 0 vagy Param0. Az SQL-utasításokban használandó paraméternevekkel kapcsolatos információkért tekintse meg a szolgáltatóspecifikus dokumentációt.

Ha OLE DB kapcsolatkezelőt használ, nem használhat paraméteres részlekérdezéseket, mert az OLE DB-forrás nem tud paraméteradatokat kinyerni az OLE DB-szolgáltatón keresztül. Egy kifejezéssel azonban összefűzheti a paraméterértékeket a lekérdezési sztringben, és beállíthatja a forrás SqlCommand tulajdonságát. Az SSIS Designerben az OLE DB-forrásszerkesztő párbeszédpanel használatával konfigurálhat egy OLE DB-forrást, és megfeleltetheti a paramétereket változóknak a Lekérdezési paraméter beállítása párbeszédpanelen.

Paraméterek megadása az ordinális pozíciók használatával

Ha a rendszer nem ad vissza paraméterneveket, a paramétereknek a Lekérdezési paraméter beállítása párbeszédpanel Paraméterek listájában szereplő sorrendje határozza meg, hogy melyik paraméterjelölőre vannak leképezve a futtatáskor. A lista első paramétere az elsőhöz van társítva. az SQL-utasításban a második "?" pozíció után a következő "?", és így tovább.

Az alábbi SQL-utasítás kiválasztja az adatbázis Termék táblájának AdventureWorks2025 sorait. A Leképezések lista első paramétere az első paramétert a Szín oszlopra, a második paramétert pedig a Méret oszlopra képezi le.

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

A paraméterneveknek nincs hatása. Ha például egy paraméter neve ugyanaz, mint az oszlop, amelyre vonatkozik, de nem a megfelelő sorrendi pozícióba kerül a Paraméterek listában, akkor a futtatáskor előforduló paraméterleképezés a paraméter sorszámát fogja használni, nem pedig a paraméter nevét.

Az EXEC parancs általában megköveteli, hogy az eljárásban paraméterértékeket biztosító változók neveit használja paraméternévként.

Paraméterek megadása nevek használatával

Ha a tényleges paraméterneveket az RDBMS adja vissza, a SELECT és AZ EXEC utasítás által használt paramétereket a rendszer név szerint megfelelteti. A paraméterneveknek meg kell egyeznie a SELECT utasítás vagy az EXEC utasítás által várt tárolt eljárás nevével.

Az alábbi SQL-utasítás az adatbázisban elérhető AdventureWorks2025 tárolt eljárást futtatja.

EXEC uspGetWhereUsedProductID ?, ?

A tárolt eljárás azt várja, hogy a @StartProductID és @CheckDate változók biztosítsák a paraméterértékeket. A paraméterek leképezési listában való megjelenésének sorrendje irreleváns. Az egyetlen követelmény, hogy a paraméternevek megegyeznek a tárolt eljárás változónevével, beleértve a @ jelet is.

Paraméterek leképezése változókhoz

A paraméterek olyan változókra vannak leképezve, amelyek futásidőben adják meg a paraméterértékeket. A változók általában felhasználó által definiált változók, de az Integration Services által biztosított rendszerváltozókat is használhatja. Ha felhasználó által definiált változókat használ, győződjön meg arról, hogy az adattípust olyan típusra állítja be, amely kompatibilis a megfeleltetett paraméter által hivatkozott oszlop adattípusával. További információ: Integration Services (SSIS) változók.

Az OLE DB-forrás hibaelhárítása

Naplózhatja az OLE DB-forrás által a külső adatszolgáltatókhoz intézett hívásokat. Ezzel a naplózási funkcióval elháríthatja az OLE DB-forrás által végrehajtott külső adatforrásokból származó adatok betöltését. Az OLE DB-forrás által a külső adatszolgáltatókhoz intézett hívások naplózásához engedélyezze a csomagnaplózást, és válassza ki a diagnosztikai eseményt a csomag szintjén. További információ: A csomagvégrehajtás hibaelhárítási eszközei.

Az OLE DB-forrás konfigurálása

A tulajdonságokat programozott módon vagy az SSIS Designer használatával is beállíthatja.

A Speciális szerkesztő párbeszédpanel a programozott módon beállítható tulajdonságokat tükrözi. A Speciális szerkesztő párbeszédpanelen vagy programozott módon beállítható tulajdonságokról az alábbi témakörök egyikére kattintva talál további információt:

Kapcsolódó tartalom

SSIS Oracle-összekötőkkel

OLE DB-forrásszerkesztő (Kapcsolatkezelő lap)

Az OLE DB Forrásszerkesztő párbeszédpanel Kapcsolatkezelő lapján válassza ki a forráshoz tartozó OLE DB kapcsolatkezelőt. Ezen a lapon egy táblázatot vagy nézetet is kijelölhet az adatbázisból.

Megjegyzés:

Ha a Microsoft Office Excel 2007-et használó adatforrásból szeretne adatokat betölteni, használjon OLE DB-forrást. Excel-forrásból nem tölthet be adatokat Excel 2007-adatforrásból. További információ: OLE DB Connection Manager konfigurálása.

Ha a Microsoft Office Excel 2003-at vagy korábbi verziót használó adatforrásból szeretne adatokat betölteni, használjon Excel-forrást. További információ: Excel Source Editor (Connection Manager Page).

Megjegyzés:

Az OLE DB-forrás CommandTimeout tulajdonsága nem érhető el az OLE DB-forrásszerkesztőben, de a Speciális szerkesztővel állítható be. A tulajdonsággal kapcsolatos további információkért lásd az OLE DB egyéni tulajdonságainak Excel-forrás szakaszát.

Nyissa meg az OLE DB-forrásszerkesztőt (Kapcsolatkezelő lap)

  1. Adja hozzá az OLE DB-forrást az Integration Services-csomaghoz az SQL Server Data Tools (SSDT) alkalmazásban.

  2. Kattintson a jobb gombbal a forrásösszetevőre, és kattintson a Szerkesztés parancsra.

  3. Kattintson a Kapcsolatkezelő elemre.

Statikus beállítások

OLE DB kapcsolatkezelő
Válasszon ki egy meglévő kapcsolatkezelőt a listából, vagy hozzon létre egy új kapcsolatot az Új gombra kattintva.

Új
Hozzon létre egy új kapcsolatkezelőt az OLE DB Connection Manager konfigurálása párbeszédpanelen.

adatelérési mód
Adja meg a forrásból származó adatok kiválasztásának módját.

Lehetőség Leírás
Táblázat vagy nézet Adatok lekérése egy táblából vagy nézetből az OLE DB adatforrásában.
Táblanév- vagy nézetnévváltozó Adja meg a tábla vagy a nézet nevét egy változóban.

Kapcsolódó információk:Változók használata a csomagokban
SQL-parancs Adatok lekérése az OLE DB-adatforrásból EGY SQL-lekérdezés használatával.
SQL-parancs változóból Adja meg az SQL-lekérdezés szövegét egy változóban.

Előzetes verzió
Az Adatnézet párbeszédpanel használatával tekintheti meg az eredmények előnézetét. Az előnézet legfeljebb 200 sort jeleníthet meg.

Megjegyzés:

Az adatok előnézetének megtekintésekor a CLR felhasználó által definiált típusú oszlopok nem tartalmaznak adatokat. Ehelyett az értékek túl nagyok <a megjelenítéshez> vagy a System.Byte[] megjelenítéshez. Az előbbi akkor jelenik meg, ha az adatforrás az SQL OLE DB-szolgáltatóval érhető el, az utóbbi pedig az SQL Server natív ügyfélszolgáltatójának használatakor.

Adatelérési mód dinamikus beállításai

Adatelérési mód = Táblázat vagy nézet

A tábla vagy a nézet neve
Válassza ki a tábla vagy nézet nevét az adatforrásban elérhetőek listájából.

Adatelérési mód = Táblanév vagy nézetnévváltozó

változónév
Válassza ki a tábla vagy nézet nevét tartalmazó változót.

Adatelérési mód = SQL parancs

SQL-parancsszöveg
Írja be egy SQL-lekérdezés szövegét, hozza létre a lekérdezést a Lekérdezés összeállítása gombra kattintva, vagy keresse meg a lekérdezés szövegét tartalmazó fájlt a Tallózás gombra kattintva.

Paraméterek
Ha paraméteres lekérdezést adott meg a következő használatával: ? a lekérdezés szövegében paraméterhelyőrzőként használja a Lekérdezési paraméterek beállítása párbeszédpanelt a lekérdezés bemeneti paramétereinek a csomagváltozókhoz való leképezéséhez.

Lekérdezés összeállítása
A Lekérdezésszerkesztő párbeszédpanel használatával vizuálisan hozhatja létre az SQL-lekérdezést.

Tallózás
A Megnyitás párbeszédpanelen keresse meg az SQL-lekérdezés szövegét tartalmazó fájlt.

Lekérdezés elemzése
Ellenőrizze a lekérdezés szövegének szintaxisát.

Adatelérési mód = SQL-parancs változóból

változónév
Válassza ki az SQL-lekérdezés szövegét tartalmazó változót.

OLE DB Forrásszerkesztő (Oszlopok oldal)

Az OLE DB Forrásszerkesztő párbeszédpanel Oszlopok lapján képezhet le egy kimeneti oszlopot minden külső (forrás) oszlophoz.

Beállítások

elérhető külső oszlopok
Tekintse meg az adatforrásban elérhető külső oszlopok listáját. A táblázat nem használható oszlopok hozzáadására és törlésére.

külső oszlop
Tekintse meg a külső (forrás) oszlopokat abban a sorrendben, amelyben a forrásból származó adatokat használó összetevők konfigurálásakor látni fogja őket. Ezt a sorrendet úgy módosíthatja, hogy először törli a táblázat kijelölt oszlopait, majd egy másik sorrendben kiválasztja a külső oszlopokat a listából.

kimeneti oszlop
Adja meg az egyes kimeneti oszlopok egyedi nevét. Az alapértelmezett érték a kijelölt külső (forrás) oszlop neve; azonban bármilyen egyedi, leíró nevet választhat. A megadott név megjelenik az SSIS Designerben.

OLE DB-forrásszerkesztő (Hibakimeneti oldal)

Az OLE DB Forrásszerkesztő párbeszédpanel Hibakimenet lapján válassza ki a hibakezelési beállításokat, és adja meg a hibakimeneti oszlopok tulajdonságait.

Beállítások

bemeneti/kimeneti
Az adatforrás nevének megtekintése.

oszlop
Tekintse meg az OLE DB Forrásszerkesztő párbeszédpanel Kapcsolatkezelő lapján kiválasztott külső (forrás) oszlopokat.

Hiba
Adja meg, hogy mi történjen, ha hiba történik: hagyja figyelmen kívül a hibát, irányítsa át a sort, vagy hiúsítsa meg az összetevőt.

Kapcsolódó témakörök:Hibakezelés az adatokban

Truncálás
Adja meg, hogy mi történjen csonkolás esetén: hagyja figyelmen kívül a hibát, irányítsa át a sort, vagy az összetevő sikertelen legyen.

Leírás
Tekintse meg a hiba leírását.

Állítsa be ezt az értéket a kijelölt cellákra
Adja meg, hogy mi történjen az összes kijelölt cellával, ha hiba vagy csonkolás történik: hagyja figyelmen kívül a hibát, irányítsa át a sort, vagy az összetevő meghibásodjon.

alkalmazása
Alkalmazza a hibakezelési beállítást a kijelölt cellákra.

Lásd még:

OLE DB célhelye
Integrációs szolgáltatások (SSIS) változói
Adatfolyam

  • Last updated on