Dela via

Teradata-destination

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

Teradata-destinationen laddar in stora mängder data i Teradata Database.

Måldestinationen använder Teradata-anslutningshanteraren för att ansluta till en datakälla. Mer information finns i Teradata Connection Manager.

Inläsningsalternativ

Teradata-målet stöder två dataöverföringslägen:

  • TPT Stream: I det här läget används TPT API Stream-operatorn (Teradata TPump-protokollet).

  • TPT-belastning (snabb massinläsning): I det här läget används TPT API Load-operatorn (Teradata FastLoad-protokollet) för snabb massinläsning.

Läget för snabb inläsning har nedanstående begränsningar:

  • Gränsen för sessioner för Teradata-databasen bestäms av den faktor som anges nedan först:

    • Sessionsgränser som angetts med hjälp av sessionskommandot
    • Teradata Database-gränsen på en session per AMP
    • Plattformsgränsen för maximalt antal sessioner per program: Definierad av MaxSess-variabeln i programvarufilen för kommunikationsprocessorns (COP) gränssnitt CLISPB.DAT. Du kan använda kommandot TDP SET MAXSESSIONS för att ange en plattformsgräns. Standardgränsen är lika med serverns MAXSESS.

  • Join-indexar stöds inte.

  • Sekundärnyckelreferenser i måltabeller stöds inte.

  • Måltabeller som definierats med ett sekundärt index stöds inte.

Mer information om begränsningar för snabb inläsning med Teradata finns i Teradatas snabbinläsningsreferens.

Du kan ange läget i Teradata-målredigeraren (anslutningshanterarens sida).

Felhantering

Fel som returneras under inläsningsprocessen skrivs till tillfälliga feltabeller som är låsta under inläsningsprocessen. Maximalt antal fel (MaxErrors) i Avancerad redigerare anger det maximala antalet fel som kan skrivas till dessa tabeller.

Om maximalt antal fel är större än noll genereras feltabeller med unika namn och informationsmeddelande skrivs ut i paketloggen. Felen kan hämtas via standardfelutdata för SSIS-komponenter.

De temporära tabellerna tas bort när inläsningsprocessen har slutförts. Om de temporala tabellerna inte kan läsas av Teradata-målet tas de inte bort såvida inte egenskapen Ta bort feltabell kontrolleras. Om inläsningsprocessen stoppas före slutförandet måste du ta bort tabellerna manuellt om det behövs. Dessa tabeller finns i samma databas som måltabellen.

När maximalt antal fel har nåtts beror måltabelltillståndet på vilket läge som används.

  • I läget för snabb inläsning går det inte att använda måltabellen. För att köra igen måste du antingen ta bort eller återskapa måltabellen. Återställning stöds inte.
  • I TPT Steam-operatörsläge körs Teradata-målet via en buffrad radmekanism. Om jobbet misslyckas blir alla ändringar som slutfördes (buffertar skickades) vid tidpunkten för felet permanenta i måltabell(er). Det finns inget rollback-koncept. Feltabeller tas bort.

Teradata-målet har en felutgång. Mer information finns i Teradata-målredigeraren (felutdatasida).

Parallellitet

Parallellitet är begränsad i snabbt inläsningsläge, flera oberoende snabbinläsningsjobb kan inte komma åt samma tabell samtidigt. Även antalet samtidiga snabbinläsningsjobb begränsas av databasvariabeln MaxLoadTasks.

Det finns ingen begränsning av parallellitet i TPT Stream-läge. Det går att köra flera Teradata-mål samtidigt mot samma tabell, vilket kan minska prestandan per Teradata. Mer information finns i Teradata-dokumentationen.

Felsöka Teradata-destinationen

Du kan logga de anrop som Teradata-källan gör till Teradata Parallel Transporter API (TPT API). Du kan aktivera paketloggning och välja diagnostikhändelsen på paketnivå för att logga anropen.

Du kan logga ODBC-anropen som Teradada-källan gör till Teradata ODBC-drivrutinen genom att aktivera 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 Teradata-mål

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

Egenskapsnamn Datatyp Description
AlwaysDropErrorTable Boolean Standardvärdet är Falskt. Ta bort alla feltabeller om Sant, även om Teradata-destinationen misslyckas att läsa.
ArraySupport Boolean Standardvärdet är True. DML-grupper använder ArraySupport om True. Gäller endast för TPT Stream. Den här egenskapen finns i Avancerad redigerare.
Buffertar Integer Antalet buffertar för begäran som ska ökas, värdet kan anges från 2 till 64. Gäller endast för TPT Stream. Den här egenskapen finns i Avancerad redigerare.
Bufferläge Boolean Standardvärdet är True. Måste vara True om PutBuffer-funktionen används. Den här egenskapen finns i Avancerad redigerare.
Buffertstorlek Integer Utdatabuffertens storlek (i KB) som används för att skicka lastpaket. Standardvärdet är 1024. Gäller endast för TPT-inläsning. Den här egenskapen finns i Avancerad redigerare.
DataKryptering Boolean Standardvärdet är Falskt. Fullständig säkerhetskryptering används om sant.
DefaultCodePage Integer Kodsidan som ska användas när datakällan inte har kodsidasinformation.
Obs! Den här egenskapen finns i Avancerad redigerare.
DetaljeradSpårningsNivå Heltal (uppräkning) Välj något av följande alternativ för avancerad spårning:
Av: Ingen avancerad loggning.
Allmänt: Det loggas allmän spårning av drivrutinsspecifika aktiviteter.
CLI: Spårning av CLIv2-relaterade aktiviteter loggas.
Notify-metod: Meddela att spårning av funktionsrelaterade aktiviteter loggas.
Common Library: Spårning av aktiviteter i opcommon-biblioteket loggas.
Alla: Alla aktiviteter som spåras ovan loggas.
Den avancerade spårningsloggfilen definieras i egenskapen DetailedTracingFile .
Egenskapen DetailedTracingFile måste anges om alternativet inte är Av.
Den här egenskapen finns i Avancerad redigerare.
DetaljeradSporfil String Sökvägen till loggfilen som genereras automatiskt när DetailedTracingLevel inte är Avstängd. Den här egenskapen finns i Avancerad redigerare.
DiscardLargeRow Boolean Standardvärdet är Falskt. Ta bort stora rader (större än 64 000) om True
ErrorTableName String Feltabellnamn. Standardvärdet är måltabellnamnet
FörlängdSträngKolumnerAllokering Boolean Maximal överföringsteckenallokeringsfaktor används om True.
Det här värdet ska anges till Sant om Teradata-databasens egenskap Exportera breddtabell-ID är inställd på Maximala standardvärden.
Standardvärdet är Falskt.
FastLoad Boolean Snabb inläsning används om sant. Standardvärdet är false. Detta kan också anges i Teradata-målredigeraren (sidan Anslutningshanterare).
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 Teradata-målredigeraren (felutdatasida).
MaxSessions Integer Det maximala antalet sessioner som är inloggade. Det här värdet måste vara större än ett. Standardvärdet är en session för varje tillgänglig AMP.
MinSessioner Integer Det minsta antalet sessioner som är inloggade. Det här värdet måste vara större än ett. Standardvärdet är en session för varje tillgänglig AMP.
Paket Integer Antalet instruktioner som ska packas i en begäran med flera instruktioner. Standardvärdet är 20, högsta tillåtna är 2400. Gäller endast för TPT Stream. Den här egenskapen finns i Avancerad redigerare.
PackMaximum Boolean Bestäm dynamiskt den maximala packfaktorn för det aktuella Stream-jobbet om det är sant. Gäller endast för TPT Stream. Den här egenskapen finns i Avancerad redigerare.
QueryBandSessInfo Varchar Ett användardefinierat, sessionsbaserat frågebandsuttryck för att aktivera övervakning och styrning av debitering. Den här egenskapen måste vara i anslutningssträngsformat. Den här egenskapen finns i Avancerad redigerare.
ReplicationOveride Heltal (uppräkning) Alternativ:
Standard: Ingen SET SESSION OVERRIDE REPLICATION-instruktion skickas till databasen. Databasens standardinställningar används.
På: De normala replikeringstjänstkontrollerna åsidosätts.
Av: De normala replikeringstjänstkontrollerna används.
Den här egenskapen gäller endast för TPT Stream.
Den här egenskapen finns i Avancerad redigerare.
Robust Boolean Robust omstartslogik används för återställnings- och omstartsåtgärder om sant. Den här egenskapen gäller endast för TPT Stream. Den här egenskapen finns i Avancerad redigerare.
TableName String Namnet på tabellen med de data som används.
Uthållighetstimmar Integer Antalet timmar som TPT-drivrutinen försöker logga in när det maximala antalet belastnings-/exportåtgärder redan körs. Standardvärdet är 4 timmar. Den här egenskapen finns i Avancerad redigerare
TenacitySleep Integer Antal minuter som TPT-drivrutinen pausar innan den försöker logga in när gränsen har uppnåtts. Gränsen definieras av egenskaperna MaxSessions och TenacityHours . Standardvärdet är sex minuter. Den här egenskapen finns i Avancerad redigerare
UnicodePassThrough Boolean Av (standard): Inaktivera Unicode-genomströmningen.
På: Aktivera Unicode-genomströmningen.

Konfigurera Teradata-målet

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

Teradata-målredigeraren visas i bilden nedan. Den innehåller Sidan Anslutningshanteraren, Sidan Mappningar och Sidan Felutdata.

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

destinationsredigeraren

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 ditt Integration Services-projekt högerklickar du på Teradata-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 Teradata-mål.

Teradata-Destination-redigeraren (sidan Anslutningshanterare)

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

Öppna Teradata Destination Editor-anslutningshanterarsidan

  • I SQL Server Data Tools öppnar du SSIS-paketet (SQL Server Integration Services) som har Teradata-målet.

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

  • I Teradata-målredigeraren klickar du på Anslutningshanteraren.

Options

Anslutningshanteraren

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

New

Klicka på Nytt. Dialogrutan Teradata 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 – TPT Stream Inkrementellt läge med TPT Stream-operatorn.
Namnet på tabellen eller vy: Välj en befintlig tabell eller vy från listan. Den här listan visar bara de första 1 000 tabellerna. Du kan skriva tabellnamnprefix eller använda någon del av namnet med jokertecknet (*) för att visa den tabell eller de tabeller som du vill använda.
Tabellnamn – TPL-inläsning Snabbt inläsningsläge (direktsökväg) med TPT API Load-operatorn (Teradata FastLoad-protokollet), som kräver att måltabellen är tom.
Namnet på tabellen eller vyn: Välj en befintlig tabell eller vy i listan. Den här listan visar bara de första 1 000 tabellerna. Du kan skriva tabellnamnprefix eller använda någon del av namnet med jokertecknet (*) för att visa den tabell eller de tabeller som du vill använda.

Datakryptering Kryssruta för att aktivera datakryptering. Standardalternativet är inte valt.

Ta alltid bort feltabell Kryssruta för att ta bort feltabeller i alla instanser.

Feltabell Namnet på den tabell som felen skrivs till.

Minsta antal sessioner Det minsta antalet sessioner som är inloggade. Standardvärdet är en session för varje tillgänglig AMP. Värdet måste vara större än ett.

Maximalt antal sessioner Det maximala antalet sessioner som är inloggade. Standardvärdet är en session för varje tillgänglig AMP. Värdet måste vara större än ett.

Maximalt antal fel Det maximala antalet fel som kan returneras innan dataflödet stoppas eller omdirigeras.

Teradata-målredigeraren (mappningssida)

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

Så här öppnar du sidan mappningar för Teradata-målredigeraren

  • I SQL Server Data Tools öppnar du SSIS-paketet (SQL Server Integration Services) som har Teradata-målet.

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

  • I Teradata-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.

Teradata målredigerare (felutgångssida)

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

Så här öppnar du felsidan för Teradata-målredigeraren

  • I SQL Server Data Tools öppnar du SSIS-paketet (SQL Server Integration Services) som har Teradata-målet.

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

  • Klicka på Felutgång i Teradata-målredigeraren.

Options

Felbeteende

Välj hur Teradata-målet ska hantera fel i ett flöde: ignorera felet, omdirigera raden eller fela komponenten.

Relaterade ämnen: Fel vid överlämnande av data

Trunkering

Välj hur Teradata-destinationen ska hantera trunkering i ett flöde: ignorera felet, omdirigera raden eller rapportera komponentfel.

Nästa steg

  • Last updated on