OLE DB-bron

van toepassing op:SQL Server SSIS Integration Runtime in Azure Data Factory

De OLE DB-bron extraheert gegevens uit verschillende relationele OLE DB-compatibele relationele databases met behulp van een databasetabel, een weergave of een SQL-opdracht. De OLE DB-bron kan bijvoorbeeld gegevens extraheren uit tabellen in Microsoft Office Access- of SQL Server-databases.

De OLE DB-bron biedt vier verschillende modi voor gegevenstoegang voor het extraheren van gegevens:

• Een tabel of weergave.

• Een tabel of weergave die is opgegeven in een variabele.

• De resultaten van een SQL-instructie. De query kan een geparameteriseerde query zijn.

• De resultaten van een SQL-instructie die is opgeslagen in een variabele.

Als u een geparameteriseerde query gebruikt, kunt u variabelen toewijzen aan parameters om de waarden voor afzonderlijke parameters in de SQL-instructies op te geven.

Deze bron maakt gebruik van een OLE DB-verbindingsbeheer om verbinding te maken met een gegevensbron en het verbindingsbeheer specificeert de OLE DB-provider die moet worden gebruikt. Zie OLE DB Connection Manager voor meer informatie.

Een Integration Services-project biedt ook het gegevensbronobject waaruit u een OLE DB-verbindingsbeheer kunt maken, waardoor gegevensbronnen en gegevensbronweergaven beschikbaar zijn voor de OLE DB-bron.

Afhankelijk van de OLE DB-provider gelden enkele beperkingen voor de OLE DB-bron:

• De Microsoft OLE DB-provider voor Oracle biedt geen ondersteuning voor de Oracle-gegevenstypen BLOB, CLOB, NCLOB, BFILE OF UROWID en de OLE DB-bron kunnen geen gegevens extraheren uit tabellen die kolommen met deze gegevenstypen bevatten.

• De IBM OLE DB DB2-provider en Microsoft OLE DB DB2-provider bieden geen ondersteuning voor het gebruik van een SQL-opdracht die een opgeslagen procedure aanroept. Wanneer dit type opdracht wordt gebruikt, kan de OLE DB-bron de metagegevens van de kolom niet maken. Als gevolg daarvan zijn de onderdelen van de gegevensstroom die volgen op de OLE DB-bron in de gegevensstroom zonder kolomgegevens beschikbaar, en mislukt de uitvoering van de gegevensstroom.

De OLE DB-bron heeft één normale uitvoer en één foutuitvoer.

Geparameteriseerde SQL-instructies gebruiken

De OLE DB-bron kan een SQL-instructie gebruiken om gegevens te extraheren. De instructie kan een SELECT- of EXEC-instructie zijn.

De OLE DB-bron maakt gebruik van een OLE DB-verbindingsbeheer om verbinding te maken met de gegevensbron waaruit gegevens worden geëxtraheerd. Afhankelijk van de provider waarmee de OLE DB-verbindingsbeheerder gebruikmaakt en het Relational Database Management System (RDBMS) waarmee de verbindingsbeheerder verbinding maakt, zijn verschillende regels van toepassing op de naamgeving en vermelding van parameters. Als de parameternamen worden geretourneerd vanuit de RDBMS, kunt u parameternamen gebruiken om parameters in een parameterlijst toe te wijzen aan parameters in een SQL-instructie; anders worden de parameters toegewezen aan de parameter in de SQL-instructie door hun rangtelpositie in de parameterlijst. De typen parameternamen die worden ondersteund, variëren per provider. Sommige providers vereisen bijvoorbeeld dat u de variabele- of kolomnamen gebruikt, terwijl sommige providers vereisen dat u symbolische namen zoals 0 of Param0 gebruikt. U dient de providerspecifieke documentatie te raadplegen voor informatie over de parameternamen die in SQL-instructies moeten worden gebruikt.

Wanneer u een OLE DB-verbindingsbeheer gebruikt, kunt u geen geparameteriseerde subquery's gebruiken, omdat de OLE DB-bron geen parametergegevens kan afleiden via de OLE DB-provider. U kunt echter een expressie gebruiken om de parameterwaarden samen te voegen in de querytekenreeks en om de eigenschap SqlCommand van de bron in te stellen. In SSIS Designer configureert u een OLE DB-bron met behulp van het dialoogvenster OLE DB-broneditor en wijst u de parameters toe aan variabelen in het dialoogvenster Queryparameter instellen .

Parameters opgeven met behulp van ordinale posities

Als er geen parameternamen worden geretourneerd, bepaalt de volgorde waarin de parameters worden vermeld in de lijst Parameters in het dialoogvenster Queryparameter instellen welke parametermarkering ze tijdens runtime worden toegewezen. De eerste parameter in de lijst komt overeen met de eerste ? in de SQL-instructie, van de tweede naar de tweede ?, enzovoort.

Met de volgende SQL-instructie worden rijen uit de tabel Product in de AdventureWorks2022 database geselecteerd. De eerste parameter in Toewijzingen komt overeen met de eerste parameter van de kolom Kleur, de tweede parameter met de kolom Grootte.

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

De parameternamen hebben geen effect. Als een parameter bijvoorbeeld dezelfde naam krijgt als de kolom waarop deze van toepassing is, maar niet in de juiste ordinale positie plaatst in de lijst Parameters, wordt bij runtime de ordinale positie van de parameter gebruikt, niet de parameternaam.

De EXEC-opdracht vereist doorgaans dat u de namen van de variabelen gebruikt die parameterwaarden in de procedure als parameternamen opgeven.

Parameters opgeven met behulp van namen

Als de werkelijke parameternamen worden geretourneerd door de RDBMS, worden de parameters die door een SELECT- en EXEC-instructie worden gebruikt, op naam toegewezen. De parameternamen moeten overeenkomen met de namen die de opgeslagen procedure, uitgevoerd door de SELECT-instructie of de EXEC-instructie, verwacht.

Met de volgende SQL-instructie wordt de opgeslagen procedure uspGetWhereUsedProductID uitgevoerd, die beschikbaar is in de AdventureWorks2022 database.

EXEC uspGetWhereUsedProductID ?, ?

In de opgeslagen procedure wordt verwacht dat de variabelen, @StartProductID en @CheckDate, parameterwaarden leveren. De volgorde waarin de parameters worden weergegeven in de lijst Toewijzingen is niet relevant. De enige vereiste is dat de parameternamen overeenkomen met de namen van variabelen in de opgeslagen procedure, inclusief het @-teken.

Parameters koppelen aan variabelen

De parameters worden toegewezen aan variabelen die de parameterwaarden tijdens runtime leveren. De variabelen zijn doorgaans door de gebruiker gedefinieerde variabelen, hoewel u ook de systeemvariabelen kunt gebruiken die Integration Services biedt. Als u door de gebruiker gedefinieerde variabelen gebruikt, moet u ervoor zorgen dat u het gegevenstype instelt op een type dat compatibel is met het gegevenstype van de kolom waarnaar de toegewezen parameter verwijst. Zie SSIS-variabelen (Integration Services)voor meer informatie.

Problemen met de OLE DB-bron oplossen

U kunt de aanroepen die de OLE DB-bron uitvoert, registreren bij externe gegevensproviders. U kunt deze logboekregistratiefunctie gebruiken om problemen met het laden van gegevens uit externe gegevensbronnen op te lossen die door de OLE DB-bron worden uitgevoerd. Als u de oproepen die de OLE DB-bron doet naar externe gegevensproviders wilt registreren, schakelt u pakketregistratie in en selecteert u het Diagnostische evenement op het pakketniveau. Zie Hulpprogramma's voor probleemoplossing voor pakketuitvoering voor meer informatie.

De OLE DB-bron configureren

U kunt eigenschappen programmatisch of via SSIS Designer instellen.

Het dialoogvenster Geavanceerde editor weerspiegelt de eigenschappen die programmatisch kunnen worden ingesteld. Klik op een van de volgende onderwerpen voor meer informatie over de eigenschappen die u kunt instellen in het dialoogvenster Geavanceerde editor of programmatisch:

• algemene eigenschappen

• Aangepaste OLE DB-eigenschappen

Gerelateerde taken

• Gegevens extraheren met behulp van de OLE DB-bron

• Queryparameters toewijzen aan variabelen in een gegevensstroomcomponent

• de eigenschappen van een gegevensstroomonderdeel instellen

• Gegevens sorteren voor de samenvoeg- en merge join-transformaties

Verwante inhoud

SSIS met Oracle connectors

OLE DB-broneditor (Verbindingsbeheerpagina)

Gebruik de pagina Verbindingsbeheer van het dialoogvenster OLE DB-broneditor om het OLE DB-verbindingsbeheer voor de bron te selecteren. Op deze pagina kunt u ook een tabel of weergave in de database selecteren.

Open de OLE DB-broneditor (pagina Verbindingsbeheer)

1. Voeg de OLE DB-bron toe aan het Integration Services-pakket in SQL Server Data Tools (SSDT).

2. Klik met de rechtermuisknop op het brononderdeel en klik op Bewerken.

3. Klik op Verbindingsbeheer.

Statische opties

OLE DB-verbindingsbeheer
Selecteer een bestaand verbindingsbeheer in de lijst of maak een nieuwe verbinding door op Nieuw te klikken.

Nieuw
Maak een nieuw verbindingsbeheer met behulp van het dialoogvenster OLE DB-verbindingsbeheer configureren .

gegevenstoegangsmodus
Geef de methode op voor het selecteren van gegevens uit de bron.

Voorbeeld
Bekijk een voorbeeld van de resultaten door het dialoogvenster gegevensweergave te gebruiken. Preview kan maximaal 200 rijen weergeven.

Dynamische opties voor gegevenstoegangsmodus

Gegevenstoegangsmodus = Tabel of weergave

Naam van de tabel of de weergave
Selecteer de naam van de tabel of weergave in een lijst met de tabellen die beschikbaar zijn in de gegevensbron.

Gegevenstoegangsmodus = tabelnaam of weergavenaamvariabele

naam van variabele
Selecteer de variabele die de naam van de tabel of weergave bevat.

Gegevenstoegangsmodus = SQL-opdracht

SQL-opdrachttekst
Voer de tekst van een SQL-query in, bouw de query door op BuildQuery te klikken of zoek het bestand dat de querytekst bevat door op Bladeren te klikken.

Parameters
Als u een geparameteriseerde query hebt ingevoerd met behulp van ? als tijdelijke aanduiding voor parameters in de querytekst gebruikt u het dialoogvenster Queryparameters instellen om queryinvoerparameters toe te wijzen aan pakketvariabelen.

Buildquery
Gebruik het dialoogvenster Opbouwfunctie voor query's om de SQL-query visueel samen te stellen.

navigeren
Gebruik het dialoogvenster Openen om het bestand te zoeken dat de tekst van de SQL-query bevat.

Query parseren
Controleer de syntaxis van de querytekst.

Gegevenstoegangsmodus = SQL-opdracht van variabele

naam van variabele
Selecteer de variabele die de tekst van de SQL-query bevat.

OLE DB-Broneditor (Kolommenpagina)

Gebruik de pagina Kolommen van het dialoogvenster OLE DB-broneditor om een uitvoerkolom toe te wijzen aan elke externe (bron) kolom.

Opties

beschikbare externe kolommen
Bekijk de lijst met beschikbare externe kolommen in de gegevensbron. U kunt deze tabel niet gebruiken om kolommen toe te voegen of te verwijderen.

Externe Kolom
Bekijk externe (bron)kolommen in de volgorde waarin u ze ziet wanneer u onderdelen configureert die gegevens uit deze bron verbruiken. U kunt deze volgorde wijzigen door eerst de geselecteerde kolommen in de tabel te wissen en vervolgens externe kolommen in de lijst in een andere volgorde te selecteren.

Uitvoerkolom
Geef een unieke naam op voor elke uitvoerkolom. De standaardwaarde is de naam van de geselecteerde externe kolom (bronkolom; U kunt echter elke unieke, beschrijvende naam kiezen. De opgegeven naam wordt weergegeven in de SSIS Designer.

OLE DB-broneditor (foutuitvoerpagina)

Gebruik de pagina Foutuitvoer van het dialoogvenster Ole DB-broneditor om opties voor foutafhandeling te selecteren en eigenschappen in te stellen voor kolommen voor foutuitvoer.

Opties

Invoer/Uitvoer
Bekijk de naam van de gegevensbron.

kolom
Bekijk de externe (bron)kolommen die u hebt geselecteerd op de pagina Verbindingsbeheer van het dialoogvenster OLE DB-broneditor .

Fout
Geef op wat er moet gebeuren wanneer er een fout optreedt: de fout negeren, de rij omleiden of het onderdeel mislukken.

verwante onderwerpen:foutafhandeling in gegevens

Afkorting
Geef op wat er moet gebeuren wanneer er een afkapping plaatsvindt: de fout negeren, de rij omleiden of het onderdeel laten falen.

Beschrijving
Bekijk de beschrijving van de fout.

deze waarde instellen op geselecteerde cellen
Geef op wat er moet gebeuren met alle geselecteerde cellen wanneer er een fout of truncatie optreedt: negeer de fout, leid de rij om, of laat het onderdeel falen.

Toepassen
Pas de foutafhandelingsoptie toe op de geselecteerde cellen.

Zie ook

OLE DB-bestemming
SSIS-variabelen (Integration Services)
gegevensstroom