Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of mappen te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen om mappen te wijzigen.
van toepassing op:
SQL Server SSIS Integration Runtime in Azure Data Factory
De OLE DB-bestemming laadt gegevens in verschillende OLE DB-compatibele databases met behulp van een databasetabel of -weergave of een SQL-opdracht. De OLE DB-bron kan bijvoorbeeld gegevens laden in tabellen in Microsoft Office Access- en SQL Server-databases.
Opmerking
Als de gegevensbron Microsoft Office Excel 2007 is, is voor de gegevensbron een ander verbindingsbeheer vereist dan in eerdere versies van Excel. Zie Verbinding maken met een Excel-werkmap voor meer informatie.
De OLE DB-bestemming biedt vijf verschillende modi voor gegevenstoegang voor het laden van gegevens:
Een tabel of weergave. U kunt een bestaande tabel of weergave opgeven of u maakt een nieuwe tabel.
Een tabel of weergave met opties voor snel laden. U kunt een bestaande tabel opgeven of een nieuwe tabel maken.
Een tabel of weergave die is opgegeven in een variabele.
Een tabel of weergave die is opgegeven in een variabele met snelle laadopties.
De resultaten van een SQL-instructie.
Opmerking
De OLE DB-bestemming biedt geen ondersteuning voor parameters. Als u een geparameteriseerde INSERT-instructie moet uitvoeren, kunt u de OLE DB-opdrachttransformatie overwegen. Zie OLE DB-opdrachttransformatievoor meer informatie.
Wanneer de OLE DB-bestemming gegevens laadt die gebruikmaken van een DBCS-tekenset (double-byte character set), kunnen de gegevens beschadigd raken als de gegevenstoegangsmodus niet gebruikmaakt van de optie voor snelle belasting en als de OLE DB-verbindingsbeheerder de Microsoft OLE DB-provider voor SQL Server (SQLOLEDB) gebruikt. Als u de integriteit van DBCS-gegevens wilt waarborgen, moet u het OLE DB-verbindingsbeheer configureren voor het gebruik van de systeemeigen SQL Server-client, of een van de fast-load-toegangsmodi gebruiken: tabel of weergave - snel ladenof tabelnaam of weergavenaamvariabele - snel laden. Beide opties zijn beschikbaar in het dialoogvenster OLE DB-doeleditor . Bij het programmeren van het SSIS-objectmodel moet u de eigenschap AccessMode instellen op OpenRowset met behulp van FastLoad of OpenRowset met behulp van FastLoad From Variable.
Opmerking
Als u het dialoogvenster OLE DB-doeleditor in SSIS Designer gebruikt om de doeltabel te maken waarin de OLE DB-bestemming gegevens invoegt, moet u mogelijk de zojuist gemaakte tabel handmatig selecteren. De noodzaak van handmatige selectie vindt plaats wanneer een OLE DB-provider, zoals de OLE DB-provider voor DB2, automatisch schema-id's toevoegt aan de tabelnaam.
Opmerking
Voor de instructie CREATE TABLE die het dialoogvenster OLE DB-doeleditor genereert, is mogelijk een wijziging vereist, afhankelijk van het doeltype. Sommige bestemmingen bieden bijvoorbeeld geen ondersteuning voor de gegevenstypen die door de instructie CREATE TABLE worden gebruikt.
Deze bestemming maakt gebruik van een OLE DB-verbindingsbeheer om verbinding te maken met een gegevensbron en de verbindingsbeheerder 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 om gegevensbronnen en gegevensbronweergaven beschikbaar te maken voor de OLE DB-bestemming.
Een OLE DB-bestemming bevat toewijzingen tussen invoerkolommen en kolommen in de bestemmingsgegevensbron. U hoeft geen invoerkolommen toe te wijzen aan alle doelkolommen, maar afhankelijk van de eigenschappen van de doelkolommen kunnen er fouten optreden als er geen invoerkolommen zijn toegewezen aan de doelkolommen. Als een doelkolom bijvoorbeeld geen null-waarden toestaat, moet een invoerkolom worden toegewezen aan die kolom. Bovendien moeten de gegevenstypen van toegewezen kolommen compatibel zijn. U kunt bijvoorbeeld geen invoerkolom met een tekenreeksgegevenstype toewijzen aan een doelkolom met een numeriek gegevenstype.
De OLE DB-bestemming heeft één reguliere invoer en één foutuitvoer.
Zie Integration Services-gegevenstypenvoor meer informatie over gegevenstypen.
Opties voor snel laden
Als de OLE DB-bestemming gebruikmaakt van een modus voor snelle gegevenstoegang, kunt u de volgende opties voor snelle belasting opgeven in de gebruikersinterface, OLE DB-doeleditor, voor de bestemming:
Bewaar identiteitswaarden uit het geïmporteerde gegevensbestand of gebruik unieke waarden die zijn toegewezen door SQL Server.
Behoud een null-waarde tijdens het bulkladen.
Controleer de beperkingen voor de doeltabel of tabelweergave bij de bulkimportbewerking.
Verkrijg een vergrendeling op tabelniveau voor de duur van de bulksgewijs laden.
Geef het aantal rijen in de batch en de doorvoergrootte op.
Sommige snelle laadopties worden opgeslagen in specifieke eigenschappen van de OLE DB-bestemming. FastLoadKeepIdentity geeft bijvoorbeeld aan of identiteitswaarden moeten worden bewaard, FastLoadKeepNulls geeft aan of nulwaarden moeten worden bewaard en FastLoadMaxInsertCommitSize bepaalt het aantal rijen dat als een batch moet worden doorgevoerd. Andere opties voor snelle belasting worden opgeslagen in een door komma's gescheiden lijst in de eigenschap FastLoadOptions. Als voor de OLE DB-bestemming alle opties voor snelle belasting worden gebruikt die zijn opgeslagen in FastLoadOptions en worden vermeld in het dialoogvenster Van de OLE DB-doeleditor , wordt de waarde van de eigenschap ingesteld op TABLOCK, CHECK_CONSTRAINTS, ROWS_PER_BATCH=1000. De waarde 1000 geeft aan dat de bestemming is geconfigureerd voor het gebruik van batches van 1000 rijen.
Opmerking
Elke beperkingsfout aan de bestemmingslocatie heeft tot gevolg dat de gehele batch rijen zoals gedefinieerd door FastLoadMaxInsertCommitSize mislukt.
Naast de opties voor snel laden die worden weergegeven in het dialoogvenster Ole DB-doeleditor , kunt u de OLE DB-bestemming configureren voor het gebruik van de volgende opties voor bulksgewijs laden door de opties in de eigenschap FastLoadOptions in het dialoogvenster Geavanceerde editor te typen.
| Optie voor snel laden | Beschrijving |
|---|---|
| KILOBYTES_PER_BATCH | Geef de grootte in kilobytes op die moet worden ingevoegd. De optie heeft de vorm KILOBYTES_PER_BATCH = <positieve geheel getalwaarde>. |
| VUUR_TRIGGERS | Hiermee geeft u op of triggers worden geactiveerd in de invoegtabel. De optie bevat het formulier FIRE_TRIGGERS. De aanwezigheid van de optie geeft aan dat brand wordt geactiveerd. |
| BESTELLING | Hiermee geeft u op hoe de invoergegevens worden gesorteerd. De optie heeft de vorm ORDER <kolomnaam> ASC|DESC. Een willekeurig aantal kolommen kan worden weergegeven en het is optioneel om de sorteervolgorde op te nemen. Als de sorteervolgorde wordt weggelaten, wordt bij de invoegbewerking ervan uitgegaan dat de gegevens niet zijn gesorteerd. Opmerking: de prestaties kunnen worden verbeterd als u de optie ORDER gebruikt om de invoergegevens te sorteren op basis van de geclusterde index in de tabel. |
De Transact-SQL trefwoorden worden traditioneel getypt met hoofdletters, maar de trefwoorden zijn niet hoofdlettergevoelig.
Zie BULK INSERT (Transact-SQL) voor meer informatie over opties voor snel laden.
Problemen met de OLE DB-bestemming oplossen
U kunt de aanroepen die de OLE DB-bestemming doet, registreren bij externe gegevensproviders. U kunt deze logboekregistratiefunctie gebruiken om problemen met het opslaan van gegevens op te lossen in externe gegevensbronnen die door de OLE DB-bestemming worden uitgevoerd. Als u de aanroepen wilt vastleggen die door de OLE DB-bestemming worden verzonden naar externe gegevensproviders, schakelt u pakketregistratie in en selecteert u de diagnostische gebeurtenis op pakketniveau. Zie Hulpprogramma's voor probleemoplossing voor pakketuitvoering voor meer informatie.
De OLE DB-bestemming configureren
U kunt eigenschappen instellen via SSIS Designer of programmatisch.
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:
Klik op een van de volgende onderwerpen voor meer informatie over het instellen van eigenschappen:
OLE DB-doeleditor (pagina Verbindingsbeheer)
Gebruik de pagina Verbindingsbeheer van het dialoogvenster OLE DB-doeleditor om de OLE DB-verbinding voor de bestemming te selecteren. Op deze pagina kunt u ook een tabel of weergave in de database selecteren.
Opmerking
Als de gegevensbron Microsoft Office Excel 2007 is, is voor de gegevensbron een ander verbindingsbeheer vereist dan in eerdere versies van Excel. Zie Verbinding maken met een Excel-werkmap voor meer informatie.
Opmerking
De eigenschap CommandTimeout van het OLE DB-doel is niet beschikbaar in de OLE DB-doeleditor, maar kan worden ingesteld met behulp van de geavanceerde editor. Daarnaast zijn bepaalde opties voor snel laden alleen beschikbaar in de geavanceerde editor. Zie de sectie OLE DB-bestemming van aangepaste OLE DB-eigenschappen voor meer informatie over deze eigenschappen.
De eigenschap CommandTimeout is alleen van kracht wanneer de gegevenstoegangsmodus SQL-opdracht is.
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 laden van gegevens in de bestemming. Voor het laden van DBCS-gegevens (double-byte character set) is een van de opties voor snel laden vereist. Zie OLE DB-bestemming voor meer informatie over de modi voor snelle gegevenstoegang, die zijn geoptimaliseerd voor bulkinvoegingen.
| Optie | Beschrijving |
|---|---|
| Tabel of weergave | Gegevens laden in een tabel of weergave in de OLE DB-bestemming. |
| Tabel of weergave - snel laden | Laad gegevens in een tabel of weergave in de OLE DB-bestemming en gebruik de optie voor snel laden. Zie OLE DB-bestemming voor meer informatie over de modi voor snelle gegevenstoegang, die zijn geoptimaliseerd voor bulkinvoegingen. |
| Tabelnaam of weergavenaam variabele | Geef de tabel- of weergavenaam op in een variabele. Gerelateerde informatie: Variabelen gebruiken in pakketten |
| Tabelnaam of weergavenaamvariabele - snel laden | Geef de tabel- of weergavenaam op in een variabele en gebruik de optie voor snel laden om de gegevens te laden. Zie OLE DB-bestemming voor meer informatie over de modi voor snelle gegevenstoegang, die zijn geoptimaliseerd voor bulkinvoegingen. |
| SQL-opdracht | Gegevens laden in het OLE DB-doel met behulp van een SQL-query. |
Voorbeeld
Voorbeeld van resultaten bekijken met behulp van het dialoogvenster Voorbeeld van queryresultaten . Preview kan maximaal 200 rijen weergeven.
Dynamische opties voor gegevenstoegangsmodus
Elk van de instellingen voor de modus Gegevenstoegang geeft een dynamische set opties weer die specifiek zijn voor die instelling. In de volgende secties worden alle dynamische opties beschreven die beschikbaar zijn voor elke instelling 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.
Nieuw
Maak een nieuwe tabel met behulp van het dialoogvenster Tabel maken .
Opmerking
Wanneer u op Nieuw klikt, genereert Integration Services een standaard CREATE TABLE-instructie op basis van de verbonden gegevensbron. Deze standaard CREATE TABLE-instructie bevat niet het KENMERK FILESTREAM, zelfs niet als de brontabel een kolom bevat met het kenmerk FILESTREAM gedeclareerd. Als u een Integration Services-onderdeel wilt uitvoeren met het kenmerk FILESTREAM, implementeert u eerst FILESTREAM-opslag in de doeldatabase. Voeg vervolgens het kenmerk FILESTREAM toe aan de instructie CREATE TABLE in het dialoogvenster Tabel maken . Zie Binary Large Object (Blob) Data (SQL Server) voor meer informatie.
Gegevenstoegangsmodus = Tabel of weergave - snel laden
Naam van de tabel of weergave
Selecteer een tabel of weergave in de database met behulp van deze lijst of maak een nieuwe tabel door op Nieuw te klikken.
Nieuw
Maak een nieuwe tabel met behulp van het dialoogvenster Tabel maken .
Opmerking
Wanneer u op Nieuw klikt, genereert Integration Services een standaard CREATE TABLE-instructie op basis van de verbonden gegevensbron. Deze standaard CREATE TABLE-instructie bevat niet het KENMERK FILESTREAM, zelfs niet als de brontabel een kolom bevat met het kenmerk FILESTREAM gedeclareerd. Als u een Integration Services-onderdeel wilt uitvoeren met het kenmerk FILESTREAM, implementeert u eerst FILESTREAM-opslag in de doeldatabase. Voeg vervolgens het kenmerk FILESTREAM toe aan de instructie CREATE TABLE in het dialoogvenster Tabel maken . Zie Binary Large Object (Blob) Data (SQL Server) voor meer informatie.
Identiteit behouden
Geef op of u identiteitswaarden wilt kopiëren wanneer gegevens worden geladen. Deze eigenschap is alleen beschikbaar met de optie voor snel laden. De standaardwaarde van deze eigenschap is onwaar.
Null-waarden behouden
Geef op of null-waarden moeten worden gekopieerd wanneer gegevens worden geladen. Deze eigenschap is alleen beschikbaar met de optie voor snel laden. De standaardwaarde van deze eigenschap is onwaar.
Tabelvergrendeling
Geef aan of de tabel tijdens het laden is vergrendeld. De standaardwaarde van deze eigenschap is waar.
Beperkingen controleren
Geef op of de bestemming beperkingen controleert wanneer er gegevens worden geladen. De standaardwaarde van deze eigenschap is waar.
Rijen per batch
Geef het aantal rijen in een batch op. De standaardwaarde van deze eigenschap is -1, wat aangeeft dat er geen waarde is toegewezen.
Opmerking
Wis het tekstvak in de DOELeditor van OLE DB om aan te geven dat u geen aangepaste waarde wilt toewijzen voor deze eigenschap.
Maximale invoeg-commitgrootte
Geef de batchgrootte op die de OLE DB-bestemming probeert door te voeren tijdens snelle belastingbewerkingen. De waarde van 0 geeft aan dat alle gegevens in één batch worden doorgevoerd nadat alle rijen zijn verwerkt.
Opmerking
Een waarde van 0 kan ertoe leiden dat het actieve pakket niet meer reageert als het OLE DB-doel en een ander gegevensstroomonderdeel dezelfde brontabel bijwerkt. Als u wilt voorkomen dat het pakket wordt gestopt, stelt u de optie Maximale doorvoergrootte in op 2147483647.
Als u een waarde opgeeft voor deze eigenschap, worden rijen in batches doorgevoerd die kleiner zijn dan (a) de maximale doorvoergrootte voor invoegen, of (b) de resterende rijen in de buffer die momenteel worden verwerkt.
Opmerking
Elke beperkingsfout op het doel veroorzaakt dat de hele batch met rijen die zijn gedefinieerd door de Maximale invoeg-commitsgrootte mislukt.
Gegevenstoegangsmodus = tabelnaam of weergavenaamvariabele
naam van variabele
Selecteer de variabele die de naam van de tabel of weergave bevat.
Data Access-modus = tabelnaam of weergavenaam variabele - snel laden)
naam van variabele
Selecteer de variabele die de naam van de tabel of weergave bevat.
Nieuw
Maak een nieuwe tabel met behulp van het dialoogvenster Tabel maken .
Opmerking
Wanneer u op Nieuw klikt, genereert Integration Services een standaard CREATE TABLE-instructie op basis van de verbonden gegevensbron. Deze standaard CREATE TABLE-instructie bevat niet het KENMERK FILESTREAM, zelfs niet als de brontabel een kolom bevat met het kenmerk FILESTREAM gedeclareerd. Als u een Integration Services-onderdeel wilt uitvoeren met het kenmerk FILESTREAM, implementeert u eerst FILESTREAM-opslag in de doeldatabase. Voeg vervolgens het kenmerk FILESTREAM toe aan de instructie CREATE TABLE in het dialoogvenster Tabel maken . Zie Binary Large Object (Blob) Data (SQL Server) voor meer informatie.
Identiteit behouden
Geef op of u identiteitswaarden wilt kopiëren wanneer gegevens worden geladen. Deze eigenschap is alleen beschikbaar met de optie voor snel laden. De standaardwaarde van deze eigenschap is onwaar.
Null-waarden behouden
Geef op of null-waarden moeten worden gekopieerd wanneer gegevens worden geladen. Deze eigenschap is alleen beschikbaar met de optie voor snel laden. De standaardwaarde van deze eigenschap is onwaar.
Tabelvergrendeling
Geef aan of de tabel tijdens het laden is vergrendeld. De standaardwaarde van deze eigenschap is onwaar.
Beperkingen controleren
Geef aan of de beperkingen van de taak worden gecontroleerd. De standaardwaarde van deze eigenschap is onwaar.
Rijen per batch
Geef het aantal rijen in een batch op. De standaardwaarde van deze eigenschap is -1, wat aangeeft dat er geen waarde is toegewezen.
Opmerking
Wis het tekstvak in de DOELeditor van OLE DB om aan te geven dat u geen aangepaste waarde wilt toewijzen voor deze eigenschap.
Maximale invoeg-commitgrootte
Geef de batchgrootte op die de OLE DB-bestemming probeert door te voeren tijdens snelle belastingbewerkingen. De standaardwaarde van 2147483647 geeft aan dat alle gegevens in één batch worden doorgevoerd nadat alle rijen zijn verwerkt.
Opmerking
Een waarde van 0 kan ertoe leiden dat het actieve pakket niet meer reageert als het OLE DB-doel en een ander gegevensstroomonderdeel dezelfde brontabel bijwerkt. Als u wilt voorkomen dat het pakket wordt gestopt, stelt u de optie Maximale doorvoergrootte in op 2147483647.
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.
Opmerking
De OLE DB-bestemming biedt geen ondersteuning voor parameters. Als u een geparameteriseerde INSERT-instructie moet uitvoeren, kunt u de OLE DB-opdrachttransformatie overwegen. Zie OLE DB-opdrachttransformatievoor meer informatie.
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.
OLE DB-doelbestemmingseditor (Toewijzingenpagina)
Gebruik de pagina Toewijzingen van het dialoogvenster OLE DB Bestemmingseditor om invoerkolommen toe te wijzen aan doelkolommen.
Opties
Beschikbare invoerkolommen
Bekijk de lijst met beschikbare invoerkolommen. Gebruik een slepen-en-neerzetten-bewerking om beschikbare invoerkolommen in de tabel toe te wijzen aan doelkolommen.
Beschikbare doelkolommen
Bekijk de lijst met beschikbare doelkolommen. Gebruik een drag-and-drop operatie om beschikbare doelkolommen in de tabel te koppelen aan invoerkolommen.
Invoerkolom
Bekijk de invoerkolommen die u hebt geselecteerd. U kunt toewijzingen verwijderen door <> negeren om kolommen uit te sluiten van de uitvoer.
Doelkolom
Bekijk elke beschikbare doelkolom, ongeacht of deze is toegewezen of niet.
OLE DB-doeleditor (foutuitvoerpagina)
Gebruik de pagina Foutuitvoer van het dialoogvenster OLE DB-doeleditor om opties voor foutafhandeling op te geven.
Opties
Invoer/Uitvoer
Bekijk de naam van de invoer.
kolom
Niet gebruikt.
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
Niet gebruikt.
Beschrijving
Bekijk de beschrijving van de bewerking.
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.