Delen via


Oracle-bestemming

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

Belangrijk

Microsoft Connector voor Oracle is nu afgeschaft. Details verwijzen naar aankondiging.

De Oracle-bestemming laadt gegevens bulksgewijs in Oracle Database.

De bestemming maakt gebruik van Oracle Connection Manager om verbinding te maken met een gegevensbron. Zie Oracle Connection Manager voor meer informatie.

Een Oracle-bestemming bevat koppelingen tussen invoerkolommen en kolommen in de doelgegevensbron. 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 treedt er tijdens runtime een fout op als de invoergegevens niet compatibel zijn voor het doelkolomtype. Afhankelijk van de instelling voor foutgedrag wordt de fout genegeerd, leidt het tot een mislukking, of wordt de rij omgeleid naar de foutuitvoer.

De Oracle-bestemming heeft één reguliere invoer en één foutuitvoer.

Kolommen met niet-ondersteunde gegevenstypen worden verwijderd met een waarschuwing voordat ze worden toegewezen. Zie Ondersteuning voor gegevenstypen voor meer informatie.

Laadopties

Er worden twee toegangsbelastingsmodi ondersteund. De modus kan worden ingesteld in de Oracle Destination Editor (verbindingsbeheerpagina). De twee modi zijn:

Foutafhandeling

De Oracle-bestemming heeft een foutuitvoer. De foutuitvoer van het onderdeel bevat de volgende uitvoerkolommen:

  • Foutcode: een getal dat het fouttype van de huidige fout aangeeft. De foutcode kan afkomstig zijn van:

    • Oracle-server. Zie de gedetailleerde beschrijving van de fout in de Documentatie van de Oracle-database.
    • SSIS runtime Zie de SSIS-foutcode en berichtreferentie voor een lijst met SSIS-foutcodes.
  • Foutkolom: het bronkolomnummer dat de conversiefouten veroorzaakt.

  • Kolom met foutgegevens: de gegevens die de fout veroorzaken.

Typen uitvoerfouten tijdens het ondersteunde laadproces zijn: gegevensconversie, afkapping of schending van beperkingen, enzovoort. Zie Oracle Destination Editor (Error Output Page).

Met de eigenschap Maximum aantal fouten (MaxErrors) wordt het maximum aantal fouten ingesteld dat kan optreden. Uitvoering stopt en retourneert fouten wanneer het maximumaantal is bereikt. En alleen uitvoeringsrecords voordat het maximum aantal fouten wordt bereikt, worden opgenomen in de doeltabel. zie De Oracle-doeleditor (verbindingsbeheerpagina) voor gedetailleerde configuratie.

Parallellisme

In de batchlaadmodus is er geen beperking voor de configuratie van parallelle uitvoering, maar de prestaties kunnen worden beïnvloed door het standaardmechanisme voor recordvergrendeling. De hoeveelheid prestatieverlies is afhankelijk van de gegevens en de tabelorganisatie.

In het direct-padprotocol (snel laden) kan slechts één Oracle-bestemming worden geconfigureerd om tegelijkertijd op dezelfde tabel te draaien, maar de Parallel-modus kan worden gebruikt.

Een parallelle directe pad maakt het mogelijk om meerdere directe padbelastingen uit te voeren, waarmee meerdere Oracle-bestemmingen kunnen worden geconfigureerd om gelijktijdig op dezelfde tabel te werken. Oracle vergrendelt de doeltabel niet uitsluitend voor gebruik in de sessie voor snelle belasting, waardoor extra snel ladende doelonderdelen parallel dezelfde doeltabel kunnen laden. Het parallelle directe pad is restrictiever; elk gebruik van parallellisme moet vooraf worden gepland.

Er is geen reden om één parallelle sessie te gebruiken.

Raadpleeg de Oracle-documentatie over beperkingen bij het gebruik van parallelle directe pad-ladingen.

Zie Aangepaste eigenschappen van Oracle Destination voor meer informatie.

Problemen met de Oracle-bestemming oplossen

U kunt de ODBC-aanroepen die de Oracle-bron uitvoert, vastleggen in Oracle-gegevensbronnen om problemen met het exporteren van gegevens op te lossen. Als u de ODBC-aanroepen wilt registreren die door de Oracle-bron naar Oracle-gegevensbronnen worden uitgevoerd, schakelt u de ODBC-stuurprogrammabeheertracering in. Voor meer informatie, zie de Microsoft-documentatie over hoe een ODBC-tracering te genereren met de ODBC-gegevensbronbeheerder.

Aangepaste eigenschappen van Oracle-doel

In de volgende tabel worden de aangepaste eigenschappen van de Oracle-bestemming beschreven. Alle eigenschappen zijn leesbaar en beschrijfbaar.

Naam van de eigenschap Gegevenssoort Description Laadmodus
BatchSize Integer De grootte van de batch voor bulksgewijs laden. Dit is het aantal rijen dat als batch is geladen. Wordt alleen gebruikt in de batchmodus.
DefaultCodePage Integer De codepagina die moet worden gebruikt wanneer de gegevensbron geen codepagina-informatie bevat.
Opmerking: deze eigenschap is alleen ingesteld door Geavanceerde editor ..
Gebruik voor beide modi.
FastLoad Booleaan Of Fast Loading wordt gebruikt. De standaardwaarde is onwaar. Dit kan ook worden ingesteld in de Oracle-doeleditor (verbindingsbeheerpagina). Gebruik voor beide modi.
MaxErrors Integer Het aantal fouten dat kan optreden voordat de gegevensstroom wordt gestopt. De standaardwaarde is 0, wat betekent dat er geen limiet is voor het foutnummer.
Als Redirect flow is geselecteerd op de pagina Foutafhandeling. Voordat de limiet voor foutnummers wordt bereikt, worden alle fouten geretourneerd in de foutuitvoer. Zie Foutafhandeling voor meer informatie.
Wordt alleen gebruikt in de modus Fast Load.
NoLogging Booleaan Of databaselogboekregistratie is uitgeschakeld. De standaardwaarde is False, wat betekent dat logboekregistratie is ingeschakeld. Gebruik voor beide modi.
Evenwijdig Booleaan Of parallel laden is toegestaan. True geeft aan dat andere laadsessies mogen worden uitgevoerd op dezelfde doeltabel.
Zie parallellisme voor meer informatie.
Wordt alleen gebruikt in de modus Fast Load.
TableName Snaar / Touwtje De naam van de tabel met de gegevens die worden gebruikt. Wordt gebruikt voor beide modi.
TableSubName Snaar / Touwtje De subnaam of subsectie. Deze waarde is optioneel.
Opmerking: deze eigenschap kan alleen worden ingesteld in Geavanceerde editor.
Wordt alleen gebruikt in de modus Fast Load.
Transactiegrootte Integer Het aantal invoegingen dat in één transactie kan worden aangebracht. De standaardwaarde is batchSize. Wordt alleen gebruikt in de batchmodus.
TransferBufferSize Integer De grootte van de overdrachtbuffer. De standaardwaarde is 64 kB. Wordt alleen gebruikt in de modus Fast Load.

De Oracle-bestemming configureren

De Oracle-bestemming kan programmatisch of via SSIS Designer worden geconfigureerd.

De Oracle Destination Editor wordt weergegeven in de onderstaande afbeelding. Deze bevat de Verbindingsbeheerpagina, de toewijzingspagina en de foutuitvoerpagina.

Zie een van de volgende secties voor meer informatie:

Oracle-bestemming

Het dialoogvenster Geavanceerde editor bevat de eigenschappen die programmatisch kunnen worden ingesteld. Om het dialoogvenster Geavanceerde editor te openen:

  • Klik in het scherm Gegevensstroom van uw Integration Services-project met de rechtermuisknop op de Oracle-bestemming en selecteer Geavanceerde editor weergeven.

Zie Aangepaste eigenschappen van Oracle Destination voor meer informatie over de eigenschappen die u kunt instellen in het dialoogvenster Geavanceerde editor.

Oracle Destination Editor (Verbindingsbeheerpagina)

Gebruik de pagina Verbindingsbeheer van het dialoogvenster Oracle Destination Editor om het Oracle-verbindingsbeheer voor de bestemming te selecteren. Op deze pagina kunt u ook een tabel of weergave in de database selecteren.

De verbindingsbeheerpagina van De Oracle-doeleditor openen

  • Open in SQL Server Data Tools het SSIS-pakket (SQL Server Integration Services) met de Oracle-bestemming.

  • Dubbelklik op de Oracle-bestemming op het tabblad Data Flow.

  • Klik in de Oracle-doeleditor op Verbindingsbeheer.

Options

Verbindingsbeheer

Selecteer een bestaand verbindingsbeheer in de lijst of klik op Nieuw om een nieuw Oracle-verbindingsbeheer te maken.

Nieuw

Klik op Nieuw. Het dialoogvenster Oracle Connection Manager Editor wordt geopend, waar u een nieuw verbindingsbeheer kunt maken.

gegevenstoegangsmodus

Selecteer de methode voor het selecteren van gegevens uit de bron. De opties worden weergegeven in de volgende tabel:

Optie Description
Tabelnaam Configureer de Oracle-bestemming om te werken in de batchmodus. Options:

Naam van de tabel of de weergave: Selecteer een beschikbare tabel of weergave uit de database in de lijst.

Transactiegrootte: voer het aantal invoegingen in dat in één transactie kan staan. De standaardwaarde is batchSize.

Batchgrootte: typ de grootte (aantal rijen geladen) van de batch voor bulksgewijs laden.
Tabelnaam – Snel laden Configureer de Oracle-bestemming zodat deze in de laadmodus snel (Direct Path) werkt.

Er zijn opties beschikbaar:

Naam van de tabel of de weergave: Selecteer een beschikbare tabel of weergave uit de database in de lijst.

Parallelle belasting: of parallel laden is ingeschakeld. Zie Parallellisme voor meer informatie.

Geen logboekregistratie: dit selectievakje om logboekregistratie van databases uit te schakelen. Deze logboekregistratie is een Oracle-database die wordt gebruikt voor hersteldoeleinden, niet gerelateerd aan tracering.

Maximum aantal fouten: maximum aantal fouten dat kan optreden voordat de gegevensstroom wordt gestopt. De standaardwaarde is 0, wat betekent dat er geen getallimiet is.

Alle fouten die kunnen optreden, worden geretourneerd in de foutuitvoer.

Overdrachtbuffergrootte (KB): voer de grootte van de overdrachtsbuffer in. De standaardgrootte is 64 kB.

Bestaande gegevens weergeven

Klik op Bestaande gegevens weergeven om maximaal 200 rijen met gegevens weer te geven voor de tabel die u hebt geselecteerd.

Oracle Destination Editor (pagina Toewijzingen)

Gebruik de pagina Toewijzingen van het dialoogvenster Oracle Destination Editor om invoerkolommen toe te wijzen aan doelkolommen.

De pagina Toewijzingen van de Oracle-bestemmingeditor openen

  • Open in SQL Server Data Tools het SSIS-pakket (SQL Server Integration Services) met de Oracle-bestemming.

  • Dubbelklik op het tabblad Gegevensstroom op de Oracle-bestemming.

  • Klik in de Oracle-doeleditor op Toewijzingen.

Options

Beschikbare invoerkolommen

De lijst met beschikbare invoerkolommen. Sleep een invoerkolom naar een beschikbare doelkolom om de kolommen te koppelen.

Beschikbare doelkolommen

De lijst met beschikbare doelkolommen. Sleep een doelkolom naar een beschikbare invoerkolom om de kolommen te koppelen.

Invoerkolom

Bekijk de invoerkolommen die u hebt geselecteerd. U kunt toewijzingen verwijderen door negeren <te selecteren> om kolommen uit te sluiten van de uitvoer.

Doelkolom

Bekijk alle beschikbare doelkolommen, zowel toegewezen als niet-toegewezen.

Opmerking

Kolommen met niet-ondersteunde gegevenstypen worden verwijderd uit de toewijzing met een waarschuwing.

Oracle-doeleditor (pagina Foutuitvoer)

Gebruik de pagina Foutuitvoer van het dialoogvenster Oracle Destination Editor om opties voor foutafhandeling te selecteren.

Om de foutuitvoerpagina van de Oracle-doeleditor te openen

  • Open in SQL Server Data Tools het SSIS-pakket (SQL Server Integration Services) met de Oracle-bestemming.

  • Open het tabblad Gegevensstroom en dubbelklik op de Oracle-bestemming.

  • Klik in de Oracle-doeleditor op Foutuitvoer.

Options

Foutgedrag

Selecteer hoe de Oracle-bron fouten in een stroom moet verwerken: negeer de fout, leid de rij om of mislukt het onderdeel. Gerelateerde sectie: Foutafhandeling in gegevens

Afkorting

Selecteer hoe de Oracle-bron inkorting in een stroom moet verwerken: negeer de fout, leid de rij om of laat het onderdeel falen.

Volgende stappen