Oracle-mål

gäller för:SQL Server SSIS Integration Runtime i Azure Data Factory

Viktigt!

Microsoft Connector för Oracle är inaktuellt nu. Information finns i meddelandet.

Oracle-målet massinläsningar data till Oracle Database.

Målet använder Oracle Connection Manager för att ansluta till en datakälla. Mer information finns i Oracle Connection Manager.

Ett Oracle-mål innehåller mappningar mellan indatakolumner och kolumner i måldatakällan. Du behöver inte mappa indatakolumner till alla målkolumner, men beroende på egenskaperna för målkolumnerna kan fel inträffa om inga indatakolumner mappas till målkolumnerna. Om en målkolumn till exempel inte tillåter null-värden måste en indatakolumn mappas till den kolumnen. Om indata inte är kompatibla för målkolumntypen uppstår dessutom ett fel vid körning. Beroende på inställningen för felbeteende ignoreras felet, orsakar ett fel eller raden omdirigeras till felutdata.

Oracle-destinationen har en normal indatakälla och en felutdatakälla.

Kolumner med datatyper som inte stöds tas bort från kolumner med en varning innan de mappas. Mer information finns i Stöd för datatyp.

Inläsningsalternativ

Två laddningslägen för åtkomst stöds. Läget kan anges i Oracle-målredigeraren (sidan Anslutningshanterare). De två lägena är:

• Batchbelastning: Det här läget är att läsa in data i Oracle-tabellen i batchar och hela batchen infogas under samma transaktion. Information om hur du konfigurerar det här läget finns i Oracle-målredigeraren (sidan Anslutningshanterare) och Anpassade egenskaper för Oracle-mål.

• Snabb inläsning med direktsökväg: Det här läget är att använda drivrutinens direktsökvägsläge för att läsa in Oracle-tabellen. Det finns begränsningar när du använder det här läget. Mer information finns i Oracle-dokumentationen.
  Information om hur du konfigurerar det här läget finns i Oracle-målredigeraren (sidan Anslutningshanterare) och Anpassade egenskaper för Oracle-mål.

Felhantering

Oracle-målet har en felutgång. Komponentfelutdata innehåller följande utdatakolonner:

• Felkod: Ett tal som representerar feltypen för det aktuella felet. Felkoden kan vara från:

  • Oracle-server. Se detaljerad felbeskrivning i Oracle-databasdokumentationen.
  • SSIS-körningstid. En lista över SSIS-felkoder finns i SSIS-felkoden och meddelandereferensen.

• Felkolumn: Det källkolumnnummer som orsakar konverteringsfelen.

• Feldatakolumner: De data som orsakar felet.

Typer av utdatafel under inläsningsprocessen som stöds är: datakonvertering, trunkering eller begränsningsöverträdelse och så vidare. Se även Oracle-destinationsredigerare (felutgångssida).

Maximalt antal fel (MaxErrors) anger det maximala antalet fel som kan inträffa. Körningen stoppar och returnerar fel när maximalt antal nås. Endast körningsposter som gjorts innan det maximala felnumret uppnås inkluderas i måltabellen. Se Oracle-målredigeraren (sidan Anslutningshanteraren) för detaljerad konfiguration.

Parallellitet

I batchinläsningsläge finns det ingen begränsning för konfigurationen av parallell körning, men prestandan kan påverkas av standardmekanismen för postlåsning. Mängden prestandaförlust beror på data- och tabellorganisationen.

I direktvägsprotokollet (snabb inläsning) kan endast ett Oracle-mål konfigureras för att köras mot samma tabell samtidigt, men kan använda parallellt läge.

En parallell direktvägs tillåter flera direktvägsinladdningar, där flera Oracle-mål kan konfigureras att köras samtidigt mot samma tabell. Oracle låser inte måltabellen exklusivt för användning i den snabba belastningssessionen, vilket gör att ytterligare komponenter för snabb belastning kan läsa in samma måltabell parallellt. Den parallella direktvägen är mer restriktiv, och all användning av parallellitet bör planeras i förväg.

Det finns ingen anledning att använda en enda parallell session.

Se Oracle-dokumentation om begränsningar när du använder parallella direktsökvägsbelastningar.

Mer information finns i Anpassade egenskaper för Oracle-mål.

Felsöka Oracle-målet

Du kan logga ODBC-anropen som Oracle-källan gör till Oracle-datakällor för att felsöka dataexporten. Om du vill logga ODBC-anropen som Oracle-källan gör till Oracle-datakällor aktiverar du ODBC-drivrutinshanterarens spårning. Mer information finns i Microsoft-dokumentationen om hur du genererar en ODBC-spårning med ODBC som datakälladministratör.

Anpassade egenskaper för destination i Oracle

I följande tabell beskrivs de anpassade egenskaperna för Oracle-målet. Alla egenskaper är läs-/skrivegenskaper.

Egenskapsnamn	Datatyp	Description	Inläsningsläge
BatchSize	Integer	Storleken på batchen för massinläsning. Det här är antalet rader som läses in som en batch.	Används endast i batchläge.
DefaultCodePage	Integer	Kodsidan som ska användas när datakällan inte har kodsidasinformation. Obs! Den här egenskapen anges endast av Avancerad redigerare ..	Använd för båda lägena.
FastLoad	Boolean	Om snabb inläsning används. Standardvärdet är false. Detta kan också anges i Oracle-målredigeraren (anslutningshanterarens sida).	Använd för båda lägena.
MaxErrors	Integer	Antalet fel som kan inträffa innan dataflödet stoppas. Standardvärdet är 0, vilket innebär att det inte finns någon gräns för felnummer. Om omdirigeringsflödet har valts på sidan Felhantering . Innan felnummergränsen når returneras alla fel i felutdata. Mer information finns i Felhantering.	Används endast i läge för snabb inläsning.
Ingen loggning	Boolean	Om databasloggning är inaktiverad. Standardvärdet är False, vilket innebär att loggning är aktiverat.	Använd för båda lägena.
Parallell	Boolean	Om parallell inläsning tillåts. True anger att andra inläsningssessioner tillåts köras mot samma måltabell. Mer information finns i Parallellitet.	Används endast i läge för snabb inläsning.
TableName	String	Namnet på tabellen med de data som används.	Används för båda lägena.
TableSubName	String	Undernamnet eller underpartitionen. Det här värdet är valfritt. Obs! Den här egenskapen kan bara anges i Avancerad redigerare.	Används endast i läge för snabb inläsning.
Transactionstorlek	Integer	Antalet infogningar som kan göras i en enda transaktion. Standardvärdet är BatchSize.	Används endast i batchläge.
Överföringsbuffertstorlek	Integer	Storleken på överföringsbufferten. Standardvärdet är 64 KB.	Används endast i läge för snabb inläsning.

Konfigurera Oracle-målet

Oracle-målet kan konfigureras programmatiskt eller via SSIS Designer.

Oracle-destinationeditorn visas på bilden nedan. Den innehåller Sidan Anslutningshanteraren, Sidan Mappningar och Sidan Felutdata.

Mer information finns i något av följande avsnitt:

• Oracle-målredigeraren (sidan Anslutningshanterare)
• Oracle-målredigeraren (mappningssida)
• Oracle-målredigeraren (felutdatasida)

Dialogrutan Avancerad redigerare innehåller de egenskaper som kan anges programmatiskt. Så här öppnar du dialogrutan Avancerad redigerare:

• På skärmen Dataflöde i integrationstjänster-projektet högerklickar du på Oracle-målet och väljer Visa avancerad redigerare.

Mer information om de egenskaper som du kan ange i dialogrutan Avancerad redigerare finns i Anpassade egenskaper för Oracle-mål.

Oracle-målredigeraren (Anslutningshanterarens sida)

Använd sidan Anslutningshanteraren i dialogrutan Oracle-målredigeraren för att välja Oracle-anslutningshanteraren för målet. På den här sidan kan du också välja en tabell eller vy från databasen.

Så här öppnar du sidan Anslutningshanteraren för Oracle-målredigeraren

• Öppna SQL Server Integration Services-paketet (SSIS) som har Oracle-målet i SQL Server Data Tools.

• Dubbelklicka på Oracle-målet på fliken Dataflöde.

• Klicka på Anslutningshanteraren i Oracle-målredigeraren.

Options

Anslutningshanteraren

Välj en befintlig anslutningshanterare i listan eller klicka på Ny för att skapa en ny Oracle-anslutningshanterare.

New

Klicka på Nytt. Dialogrutan Oracle Connection Manager Editor öppnas där du kan skapa en ny anslutningshanterare.

Dataåtkomstläge

Välj metoden för att välja data från källan. Alternativen visas i följande tabell:

Option	Description
Tabellnamn	Konfigurera Oracle-målet så att det fungerar i batchläge. Options: Namnet på tabellen eller vyn: Välj en tillgänglig tabell eller vy från databasen i listan. Transaktionsstorlek: Ange antalet infogningar som kan finnas i en enda transaktion. Standardvärdet är BatchSize. Batchstorlek: Ange storleken (antalet rader som läses in) för batchen för massinläsning.
Tabellnamn – Snabbladdning	Konfigurera Oracle-målet så att det fungerar i snabbt inläsningsläge (direkt sökväg). Alternativ är tillgängliga: Namnet på tabellen eller vyn: Välj en tillgänglig tabell eller vy från databasen i listan. Parallell belastning: Om parallell inläsning är aktiverat. Mer information finns i Parallellitet. Ingen loggning: Den här kryssrutan för att inaktivera databasloggning. Den här loggningen är En Oracle-databas som används för återställning, inte relaterad till spårning. Maximalt antal fel: Maximalt antal fel som kan inträffa innan dataflödet stoppas. Standardvärdet är 0, vilket innebär att det inte finns någon nummergräns. Alla fel som inträffar returneras i felutdata. Överföringsbuffertstorlek (KB): Ange storleken på överföringsbufferten. Standardstorleken är 64 KB.

Visa befintliga data

Klicka på Visa befintliga data för att visa upp till 200 rader data för den tabell som du har valt.

Oracle Målredigeraren (sidan Mappningar)

Använd sidan Mappningar i dialogrutan Oracle-målredigeraren för att mappa indatakolumner till målkolumner.

För att öppna Mappningssidan i Oracle Destination Editor

• Öppna SQL Server Integration Services-paketet (SSIS) som har Oracle-målet i SQL Server Data Tools.

• Dubbelklicka på Oracle-målet på fliken Dataflöde.

• I Oracle-målredigeraren klickar du på Mappningar.

Options

Tillgängliga Indatakolumner

Listan över tillgängliga indatakolumner. Dra och släpp en indatakolumn till en tillgänglig målkolumn för att mappa kolumnerna.

Tillgängliga målkolumner

Listan över tillgängliga målkolumner. Dra och släpp en målkolumn till en tillgänglig indatakolumn för att mappa kolumnerna.

Indatakolumn

Visa de indatakolumner som du har valt. Du kan ta bort mappningar genom att < välja Ignorera > för att exkludera kolumner från utdata.

Målkolumn

Visa alla tillgängliga målkolumner, både mappade och avmappade.

Anmärkning

Kolumner med datatyper som inte stöds tas bort från mappningen med en varning.

Oracle-måleditor (Felutdata-sida)

Använd sidan Felutdata i dialogrutan Oracle-målredigeraren för att välja alternativ för felhantering.

Så här öppnar du felutdatasidan för Oracle-målredigeraren

• Öppna SQL Server Integration Services-paketet (SSIS) som har Oracle-målet i SQL Server Data Tools.

• Dubbelklicka på Oracle-målet på fliken Dataflöde.

• I Oracle-målredigeraren, klickar du på Felutgång.

Options

Felbeteende

Välj hur Oracle-källan ska hantera fel i ett flöde: ignorera felet, omdirigera raden eller fela komponenten. Relaterat avsnitt: Felhantering i data

Trunkering

Välj hur Oracle-källan ska hantera avkortning i ett flöde: ignorera felet, omdirigera raden eller stoppa komponenten.

Nästa steg

• Konfigurera Oracle Connection Manager.
• Konfigurera Oracle-källa.
• Konfigurera Oracle-destination.
• Om du har frågor kan du besöka TechCommunity.