Delen via

Teradata-bestemming

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

De Teradata-bestemming laadt gegevens bulksgewijs in Teradata Database.

De bestemming maakt gebruik van het Teradata-verbindingsbeheer om verbinding te maken met een gegevensbron. Zie Teradata Connection Manager voor meer informatie.

Laadopties

Teradata-doel ondersteunt twee modi voor het laden van gegevens:

  • TPT Stream: deze modus maakt gebruik van de TPT API Stream-operator (Teradata TPump-protocol).

  • TPT Load (snel bulksgewijs laden): In deze modus wordt de TPT API Load-operator (Teradata FastLoad-protocol) gebruikt om snel bulksgewijs te laden.

De modus voor snel laden heeft de onderstaande beperkingen:

  • De limiet van sessies voor de Teradata-database wordt bepaald door de factor die hieronder als eerste optreedt.

    • Sessielimieten ingesteld met behulp van de opdracht SESSIONS
    • De limiet van de Teradata-database van één sessie per AMP
    • De platformlimiet voor het maximum aantal sessies per toepassing: gedefinieerd door de variabele MaxSess in het cop-interfacesoftwarebestand (Communications Processor) CLISPB.DAT. U kunt de TDP SET MAXSESSIONS-opdracht gebruiken om een platformlimiet op te geven. De standaardlimiet is gelijk aan de server MAXSESS.

  • Join-indexen worden niet ondersteund.

  • Verwijzingen naar vreemde sleutels in doeltabellen worden niet ondersteund.

  • Doeltabellen die zijn gedefinieerd met een secundaire index, worden niet ondersteund.

Zie de referentie voor snelle belasting van Teradata voor meer informatie over de beperkingen voor snelle belasting van Teradata.

U kunt de modus instellen in de Teradata-doeleditor (verbindingsbeheerpagina).

Foutafhandeling

Fouten die tijdens het laadproces worden geretourneerd, worden geschreven naar tijdelijke fouttabellen die tijdens het laadproces zijn vergrendeld. Het maximum aantal fouten (MaxErrors) in Geavanceerde editor stelt het maximum aantal fouten in dat naar deze tabellen kan worden geschreven.

Als het maximum aantal fouten groter is dan nul, worden fouttabellen met unieke namen gegenereerd en wordt een informatief bericht afgedrukt naar het pakketlogboek. De fouten kunnen worden opgehaald via de foutuitvoer van de standaard SSIS-component.

De tijdelijke tabellen worden verwijderd zodra het laadproces is voltooid. Als de temporele tabellen niet kunnen worden gelezen door de Teradata-bestemming, worden ze niet verwijderd, tenzij de eigenschap Foutentabel altijd laten vallen is ingeschakeld. Als het laadproces vóór voltooiing is gestopt, moet u deze tabellen indien nodig handmatig verwijderen. Deze tabellen bevinden zich in dezelfde database met de doeltabel.

Wanneer het maximum aantal fouten is bereikt, is de status van de doeltabel afhankelijk van de modus die wordt gebruikt.

  • In de modus snel laden is de doeltabel niet bruikbaar. Als u het opnieuw wilt uitvoeren, moet u de doeltabel afkappen of verwijderen en opnieuw maken. Terugdraaien wordt niet ondersteund.
  • In de TPT Steam-operatormodus wordt de Teradata-bestemming uitgevoerd via het buffermechanisme voor rijen. Als de taak mislukt, zijn alle wijzigingen die zijn voltooid (buffers zijn verzonden) op het moment van de fout permanent in de doeltabel(s). Er is geen terugdraaiconcept. Fouttabellen worden verwijderd.

De Teradata-bestemming heeft een foutoutput. Zie Teradata Destination Editor (foutuitvoerpagina) voor meer informatie.

Parallellisme

Parallellisme is beperkt in de modus voor snelle belasting. Meerdere onafhankelijke taken voor snelle belasting hebben geen toegang tot dezelfde tabel tegelijk. Het aantal gelijktijdige taken voor snelle belasting wordt ook beperkt door de databasevariabele MaxLoadTasks.

Er is geen beperking van parallelle uitvoering in de TPT Stream-modus. Het is mogelijk om meerdere Teradata-bestemmingen gelijktijdig uit te voeren op dezelfde tabel, terwijl dit de prestaties per Teradata kan verminderen. Zie de Documentatie van Teradata voor meer informatie.

Problemen met de Teradata-bestemming oplossen

U kunt de aanroepen die door de Teradata-bron worden uitgevoerd, registreren bij de Teradata Parallel Transporter-API (TPT-API). U kunt logboekregistratie van pakketten inschakelen en de diagnostische gebeurtenis op pakketniveau selecteren om de aanroepen te registreren.

U kunt de ODBC-aanroepen die door de Teradada-bron naar het ODBC-stuurprogramma van Teradata worden uitgevoerd, registreren door de tracering van ODBC-stuurprogrammabeheer in te schakelen. Voor meer informatie, zie de Microsoft-documentatie over Hoe een ODBC-trace te genereren met de ODBC-gegevensbronbeheerder.

Aangepaste eigenschappen van Teradata-bestemming

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

Naam van de eigenschap Gegevenssoort Description
AlwaysDropErrorTable Booleaan De standaardwaarde is Onwaar. Verwijder alle fouttabellen als Waar is ingesteld, zelfs als het lezen van de Teradata-bestemming mislukt.
ArraySupport Booleaan De standaardwaarde is True. DML-groepen gebruiken ArraySupport als True. Alleen van toepassing op TPT Stream. Deze eigenschap bevindt zich in geavanceerde editor.
Buffers Integer Het aantal aanvraagbuffers moet worden verhoogd, waarbij de waarde kan worden ingesteld van 2 tot 64. Alleen van toepassing op TPT Stream. Deze eigenschap bevindt zich in geavanceerde editor.
BufferMode Booleaan De standaardwaarde is True. Moet Waar zijn als de PutBuffer-functionaliteit wordt gebruikt. Deze eigenschap bevindt zich in geavanceerde editor.
Buffergrootte Integer De grootte van de uitvoerbuffer (in KB) die wordt gebruikt voor het verzenden van laadpakketten. De standaardwaarde is 1024. Van toepassing alleen op TPT laden. Deze eigenschap bevindt zich in geavanceerde editor.
Gegevensversleuteling Booleaan De standaardwaarde is Onwaar. Volledige beveilingsencryptie wordt gebruikt als Waar.
DefaultCodePage Integer De codepagina die moet worden gebruikt wanneer de gegevensbron geen codepagina-informatie bevat.
Opmerking: deze eigenschap bevindt zich in geavanceerde editor.
GedetailleerdTraceringsniveau Integer (opsomming) Selecteer een van de volgende opties voor geavanceerde tracering:
Uit: Geen geavanceerde logboekregistratie.
Algemeen: Algemene tracering van stuurprogrammaspecifieke activiteiten wordt vastgelegd.
CLI: CLIv2-gerelateerde activiteitentracering wordt vastgelegd.
Methode Notify: Tracering van functiegerelateerde activiteiten wordt vastgelegd.
Algemene bibliotheek: tracering van activiteiten in de opcommon bibliotheek wordt gelogd.
Alle: Alle bovenstaande activiteiten worden geregistreerd in een log.
Het logboekbestand voor geavanceerde tracering wordt gedefinieerd in de eigenschap DetailedTracingFile .
De eigenschap DetailedTracingFile moet worden ingesteld als de optie niet is uitgeschakeld.
Deze eigenschap bevindt zich in geavanceerde editor.
GedetailleerdVolgbestand Snaar / Touwtje Het pad van het logboekbestand dat automatisch wordt gegenereerd wanneer DetailedTracingLevel niet is uitgeschakeld. Deze eigenschap bevindt zich in geavanceerde editor.
DiscardLargeRow Booleaan De standaardwaarde is Onwaar. Grote rijen verwijderen (meer dan 64.000) als True
ErrorTableName Snaar / Touwtje Naam van fouttabel. Standaard is de naam van de doeltabel
ExtendedStringColumnsAllocation Booleaan Maximal Transfer Character Allocation Factor wordt gebruikt indien True.
Deze waarde moet worden ingesteld op True als de Export Tabel-ID eigenschap van de Teradata-database is ingesteld op Maximale Standaardinstellingen.
De standaardwaarde is Onwaar.
FastLoad Booleaan Snel laden wordt gebruikt als Waar. De standaardwaarde is onwaar. Dit kan ook worden ingesteld in de Teradata-doeleditor (verbindingsbeheerpagina).
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 Teradata Destination Editor (foutuitvoerpagina) voor meer informatie.
MaxSessions Integer Het maximum aantal sessies dat is aangemeld. Deze waarde moet groter zijn dan één waarde. De standaardwaarde is één sessie voor elke beschikbare AMP.
MinSessions Integer Het minimale aantal sessies dat is aangemeld. Deze waarde moet groter zijn dan één waarde. De standaardwaarde is één sessie voor elke beschikbare AMP.
Inpakken Integer Het aantal instructies dat moet worden ingepakt in een verzoek met meerdere instructies. De standaardwaarde is 20, maximaal toegestaan is 2400. Alleen van toepassing op TPT Stream. Deze eigenschap bevindt zich in geavanceerde editor.
PackMaximum Booleaan Bepaal dynamisch de maximale packfactor voor de huidige Stream-taak als waar. Alleen van toepassing op TPT Stream. Deze eigenschap bevindt zich in geavanceerde editor.
QueryBandSessInfo Varchar Een door de gebruiker gedefinieerde, op sessies gebaseerde querybandexpressie om kostenverrekeningbewaking en -beheer in te schakelen. Deze eigenschap moet in het format van een verbindingsreeks zijn. Deze eigenschap bevindt zich in geavanceerde editor.
ReplicationOveride Geheel getal (enumeratie) Opties:
Standaard: Er wordt geen SET SESSION OVERRIDE REPLICATION-instructie verzonden naar de database. De standaardinstellingen voor de database worden gebruikt.
Aan: De normale besturingselementen voor de replicatieservice worden overschreven.
Uit: de normale besturingselementen voor de replicatieservice worden gebruikt.
Deze eigenschap is alleen van toepassing op TPT Stream.
Deze eigenschap bevindt zich in geavanceerde editor.
Robuuste Booleaan Robuuste herstartlogica wordt gebruikt voor herstel- en herstartbewerkingen als True. Deze eigenschap is alleen van toepassing op TPT Stream. Deze eigenschap bevindt zich in geavanceerde editor.
TableName Snaar / Touwtje De naam van de tabel met de gegevens die worden gebruikt.
TenacityHours Integer Het aantal uren dat het TPT-stuurprogramma probeert in te loggen wanneer het maximum aantal laad-/exportbewerkingen al wordt uitgevoerd. De standaardwaarde is 4 uur. Deze eigenschap bevindt zich in geavanceerde editor
TenacitySleep Integer Het aantal minuten dat het TPT-stuurprogramma pauzeert voordat het opnieuw probeert aan te melden wanneer de limiet is bereikt. Limiet wordt gedefinieerd door de eigenschappen MaxSessions en TenacityHours . De standaardwaarde is zes minuten. Deze eigenschap bevindt zich in geavanceerde editor
UnicodePassThrough Booleaan Uit (standaard): Schakel de Unicode Pass Through uit.
Aan: Schakel de Unicode Pass Through in.

De Teradata-bestemming configureren

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

De Teradata-doeleditor wordt weergegeven in de onderstaande afbeelding. Deze bevat de Verbindingsbeheerpagina, de toewijzingspagina en de foutuitvoerpagina.

Zie een van de volgende onderwerpen voor meer informatie:

doel-editor

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 het Teradata-doel en selecteer Geavanceerde editor weergeven.

Zie aangepaste eigenschappen van de Teradata-bestemming voor meer informatie over welke eigenschappen u kunt instellen in het dialoogvenster Geavanceerde editor.

Teradata-doellocatie-editor (Verbindingsbeheer-pagina)

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

De verbindingsbeheerpagina van de Teradata-doeleditor openen

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

  • Dubbelklik op het tabblad Gegevensstroom op het Teradata-doel.

  • Klik in de Teradata-doeleditor op Verbindingsbeheer.

Options

Verbindingsbeheer

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

Nieuw

Klik op Nieuw. Het dialoogvenster Teradata 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 - TPT Stream Incrementele modus met behulp van de TPT Stream-operator.
Naam van de tabel of de weergave: Selecteer een bestaande tabel of weergave in de lijst. In deze lijst worden alleen de eerste 1000 tabellen weergegeven. U kunt het voorvoegsel voor de tabelnaam typen of een deel van de naam met het jokerteken (*) gebruiken om de tabel of tabellen weer te geven die u wilt gebruiken.
Tabelnaam – TPL-last Snel-laadmodus (Direct Path) via de TPT API Load-operator (Teradata FastLoad-protocol), waarvoor de doeltabel leeg moet zijn.
Naam van de tabel of de weergave: Selecteer een bestaande tabel of weergave in de lijst. In deze lijst worden alleen de eerste 1000 tabellen weergegeven. U kunt het voorvoegsel voor de tabelnaam typen of een deel van de naam met het jokerteken (*) gebruiken om de tabel of tabellen weer te geven die u wilt gebruiken.

Gegevensversleuteling Schakel het selectievakje in om gegevensversleuteling in te schakelen. De standaardwaarde is niet geselecteerd.

Fouttabel altijd verwijderen Selecteer het selectievakje om fouttabellen in alle instanties te verwijderen.

Fouttabel Naam van de tabel waarnaar fouten worden geschreven.

Minimum aantal sessies Het minimale aantal sessies dat is aangemeld. De standaardwaarde is één sessie voor elke beschikbare AMP. De waarde moet groter zijn dan één.

Maximum aantal sessies Het maximum aantal sessies dat is aangemeld. De standaardwaarde is één sessie voor elke beschikbare AMP. De waarde moet groter zijn dan één.

Maximum aantal fouten Het maximum aantal fouten dat kan worden geretourneerd voordat de gegevensstroom wordt gestopt of omgeleid.

Teradata-doeleditor (toewijzingenpagina)

Gebruik de pagina Toewijzingen van het Teradata-doeleditor dialoogvenster om invoerkolommen aan doelkolommen toe te wijzen.

De pagina Toewijzingen van de Teradata-doeleditor openen

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

  • Dubbelklik op het tabblad Gegevensstroom op het Teradata-doel.

  • Klik in de Teradata-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.

Teradata-doeleditor (foutuitvoerpagina)

Gebruik de pagina Foutuitvoer van het dialoogvenster Doeleditor van Teradata om opties voor foutafhandeling te selecteren.

De foutuitvoerpagina van de Teradata-doellocatie-editor openen

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

  • Dubbelklik op het tabblad Gegevensstroom op het Teradata-doel.

  • Klik in de Doeleditor van Teradata op Foutuitvoer.

Options

Foutgedrag

Kies hoe de Teradata-bestemming fouten in een stroom moet afhandelen: negeer de fout, leid de rij door, of laat het onderdeel falen.

Verwante onderwerpen: Fout bij het inleveren van gegevens

Afkorting

Selecteer hoe de Teradata-bestemming afkapping in een datastroom moet verwerken: negeer de fout, leid de rij om, of laat het onderdeel mislukken.

Volgende stappen

  • Last updated on